API（自動注文）ドキュメント

ページ更新日：2026/04/23

本ページでは、REST API（v1）について説明します。
API の利用には、事前にマイページからお申込みいただいた API キーが必要です。
API を利用することで、貴社システムから SSL 証明書の注文・ステータス確認・証明書ダウンロードなどを自動化できます。
注文は RapidSSL と QuickSSL Premium（ワイルドカード含む）に対応しています。年単位・月単位・日単位（満了日指定）での注文が可能です。
ステータス確認・再発行・証明書ダウンロードはトゥルービジネスID・デジサート Secure Site 等の OV/EV 証明書を含む、デジサート全製品に対応しています。

1. ベース URL

API は本番環境とサンドボックス環境で同じ URL を利用します。

URL：https://www.slogical.co.jp/ssl/api/v1/

サンドボックス環境では実際の請求や証明書発行は行われません。疎通確認や実装テストにご利用ください。
※サンドボックス注文すると、マイページで「キャンセルされた注文」としてご確認いただけます。
※サンドボックス注文では、ファイル認証のAPIキーや証明書などのレスポンスがダミー値になります。

2. 認証（API キー）

API の利用には、事前にマイページからお申込みいただいた API キーが必要です。
弊社にて内容確認のうえ、本番用・サンドボックス用の API キーを発行します。

リクエストヘッダーに、以下の形式で API キーを送信してください。

Authorization: ApiKey <発行されたAPIキー>

接続元 IP アドレス制限をしておりますので、アクセス元IPアドレスをお教えください。
登録されていない IP からのAPIアクセスは認証エラーとなります。

3. エンドポイント一覧

HTTP メソッド	パス	概要
POST	/ssl/api/v1/orders	注文作成（証明書の新規発行／更新）
GET	/ssl/api/v1/orders/{order_id}	注文ステータス・DCV 用トークン取得
DELETE	/ssl/api/v1/orders/{order_id}	注文キャンセル
GET	/ssl/api/v1/orders	オーダー一覧取得
POST	/ssl/api/v1/csrs	CSR 作成（秘密鍵生成を含む）
POST	/ssl/api/v1/orders/{order_id}/reissue	証明書再発行
DELETE	/ssl/api/v1/orders/{order_id}/reissue	再発行キャンセル
GET	/ssl/api/v1/certificates/{order_id}	証明書／中間証明書のダウンロード

4. リクエスト形式

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

4-1. 注文作成リクエスト（POST /orders）

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

certificate.product：RapidSSL / RapidSSLWildcard / QuickSSLPremium / QuickSSLPremiumWildcard
certificate.years：1～3（年単位。months・expire と排他）
certificate.months：1～11（月単位。years・expire と排他）
certificate.expire：満了日を YYYY-MM-DD 形式で指定（日単位。years・months と排他）。価格は満了日までの日数を30日で割り上げた月数で計算されます。
certificate.csr：PEM 形式の CSR
certificate.dcv：DCV（ドメイン認証）方法
- admin@：メール認証
- administrator@：メール認証
- hostmaster@：メール認証
- webmaster@：メール認証
- postmaster@：メール認証
- file：ファイル認証（指定ファイルを Web サーバーに設置）
- dns：DNS 認証（TXT レコードまたは CNAME レコードを追加）
certificate.www_option：www オプション（ワイルドカード証明書では不要）
- a：自動（コモンネームが www.ベースドメインであれば、コモンネームと www あり／なしの両方を保護）
- y：あり（コモンネームと www あり／なしの両方を保護）
- n：なし（コモンネームのみ保護）
organization.corp_name：日本語の会社名
contact.email_invoice：請求書送付先メールアドレス

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

5. レスポンス形式

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

{
  "status": "OK" | "NG",
  "order_id": 12345,
  "digicert_order_id": 67890,
  "order_status": "issued" | "pending" | "...",
  "token": "dcv-random-value",
  "certificate": "-----BEGIN CERTIFICATE----- ...",
  "intermediate_certificate": "-----BEGIN CERTIFICATE----- ...",
  "order": {
    "id": 12345,
    "ssl_type": "ra01",
    "months": "",
    "csrinfo_cn": "www.example.com",
    "csrinfo_bit": "2048",
    "sans": "",
    "hash_algorithm": "sha256",
    "www_option": "a",
    "ev_jp_corp_name": ""
  },
  "message": [
    "説明メッセージ1",
    "説明メッセージ2"
  ]
}

