Account GET
Con l'autenticazione dell'API a livello di utente, non è necessario integrare l'autenticazione dell'API per ogni singolo account. È possibile utilizzare "GET accounts" per ottenere un elenco aggiornato di account ed eseguire automaticamente le richieste necessarie per ogni account.
Attenzione: se aggiungete o rimuovete il vostro account utente da un account editore o inserzionista, potrebbero essere necessari fino a 10 minuti prima che la modifica dei diritti di accesso diventi operativa nell'API.
Chi può usarlo
Ogni utente che possiede almeno un account editore o inserzionista. Nota bene: per utilizzare uno degli altri endpoint/metodi per recuperare i dati dell'account, è necessario avere almeno l'accesso come "viewer" dell'account.
Come effetuare la chiamata API
https://api.awin.com/accounts (elenca tutti gli account)
https://api.awin.com/accounts?type=publisher (elenca solo gli account dell'editore)
https://api.awin.com/accounts?type=advertiser (elenca solo gli account dell'inserzionista)
Aggiungere il parametro 'accessToken' per fornire la chiave di accesso come descritto in Come si genera il token di accesso alla Publisher API?
Come appare la risposta
{
" userId": 699645,
" conti": [
{
"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"
},
(...)
Quali campi dati forniamo
| Nome del campo | Descrizione |
|---|
| accountId | ID dell'account, come noto dagli URL del frontend (ad es. https://ui.awin.com/awin/affiliate/111) |
| NomeConto | nome del programma per un inserzionista e nome della società per un editore |
| tipo di conto | può essere un editore o un inserzionista |
| utenteRuolo | il ruolo che l'account utente ha per l'account |