Autenticación
Envía una clave de API como token de portador. La clave debe tener el permiso tickets.view; una clave que no lo tenga se rechazará con un código 403, no 404.
Este endpoint no requiere ningún id de organización. Su clave ya identifica la organización a la que pertenece, y la respuesta está delimitada a ella.
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 GET https://api.zinndigital.com/v1/tickets/{ticketId} \
-H "Authorization: Bearer zdk_live_…"¿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
One ticket in scope with its full message thread in chronological order. Staff-internal notes are **not** included — they are excluded by the query and never reach this surface. Requires `tickets.view`.
Parámetros
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
ticketId (path) | Uuid | Sí | The ticket's id. |
Respuesta
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
id | Uuid | Sí | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
org_id | Uuid | Sí | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
subject | string | Sí | — |
status | TicketStatus | Sí | Where a ticket sits in its lifecycle. `open` = waiting on us; `pending` = waiting on the customer; `solved` = we believe it is resolved and a customer reply reopens it; `closed`… |
priority | TicketPriority | Sí | How urgent the ticket is. The customer may propose one; staff decide. |
channel | string | Sí | How the ticket reached us — `dashboard`, `api` or `staff`. Server-decided; an open string so a future channel is additive on both sides. |
site_id | object | No | — |
invoice_id | object | No | — |
on_behalf_of_org_id | object | No | The **client org** a reseller opened this ticket about. Null on every ordinary ticket. ⛔ Validated as a descendant of the ticket's own org and `404`d otherwise, so it can never… |
assignee_name | object | Sí | The owning agent's display name (first name), or null while unassigned. The customer sees a **name** so they know a person owns their ticket; the agent's id and email are staff-… |
first_response_at | object | No | — |
resolved_at | object | No | — |
closed_at | object | No | — |
last_message_at | object | No | — |
reopened_count | integer | Sí | — |
message_count | integer | Sí | Customer-visible messages in the thread — internal notes are not counted. |
created_at | string | Sí | — |
updated_at | string | Sí | — |
messages | TicketMessage[] | Sí | The customer-visible thread in chronological order. |
Errores que este endpoint puede devolver
401 · 403 · 404 · 429