REST API v1 ドキュメント

注文作成（POST /ssl/api/v1/orders）

注文作成のリクエスト・レスポンスの全フィールドと、DCV 方式の指定、月単位・満了日指定の注文、cURL サンプル。

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

リクエスト形式

文字コード： UTF-8
Content-Type： application/json
ボディ： POST /ssl/api/v1/orders、POST /ssl/api/v1/csrs、POST /ssl/api/v1/orders/{order_id}/reissue のみ JSON ボディ必須、その他のエンドポイントはボディ不要です。

注文作成リクエスト（POST /ssl/api/v1/orders）

代表的なフィールドは次の通りです（実際のフィールド名は英語で、値の内容は日本語を含んでも構いません）。

certificate.product：RapidSSL / RapidSSLWildcard / QuickSSLPremium / QuickSSLPremiumWildcard
certificate.years：1～3（年単位。months・expire と排他）
certificate.months：3～11（月単位。years・expire と排他）※月単位のご購入は3ヵ月からです
certificate.expire：満了日を YYYY-MM-DD 形式で指定（日単位。years・months と排他）。価格は満了日までの日数を30日で割り上げた月数で計算されます（3ヵ月より短い期間も指定できますが、価格は3ヵ月分が下限です）。
certificate.csr：PEM 形式の CSR
certificate.dcv：DCV（ドメイン認証）方法
- email：メール認証（承認メールの宛先は certificate.dcv_detail で指定。dcv_detail を省略（空）した場合は、認証局の標準承認アドレス（admin@ / administrator@ / hostmaster@ / postmaster@ / webmaster@）すべてに送付されます。送付先のドメインは dcv_scope に従い、省略／自動時はベースドメイン（admin@<ベースドメイン> 等）、fqdn 指定時は各 FQDN（admin@<FQDN> 等）になります）
- file：ファイル認証（指定ファイルを Web サーバーに設置）。ワイルドカード証明書（コモンネームが *. で始まる）では file 認証は利用できません（認証局が拒否するため、リクエスト時に 400 を返します）。dns または email をご利用ください。
- dns：DNS 認証（TXT レコードまたは CNAME レコードを追加）
- dns_persistent：Persistent DNS 認証（_validation-persist.<ベースドメイン> の固定 TXT レコードを1回設定。以後の再発行・更新では再設定不要で、認証局が自動承認します。dcv_scope 省略時はベースドメイン単位）。ランダムコード（token）は発行されず、設定するレコードは GET /ssl/api/v1/dcv/persistent（Persistent DNS 認証のレコード取得）または再発行応答・注文詳細の dcv_records で取得します。対象は DigiCert 系の SSL サーバー証明書すべて（DV は注文・再発行、OV/EV は再発行。OV/EV は JP 契約固定のため GET /dcv/persistent では product を指定）。解説：Persistent DNS認証とは
certificate.dcv_detail：メール認証（dcv が email）の場合の承認メールアドレス（例：admin@example.com）。任意：省略（空）した場合は、認証局の標準承認アドレス（admin@ / administrator@ / hostmaster@ / postmaster@ / webmaster@）すべてに送付されます（送付先のドメインは dcv_scope に従い、省略／自動時はベースドメイン、fqdn 指定時は各 FQDN になります）。file / dns 認証では不要。
※ 再発行（POST /ssl/api/v1/orders/{order_id}/reissue）では dcv_detail は使用しません。再発行のメール認証は、認証局の標準承認アドレスすべてに送付されます（宛先の個別指定はできません）。
certificate.dcv_scope：DCV の適用範囲（任意）。base_domain（ベースドメイン全体で確認）／ fqdn（コモンネーム・各 SAN を FQDN 単位で確認）。省略時は自動判定（従来どおりの動作）。通常は省略で問題ありません。
※ fqdn は file / dns / dns_persistent 認証に加え、メール認証（dcv=email）でも有効です。メール認証で fqdn を指定した場合、承認メールは各 FQDN の宛先（admin@<FQDN> 等）へ送られます。省略（自動）のメール認証は従来どおりベースドメインの標準アドレスへ送ります。
※ ワイルドカード証明書（コモンネームが *. で始まる）で fqdn を指定した場合は、*. を除いたドメイン（例: *.sub.example.com → sub.example.com）で確認し、メール認証の承認メールもそのドメインの宛先へ送られます。
certificate.www_option：www オプション（ワイルドカード証明書では不要）
- a：自動（コモンネームが www.ベースドメインであれば、コモンネームと www あり／なしの両方を保護）
- y：あり（コモンネームと www あり／なしの両方を保護）
- n：なし（コモンネームのみ保護）
organization.corp_name：日本語の会社名
organization.email_add1 / organization.email_add2：組織情報メールの追加先（任意）。認証局（CA）の承認・連絡メール送付先として登録されます。
※ サイバートラスト系商品は CA 制約により email_add1 のみ有効（email_add2 は無視されます）。
contact.email_invoice：請求メール送付先（主・任意）。請求書・発行通知・更新／再発行通知など、すべての請求系メールの宛先になります。
※ 省略した場合は APIキー所有者のメールアドレスが請求先（主）として使用されます。
contact.email_invoice_add1 / contact.email_invoice_add2：請求メール送付先の追加先（任意）。請求・各種通知メールが、請求先（主）に加えてこれらのアドレスにも送信されます。

