Segmenti
Visualizza segmento
Restituisce un segmento dell'operazione.
GET
/segments/{id}segments:readCOMPORTAMENTO
La lettura cerca l'identificativo all'interno dell'account legato alla chiave e restituisce 404 quando non appartiene all'operazione.
EFFETTO
Non modifica le risorse né attiva la pubblicazione.
RIPETIZIONE
L'operazione è sicura da ripetere. Su 429 o 5xx, utilizzare il backoff esponenziale con jitter.
Richiesta
idstring · pathIdentificatore della risorsa.minLength 2 · maxLength 100obbligatorioAuthorization
Bearer ach_live_...Accept
application/jsonAmbito
segments:readEsempio eseguibile
curl
curl 'https://achadu.com/api/v1/segments/resource_id' \
-H 'Authorization: Bearer ach_live_...' \
-H 'Accept: application/json'Risposta ed errori
Ogni risposta include request_id. Gli elenchi aggiungono l'impaginazione; le risorse mutabili restituiscono lo stato persistente dopo l'operazione.
200 application/json
{
"data": {
"id": "seg_01J...",
"name": "Home and kitchen",
"slug": "home-and-kitchen",
"distribution": "balanced",
"created_at": "2026-08-31T18:20:00.000Z"
},
"request_id": "req_01J..."
}200Operazione completata.400Parametro, corpo o transizione non validi.401Chiave mancante, non valida, scaduta o revocata.402Il piano dell'account non rilascia questa interfaccia.403A chave precisa do escopo segments:read.404La funzionalità non esiste in questo account.409Lo stato attuale impedisce questa operazione.413Il corpo JSON supera i 128 KB.429La finestra di 120 richieste al minuto è stata superata.