Obtenir un client

Obtenir un client #

Obtient un client existant

GET /v1.0/customers/{CUSTOMER_TENANT_ID}

Exemple #

Cette demande permettra d'obtenir le locataire client spécifique.

Demande # 

GET <https://api.na.myreports.cloud/api/v1.0/customers/{CUSTOMER_TENANT_ID}> HTTP/1.1
Autorisation : Porteur {TOKEN}

Réponse # 

HTTP/1.1 200 OK
Type de contenu : application/json; charset=utf-8
Longueur du contenu : xx
{
	« données » : {
			« id » : « {CUSTOMER_TENANT_ID_1} »,
			« name » : « Client 1 »,
			« description » : « Il s'agit du client 1 »,
			« enabled » : true,
			« parentTenantId » : « {ACCOUNT_ID} »,
			« reference » : « référence du client 1 »,
			« dateCreated » : « 2019-01-01T09:00:00.000 »
	},
	« status » : « succès »,
	« timestamp » : « 2019-01-01T10:00:00.2890319Z »
}

Erreurs #

Non autorisé #

Lorsque le jeton n'est pas fourni, invalide ou expiré 

HTTP/1.1 401 Non autorisé

Mauvaise demande #

Lorsque l'identifiant du locataire fourni n'est pas dans le bon format 

HTTP/1.1 400 Mauvaise demande
Date : Thu, 06 Feb 2020 12:45:27 GMT
Type de contenu : application/json; charset=utf-8
Longueur du contenu : 149
{
	« error » : 400,
	« message » : « La valeur '<tenant id>' n'est pas valide.
	« status » : « erreur »,
	« timestamp » : « 2020-02-06T12:45:27.5903465Z »
}

Non trouvé #

Lorsqu'il n'y a pas de clients qui ont un identifiant de locataire correspondant 

HTTP/1.1 404 Introuvable
Date : Thu, 06 Feb 2020 12:46:58 GMT
Type de contenu : application/json; charset=utf-8
Longueur du contenu : 95
{
	« error » : 404,
	« message » : « Introuvable »,
	« status » : « erreur »,
	« timestamp » : « 2020-02-06T12:46:58.7669535Z »
}