La REST API fornisce l'accesso programmatico ai dati della tua azienda. È destinata agli sviluppatori che creano un'integrazione; non ti serve per l'uso quotidiano.
- Riferimento API: il riferimento completo è pubblico in /docs/api all'indirizzo del tuo spazio di lavoro, con il documento OpenAPI in /docs/api/openapi.yaml e /docs/api/openapi.json. API e webhook nelle Impostazioni vi rimanda.
- URL base: mostrato in cima a API e webhook. Termina con /api/v1.
- Autenticazione: invia l'intestazione Authorization: Bearer seguita dal tuo token, e Accept: application/json.
- Risposte: solo JSON. I singoli record sono racchiusi in data; gli elenchi aggiungono meta e links per la paginazione a cursore (parametri limit e cursor, fino a 100 per pagina).
- Ritentativi sicuri: invia un'intestazione Idempotency-Key nelle richieste POST. Ripetere la stessa richiesta con la stessa chiave restituisce la risposta memorizzata invece di creare un secondo record. Le chiavi vengono conservate per 24 ore.
- Limite di frequenza: 120 richieste al minuto per token. Le intestazioni X-RateLimit-Limit e X-RateLimit-Remaining mostrano a che punto sei; oltre il limite ricevi 429 con un'intestazione Retry-After.
Cosa può fare una richiesta
Una chiamata riesce solo quando il token ha il permesso (ad esempio invoices:write) e l'utente del token ha il permesso corrispondente nell'app. Si applicano le stesse regole di business dello schermo, quindi nemmeno tramite l'API si può modificare una fattura emessa.
Guide correlate
Chiedi informazioni sul prodotto
Chiedi cosa può fare il software, come funziona un'attività, o quali paesi e lingue supporta. Le risposte provengono da queste guide.
Sto pensando…
L'assistente IA non è disponibile al momento. Cerca nelle guide o parla con il nostro team. Contatta l’assistenza
L'IA può commettere errori. Controlla le guide collegate.
Serve ancora aiuto?
Il nostro team di assistenza legge ogni messaggio e risponde in modo chiaro.
Contatta l’assistenza