/v1/offers/accounts、/v1/offers/currency など）と独自のフィールドがあります。販売しているカテゴリとだけ連携すればよく、後からプラットフォームに追加されたカテゴリがあなたの連携に影響することはありません。
これは公開インターフェースです。販売者ダッシュボード固有の画面（出金、紛争、アカウント設定）は含まれず、APIキーからはアクセスできません。
出品はマーケットプレイス上の1つの掲載を指します。APIではこれを offers と呼び、以下でも同様です。
ベースURL
/v1/...。
最初のリクエスト
1
キーを作成する
販売者ダッシュボードの 販売者 → APIキー でキーを作成します。キーは一度しか表示されません。その場でコピーしてください。後から読み出す方法はありません。
2
キーを送信する
キーはすべてのリクエストの
Authorization ヘッダーに含めます。何かと交換する必要はありません。3
カテゴリ固有のフィールドを確認する
カテゴリの作成APIが受け付ける内容は、そのカテゴリ自身のリファレンスページに記載されています。アカウントの出品には価格と画像、通貨の出品には商品と在庫があります。ゲームによって変わるのは このパスはゲームの
attributes で、スキーマエンドポイントがフィールド、型、必須項目を返します。slug を受け付けます。その他のカタログパスでは GET /v1/offers/games が返す id でゲームを指定します。そこでslugを使うと 400 が返ります。カタログの読み取りは公開されているので、キーを取得する前でも試せます。ステータス
新しい出品はdraft です。あなただけのもので、他の人には見えません。publish で active になり、その瞬間から購入者が購入できます。事前の審査はありません。販売できる在庫がない出品を公開しようとすると 409 で拒否されるので、先に在庫を追加してください。編集しても出品のステータスは変わりません。active の出品は公開されたまま、draft は下書きのままです。
unpublish は active の出品を draft に戻します。archived は最終状態です。DELETE は出品を完全に取り下げますが、あなたは引き続き閲覧できます。sold はAPI呼び出しではなく注文によって決まり、最後のユニットが完了した注文に渡った状態です。在庫がすべて進行中の注文に入っている出品は active のままで、注文がキャンセルされると在庫が戻ります。
モデレーションは公開中の出品を changes_requested として差し戻すことがあります。出品はマーケットプレイスから外れ、moderation_reason_code と moderation_note で修正箇所が示されます。次の PATCH で draft になるので、修正後に publish してください。明らかな規約違反でモデレーションが削除した出品は消去され、それに対するすべての呼び出しは 404 を返します。
価格
このAPIの価格はすべて米セント単位の整数です。price: 4990 は49.90ドルです。小数の金額はなく、通貨は USD のみです。
次のステップ
認証
キー、アドレスの許可リスト、レート制限、エラーの意味。
APIリファレンス
すべてのエンドポイントと、実際にリクエストを送れるプレイグラウンド。