hosting
GET /v1/transfers
List every site transfer this account is a party to.
Autenticación
Envía una clave de API como token de portador. La clave debe tener el permiso sites.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/transfers \
-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
Both directions in one list. `direction` is computed per request from the caller's own organizations — the same row is `outgoing` to one party and `incoming` to the other, so a stored direction would be wrong for one of its two readers. `org_ids` carries the caller's own organization ids. That is the value a customer gives to somebody who is transferring them a site: transfers are addressed by organization id rather than by email address, because resolving a recipient by email would turn the offer form into a way to discover whether an address has an account with us and whether it is in arrears. Requires `sites.view`.
Respuesta
| Nombre | Tipo | Obligatorio | ¿Qué es esto? |
|---|---|---|---|
transfers | SiteTransfer[] | Sí | — |
org_ids | Uuid[] | Sí | The caller's own organization ids — what they give to somebody transferring them a site. See `SiteTransferProposal.target_org_id` for why transfers are addressed this way. |
Errores que este endpoint puede devolver
401 · 403 · 429