status：API の結果。OK（成功）または NG（エラー）。
order_id：当社システム側の注文 ID。
digicert_order_id：DigiCert 側のオーダー ID（一部エンドポイントのみ）。
order_status：DigiCert 側のステータス（例：pending / issued / rejected）。
token：ファイル認証・DNS 認証で使用するランダムコード。
certificate：サーバー証明書本体（PEM）。
intermediate_certificate：中間 CA 証明書（PEM）。
order：注文詳細オブジェクト（GET /orders/{order_id} および GET /orders で返されます）。主なフィールドは下記のとおりです。
- id：注文 ID。
- ssl_type：証明書種別（例：ra01 / rw01）。
- months：有効期間（月数で購入の場合）。
- csrinfo_cn：CSR に含まれるコモンネーム（ドメイン名）。
- csrinfo_bit：鍵長（例：2048 / 4096）。
- sans：SAN（Subject Alternative Name）。複数ドメインの場合はスペース区切り。
- hash_algorithm：署名ハッシュアルゴリズム（例：sha256）。
- www_option：www オプション（a=自動 / y=www あり / n=www なし）。
- ev_jp_corp_name：EV 証明書の日本語会社名（EV 証明書のみ）。
message：補足情報やエラーメッセージ（英語／英数字）。

6. cURL サンプル

6-1. 注文作成（POST /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",
      "post": "3300854",
      "addr1": "埼玉県",
      "addr2": "さいたま市大宮区",
      "addr3": "桜木町1-195-1",
      "addr4": "（省略可能）大宮ソラミチKOZ4階 エキスパートオフィス大宮"
    },
    "contact": {
      "is_postpay": "y",
      "memo": "（省略可能）APIからの注文です"
    }
  }'

6-1-2. 月単位での注文（certificate.months）

years の代わりに months（1～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"
    }
  }'

6-1-3. 満了日指定での注文（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"
    }
  }'

6-2. 注文ステータス・DCV トークン取得（GET /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 認証で利用するランダムコードが含まれます。

レスポンス例：

{
  "status": "OK",
  "is_sandbox": false,
  "order_id": 12345,
  "digicert_order_id": 67890,
  "order_status": "issued",
  "token": "_abcdefghijklmnopqrstuvwxyz01234",
  "order": {
    "id": 12345,
    "ssl_type": "ra01",
    "months": "",
    "csrinfo_cn": "www.example.com",
    "csrinfo_bit": "2048",
    "sans": "",
    "hash_algorithm": "sha256",
    "www_option": "a",
    "ev_jp_corp_name": ""
  }
}

※ DigiCert への注文処理が完了する前にリクエストした場合、order_status は返されず、message に "Please wait. Your order is being processed." が含まれます。その場合でも order オブジェクトは返されます。

6-3. 証明書ダウンロード（GET /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>"

order_status が issued になった後、このエンドポイントからサーバー証明書と中間証明書（PEM 形式）を取得できます。
2026/02/07 証明書の改行コードを LF（Unix）で統一いたしました。

6-4. 注文キャンセル（DELETE /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" および関連するメッセージが返されます。

6-5. オーダー一覧取得（GET /orders）

過去の注文を一覧で取得します。結果は注文 ID の降順（新しい順）で返されます。
ページングや検索条件（注文日・コモンネーム等）をクエリパラメータで指定できます。
特定のコモンネームに対して「新規発行・更新・再発行」のどれを実行すべきかを判定したい場合は、GET /orders?common_name=<CN>&per_page=1 を実行することで、最新注文の契約期限（order.expire）および証明書有効期限（digicert_cert_valid_till_gmt）を取得できます。

パラメータ名	説明	例
page	ページ番号（デフォルト: 1）	page=2
per_page	1ページあたり件数（デフォルト: 30、最大: 200）	per_page=10
common_name	コモンネームで部分一致検索	common_name=example.com
corp_name	会社名で部分一致検索	corp_name=エスロジカル
created_from	注文日（From）YYYY-MM-DD	created_from=2025-01-01
created_to	注文日（To）YYYY-MM-DD	created_to=2025-12-31
digicert_cert_from	証明書有効期限（From）YYYY-MM-DD	digicert_cert_from=2026-01-01
digicert_cert_to	証明書有効期限（To）YYYY-MM-DD	digicert_cert_to=2026-03-31
digicert_contract_from	DigiCert 契約期限（From）YYYY-MM-DD	digicert_contract_from=2026-01-01
digicert_contract_to	DigiCert 契約期限（To）YYYY-MM-DD	digicert_contract_to=2026-12-31
include_csr	true を指定すると CSR 全文を返す（デフォルト: 返さない）	include_csr=true
include_deleted	true を指定するとキャンセル済み注文も含める	include_deleted=true

