一般クーポンの使用照会
    • PDF

    一般クーポンの使用照会

    • PDF

    記事の要約

    当該コンテンツは、ローカリゼーションサービスを準備しております。早急にローカライズサービスをご提供できるよう、努めております。

    一般クーポンの使用履歴を照会します。
    キーワードクーポン使用履歴は照会されません。

    要請

    GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/coupon/{couponNumber}
    
    項目タイプ必須かどうか説明備考
    projectIdStringOGamePot SDKの projectId
    couponNumberStringOダッシュボードで発行されたクーポン番号

    要請 Header

    Header名必須かどうか説明
    x-api-keyOGamePotで発行する認証key
    accept-languageX使用言語

    応答

    フィールド名タイプ説明
    statusInt結果値 (1: 成功)
    idStringクーポン使用履歴ID
    statusBooleanクーポンの使用可否(true: 使用, false: 未使用)
    enableInt使用可否
    numberStringクーポン番号
    userdataStringクーポン使用ユーザー情報
    usedAtStringクーポン使用日
    requestStringクーポン券の使用要請
    responseStringクーポン応答
    (coupon_idの) idStringクーポンID
    (coupon_idの) enableint使用可否
    typeStringクーポン タイプ
    keywordStringキーワード クーポン キーワード
    descStringクーポン名
    usedintクーポンの状態
    countintクーポン数量
    lengthintクーポンの長さ
    limitStringアイテム数量
    prefixStringクーポン接尾辞
    suffixStringクーポン接頭辞
    store_idStringストア アイディ (google,one,apple,galaxy)
    startedAtStringクーポン使用開始日
    endedAtStringクーポン使用終了日
    item_idStringアイテムID
    store_item_idStringアイテム ストア ID
    countintアイテム数量

    例示

    要請例

    
    curl --request GET \
      --url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/coupon/xxxxxx  \
      --header 'accept-language: ko' \
      --header 'x-api-key: 86dcgffae0641745432as02a8801ce5a5475f764fxxxxxxxxx'
    

    応答例

    {
      "status": 1,
      "result": {
        "id": "xxxxxxxxxxxxxxxx",
        "status": false,
        "enable": 1,
        "number": "xxxxxxxxxxxxxxxx",
        "userdata": "",
        "usedAt": null,
        "createdAt": "Wed May 13 2020 12:12:04 GMT+0900 (Korean Standard Time)",
        "request": null,
        "response": null,
        "coupon_id": {
          "id": "xxxxxxxxxxxxxxxx",
          "enable": 1,
          "type": "normal",
          "keyword": null,
          "desc": "시즌2 업데이트 사전예약 보상",
          "used": 1,
          "count": 2010,
          "length": 7,
          "limit": null,
          "prefix": "",
          "suffix": "",
          "store_id": "",
          "startedAt": "Sun May 10 2020 16:35:00 GMT+0900 (Korean Standard Time)",
          "endedAt": "Sat May 23 2020 16:35:00 GMT+0900 (Korean Standard Time)",
          "items": [
            {
              "item_id": "xxxxxxxxxxxxxxxx",
              "store_item_id": "xxxxxxxxxxxxxxxx",
              "count": 10
            },
            {
              "item_id": "xxxxxxxxxxxxxxxx",
              "store_item_id": "xxxxxxxxxxxxxxxx",
              "count": 1
            }
          ]
        }
      }
    }
    

    エラーコード

    Gamepot Open APIリクエスト時に発生する共通エラーコードです。

    parameter説明
    statusエラーコード(1: 成功、失敗時Error code参考)
    messageエラー詳細説明
    エラーコード説明
    -1ダッシュボードにないkeyを使用した場合
    -2ダッシュボードのkeyとheaderのkeyが異なる場合
    -3ダッシュボードで削除したkeyを使用した場合
    -4ダッシュボードで未使用に処理されたkeyを使用した場合
    -5keyが切れた場合
    -6プロジェクトIDがない場合
    {
      "status": -6,
      "message": "projectId was wrong."
    }
    

    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.