POST /v1/accounting/xero/connect

Authentifizierung

Senden Sie einen API-Schlüssel als Bearer-Token. Der Schlüssel muss über die Berechtigung billing.invoice.manage 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 POST https://api.zinndigital.com/v1/accounting/xero/connect \
  -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

Returns the Xero authorization URL to send the customer to. The URL carries a signed, short-lived `state` that names the organization and the actor — the callback has no other authority, because Xero redirects a browser to it with no credential of ours. `409 ACCOUNTING_CONNECTION_REFUSED` means **our** Xero application has no free organization slot, not that the caller did anything wrong. `422 FEATURE_NOT_INCLUDED` means the plan does not include accounting sync and it has not been bought as an add-on. Requires `billing.invoice.manage`.

Antwort

Fehler, die dieser Endpunkt zurückgeben kann

401 · 403 · 409 · 422 · 429