La variable Edge Network Server API gère à la fois la collecte de données authentifiées et non authentifiées, en fonction de la source des événements et du domaine de collecte de l’API.
Pour chaque requête, la variable Server API vérifie le flux de données access type . Grâce à ce paramètre, les clients peuvent configurer un flux de données pour accepter les données authentifiées ou les données authentifiées et non authentifiées. Par défaut, les deux types de données sont acceptés.
Pour plus d’informations sur la configuration du type d’accès au flux de données, consultez la documentation sur la manière de créer et configurer un flux de données.
Vous trouverez ci-dessous un résumé du comportement, basé sur le flux de données Access Type configuration et le point de terminaison sur lequel la requête est reçue.
Access Type | edge.adobedc.net | server.adobedc.net |
---|---|---|
mixte (par défaut) | N’authentifie pas la requête | Authentifie la requête |
authentifié | Authentifie la requête | Authentifie la requête |
Appels API provenant d’un serveur privé sur server.adobedc.net
doit toujours être authentifié.
Avant d’effectuer des appels à la fonction Server API, assurez-vous de respecter les conditions préalables suivantes :
developer
et user
rôles activés pour le profil de produit de l’API Adobe Experience Platform. Contactez votre Admin Console pour activer ces rôles pour votre compte.Pour lancer des appels aux API Platform, vous devez d’abord suivre le tutoriel sur l’authentification. Le tutoriel sur l’authentification indique les valeurs de chacun des en-têtes requis dans tous les appels API Experience Platform, comme illustré ci-dessous :
{ACCESS_TOKEN}
{API_KEY}
{ORG_ID}
Les ressources d’Experience Platform peuvent être isolées dans des sandbox virtuels spécifiques. Dans les requêtes aux API Platform, vous pouvez spécifier le nom et l’identifiant du sandbox dans lequel l’opération aura lieu. Il s’agit de paramètres facultatifs.
{SANDBOX_NAME}
Pour plus d’informations sur les sandbox dans Experience Platform, consultez la documentation de présentation des sandbox.
Toutes les requêtes qui contiennent un payload (POST, PUT, PATCH) nécessitent un en-tête de type de média supplémentaire :
application/json
Pour configurer les autorisations d’écriture de jeux de données, accédez au Admin Console, recherchez le profil de produit associé à votre clé API, puis définissez les autorisations suivantes :
Code d’erreur | Message d’erreur | Description |
---|---|---|
EXEG-0500-401 |
Jeton d’autorisation non valide | Ce message d'erreur s'affiche dans l'une des situations suivantes :
|
EXEG-0501-401 |
Jeton d’autorisation d’utilisateur non valide | Ce message d'erreur s'affiche dans l'une des situations suivantes :
|
EXEG-0502-401 |
Jeton d’autorisation non valide | Ce message d’erreur s’affiche lorsque le jeton d’autorisation fourni a un format valide (JWT), mais que sa signature n’est pas valide. Vérifiez les tutoriel sur l’authentification pour savoir comment obtenir un jeton JWT valide. |
EXEG-0503-401 |
Jeton d’autorisation non valide | Ce message d’erreur s’affiche lorsque le jeton d’autorisation fourni a expiré. Accédez au tutoriel sur l’authentification pour générer un nouveau jeton. |
EXEG-0504-401 |
Le contexte de produit requis est manquant | Ce message d'erreur s'affiche dans l'une des situations suivantes :
|
EXEG-0505-401 |
La portée du jeton d’autorisation requis est manquante | Cette erreur s’applique uniquement à l’authentification du compte de service. Le message d’erreur s’affiche lorsque le jeton d’autorisation de service inclus dans l’appel appartient à un compte de service qui n’a pas accès à la variable acp.foundation Portée IMS. |
EXEG-0506-401 |
Environnement de test non accessible pour l’écriture | Ce message d’erreur s’affiche lorsque le compte de développeur n’a pas WRITE accès à l’environnement de test de l’Experience Platform dans lequel le flux de données est défini. |