Authentifizierung
Senden Sie einen API-Schlüssel als Bearer-Token. Der Schlüssel muss über die Berechtigung sites.view verfügen; ein Schlüssel ohne diese wird mit 403 statt 404 abgelehnt.
Dieser Endpunkt erfordert keine Organisations-ID. Ihr Schlüssel identifiziert bereits die zugehörige Organisation, und die Antwort ist entsprechend eingeschränkt.
Ausprobieren
Ersetzen Sie alles in spitzen Klammern durch Ihre eigenen Werte und den Platzhalter für den Schlüssel durch einen Schlüssel aus Ihrem Dashboard.
curl -X GET https://api.zinndigital.com/v1/transfers \
-H "Authorization: Bearer zdk_live_…"Angemeldet? Die API-Konsole in Ihrem Dashboard trägt automatisch Ihre echte Organisations-ID sowie Ihren eigenen Schlüssel ein und führt die Anfrage gegen die Live-API aus, sodass Sie die tatsächliche Antwort sehen können. Öffnen Sie diesen Endpunkt in der API-Konsole
Details
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`.
Antwort
| Name | Typ | Erforderlich | Was es ist |
|---|---|---|---|
transfers | SiteTransfer[] | Ja | — |
org_ids | Uuid[] | Ja | 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. |
Fehler, die dieser Endpunkt zurückgeben kann
401 · 403 · 429