メインコンテンツまでスキップ

API メッセージの送受信プロトコル

準拠プロトコル​

API メッセージ（SOAP 要求/応答および例外）は HTTP 1.1 をトランスポートとして用います。

API クライアントの要件​

API クライアントは以下の要件を満たす必要があります。

  • HTTP 1.1 に対応していること。
  • HTTP 1.1 の通信内容を TLS で暗号化できること。
    • 暗号化方式は以下の通り：
      • TLS バージョン: 1.2
      • 公開鍵暗号化方式: DH または RSA
      • 検証方式: RSA または DSS
      • 共通鍵暗号化方式: AES 128ビット または 256ビット
      • ハッシュ関数: SHA-2
  • Cookie をサポートしていること。
    • KREISEL からの Set-Cookie ヘッダの指示に従い、Cookie を追加・削除できること。

アクセス先 URL​

API 要求の接続先 URL は以下の通りです。

カスタムドメイン未使用​

  • https://krs.bz/<環境ID>/rpc
  • ポート: 443
  • 通常の環境はこれに該当します。

クリックカウントカスタムドメイン​

  • https://krs.bz/<環境ID>/rpc
  • ポート: 443

フォームカスタムドメイン（SSL）​

  • https://<カスタムドメイン名>/rpc
  • ポート: 443

※試用環境の場合は別途指示します。

名前空間 URI​

SOAP サービスの属性・要素名の衝突を避けるため、API を発行する場合は名前空間 URI として https://krs.bz/rpc の設定を推奨します。