メニュー
SSL証明書 > APIドキュメント > 注文ステータス・証明書ダウンロード・キャンセル
REST API v1 ドキュメント

注文ステータス・証明書ダウンロード・キャンセル

注文ステータスと DCV トークンの取得、発行後の証明書ダウンロード、未発行注文のキャンセル。

ページ更新日:2026/10/12 / 仕様変更の履歴 / BASE URL https://www.slogical.co.jp/ssl/api/v1/

注文ステータス・DCV トークン取得(GET /ssl/api/v1/orders/{order_id})

curl -i "https://www.slogical.co.jp/ssl/api/v1/orders/12345" \
  -H "Authorization: ApiKey <YOUR_SANDBOX_API_KEY>"

レスポンスの order_status で発行状況を確認できます。また、token フィールドにファイル認証/DNS 認証で利用するランダムコードが含まれます。
※ Persistent DNS 認証(dcv=dns_persistent)のご注文では token は空で、代わりに設定する TXT レコードが dcv_records(name / type / value の配列)で返ります。

レスポンス例:

{
  "status": "OK",
  "is_sandbox": false,
  "order_id": 12345,
  "digicert_order_id": 67890,
  "order_status": "issued",
  "token": "_abcdefghijklmnopqrstuvwxyz01234",
  "digicert_cert_valid_from": "2026-10-10",
  "digicert_cert_valid_till": "2027-01-18",
  "order": {
    "id": 12345,
    "ssl_type": "ra01",
    "months": "",
    "csrinfo_cn": "www.example.com",
    "csrinfo_bit": "2048",
    "sans": "",
    "hash_algorithm": "full-sha2",
    "www_option": "a",
    "dcv_scope": "",
    "ev_jp_corp_name": "",
    "c_email": "info@example.com",
    "c_email_add1": "",
    "c_email_add2": "",
    "c_email_invoice": "billing@example.com",
    "c_email_invoice_add1": "",
    "c_email_invoice_add2": ""
  }
}

※ DigiCert への注文処理が完了する前にリクエストした場合、order_status は返されず、message に "Please wait. Your order is being processed." が含まれます。その場合でも order オブジェクトは返されます。
2026/10/10 digicert_cert_valid_from / digicert_cert_valid_till(DigiCert 側の証明書有効期間。日付精度・発行前は省略)を追加しました。取得した証明書が今回の再発行分かを確認するには、証明書ダウンロードの certificate_info(fingerprint_sha256 / serial_number)をご利用ください。

証明書ダウンロード(GET /ssl/api/v1/certificates/{order_id})

curl -i "https://www.slogical.co.jp/ssl/api/v1/certificates/12345" \
  -H "Authorization: ApiKey <YOUR_SANDBOX_API_KEY>"

# ルート証明書も含めたい場合(オプション)
curl -i "https://www.slogical.co.jp/ssl/api/v1/certificates/12345?include_root=true" \
  -H "Authorization: ApiKey <YOUR_SANDBOX_API_KEY>"

レスポンス例:

{
  "status": "OK",
  "is_sandbox": false,
  "certificate": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n",
  "intermediate_certificate": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n",
  "certificate_info": {
    "serial_number": "0A1B2C3D4E5F60718293A4B5C6D7E8F9",
    "not_before": "2026-10-10T00:00:00Z",
    "not_after": "2027-01-18T23:59:59Z",
    "not_before_jst": "2026-10-10 09:00:00 JST",
    "not_after_jst": "2027-01-19 08:59:59 JST",
    "issuer": "RapidSSL TLS RSA CA G1",
    "subject_cn": "www.example.com",
    "sans": ["www.example.com", "example.com"],
    "fingerprint_sha256": "AB:CD:EF:..."
  }
}

order_status が issued になった後、このエンドポイントからサーバー証明書と中間証明書(PEM 形式)を取得できます。
2026/02/07 証明書の改行コードを LF(Unix)で統一いたしました。
2026/10/10 certificate_info を追加しました。certificate(サーバー証明書)を解析した値です。not_before / not_after は有効開始日時・有効期限(UTC の RFC 3339。*_jst は日本時間表記)で、not_before は発行時刻ではありません(DigiCert では開始日の 00:00:00 UTC になるため、同日中の再発行は日時では区別できません)。
取得した証明書が今回の再発行分かどうかは、再発行を申請する前に取得しておいた fingerprint_sha256(または serial_number)と比較し、値が変わっていれば新しい証明書と判定してください。設置中の証明書と比較すれば「設置済みの証明書と同一か」も確認できます。証明書の発行メールが届かない場合でも、この値で確認できます。
※ サンドボックスキーでは固定のサンプル証明書を返すため、certificate_info も固定値(過去の日付)になります。

注文キャンセル(DELETE /ssl/api/v1/orders/{order_id})

SSL証明書がまだ発行されていない場合に限り、APIからのキャンセルが可能です。
それ以外のステータスではキャンセルはエラーとなり、手動対応が必要です。

curl -i -X DELETE "https://www.slogical.co.jp/ssl/api/v1/orders/12345" \
  -H "Authorization: ApiKey <YOUR_SANDBOX_API_KEY>"

成功時は 200 OK が返り、レスポンスの status が OK になります。

{
  "status": "OK",
  "order_id": 12345,
  "message": [
    "This order has been canceled."
  ]
}

すでにキャンセルされている注文、またはキャンセルできない状態の場合は、
status: "NG" および関連するメッセージが返されます。