Documentation des WebAPIs à Cegid Quadra On Demand

Accès :
DOCUMENTATION


Authentification (via API KEY) :

L’authentification du client auprès de la Web Api se fait via un couple code sic/clé fournie par Quadratus. La clé permet de récupérer un TOKEN d’accès de type OAuth nécessaire à la consommation des méthodes de la Web Api. Ce TOKEN devra être passé dans l’entête des requêtes pour pouvoir consommer le service.

La récupération d’un token s’effectue via un POST sur l’URL suivante :
https://www.quadraondemand.com/QuadraODOpenApi/token
Un token est attribué pour une durée de 10h0. Au delà, vous devez demander un nouveau token.

Au niveau du corps du message, vous devez renseigner les paramètres suivants :
client_Id : le clientID transmis par Quadratus
grant_type : le type d’authentification, la web api supporte uniquement client_credentials
client_secret : la clé secrète ou api_key transmise par Quadratus
Identification de l’application appelante et de l’éditeur :
vendor_name : guid (unique à l’éditeur, remis par CEGID pour les éditeurs validés)
application_name : NOM_DE_L_APPLICATION_APPELANTE (par ex DashBoardData)
application_version : numéro de la version de votre application sous n’importe quel format 1.2.0 ou v1.2.0, …


Exemples

Récupération d'un token (c#)

var client = new RestClient(https://www.quadraondemand.com/QuadraODOpenApi/token);
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/x-www-form-urlencoded");
request.AddHeader("cache-control", "no-cache");
request.AddParameter("application/x-www-form-urlencoded", "client_Id=[MON_CLIENT_ID]&grant_type=client_credentials&client_secret=[MON_CLIENT_SECRET]&app_request=[MON_APP_REQUEST]", ParameterType.RequestBody);
request.AddParameter("application/x-www-form-urlencoded", "grant_type=client_credentials&client_id=[MON_CLIENT_ID]&client_secret=[MON_CLIENT_SECRET]&vendor_name=[MON_VENDOR_NAME]&application_name=Postman&application_version=7.2.0", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

Appel methode (c#)

var client = new RestClient(https://www.quadraondemand.com/QuadraODOpenApi/[METHODE]?[PARAMETRE]);
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/x-www-form-urlencoded");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("authorization", "Bearer [AccessToken]");
IRestResponse response = client.Execute(request);