Envelope dell'errore
{
"error": {
"code": "asset_not_found",
"message": "No asset with id 42 for this shop",
"status": 404,
"request_id": "req_..."
}
}Includi il request id quando contatti l'assistenza.
Codici di errore comuni
| HTTP | Codice | Significato |
|---|---|---|
| 400 | invalid_request | JSON malformato o campo mancante. |
| 400 | idempotency_key_required | Richiesta di scrittura priva di Idempotency-Key. |
| 401 | unauthorized | Token mancante, non valido, sconosciuto o revocato. |
| 402 | plan_required | L'accesso alle API non è stato attivato per il negozio. |
| 404 | asset_not_found, mapping_not_found, order_not_found, category_not_found, job_not_found | La risorsa non esiste o appartiene a un altro negozio. |
| 409 | idempotency_conflict | La stessa chiave è stata riutilizzata con una richiesta diversa. |
| 409 | stamping_in_progress | Il reinvio è bloccato finché la timbratura del PDF è in sospeso. |
| 409 | delivery_not_yet_released | Il prodotto ha un ritardo di consegna dei download configurato e i file dell'acquirente non sono ancora sbloccati. error.details.release_at è l'istante ISO 8601 dello sblocco; il merchant può rilasciare l'ordine in anticipo con l'endpoint grant-downloads. |
| 422 | storage_quota_exceeded | Il caricamento o l'importazione supererebbe la quota di archiviazione. |
| 422 | key_limit_reached | Il negozio ha già il massimo di 25 chiavi API attive; revocane prima una. |
| 422 | withdrawal_consent_required | Il negozio ha attivato il consenso al diritto di recesso UE e l'ordine non ha ancora un record di consenso; gli URL di download vengono emessi non appena il cliente acconsente. |
| 429 | rate_limited | È stato raggiunto il limite di chiavi API o di reinvii dell'ordine. |
| 500 | internal_error | Errore imprevisto del server. |
Documentazione API
È stato utile?
Ultimo aggiornamento 2026-06-05