Soumissionnaires - Service utilisateur

Ici, « utilisateur » fait référence à des personnes ou des groupes utilisant les API de Xandr. Le service utilisateur vous permet de gérer qui a accès aux API de Xandr. Les utilisateurs sont classés comme étant de type d’utilisateur offrant ou membre.

• Les utilisateurs soumissionnaires peuvent être créés par d’autres utilisateurs soumissionnaires.
• Un soumissionnaire-utilisateur peut créer et mettre à jour des utilisateurs-membres, ainsi que mettre à jour ses propres informations utilisateur.
• Un membre-utilisateur peut mettre à jour ses propres informations utilisateur.
• Chaque nouveau nom d’utilisateur associé à un soumissionnaire particulier doit être unique.

API REST

Pour supprimer un utilisateur existant :
SUPPRIMER https://api.adnxs.com/user/USER_ID

Structure JSON

Exemples

Jeton d’authentification

L’authentification est toujours la première étape lors de l’utilisation des services d’API. Le jeton d’authentification peut ensuite être écrit dans notre fichier de cookie pour une utilisation ultérieure. Pour obtenir des instructions plus détaillées, consultez Service d’authentification .

Create un fichier texte de profil utilisateur

Pour accorder à l’API l’accès à « TestUser », vous allez créer un fichier texte au format JSON avec le nom d’utilisateur et le mot de passe de l’utilisateur, ainsi que l’ID d’un membre ou d’un soumissionnaire auquel appartient cet utilisateur. Ci-dessous, nous avons utilisé la commande « cat » pour générer un exemple de fichier JSON utilisateur.

$ cat user
{
   "user":{
      "username":"TestUser",
      "password":"2323test",
      "entity_id":7,
          "email": "user1@examplecompany.com",
          "user_type": "bidder"
   }
}

Instructions pour la création de votre mot de passe

Lorsque vous créez votre mot de passe, créez un mot de passe complexe avec les éléments suivants :

• 10 caractères ou plus
• 64 caractères ou moins
• Au moins une lettre majuscule (A–Z)
• Au moins une lettre minuscule (a–z)
• Au moins un chiffre (0-9)
• Au moins un caractère spécial (par exemple, #, $, ? %, &)

Ajouter un nouvel utilisateur au cache Imp Bus

Nous allons maintenant entrer le fichier utilisateur. Nous avons utilisé des cookies pour nous authentifier.

$ curl -b cookies -c cookies -X POST --data-binary @user https://api.adnxs.com/user
{
   "response":{
      "status":"OK",
      "id":59
   }
}

Récupérer les informations utilisateur du cache Imp Bus

Grâce à la sortie de la commande ci-dessus, nous savons que l’utilisateur que nous venons d’ajouter s’est vu attribuer l’ID #59 par l’Imp Bus. Nous pouvons utiliser cet ID pour afficher des informations sur cet utilisateur particulier. Pour voir tous les utilisateurs que nous avons créés, nous allons laisser l’ID utilisateur.

$ curl -b cookies -c cookies https://api.adnxs.com/user/59
{
  "response": {
    "status": "OK",
    "count": 1,
    "start_element": null,
    "num_elements": null,
    "user": {
      "id": 59,
      "active": true,
      "first_name": null,
      "last_name": null,
      "phone": null,
      "username": "TestUser",
      "email": "user1@examplecompany.com",
      "user_type": "bidder",
      "read_only": false,
      "api_login": false,
      "entity_id": 7,
      "publisher_id": null,
      "advertiser_id": null,
      "custom_data": null,
      "send_safety_budget_notifications": false,
      "entity_name": "Platform Services Test Bidder",
      "timezone": null,
      "entity_reporting_decimal_type": null,
      "reporting_decimal_type": null,
      "decimal_mark": "period",
      "thousand_separator": "comma",
      "last_modified": "2017-02-16 19:06:47",
      "is_developer": false,
      "role_id": null,
      "languages": null,
      "advertiser_access": null,
      "publisher_access": null
    },
    "dbg": {
                ...
    }
  }
}

Demander l’accès à l’API

Notez dans le code retourné au-dessus du champ api_login . Ce champ ne peut être modifié que par un administrateur Xandr. La dernière étape pour accorder à un utilisateur l’accès à l’API consiste à contacter le support client et à demander que l’indicateur api_login pour l’utilisateur soit défini sur true. Veillez à inclure un nom d’utilisateur ou un ID dans la demande.

Rubrique connexe

Services d’API