Formato dati response

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

Per 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

CampoDescrizione
ResponseToTipologia di operazione eseguita
TimestampTimestamp della risposta
AckEsito della chiamata (OK / KO)
MessaggioErroreDescrizione dell’errore, valorizzato solo in caso di errore
CodiceErroreCodice identificativo dell’errore
OutputMessaggio di output dell’elaborazione