再販業者向けWebhook API:販売と価格変更をJSONで取得
Webhook APIは、RestocksAIOの各販売、各オファー、Bricker Modeの各価格変更をJSONとして独自のHTTPSエンドポイントへ送信します。送信するイベントのグループを選べます。
Settingsで設定
「Endpoint URL」にエンドポイントのアドレスを入力し、「Test」をクリックしてください。アプリがテストリクエストを一件送信し、受信結果を表示します。
次に「Enable Webhook API」と、必要なイベントグループ(Sales、Offers、Bricker、Labels)にチェックを入れてください。
アプリ内: Settings › Notifications › Webhook API
すべてのイベントが同じ形式
各リクエストは四つのフィールド(event、timestampUtc、data、meta)を含むHTTPS POSTです。eventフィールドはイベント名を示し、dataにはイベントの情報が含まれます。
販売イベントには販売ID、商品、スタイルコード、マーケットプレイス、サイズ、手取り額が含まれます。価格変更イベントにはタスク、マーケットプレイス、変更前の価格、変更後の価格、理由が含まれます。
販売者が構築できる仕組み
ペアが別の場所で売れたときに、DepopなどRestocksAIOが対応していないマーケットプレイスの出品を終了できます。ご自身のコードでsale.detectedを受信し、出品を終了します。
販売ごとに表計算シート、データベース、会計ツールへ記録できます。Bricker Modeが価格を変更したときに、チームへメッセージを送信できます。
イベントと詳細情報
- sale.detected
- 新しい販売、またはステータスが変わった販売。
- offer.detected
- 出品へのオファーと金額、手取り額、承認した場合の利益。
- bricker.price_change
- Bricker Modeが価格を引き上げた、または引き下げたことを示します。
- bricker.item_sold
- Bricker Modeタスクがあるペアの販売と、価格および手数料差し引き後の手取り額。
- bricker.item_deleted
- アプリが出品の削除を試みた結果と、成功または失敗の状況。
- 配信
- 同じイベントが複数回届く場合があります。販売IDまたはタスクIDを使って、一度だけ処理してください。
- アプリ起動中
- アプリの起動中にイベントを送信します。
- プラン
- Premium。
よくある質問
RestocksAIOが対応していないマーケットプレイスにも接続できますか?
はい。ご自身のコードを使って接続できます。対応マーケットプレイスでペアが売れると、RestocksAIOはsale.detectedをエンドポイントに送信します。コード側でDepopなどの出品を終了してください。eBay、Shopify、Vinted、Wallapopにはコードは不要です。アプリから直接出品できます。
どのイベントを受信できますか?
五種類です。sale.detected、offer.detected、bricker.price_change、bricker.item_sold、bricker.item_deletedです。SettingsでSales、Offers、Bricker、Labelsのグループごとに有効にします。
Webhook APIはDiscord通知と同じですか?
いいえ。DiscordとTelegramの通知はご自身で読むメッセージで、すべてのプランに含まれています。Webhook APIはご自身のソフトウェアが読み取るJSONを送信し、Premiumに含まれています。
Webhook APIを利用できるプランはどれですか?
Premiumです。イベントの多くを発生させるBricker ModeとOffer SniperもPremiumに含まれています。
関連項目
エンドポイントにテストイベントを一件送信
Premiumのトライアルを開始し、エンドポイントURLを入力して「Test」をクリックしてください。