エラーコードおよびその原因、対処法については以下をご参照ください。
※基本⽅針は RFC7807 に準拠します。
400 Bad Request
このエラーが出た場合には、リクエスト内容が誤っていることが想定されますので、申込みサイトにて、エラー内容として表示された項目が正しいことをご確認ください。
HTTP/1.1 400 Bad Request
Content-Type: application/problem+json
Content-Language: en
レスポンス内容例:
{
"type": "https://g4b.giftee.biz/api/probs/bad_request",
"title": "入力に誤りがあります",
"invalid_params": [
{
"name": "gift_card_config_code",
"reason": "は不正な値です"
}
]
}
上記の場合の対処方法については、以下をお試しください。
・該当の案件の「gift_card_config_code」を正しくリクエストしているかご確認ください。
・トークン情報は案件ごとに異なります。トークンとconfig_codeの組み合わせに間違いがないかご確認ください。
その他の表示の場合も、「"invalid_params"」に表示された内容が正しくリクエストされているのかをご確認ください。
401 Unauthorized
このエラーが出た場合には設定されたトークン情報に誤りがあります。
該当案件に表示されたトークン情報が設定されていることをご確認ください。
もしくは、仕様書「6. 認証⽅法」に記載の通りに設定されているかのご確認をお願いします。
HTTP/1.1 401 Unauthorized
Content-Type: application/problem+json
Content-Language: en
レスポンス内容:
{
"type": "https://g4b.giftee.biz/api/probs/unauthorized",
"title": "認証に失敗しました。認証トークンをご確認ください。"
}
403 Forbidden
アクセス権限に制限がかかってる場合に403がレスポンスされます。
申込みサイトより「許可するIPアドレスを追加」をしてください。「テスト案件」へのIPアドレス追加も必須です。
追加手順:
以下のページをご確認いただき、「許可するIPアドレスを追加」をしてください。
5. 「APIトークン」の取得 > 2)「IPアドレス制限」タブより、API利用をされる貴社のIPアドレスを設定します。
ご注意
- 追加済みのIPアドレスが正しいことをご確認ください。
- IPアドレスの設定は「テスト案件」、「お申し込み案件」それぞれへの設定が必要です。
- IPアドレスを設定してるのにforbiddenになる場合
- 設定されているIPアドレスが異なる可能性があります。
- 疎通したい「案件」のIPアドレス制限タブの画面に表示されている内容をご確認ください
404 Not Found
「Endpoint」の設定に誤りがあることが想定されます。正しく設定されているかご確認ください。
HTTP/1.1 404 NotFound
Content-Type: application/problem+json
Content-Language: en
レスポンス内容:
{
"type": "https://g4b.giftee.biz/api/probs/not_found",
"title": "指定したリソースが見つかりません"
}
423 Locked
ご利用限度額を超えたギフト発行の場合に423がレスポンスされます。
エラーレスポンスの内容をそのまま弊社担当までご連絡ください。
レスポンス内容:
{
"type": "https://g4b.giftee.biz/api/probs/locked",
"title": "ご利用限度額に達したため発行できません"
}
500 Internal Server Error
弊社にて確認しますので、エラーレスポンスの内容をそのまま弊社担当までご連絡ください。
HTTP/1.1 500 InternalServerError
Content-Type: application/problem+json
Content-Language: en
レスポンス内容:
{
"type": "https://g4b.giftee.biz/api/probs/internal_server_error",
"title": "サーバーでエラーが発生しました"
}