本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>ニフクラAPI>ESS>共通リクエスト・レスポンス
本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/ess/api/request.htmへ移行しました。 今後は新ページをご参照ください。

ESS:共通リクエスト・レスポンス

概要

ESS APIを使用する際の共通リクエストパラメーター、レスポンスを説明します。

リクエストパラメーター

要素名 説明 形式 シグネチャーバージョンごとの必須対応
4(ヘッダー) 4(パラメーター)
Content-Type application/x-www-form-urlencoded を指定 ヘッダー    
Timestamp APIへのリクエスト日時
形式 : YYYY-MM-DDThh:mm:ssZ
パラメーター    
Date リクエスト日時、シグネチャー算出に使用 ヘッダー    
X-Nifty-Date | X-Amz-Date リクエスト日時、シグネチャー算出に使用 ヘッダー
パラメーター
Authorization 算出されたシグネチャーから生成した認証文字列 ヘッダー  
X-Nifty-Algorithm | X-Amz-Algorithm シグネチャーの暗号方式
指定可能な値 : AWS4-HMAC-SHA256 | NIFTY4-HMAC-SHA256
パラメーター  
X-Nifty-Credential | X-Amz-Credential アクセスキーID/日付/
リージョン名/サービス名/固定文字の順
パラメーター  
X-Nifty-Signature | X-Amz-Signature リクエスト時の認証用文字列 パラメーター  
X-Nifty-SignedHeaders | X-Amz-SignedHeaders 認証用文字列作成時に利用されたヘッダー名のリスト(;区切り) パラメーター  
  • ※注1シグネチャーの生成については「API:シグネチャー」をご参照ください。
  • ※注2「X-Nifty-Date」または「X-Amz-Date」と Dateヘッダーが指定された場合、Dateヘッダーが無視されます。
  • ※注3「X-Nifty-xxx」系、「X-Amz-xxx」系はどちらかに統一して指定する必要があります。
  • ※注4パラメーターの値は、ASCII英数字と * - . _ はそのまま、空白文字は + 、それ以外の文字は %XX の形式にURLエンコードを行ってください

レスポンス

要素名 説明 備考
ResponseMetadata 共通メタ情報ルート  
RequestId リクエストID  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

推奨画面サイズ 1024×768 以上