DocsAutenticazione
Scopri come autenticarti con l'API Cost+
Tutta la comunicazione con l'API Cost+ richiede TLS 1.2 o superiore e Autenticazione Base HTTP.
Come Funziona l'Autenticazione Base
Autenticati utilizzando la tua chiave API come nome utente con una password vuota. Codifica in Base64 la stringa \{api_key\}: (nota i due punti finali — la password è vuota).
L'header Authorization risultante appare così:
Authorization: Basic aHVudGVyMjo=Non esporre mai la tua chiave API nel codice lato client o nei repository pubblici. Mantienila esclusivamente lato server.
Utilizzo di cURL
Metodo predefinito (consigliato)
cURL supporta nativamente l'Autenticazione Base con il flag -u. Passa la tua chiave API seguita da due punti:
curl -u YOUR_API_KEY: https://api.costplus.online/v1/orders/Codifica Base64 manuale
Se preferisci costruire l'header manualmente, prima codifica la chiave:
echo -n "YOUR_API_KEY:" | base64Poi passa il valore codificato nell'header Authorization:
curl -H "Authorization: Basic YOUR_BASE64_ENCODED_KEY" https://api.costplus.online/v1/orders/I due punti finali dopo la chiave API sono obbligatori — separano il nome utente dalla password (vuota) nello schema di Autenticazione Base.
Codici di Stato HTTP
L'API utilizza codici di stato HTTP standard per indicare il risultato di una richiesta.
| Codice di Stato | Significato | Descrizione |
|---|---|---|
| 200 | OK | Richiesta riuscita. |
| 201 | Creato | La risorsa è stata creata con successo. |
| 400 | Richiesta Non Valida | La richiesta era malformata o mancava di campi obbligatori. |
| 401 | Non Autorizzato | Autenticazione fallita — verifica la tua chiave API. |
| 403 | Vietato | Non hai i permessi per accedere a questa risorsa. |
| 404 | Non Trovato | La risorsa richiesta non esiste. |
| 500 | Errore Interno del Server | Si è verificato un problema da parte nostra. |
| 502 | Bad Gateway | Errore del servizio a monte. |
| 503 | Servizio Non Disponibile | L'API è temporaneamente non disponibile. |
| 504 | Gateway Timeout | Il servizio a monte non ha risposto in tempo. |