Exigences et recommandations relatives aux API api-requirements-and-recommendations
Éléments à prendre en compte lorsque vos clients utilisent les API d’Audience Manager.
Exigences requirements
Notez ce qui suit lorsque vous utilisez Audience Manager code API :
-
Paramètres de requête : tous les paramètres de requête sont requis, sauf indication contraire.
-
JSONle type de contenu : spécifiez
content-type: application/jsonetaccept: application/jsondans votre code. -
Demandes et réponses : envoyez les demandes sous la forme d’un objet JSON correctement formaté. Audience Manager répond avec des données formatées JSON. Les réponses du serveur peuvent contenir les données demandées, un code d’état, ou les deux.
-
Accès : votre consultant Audience Manager vous fournira un identifiant client et une clé qui vous permettront d’effectuer des demandes de API.
-
Documentation et exemples de code : le texte en italique représente une variable que vous fournissez ou transmettez lors de l’exécution ou de la réception de données API. Remplacez le texte en italique par votre propre code, vos propres paramètres ou d’autres informations requises.
Recommendations : création d’un utilisateur d’API générique recommendations
Nous vous recommandons de créer un compte utilisateur technique distinct pour travailler avec les API Audience Manager. Il s’agit d’un compte générique qui n’est ni lié ni associé à un utilisateur spécifique de l’organisation de votre client. Ce type de compte utilisateur API permet d’accomplir deux choses :
- Identifiez le service qui appelle le API (par exemple, les appels provenant d’une application cliente qui utilise nos API ou qui effectuent des modifications en bloc).
- Assurer un accès ininterrompu aux API. Un compte lié à un employé spécifique peut être supprimé lorsqu’il quitte l’entreprise. Cela empêchera vos clients d’utiliser le code API disponible. Un compte générique qui n’est pas lié à un employé particulier permet d’éviter ce problème.
À titre d’exemple ou de cas d’utilisation pour ce type de compte, supposons que vos clients souhaitent modifier de nombreux segments à la fois à l’aide des outils de gestion en bloc . Pour ce faire, ils ont besoin d’un accès API. Au lieu d’ajouter des autorisations à un utilisateur spécifique, créez un compte utilisateur API non spécifique disposant des informations d’identification, de la clé et du secret appropriés pour effectuer des appels API. Cela s’avère également utile si les clients développent leurs propres applications qui utilisent les Audience Manager API.