GET accounts
L'API s'authentifiant au niveau de l'utilisateur, il n'est pas nécessaire d'intégrer l'authentification de l'API pour chaque compte individuel que vous possédez. Vous pouvez utiliser "GET accounts" pour obtenir une liste actualisée des comptes et effectuer automatiquement les requêtes nécessaires pour chacun d'entre eux.
Veuillez noter que si vous ajoutez ou supprimez votre compte d'utilisateur à un compte d'éditeur ou d'annonceur, il peut s'écouler jusqu'à 10 minutes avant que ce changement de droits d'accès ne prenne effet dans l'API.
Qui peut l’utiliser
Chaque utilisateur qui possède au moins un compte éditeur ou annonceur. Remarque : pour utiliser l'un des autres endpoints/méthodes pour récupérer les données du compte, vous devez avoir au moins un accès " lecteur " au compte.
Comment l’appeler
https://api.awin.com/accounts (répertorie tous les comptes)
https://api.awin.com/accounts?type=publisher (répertorie uniquement les comptes d’éditeur)
https://api.awin.com/accounts?type=advertiser (répertorie uniquement les comptes d’annonceurs)
Ajoutez le paramètre 'accessToken' pour fournir votre clé d’accès comme décrit dans Comment puis-je générer ma clé d'accès à l'API éditeur ?
À quoi ressemble la réponse
{
"userId": 699645,
"accounts": [
{
"accountId": 45628,
"accountName": "Example Publisher",
"accountType": "publisher",
"userRole": "userAdmin"
},
{
"accountId": 57697,
"accountName": "Demo Company Ltd.",
"accountType": "publisher",
"userRole": "userAdmin"
},
{
"accountId": 1001,
"accountName": "Example Advertiser",
"accountType": "advertiser",
"userRole": "userOwner"
},
(…)
Quels champs de données fournissons-nous ?
| Nom du champ | Description |
|---|
| accountId | ID du compte, tel qu’il est connu à partir des URL frontend (par exemple, https://ui.awin.com/awin/affiliate/111) |
| accountName | nom du programme pour un annonceur et nom de la société pour un éditeur |
| accountType | Peut-être éditeur ou annonceur |
| userRole | le rôle de votre compte d’utilisateur pour le compte |