※ 未使用のフィールドは空文字列でも構いません。必須項目や書式の詳細は、下記の cURLサンプルをご確認ください。

レスポンス形式

全てのエンドポイントは JSON でレスポンスを返します。

{
  "status": "OK" | "NG",
  "order_id": 12345,
  "digicert_order_id": 67890,
  "order_status": "issued" | "pending" | "...",
  "token": "dcv-random-value",
  "digicert_cert_valid_from": "2026-10-10",
  "digicert_cert_valid_till": "2027-01-18",
  "certificate": "-----BEGIN CERTIFICATE----- ...",
  "intermediate_certificate": "-----BEGIN CERTIFICATE----- ...",
  "certificate_info": {
    "serial_number": "0A1B2C...",
    "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:..."
  },
  "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": ""
  },
  "message": [
    "説明メッセージ1",
    "説明メッセージ2"
  ]
}

status：API の結果。OK（成功）または NG（エラー）。
order_id：当社システム側の注文 ID。
digicert_order_id：DigiCert 側のオーダー ID（一部エンドポイントのみ）。
order_status：DigiCert 側のステータス（例：pending / issued / rejected）。
token：ファイル認証・DNS 認証で使用するランダムコード。
digicert_cert_valid_from / digicert_cert_valid_till：DigiCert 側が持つ証明書の有効期間（YYYY-MM-DD。注文詳細のみ。発行前は返しません）。DigiCert へのリアルタイム照会の値で、日付精度です。
certificate：サーバー証明書本体（PEM）。
intermediate_certificate：中間 CA 証明書（PEM）。
certificate_info：certificate を解析した情報（証明書ダウンロードのみ）。serial_number（16進）／not_before・not_after（有効開始日時・有効期限、UTC の RFC 3339。not_before は発行時刻ではなく、DigiCert では開始日の 00:00:00 UTC になります）／not_before_jst・not_after_jst（同・日本時間）／issuer（発行 CA の CN）／subject_cn／sans／fingerprint_sha256。取得した証明書が今回の再発行分かどうかは、再発行前に控えておいた fingerprint_sha256（または serial_number）と比較して判定してください（再発行のたびに変わります。同日中の再発行は日時では区別できません）。
order：注文詳細オブジェクト（GET /ssl/api/v1/orders/{order_id} および GET /ssl/api/v1/orders で返されます）。主なフィールドは下記のとおりです。
- id：注文 ID。
- ssl_type：証明書種別（例：ra01 / rw01）。
- months：有効期間の月数。月単位（certificate.months）でご注文いただいた場合のみ値が入り、年単位・満了日指定のご注文では空文字になります。
- expire：満了日指定（certificate.expire）でご注文いただいた場合のみ、その指定日（YYYY-MM-DD）が入るご注文時の控えです。年単位・月単位のご注文では空文字になります。
  ※ 証明書や契約の満了日ではありません。満了日の判定には digicert_order_till_gmt（契約満了日）／digicert_cert_valid_till_gmt（証明書有効期限）をご利用ください。
