決済売上統計照会

Prev Next

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

要請

GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/purchase/statistics?startDate={startDate}&endDate={endDate}&currency={currency}
項目 タイプ 必須かどうか 説明 備考
projectId String O GamePot SDK의 projectId
startDate String X 決済売上統計検索開始日 YYYY-MM-DD
endDate String X 決済売上統計検索終了日 YYYY-MM-DD
currency String X 決済売上統計通貨検索(all...) ISO 4217の規定に従っています。
参考

Queryで startDate, endDateを入れなければ、最近30日間のデータを照会します。

要請Header

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

応答

필드명 타입 설명
status Int 結果値 (1: 成功)
totalCount Int 検索結果値数
currencyList String 通貨リスト
ISO 4217の規定に従っています。
date String 統計日付
count String 売上統計金額

例示

要請例


curl --request GET \
  --url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/purchase/statistics?startDate=2020-05-01&endDate=2020-06-01&currency=all \
  --header 'accept-language: ko' \
  --header 'x-api-key: 86dcgffae0641745432as02a8801ce5a5475f764fxxxxxxxxx'

応答例

"status": 1,
  "result": {
    "totalCount": 13,
    "currencyList": [
      "KRW",
      "USD"
    ],
    "edges": [
      {
        "node": {
          "date": "2020-05-01",
          "count": 0
        }
      },
      {
        "node": {
          "date": "2020-05-02",
          "count": 0
        }
      },

...

      {
        "node": {
          "date": "2020-05-13",
          "count": 4008857.31
        }
      }
    ]
  }
}

エラーコード

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

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

決済売上統計照会API要請時に発生するエラーコードです。

오류 코드 설명
-11 startDate値のフォーマットが正しくない場合, YYYY-MM-DD 形式のみ可能
-12 endDate 値のフォーマットが正しくない場合, YYYY-MM-DD 形式のみ可能