GET Contas
Com a autenticação da API em nível de usuário, você não precisa integrar a autenticação da API para cada conta individual que você tem. Você pode usar o "GET accounts" para obter uma lista atualizada de contas e fazer automaticamente as solicitações necessárias para cada conta que você tem.
Esteja ciente que se você adicionar ou remover sua conta de usuário de ou para uma conta de afiliado ou anunciante, pode levar até 10 minutos até que esta mudança nos direitos de acesso entre em vigor na API.
Quem pode utilizá-la
Todo usuário que tenha pelo menos uma conta de afiliado ou anunciante. Observação: para usar um dos outros pontos de extremidade/métodos para recuperar dados de conta, você precisa ter pelo menos acesso de visualizador à conta.
Como chamá-la
https://api.awin.com/accounts (lista todas as contas)
https://api.awin.com/accounts?type=publisher (só lista as contas dos editores)
https://api.awin.com/accounts?type=advertiser (só lista as contas dos anunciantes)
Adicione o parâmetro 'accessToken' para fornecer sua chave de acesso, conforme descrito em Como posso gerar meu token de acesso API de Publisher?
Como é a resposta
{
"userId": 699645,
"contas": [
{
"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"
},
(...)
Quais os campos de dados que fornecemos
| Nome do campo | Descrição |
|---|
| accountId | ID da conta, como conhecido dos URLs de frontend (por exemplo, https://ui.awin.com/awin/affiliate/111) |
| accountName | nome do programa para um anunciante e nome da empresa para um afiliado |
| accountType | pode ser afiliado ou anunciante |
| userRole | o papel que sua conta de usuário tem para a conta |
