Introduzione
Introduzione
Lo scopo di questa guida è quello di illustrare la libreria (API) di comunicazione sviluppata per permettere il dropshipping tra wwt ed i suoi partner.
Overview
- Le API utilizzano il protocollo https come canale trasmissivo e Json come linguaggio. Questa scelta garantisce sicurezza e la necessaria compatibilità con terminali ed architetture anche molto eterogenee tra loro. Il protocollo attualmente prevede chiamate al webservices (di seguito WS) con il metodo POST e l'invio dei dati dal campo con il tag name = “data”.
- Il WS di test è disponibile all'indirizzo https://dev.dropshippingb2b.com/api/ ed utilizza come livello di trasporto sicuro il protocollo TLS1.2
- Il WS elabora la richiesta e fornisce sempre una risposta, sia essa positiva o negativa.
- Sia nel messaggio di andata che in quello di ritorno ci sono dei campi fissi.
- Per la parte di richiesta, abbiamo i dati di autenticazione. Vedere sezione Login,
- Per la parte di risposta troviamo le indicazioni sull'esito della richiesta con i suoi eventuali errori.
La risposta contiene sempre tre campi
{
"success" : true|false,
"rc" : INT - "0": success; "minore di 0" error; "1": messaggio di testo arbitrario.
"message" : "Il messaggio è presente sono se rc != 0"
}
Nelle richieste MultiItems questi tre campi informano il client se tutte le richieste sono andate a buon fine o meno.
Se un campo obbligatorio viene omesso si riceve sempre il seguente errore.
{
"success" : false,
"rc" : 6
"message" : "The field {0} is mandatory"
}
Il WS restituisce un errore “404 Not Found The page that you have requested could not be found.”
se la struttura dei dati di richiesta non è corretta.
Prima di poter utilizzare le API è necessario registrarsi nella Pagina di Registrazione ed attendere di essere abilitati.
Created with the Personal Edition of HelpNDoc: Create iPhone web-based documentation