DocumentationAdobe PassAuthentification Adobe Pass

(Hérité) Récupération de la liste des ressources préautorisées retrieve-list-of-preauthorized-resources

Last update: Mon Jan 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
Le contenu de cette page est fourni à titre d’information uniquement. L’utilisation de cette API nécessite une licence Adobe. Aucune utilisation non autorisée n’est autorisée.
IMPORTANT
Veillez à rester informé des dernières annonces de produits Authentification Adobe Pass et des délais de désactivation agrégés dans la page Annonces de produits.
NOTE
L’implémentation de l’API REST est limitée par mécanisme de limitation

Points d’entrée de l’API REST clientless-endpoints

<REGGIE_FQDN> :

<SP_FQDN> :

Description description

Une requête à l’Authentification Adobe Pass pour obtenir la liste des ressources préautorisées.

Il existe deux ensembles d’API : l’un pour l’application de diffusion en continu ou le service de programmation, l’autre pour la deuxième application web Screens. Cette page décrit l’API du service de programmation ou de l’application de diffusion en continu.

Point d’entrée
Appelé
Par
Entrée
Params
HTTP
Méthode
Réponse
HTTP
Réponse
<SP_FQDN>/api/v1/preauthorize.
Service de programmation

ou

d’application en flux continu
1. demandeur (obligatoire)
2. deviceId (obligatoire)
3. ressource (obligatoire)
4. device_info/X-Device-Info (obligatoire)
5. deviceType
6 deviceUser (obsolète)
7. appId (obsolète)
GET
XML ou JSON contenant des décisions de pré-autorisation individuelles ou des détails d’erreur. Voir les exemples ci-dessous.
200 - Succès

400 - Requête incorrecte

401 - Non autorisé

405 - Méthode non autorisée

412 - Échec de la condition préalable

500 - Erreur de serveur interne
Paramètre d’entrée
Description
demandeur
ID de demandeur du programmeur pour lequel cette opération est valide.
deviceId
Octets d’ID de l’appareil.
ressource
Chaîne contenant une liste délimitée par des virgules de resourceId qui identifie le contenu susceptible d’être accessible à un utilisateur ou une utilisatrice et qui est reconnue par les points d’entrée d’autorisation MVPD.
device_info/

X-Device-Info
Informations sur l’appareil de diffusion en continu.

Remarque : cela PEUT être transmis à device_info en tant que paramètre d’URL, mais en raison de la taille potentielle de ce paramètre et des limitations de la longueur d’une URL de GET, il DOIT être transmis en tant que X-Device-Info dans l’en-tête http.

Voir les détails complets dans Transmettre les informations sur l’appareil et la connexion.
deviceType
Type d’appareil (par exemple, Roku, PC).

Si ce paramètre est défini correctement, ESM propose des mesures ventilées par type d’appareil lors de l’utilisation de Clientless, de sorte que différents types d’analyse puissent être effectués, par exemple, Roku, AppleTV et Xbox.

Voir, avantages de l’utilisation du paramètre de type d’appareil sans client dans les mesures de réussite

Remarque : le device_info remplacera ce paramètre.
deviceUser
Identifiant utilisateur de l’appareil.
appId
Nom/ID de l’application.

Remarque : device_info remplace ce paramètre.

Exemple de réponse sample-response

XML:

HTTP/1.1 200 OK
Adobe-Request-Id : 7af28ec2-a068-45c2-8009-f5443049baf4
Adobe-Response-Confidence : full
Content-Type: application/xml; charset=utf-8

<resources>
  <resource>
    <id>TestStream1</id>
    <authorized>true</authorized>
  </resource>
  <resource>
    <id>TestStream2</id>
    <authorized>false</authorized>
    <error>
      <status>403</status>
      <code>authorization_denied_by_mvpd</code>
      <message>User not authorized</message>
      <details>Your subscription package does not include the "TestStream3" channel.</details>
      <helpUrl>https://experienceleague-review.corp.adobe.com/docs/primetime/authentication/auth-features/error-reportn/enhanced-error-codes.html#error-codes</helpUrl>
      <trace>0453f8c8-167a-4429-8784-cd32cfeaee58</trace>
      <action>none</action>
    </error>
  </resource>
</resources>

JSON:

HTTP/1.1 200 OK
Adobe-Request-Id : 7af28ec2-a068-45c2-8009-f5443049baf4
Adobe-Response-Confidence : full
Content-Type: application/json; charset=utf-8

{
   "resources" : [
        {
            "id" : "TestStream1",
            "authorized" : true
        },
        {
            "id" : "TestStream3",
            "authorized" : false,
            "error" : {
               "status" : 403,
               "code" : "authorization_denied_by_mvpd",
               "message" : "User not authorized",
               "details" : "Your subscription package does not include the "TestStream3" channel.",
               "helpUrl" : "https://experienceleague-review.corp.adobe.com/docs/primetime/authentication/auth-features/error-reportn/enhanced-error-codes.html#error-codes",
               "trace" : "0453f8c8-167a-4429-8784-cd32cfeaee58",
               "action" : "none"
            }
        }
    ]
}
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b