- csrinfo_cn：CSR に含まれるコモンネーム（ドメイン名）。
- csrinfo_bit：鍵長（例：2048 / 4096）。
- sans：追加 SAN（Subject Alternative Name）。複数ドメインはスペース・カンマ・改行のいずれかで区切れます。
  有償オプションで、追加 1 件ごとに価格が加算されます（1 件で 2 倍、2 件で 3 倍…）。対応商品は qp（QuickSSL Premium）と qw（QuickSSL Premium ワイルドカード）。
  qw はワイルドカード形式（例：*.example.com）のみ、qp 等は通常ホスト名（例：aaa.example.com）のみ指定できます。
- hash_algorithm：署名ハッシュアルゴリズム。full-sha2（既定）／sha2-256／sha256-full-chain のいずれか。省略時は full-sha2。
- www_option：www オプション（a=自動 / y=www あり / n=www なし）。
- dcv_scope：DCV の適用範囲。base_domain / fqdn、または空文字（注文時に省略＝自動判定）。注文時に送信した certificate.dcv_scope をそのまま返します。
  ※ ワイルドカード証明書で fqdn を指定した場合は、*. を除いたドメイン（例: *.sub.example.com → sub.example.com）で確認します（メール認証でも同じ。リクエスト形式の certificate.dcv_scope の注記を参照）。
- ev_jp_corp_name：EV 証明書の日本語会社名（EV 証明書のみ）。
- c_email：組織情報メール（主）。認証局（CA）への登録メールアドレス。
- c_email_add1 / c_email_add2：組織情報メールの追加先（リクエストの organization.email_add1 / email_add2）。サイバートラスト系は c_email_add2 は常に空。
- c_email_invoice：請求メール送付先（主）。リクエストの contact.email_invoice（未指定時は API キー所有者メール）。
- c_email_invoice_add1 / c_email_invoice_add2：請求メール送付先の追加先（リクエストの contact.email_invoice_add1 / email_invoice_add2）。
message：補足情報やエラーメッセージ（英語／英数字）。

cURL サンプル：注文作成（POST /ssl/api/v1/orders）

サンドボックス環境でのサンプルです。実際の CSR や組織情報に置き換えてご利用ください。

