marketplace

POST `/v1/marketplace/conversations/{conversation_id}/messages`

Reply in a thread, as whichever side of it you are on.

Autentizace

Odešlete klíč API jako bearer token. Tento koncový bod ve specifikaci uvádí specifické oprávnění, takže svému klíči udělte to nejmenší možné a místo předpokladů zkontrolujte odpověď.

Sem patří ID vaší organizace

Tento koncový bod přijímá org_id jako parametr dotazu. Pokud ho vynecháte, volání pokryje celý podstrom vašeho nájemce; jeho odesláním volání zúžíte na jednu organizaci.

ID vaší organizace najdete na obrazovce API klíčů ve vašem přehledu, hned vedle samotného klíče. Je to stále stejné ID v každém volání, které provedete.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

curl -X POST https://api.zinndigital.com/v1/marketplace/conversations/{conversation_id}/messages \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "body": <string> }'

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

docs/147 §5. The same contact policy as every other marketplace message; on a pre-sales thread attachments are refused.

Parametry

Název	Typ	Požadováno	Co to je
`conversation_id (path)`	`string`	Ano	—
`org_id (query)`	`string`	Ne	Which of your organizations is replying. Naming one you do not belong to is 403.

Tělo požadavku

Název	Typ	Požadováno	Co to je
`body`	`string`	Ano	—
`locale`	`string`	Ne	—
`attachments`	`object[]`	Ne	Refused entirely on a pre-sales thread: an attachment bypasses text scanning and we have no OCR, so on the one surface where nobody has paid there are no files.

Odpověď

Název	Typ	Požadováno	Co to je
`id`	`string`	Ano	—
`body`	`string`	Ano	What the reader sees — the masked form where the policy masked it. The original is always kept in the order record and is what a dispute reads; it is not in this payload, because…
`mine`	`boolean`	Ano	—
`from_staff`	`boolean`	Ne	—
`source_locale`	`string`	Ne	BCP-47. Participants write in their own language; a message is translated FOR THE READER and the original is always shown, never replaced.
`masked`	`boolean`	Ne	—
`policy_notice`	`string`	Ne	A message KEY, rendered in every locale by the client. Set only for the SENDER of a masked message — telling the recipient "they tried to give you an email address" would be an…
`held`	`boolean`	Ne	Only on the send response. The one case where reporting "sent" would be a lie.
`created_at`	`string`	Ano	—

Chyby, které může tento koncový bod vrátit

401 · 403 · 404 · 422