La documentazione della tua API ordini non era mai stata così sicura.
Benvenuto in The Order Vault. Un caveau scuro e cinematico dove ogni richiesta è un’operazione autorizzata e ogni risposta un dato che non si muove più. Non è una guida: è una cassaforte.
Una chiave. Una volta. Niente rumore.
Autenticazione tramite API key nell'header X-Order-Vault-Key. La tua identità è la serratura. Nessun token ballerino, nessuna sessione. Solo un controllo binario: dentro o fuori.
- ✓ API key statica, generata per ogni integrazione
- ✓ Passa nell’header di ogni richiesta
- ✓ Niente refresh, niente OAuth – solo silenzio elettronico
POST /orders – Crea e sigilla.
Invia un ordine e lo blocchi nel caveau. Risposta immediata, ID univoco, nessuna sorpresa.
curl -X POST https://api.ordra.io/v1/orders \
-H "X-Order-Vault-Key: {key}" \
-H "Content-Type: application/json" \
-d '{
"customer": "azienda_123",
"items": [{"sku": "VAULT-001", "qty": 10}],
"note": "Consegna urgente"
}'
{
"id": "ord-2025-03ab",
"status": "archived",
"timestamp": "2025-03-21T10:30:00Z",
"items_count": 1,
"vault_ref": "VAULT-001"
}
| Campo | Obbligatorio |
|---|---|
| customer | ✓ |
| items[].sku | ✓ |
| items[].qty | ✓ |
| note | ✗ |
| coupon | ✗ |
GET /orders/{id} – Apri un cassetto.
Leggi un singolo ordine. Se non esiste, il caveau non ti risponde. Silenzio assoluto.
curl https://api.ordra.io/v1/orders/ord-2024-001 \
-H "X-Order-Vault-Key: {key}"
{
"id": "ord-2024-001",
"status": "archived",
"items": [{"sku":"VAULT-001","qty":5}],
"created_at": "2025-03-20T08:12:00Z"
}
| Errore | Significato |
|---|---|
| 401 | Chiave non valida |
| 404 | Ordine inesistente |
| 500 | Errore interno |
GET /orders – Sfoglia il vault.
Elenco paginato con filtri. Parametri: page, limit (default 25), status, date_from. Ogni pagina è un reparto del caveau.
curl "https://api.ordra.io/v1/orders?page=2&limit=10&status=shipped" \
-H "X-Order-Vault-Key: {key}"
{
"data": [ { "id":"ord-1","status":"shipped" }, ... ],
"pagination": { "page": 2, "total_pages": 5 }
}
| Parametro | Default |
|---|---|
| page | 1 |
| limit | 25 |
| status | — |
| date_from | — |
Codici di errore: il linguaggio del silenzio.
Ogni errore è un messaggio. Impara a leggerli.
Pronto a blindare i tuoi ordini?
Richiedi la tua API key. Inizia a operare in sicurezza. Nessun rumore, solo risultati.