marketplace

GET /v1/marketplace/orders/{sale_id}/messages

The order chat.

すべての marketplace エンドポイント

認証

ベアラー トークンとして API キーを送信します。このエンドポイントでは仕様に特定の権限が記載されていないため、キーに必要な最小限の権限を付与し、推測するのではなくレスポンスを確認してください。

このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。

試してみる

アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。

curl -X GET https://api.zinndigital.com/v1/marketplace/orders/{sale_id}/messages \
  -H "Authorization: Bearer zdk_live_…"

ログインしていますか?ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く

詳細

docs/82 §4. A per-order conversation between buyer and seller, and staff on a dispute. Messages are part of the order record and are evidence in a dispute. A held message is excluded from **both** parties, not just the recipient: showing a sender their own held message as if it had been delivered is how someone concludes they are being ignored and leaves for email — the outcome the whole feature exists to avoid. Reading clears the caller's unread count.

パラメータ

名前タイプ必須これがその内容です
sale_id (path)stringはい
cursor (query)stringいいえOpaque cursor from a previous page's `page.next_cursor`.
limit (query)integerいいえMaximum items to return (page size).

返信

名前タイプ必須これがその内容です
dataMarketplaceMessage[]はい
pagePageMetaはい

このエンドポイントが返すエラー

401 · 404