Dexyd DevelopersAPI、Webhook、AI アシスタント

コンテスト

主要ステップが進んだ瞬間から追跡します。

参加

新しい提出をより早く把握します。

Expo

商業的な依頼を適切な場所へ届けます。

設定

Webhookの作成とテスト

WebhookはHTTPS URL、選択イベント、Dexydが生成する署名シークレットを結びます。

Console
/developer

Create, test, disable and inspect deliveries.

GET /api/developer/webhooks
List webhooks for the signed-in account.
POST /api/developer/webhooks
Create a destination and receive the full secret once.
PATCH /api/developer/webhooks/{id}
Update the URL, events or status.
DELETE /api/developer/webhooks/{id}
Revoke a destination.
POST /api/developer/webhooks/{id}/test
Send test.ping to the configured URL.
イベント

現在送信されるイベント

不要な処理を避けるため、必要なフローだけを購読してください。

competition.created
A contest is created.
competition.updated
A contest is updated.
submission.created
A submission is received.
submission.updated
A submission changes status or content.
expo_product.created
An Expo product is published or prepared.
expo_product.updated
An Expo product is updated.
expo_product.bid.created
An Expo bid is recorded.
expo_product.inquiry.created
An Expo commercial request is created.
test.ping
Verification event sent from the console.
配信

Payload、署名、検証

Dexydは各POSTに署名し、サーバーが送信元とリプレイを検証できるようにします。

Payload
{
  "id": "delivery_...",
  "event": "submission.created",
  "created_at": "2026-06-11T12:00:00.000Z",
  "data": {
    "competition_id": "...",
    "submission_id": "..."
  }
}
Headers
X-Dexyd-Event: submission.created
X-Dexyd-Delivery: delivery_...
X-Dexyd-Timestamp: 1781179200
X-Dexyd-Signature: t=1781179200,v1=<hmac_sha256>
  • The v1 signature is an HMAC SHA-256 over timestamp.body using the whsec secret.
  • Dexyd waits 8 seconds for your endpoint and records status, HTTP code and a response excerpt.
エラー

宛先側で扱う状態

エンドポイントは速く応答し、署名を検証し、イベントを冪等に処理してください。

2xx
Delivery is marked delivered.
4xx / 5xx
Delivery is marked failed with the response code.
Timeout or network
Delivery is marked failed with the error message.
Lost secret
Create a new destination or rotate from the console.