AdvancedCertificateRequest

Prev Next

Classic/VPC環境で利用できます。

Advanced DV、Advanced OV証明書を申し込みます。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /certificate/requestPaidCertificateIssuance

リクエストヘッダ

ヘッダの説明は次の通りです。

Certificate Manager APIで共通して使用されるヘッダの詳細は、Certificate Managerの共通ヘッダをご参照ください。

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
csr String Required Certificate Signing Request (CSR)
certificateType String Required 証明書タイプ
  • NCP_PAID_DV_01 | NCP_PAID_OV_01
    • NCP_PAID_DV_01: Advanced DV証明書
    • NCP_PAID_OV_01: Advanced OV証明書
certificateName String Required 証明書名
commonName String Required 証明書の CN(Common Name)に含まれるドメイン
dnsName Array Optional 証明書 SAN(Subject Alternative Name)に含まれるドメインリスト
validationMethod String Required 証明書ドメイン所有権(DCV)の検証方法
  • D: DNS CNAMEレコードを利用した検証方式
organizationNo Integer Optional 組織番号
  • certificateTypeがNCP_PAID_OV_01の場合、必ず入力

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST 'https://certificatemanager.apigw.ntruss.com/api/v2/certificate/requestCertificateIssuance' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--data '{
    "csr":"-----BEGIN CERTIFICATE REQUEST-----CCAUICAQAwFT...HzV1ht+BbMeZlD\n-----END CERTIFICATE REQUEST-----\n",
    "certificateType":"NCP_PAID_OV_01",
    "certificateName": "ncloudcertificate",
    "commonName": "*.ncloud.com",
    "dnsName": ["ncloud.com", "ncloud-docs.com"],
    "validationMethod":"D",
    "organizationNo": 34
}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
returnCode String - レスポンスコード
returnMessage String - レスポンスメッセージ
totalRows Integer - 照会されたリストの総数
paidCertificate Object - 証明書申し込みの結果
paidCertificate.certificateNo Integer - 証明書番号
paidCertificate.requestSn String - リクエストの固有 ID
paidCertificate.statusCode Integer - 証明書の状態コード
paidCertificate.statusName String - 証明書の状態
paidCertificate.regDate Date - 証明書の登録日時
paidCertificate.validationMethod String - ドメイン所有権(DCV)の検証方法
paidCertificate.organizationNo Integer - 組織番号

レスポンスステータスコード

Certificate Manager APIで共通して使用されるレスポンスステータスコードの詳細は、Certificate Managerの共通レスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "returnCode": "0",
    "returnMessage": "Success",
    "totalRows": 0,
    "paidCertificate": {
        "certificateNo": 55985,
        "requestSn": "99ebaab2c04b43769a2e97e4ebbadf20",
        "certificateName": "ncloudcertificate",
        "statusCode": "0",
        "statusName": "Ongoing",
        "regDate": "2026-01-12 13:07:43",
        "validationMethod": "D",
        "organizationNo": 34
    }
}