はじめに

FANSHIP Coupon Management APIについて

FANSHIP Coupon Management API は、有償オプション機能となり、ご利用には、別途お申込みが必要です。
営業担当・もしくはサポートまでお問い合わせください。


FANSHIP Coupon Management API ご利用にあたっての注意事項

以下内容をご一読ください。

利用制限について

同時アクセス数は1を上限とします。
過剰なアクセスだと判断した場合は、リクエストをエラーにします。

User-Agentへの情報追加のお願い

ご利用状況のお問い合わせをいただいた際、ログの特定を迅速におこなうため、User-Agentヘッダの追加をお願いいたします。
例)

GET /api/v1/users/sid/dtype/uid/coupons/ HTTP/1.1
Host: ${COUPON_HOST}
User-Agent: MyPortalApp-recommend-PUSH/1.2 (Linux 4.9.30; Python-requests 2.1.12) iRidge,inc

互換性

本 API は、新機能追加などのため予告なく変更される場合があります。
予告なく変更される可能性がある機能は以下の通りです。
本 API をご利用の際は、以下の変更があることを前提としてご利用ください。

互換性の基本方針

これまで許容されていたリクエストは、変更があっても許容され続けます(ただし、文書化されていない項目・機能を利用していないこと)。
一方、これまで許容していなかったリクエストが許容される場合があります。

API リクエスト(リクエストボディ、リクエストヘッダーの両方)

  • 指定が必須ではない項目が新たに追加されることがあります。
  • バリデーションルールの制約が緩和されることがあります。
  • 新規項目が追加される際、既存項目のバリデーションルールに追加制約が発生する可能性があります。ただし、その追加制約は、変更前に許容されていたリクエストには影響を与えないものに限ります。
    • (例) 新規に coupon_type という任意項目を追加し、coupon_type=sample を指定した場合、is_open を指定してはならない。
  • 条件付き必須項目が追加されることがあります。ただし、必須となる条件は、変更前に許容されていたリクエストには影響を与えないものに限ります。
    • (例) coupon_type に spot という文字列の指定を新規に許可する(バリデーションルールの制約緩和)。
      また、新規に location という条件付必須項目を追加。location は、coupon_type を spot にした場合は、必須となる。
  • 文書化されていない項目、およびその機能は、削除または変更されることがあります。

API レスポンス(レスポンスボディ、レスポンスヘッダーの両方)

  • レスポンス項目が新たに追加されることがございます。
  • リクエスト値に応じて表示有無が変わる項目について、その項目の表示条件が緩和されることがあります。
    • (例) 変更前は、coupon_type 項目を sample 以外にした場合のみ、additional_items 項目を返していたが、coupon_type に sample を指定した場合にも、additional_items 項目が返されるようになる。
  • リクエストパラメータの新規追加、およびバリデーションの制約緩和などにより、新規リクエストパターンが許容されるようになった場合、そのパターンに対するレスポンスは、それまでのレスポンスフォーマットに沿わない可能性があります。
    • (例) リクエストパラメータに response_type を追加し、xml を指定した場合、json ではなく、xml が返されるようになる。
  • 失敗するリクエストのエラーレスポンスコード( HTTP ステータスコードではなく、レスポンスボディに含まれるエラーコード)は変更される可能性があります。
  • 文書化されていない項目、およびその機能は、削除または変更されることがあります。

互換性のあるアップデートにより、影響が出てしまう例

  • 文書化されていない項目をリクエストパラメータに指定していると、期待するレスポンスにならない可能性があります。
  • リクエストパラメータのキーが動的に決まるプログラムにしている場合、文書化されていないキーを指定してしまう可能性があり、結果、期待するレスポンスにならない可能性があります。
  • リクエストURLには、末尾に/がつきます。末尾に/がつかない場合の動作は変更される可能性があります。
  • エラーレスポンスコードは変更される可能性があるため、エラーレスポンスコードにより、後続処理を分岐している場合、後続処理が変わる可能性があります。