DocumentationAdobe PassAuthentification Adobe Pass

(Hérité) Récupérer Le Jeton D’Autorisation retrieve-authorization-token

Last update: Fri Dec 13 2024 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

Récupère le jeton d’autorisation (AuthZ).

Point d’entrée
Appelé
Par
Entrée
Params
HTTP
Méthode
Réponse
HTTP
Réponse
<SP_FQDN>/api/v1/tokens/authz

Par exemple :

<SP_FQDN>/api/v1/tokens/authz
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
1. Réussite
2.
du jeton d’authentification introuvable ou expiré :
XML expliquant le motif
jeton d’authentification introuvable
3. Jeton d’autorisation
introuvable :
Explication XML
4. Jeton d’autorisation
expiré :
Explication XML
200 - Succès
412 - Pas d’AuthN

404 - Pas d’AuthZ

410 - AuthZ expiré
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 un resourceId (ou un fragment MRSS), identifiant le contenu demandé par un utilisateur et reconnu 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 d’un paramètre de type d’appareil sans client dans les mesures de réussite

Remarque : 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 response

Succès

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <authorization>
        <expires>1348148289000</expires>
        <mvpd>sampleMvpdId</mvpd>
        <requestor>sampleRequestorId</requestor>
        <resource>sampleResourceId</resource>
        <proxyMvpd>sampleProxyMvpdId</proxyMvpd>
    </authorization>

JSON:

    {
        "mvpd": "sampleMvpdId",
        "resource": "sampleResourceId",
        "requestor": "sampleRequestorId",
        "expires": "1348148289000",
        "proxyMvpd": "sampleProxyMvpdId"
    }

Jeton d’authentification introuvable ou expiré :

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>412</status>
        <message>User not authenticated</message>
    </error>

JSON:

    {
        "status": 412,
        "message": "User not authenticated",
        "details": null
    }

Jeton d’autorisation introuvable :

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>404</status>
        <message>Not found</message>
    </error>

JSON:

    {
        "status": 404,
        "message": "Not Found",
        "details": null
    }

Jeton d’autorisation expiré :

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <error>
        <status>410</status>
        <message>Gone</message>
    </error>

JSON:

    {
        "status": 410,
        "message": "Gone",
        "details": null
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b