# 全件取得（新しい順）
curl -i "https://www.slogical.co.jp/ssl/api/v1/orders?page=1&per_page=30" \
  -H "Authorization: ApiKey <YOUR_API_KEY>"

# コモンネームで絞り込み（部分一致）
curl -i "https://www.slogical.co.jp/ssl/api/v1/orders?common_name=www.example.com" \
  -H "Authorization: ApiKey <YOUR_API_KEY>"

# 直近1件だけ取得
curl -i "https://www.slogical.co.jp/ssl/api/v1/orders?common_name=www.example.com&per_page=1" \
  -H "Authorization: ApiKey <YOUR_API_KEY>"

レスポンス例：

{
  "status": "OK",
  "is_sandbox": false,
  "total": 2,
  "page": 1,
  "per_page": 30,
  "orders": [
    {
      "order": {
        "id": 12345,
        "ssl_type": "ra01",
        "months": "",
        "expire": "2027-02-01",
        "csrinfo_cn": "www.example.com",
        "csrinfo_bit": "2048",
        "sans": "",
        "hash_algorithm": "sha256",
        "www_option": "a",
        "ev_jp_corp_name": "",
        "is_update": "n",
        "created": "2026-02-01 10:00:00"
      },
      "product_name": "RapidSSL 1年",
      "digicert_order_id": 67890,
      "digicert_order_till_gmt": "2027-02-01",
      "digicert_cert_valid_till_gmt": "2027-03-04"
    },
    {
      "order": {
        "id": 12346,
        "ssl_type": "rw01",
        "months": "",
        "expire": "2026-05-01",
        "csrinfo_cn": "*.example.com",
        "csrinfo_bit": "2048",
        "sans": "",
        "hash_algorithm": "sha256",
        "www_option": "n",
        "ev_jp_corp_name": "",
        "is_update": "n",
        "created": "2025-05-01 10:00:00"
      },
      "product_name": "RapidSSL ワイルドカード 1年",
      "digicert_order_id": 67891,
      "digicert_order_till_gmt": "2026-05-01",
      "digicert_cert_valid_till_gmt": "2026-05-30"
    }
  ]
}

※ digicert_cert_valid_till_gmt（証明書有効期限）は、DigiCert にて証明書が発行済みの場合のみ値が入ります。order_status が pending などの未発行状態では空文字になります。

6-6. CSR 作成（POST /csrs）

秘密鍵と CSR を API で生成します。
key_type と key_size は省略可能で、デフォルトは RSA 2048bit です。

curl -i -X POST "https://www.slogical.co.jp/ssl/api/v1/csrs" \
  -H "Authorization: ApiKey <YOUR_SANDBOX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "common_name": "www.example.com",
    "country": "JP"
  }'

curl -i -X POST "https://www.slogical.co.jp/ssl/api/v1/csrs" \
  -H "Authorization: ApiKey <YOUR_SANDBOX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "common_name": "www.example.com",
    "country": "JP",
    "state": "Saitama-shi",
    "locality": "Saitama",
    "organization": "Example Inc"
  }'

6-7. 再発行（POST /orders/{order_id}/reissue）

既存注文（発行済）に対して、CSR を差し替えて再発行します。
CSR の Common Name は元注文と一致している必要があります（一致しない場合はエラー）。
RapidSSL・QuickSSL Premium（DV）に加え、トゥルービジネスID・デジサート Secure Site 等の OV/EV 証明書も申請できます。
ただし OV/EV 証明書の再発行は、認証局（DigiCert）側で組織の再審査が行われる場合があります。

curl -i -X POST "https://www.slogical.co.jp/ssl/api/v1/orders/12345/reissue" \
  -H "Authorization: ApiKey <YOUR_SANDBOX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "certificate": {
      "csr": "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----",
      "dcv": "file"
    }
  }'

2026/02/07 リクエスト例の記載に誤りがありましたので訂正しました。

6-8. 再発行キャンセル（DELETE /orders/{order_id}/reissue）

進行中の再発行をキャンセルします（状態によってはキャンセル不可の場合があります）。

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

7. お問い合わせ

API の仕様に関するご質問など、お気軽にお問い合わせください。

FAQ／情報 SSL証明書