Convenzioni

All'interno delle API utilizziamo una serie di convenzioni che aiutano a mantenere un'applicazione più solida e un linguaggio costante. In questa pagina trovi tutte le informazioni a riguardo.

Valute

Per trasmettere i valori economici utilizziamo sempre i centesimi di Euro. Questo significa che se una nostra API restituisce:

amount: 1234

il valore di amount è 12,34 €.

Allo stesso modo, quando dovrai trasmettere dei dati alle nostre API dovrai utilizzare valori espressi in centesimi di €.

Protocolli

Tutte le chiamate API utilizzano il protocollo HTTP/1.1. Ecco un esempio di dialogo con le nostre API:

http --json GET http://api.sandbox.soisy.it/api/shops/{shopId}/loan-quotes\?amount\=50000\&instalments\=6 "X-Auth-token: {X-Auth-Token}"

GET /api/shops/{shopId}/loan-quotes?amount=50000&instalments=6 HTTP/1.1
Accept: application/json, */*
Accept-Encoding: gzip, deflate
Connection: keep-alive
Content-Type: application/json
Host: api.sandbox.soisy.it
X-Auth-token: {X-Auth-Token}