Ce document fournit des réponses aux questions fréquentes sur Adobe Experience Platform, ainsi qu’un guide de dépannage de haut niveau pour les erreurs courantes qui peuvent se produire dans n’importe quelle Experience Platform API. Pour obtenir des guides de dépannage sur un individu Platform services, voir répertoire de dépannage des services ci-dessous.
Vous trouverez ci-dessous une liste de réponses aux questions les plus fréquemment posées à propos d’Adobe Experience Platform.
Experience Platform propose plusieurs API RESTful qui utilisent des requêtes HTTP pour accéder à Platform ressources. Ces API de service présentent chacune plusieurs points de terminaison et vous permettent d’effectuer des opérations ayant pour but de répertorier (GET), de rechercher (GET), de modifier (PUT et/ou PATCH) et de supprimer (DELETE) des ressources. Pour plus d’informations sur les points de terminaison spécifiques et sur les opérations disponibles pour chaque service, consultez la documentation de référence sur l’API sur Adobe I/O.
Les formats de requête varient en fonction des Platform API en cours d’utilisation. La meilleure façon d’apprendre à structurer vos appels d’API est de suivre les exemples fournis dans la documentation de la Platform le service que vous utilisez.
Pour plus d’informations sur le formatage des requêtes d’API, consultez le guide de prise en main de l’API Platform . lecture d’exemples d’appels API .
Une organisation IMS est une représentation Adobe d’un client. Toutes les solutions Adobe sous licence intègrent cette organisation client. Lorsqu’une organisation IMS a droit à Experience Platform, il peut attribuer un accès aux développeurs. L’identifiant d’organisation IMS (x-gw-ims-org-id
) représente l’organisation pour laquelle un appel API devrait être exécuté. Il est donc nécessaire de le place en tant qu’en-tête de toutes les requêtes API. Cet identifiant est accessible par le biais du Console Adobe Developer: dans le Intégrations , accédez à la Présentation pour toute intégration particulière afin de trouver l’identifiant sous Informations d’identification client. Pour une présentation détaillée de la procédure d’authentification dans Platform, reportez-vous à la section tutoriel sur l’authentification.
Une clé API doit constituer l’en-tête de toutes les requêtes API. Elle se trouve via le Console Adobe Developer. Dans la console, sous l’onglet Intégrations, accédez à la section Aperçu pour une intégration spécifique et vous trouverez la clé sous Informations d’identification client. Pour une présentation détaillée de la procédure d’authentification vers Platform, reportez-vous à la section tutoriel sur l’authentification.
Les jetons d’accès doivent être renseignés dans l’en-tête d’autorisation de tous les appels API. Ils peuvent être générés à l’aide d’une commande curl
, à condition que vous ayez accès à une intégration pour une organisation IMS. Les jetons d’accès ne sont valides que pendant 24 heures. Après ce délai, un nouveau jeton doit être généré pour continuer à utiliser l’API. Pour plus d’informations sur la génération des jetons d’accès, consultez le tutoriel sur l’authentification.
Certains Platform Les points de terminaison API acceptent les paramètres de requête pour localiser des informations spécifiques et filtrer les résultats renvoyés dans la réponse. Les paramètres de requête sont ajoutés aux chemins de requête avec un point d’interrogation (?
), suivi d’un ou plusieurs paramètres de requête sous le format paramName=paramValue
. Lorsque vous combinez plusieurs paramètres dans un seul appel, vous devez utiliser une esperluette (&
) pour les séparer. L’exemple suivant illustre la manière dont une requête qui utilise plusieurs paramètres de requête est représentée dans la documentation.
Voici quelques exemples de paramètres de requête fréquemment utilisés :
GET /tenant/schemas?orderby=title
GET /datasets?limit=36&start=10
GET /batches?createdAfter=1559775880000&orderBy=desc:created
Pour savoir précisément quels paramètres de requête sont disponibles pour un service ou un point de terminaison en particulier, consultez la documentation spécifique au service.
De nombreuses opérations PATCH dans Platform Utilisation des API JSON Pointer chaînes pour indiquer les propriétés JSON à mettre à jour. Elles sont généralement incluses dans les payloads des requêtes au format JSON Patch. Pour plus d’informations sur la syntaxe requise pour ces technologies, consultez le guide de base de l’API.
Postman est un outil utile pour visualiser les appels vers les API RESTful. Le Guide de prise en main de l’API Platform contient une vidéo et des instructions pour l’importation de collections Postman. En outre, une liste des collections Postman pour chaque service est fournie.
Selon que vous utilisez l’interface utilisateur ou l’API, la configuration suivante est nécessaire :
Pour les opérations basées sur l’interface utilisateur :
Pour les interactions entre les développeurs et l’API :
Voici une liste des erreurs que vous pouvez rencontrer lors de l’utilisation de l’une des variables Experience Platform service. Pour obtenir des guides de dépannage sur un individu Platform services, voir répertoire de dépannage des services ci-dessous.
Les codes d’état suivants peuvent être rencontrés sur n’importe quelle Experience Platform API. Chacun d’entre eux pouvant être causé par un grand nombre d’éléments, les explications données dans cette section sont générales. Pour plus d’informations sur les erreurs spécifiques d’une personne Platform services, veuillez consulter la section répertoire de dépannage des services ci-dessous.
Code d’état | Description | Causes possibles |
---|---|---|
400 | Mauvaise requête | La requête a été mal construite, des informations de clé étaient absentes et/ou sa syntaxe était incorrecte. |
401 | Échec de l’authentification | La requête n’a pas pu être authentifiée. Votre jeton d’accès est peut-être absent ou non valide. Pour plus d’informations, reportez-vous à la section erreurs de jeton OAuth ci-dessous. |
403 | Interdit | La ressource a été trouvée, mais vous ne possédez pas les informations d’identification appropriées pour la consulter. |
404 | Introuvable | La ressource demandée n’a pas été trouvée sur le serveur. La ressource a peut-être été supprimée, ou le chemin d’accès demandé n’a pas été correctement saisi. |
500 | Erreur interne du serveur | Il s’agit d’une erreur côté serveur. Si vous effectuez de nombreux appels simultanés, vous pouvez atteindre la limite de l’API et devoir filtrer vos résultats. (Voir Catalog Service Sous-guide du développeur d’API sur filtrage des données pour en savoir plus.) Patientez avant de réessayer votre requête et contactez votre administrateur si le problème persiste. |
Tous les appels API dans Platform nécessitent des en-têtes de requête spécifiques. Pour connaître les en-têtes nécessaires pour un service en particulier, consultez la documentation de référence sur l’API. Pour rechercher les valeurs des en-têtes d’authentification requis, consultez le tutoriel sur l’authentification. Si l’un de ces en-têtes est absent ou non valide lors d’un appel API, les erreurs suivantes peuvent se produire.
{
"error_code": "403010",
"message": "Oauth token is missing."
}
Ce message d’erreur s’affiche lorsqu’un en-tête Authorization
est absent d’une requête API. Assurez-vous que l’en-tête d’autorisation comprend un jeton d’accès valide avant de réessayer.
{
"error_code": "401013",
"message": "Oauth token is not valid"
}
Ce message d’erreur s’affiche lorsque le jeton d’accès indiqué dans l’en-tête Authorization
n’est pas valide. Assurez-vous que le jeton a été saisi correctement ou générez un nouveau jeton dans la console Adobe I/O.
{
"error_code": "403000",
"message": "Api Key is required"
}
Ce message d’erreur s’affiche lorsqu’un en-tête de clé API (x-api-key
) est absent d’une requête API. Assurez-vous que l’en-tête comprend une clé API valide avant de réessayer.
{
"error_code": "403003",
"message": "Api Key is invalid"
}
Ce message d’erreur s’affiche lorsque la valeur de l’en-tête de clé API indiqué (x-api-key
) n’est pas valide. Vérifiez que vous avez correctement saisi la clé avant de réessayer. Si vous ne connaissez pas votre clé API, vous pouvez la trouver dans la console Adobe I/O : dans l’onglet Intégrations, accédez à la section Aperçu pour une intégration spécifique afin de trouver la clé API sous Informations d’identification du client.
{
"error_code": "400003",
"message": "Missing header"
}
Ce message d’erreur s’affiche lorsqu’un en-tête d’organisation IMS (x-gw-ims-org-id
) est absent d’une requête API. Assurez-vous que l’en-tête comprend l’identifiant de votre organisation IMS avant de réessayer.
{
"error_code": "403025",
"message": "Profile is not valid"
}
Ce message d’erreur s’affiche lorsque l’intégration de l’utilisateur ou de l’Adobe I/O (identifiée par la variable jeton d’accès dans le Authorization
en-tête) n’est pas autorisé à effectuer des appels vers Experience Platform API pour l’organisation IMS fournie dans la variable x-gw-ims-org-id
en-tête . Vérifiez que vous avez indiqué le bon identifiant pour votre organisation IMS dans l’en-tête avant de réessayer. Si vous ne connaissez pas l’identifiant de votre organisation, vous pouvez le trouver dans la console Adobe I/O : dans l’onglet Intégrations, accédez à la section Aperçu pour une intégration spécifique afin de trouver l’identifiant sous Informations d’identification du client.
{
"errorMessage":"Supplied version=[\\\\\\\"a200a2a3-0000-0200-0000-123178f90000\\\\\\\"] does not match the current version on entity=[\\\\\\\"a200cdb2-0000-0200-0000-456179940000\\\\\\\"]"
}
Vous pouvez recevoir une erreur d’etag si une modification a été apportée à une entité source ou de destination comme flux, connexion, connecteur source ou connexion cible par un autre appelant API. En raison de l’incohérence de la version, la modification que vous essayez d’apporter ne sera pas appliquée à la dernière version de l’entité.
Pour résoudre ce problème, vous devez récupérer à nouveau l’entité, vous assurer que vos modifications sont compatibles avec la nouvelle version de l’entité, puis placer la nouvelle balise dans la balise If-Match
et enfin effectuez l’appel API.
{
"type": "/placeholder/type/uri",
"status": 400,
"title": "BadRequestError",
"detail": "A valid content-type must be specified"
}
Ce message d’erreur s’affiche lorsqu’une requête POST, PUT ou PATCH comporte un en-tête Content-Type
non valide ou n’en comporte pas. Assurez-vous que l’en-tête est inclus dans la requête et que sa valeur est bien application/json
.
{
"error_code": "403027",
"message": "User region is missing"
}
Ce message d’erreur s’affiche dans l’un des deux cas ci-dessous :
x-gw-ims-org-id
) est transmis dans une requête API. Assurez-vous que l’identifiant correct de votre organisation IMS est inclus avant de réessayer.Voici une liste des guides de dépannage et de la documentation de référence sur les API pour Experience Platform API. Chaque guide de dépannage fournit des réponses aux questions fréquentes et des solutions aux problèmes spécifiques à chaque Platform services. Les documents de référence sur l’API fournissent un guide complet de tous les points de terminaison disponibles pour chaque service et présentent des échantillons de corps de requête, de réponses et de codes d’erreur que vous pouvez recevoir.
Service | Référence d’API | Dépannage |
---|---|---|
Contrôle d'accès | API Access Control | Guide de dépannage du contrôle d’accès |
Adobe Experience Platform Data Ingestion | Data Ingestion API | Guide de dépannage de l’ingestion par lots Guide de dépannage de l’ingestion par flux |
Adobe Experience Platform Data Science Workspace | Sensei Machine Learning API | Guide de dépannage du Data Science Workspace |
Gouvernance des données d’Adobe Experience Platform | Policy Service API | |
Adobe Experience Platform Identity Service | Identity Service API | Guide de dépannage du Identity Service |
Adobe Experience Platform Query Service | Query Service API | Guide de dépannage du Query Service |
Segmentation Adobe Experience Platform | Segmentation API | |
Catalog Service | Catalog Service API | |
Experience Data Model (XDM) | Schema Registry API | XDM System FAQ et guide de dépannage |
Flow Service (Sources et Destinations) | Flow Service API | |
Real-time Customer Profile | Real-time Customer Profile API | Guide de dépannage du Profile |
Environnements de test | API Sandbox | Guide de dépannage des environnements de test |