marketplace
POST /v1/marketplace/listings/{listing_id}/enquiries
Ask a seller a question before buying.
Autenticación
Envía una clave de API como token de portador. Este endpoint no especifica un permiso concreto en la especificación, así que otorga a tu clave los mínimos privilegios necesarios y comprueba la respuesta en lugar de dar por sentado.
Donde va el ID de tu organización
Este endpoint acepta org_id como parámetro de consulta. Omítelo y la llamada abarcará todo tu subárbol de inquilinos; envíalo para acotar la llamada a una sola organización.
El id de tu organización se encuentra en la pantalla de claves de API en tu panel de control, junto a la propia clave. Es el mismo id en cada llamada que realices.
Pruébalo
Reemplaza cualquier elemento entre corchetes angulares por tus propios valores, y el marcador de posición key con una clave de tu panel de control.
curl -X POST https://api.zinndigital.com/v1/marketplace/listings/{listing_id}/enquiries \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "body": <string> }'¿Has iniciado sesión? La consola de la API en tu panel de control rellena el ID de tu organización real y tu propia clave, y ejecuta la solicitud contra la API en vivo para que puedas ver la respuesta real. Abre este endpoint en la consola de la API
Detalles
docs/133 D26. **Attachments are refused here entirely**: an attachment bypasses text scanning, we have no OCR, and on the one surface where nobody has paid there are therefore no files. Saying so is honest; scanning an image we cannot read would not be.
Parámetros
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
listing_id (path) | string | Sí | — |
org_id (query) | string | No | Which of your organizations the enquiry is from. Optional when you belong to exactly one; **required (422) when you belong to more than one**, because the platform will not gues… |
Cuerpo de la solicitud
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
body | string | Sí | — |
locale | string | No | — |
attachments | object[] | No | 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. |
Respuesta
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
id | string | Sí | — |
body | string | Sí | 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, becaus… |
mine | boolean | Sí | — |
from_staff | boolean | No | — |
source_locale | string | No | 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 | No | — |
policy_notice | string | No | 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 | No | Only on the send response. The one case where reporting "sent" would be a lie. |
created_at | string | Sí | — |
Errores que este endpoint puede devolver
401 · 404 · 422