Le API supportano due formati di risposta:
- JSON (formato predefinito)
- XML
Il formato della response viene determinato in base all’header HTTP Content-Type inviato nella richiesta.
Header Content-Type
Content-TypePer richiedere una risposta in formato JSON (default):
Content-Type: application/json
Per richiedere una risposta in formato XML:
Content-Type: application/xml
Se l’header Content-Type non viene specificato, la risposta verrà restituita automaticamente in formato JSON.
Note
- Tutte le response rispettano la stessa struttura logica, indipendentemente dal formato (JSON o XML)
- I campi restituiti sono coerenti tra response di successo e di errore
Response di Successo (JSON)
{
"ResponseTo": "Stock_Price",
"Timestamp": "1765539057",
"Ack": "OK",
"MessaggioErrore": "",
"CodiceErrore": "0",
"Output": "Operazione completata correttamente"
}
Response di Errore (JSON)
In caso di errore, il campo Ack assume valore KO e vengono valorizzati i campi di errore.
{
"ResponseTo": "Stock_Price",
"Timestamp": "1765470880",
"Ack": "KO",
"MessaggioErrore": "Messaggio di errore",
"CodiceErrore": "CODICE_ERRORE",
"Output": ""
}
Significato dei Campi
| Campo | Descrizione |
|---|---|
| ResponseTo | Tipologia di operazione eseguita |
| Timestamp | Timestamp della risposta |
| Ack | Esito della chiamata (OK / KO) |
| MessaggioErrore | Descrizione dell’errore, valorizzato solo in caso di errore |
| CodiceErrore | Codice identificativo dell’errore |
| Output | Messaggio di output dell’elaborazione |