curl -i -X POST "https://www.slogical.co.jp/ssl/api/v1/orders" \
  -H "Authorization: ApiKey <YOUR_SANDBOX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "certificate": {
      "product": "RapidSSL",
      "years": 1,
      "is_update": "n",
      "server_type": "その他",
      "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICbzCCAVcCAQAwKjELMAkGA1UEBhMCSlAxGzAZBgNVBAMMEnd3dy5zbG9naWNh\nbC5jby5qcDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJafWY/71gSa\nayKMqZgeYvw3raKJyquMnIIMeVUMtJeeNSwvs54X6By+YbUkECVhQW10Q02BrLzz\n+fnrLUHp9b6QHfDlIOh6vmXNwEsJAwP8TW6ay3XAfLpr0tQ0xH9z3D51coK8Qw9m\nQlzfAN0m9b3vYOJwEFdXJRxIGiMksnOcBQMXDgruGOox/YoNiuXsKChGts9oDYAR\n1o9kzPtAgEC57SEg1TQyNiMXh8J93htgkTX1ZPca59TUiWPT3ZBmRrO4kfUn3f6v\nspnNbzC/fwRDS55x0naXbCh8FBwh1xgLpth/IIZXacp6s6DEDNofk5fZRC7RnMCQ\njEt+/I6ZREECAwEAAaAAMA0GCSqGSIb3DQEBCwUAA4IBAQCRpFDYUUOPDNMu6DGq\nSQj23tMDiUj9Wx1tZzD3n+faRPatkahnAQjmnfOH5OsaYDRkPknA/vVfWfRKNkiY\njFx+UFpyW8RrY+WzfuuEjrBNTFneSrp2h7ot3pbXoH/mQGjduqCzt+sjlhJ4oLMd\numaX7UJjmKwjGSa6itWNPM0FVXDjDhNKO/Lso0+nRvgB3HWxXHST7WeK4RAaLR69\n3Gvckf/2LgrClgYOj336E4hEyPDaQa6ftX2BGtXLq4kRxejjSpOUyv3eC469SnEk\nHJBx+dnaRZq9GZB/lIZxtfcmfKERoW3G8/GpjgWliMTpf3Ur9nzNEWsO6SeTFodT\nRWq8\n-----END CERTIFICATE REQUEST-----",
      "www_option": "a",
      "dcv": "file"
    },
    "organization": {
      "corp_name": "株式会社エスロジカル",
      "name1": "関",
      "name2": "一真",
      "name_alph1": "Seki",
      "name_alph2": "Kazumasa",
      "tel": "048-837-7778",
      "email": "seki@slogical.co.jp",
      "email_add1": "info@example.com",
      "email_add2": "info2@example.com",
      "post": "3300854",
      "addr1": "埼玉県",
      "addr2": "さいたま市大宮区",
      "addr3": "桜木町1-195-1",
      "addr4": "大宮ソラミチKOZ4階 エキスパートオフィス大宮"
    },
    "contact": {
      "is_postpay": "y",
      "email_invoice": "billing@example.com",
      "email_invoice_add1": "keiri@example.com",
      "email_invoice_add2": "keiri2@example.com",
      "memo": "APIからの注文です"
    }
  }'

月単位での注文（certificate.months）

years の代わりに months（3～11）を指定します。

curl -i -X POST "https://www.slogical.co.jp/ssl/api/v1/orders" \
  -H "Authorization: ApiKey <YOUR_SANDBOX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "certificate": {
      "product": "RapidSSL",
      "months": 3,
      "is_update": "n",
      "server_type": "その他",
      "csr": "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----",
      "www_option": "a",
      "dcv": "file"
    },
    "organization": {
      "corp_name": "株式会社エスロジカル",
      "name1": "関",
      "name2": "一真",
      "name_alph1": "Seki",
      "name_alph2": "Kazumasa",
      "tel": "048-837-7778",
      "email": "seki@slogical.co.jp",
      "post": "3300854",
      "addr1": "埼玉県",
      "addr2": "さいたま市大宮区",
      "addr3": "桜木町1-195-1"
    },
    "contact": {
      "is_postpay": "y"
    }
  }'

満了日指定での注文（certificate.expire）

years / months の代わりに expire（YYYY-MM-DD 形式）を指定します。
価格は今日から満了日までの日数を30日で割り上げた月数で計算されます。

curl -i -X POST "https://www.slogical.co.jp/ssl/api/v1/orders" \
  -H "Authorization: ApiKey <YOUR_SANDBOX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "certificate": {
      "product": "RapidSSL",
      "expire": "2026-12-31",
      "is_update": "n",
      "server_type": "その他",
      "csr": "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----",
      "www_option": "a",
      "dcv": "file"
    },
    "organization": {
      "corp_name": "株式会社エスロジカル",
      "name1": "関",
      "name2": "一真",
      "name_alph1": "Seki",
      "name_alph2": "Kazumasa",
      "tel": "048-837-7778",
      "email": "seki@slogical.co.jp",
      "post": "3300854",
      "addr1": "埼玉県",
      "addr2": "さいたま市大宮区",
      "addr3": "桜木町1-195-1"
    },
    "contact": {
      "is_postpay": "y"
    }
  }'

← はじめにステータス・取得・取消 →

APIドキュメント SSL証明書