DocumentatieAdobe PassAdobe Pass-verificatie

Verificatiesessie ophalen met gebruik van code retrieve-authentication-session-using-code

Last update: Tue Oct 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
De inhoud op deze pagina wordt alleen ter informatie verstrekt. Voor het gebruik van deze API is een huidige licentie van Adobe vereist. Ongeautoriseerd gebruik is niet toegestaan.
IMPORTANT
De implementatie van REST API V2 wordt begrensd door de Throttling mechanismedocumentatie.

Verzoek request

HTTP
pad
/api/v2/{serviceProvider}/sessies/{code}
methode
GET
Padparameters
serviceProvider
De interne unieke id die tijdens het instapproces aan de Serviceleverancier is gekoppeld.
vereist
code
De verificatiecode die wordt verkregen na het maken van de verificatiesessie op het streamingapparaat.
vereist
Kopteksten
Toestemming
De generatie van de toonder symbolische nuttige lading wordt beschreven in de 1} kopbaldocumentatie van de Toestemming {.
vereist
X-Forwarded-For
Het IP-adres van het streamingapparaat.

Het wordt sterk geadviseerd om het voor server aan serverimplementaties altijd te gebruiken, vooral wanneer de vraag door de programmeerdienst eerder dan het het stromen apparaat wordt gemaakt.

Voor client-naar-server-implementaties wordt het IP-adres van het streamingapparaat impliciet verzonden.
optioneel
Accepteren
Het mediatype dat door de clienttoepassing wordt geaccepteerd.

Indien gespecificeerd, moet het application/json zijn.
optioneel
Gebruikersagent
De gebruikersagent van de clienttoepassing.
optioneel

Antwoord response

Code
Tekst
Beschrijving
200
OK
De reactieinstantie bevat informatie over de authentificatiesessie.
400
Ongeldig verzoek
De aanvraag is ongeldig, de client moet de aanvraag corrigeren en het opnieuw proberen. Het reactielichaam kan fouteninformatie bevatten die aan de Verbeterde documentatie van de Codes van de Foutvolgt.
401
Ongeautoriseerd
Het toegangstoken is ongeldig, moet de cliënt een nieuw toegangstoken verkrijgen en opnieuw proberen. Voor meer details verwijs naar de Dynamische documentatie van de Registratie van de Cliënt van het Overzicht.
405
Methode niet toegestaan
De HTTP-methode is ongeldig, de client moet een HTTP-methode gebruiken die is toegestaan voor de aangevraagde resource en het opnieuw proberen. Voor meer details verwijs naar de 1} sectie van het Verzoek {.
500
Interne serverfout
Er is een probleem opgetreden op de server. Het reactielichaam kan fouteninformatie bevatten die aan de Verbeterde documentatie van de Codes van de Foutvolgt.

Succes success

Kopteksten
Status
200
vereist
Lichaam
parameters

JSON-object met de volgende kenmerken:

  • bestaand
    De bestaande parameters die reeds werden verstrekt.
  • het missen
    de ontbrekende parameters die moeten worden verstrekt om de authentificatiestroom te voltooien.
vereist

Fout error

Kopteksten
Status
400, 401, 405, 500
vereist
Inhoudstype
application/json
vereist
Lichaam
Het reactielichaam kan extra fouteninformatie verstrekken die aan de Verbeterde documentatie van de Codes van de Foutvolgt.
vereist

Voorbeelden samples

1. De verificatiesessie ophalen zonder ontbrekende parameters

Verzoek
code language-https 
GET /api/v2/sessions/REF30/8BLW4RW HTTP/1.1

    Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)
Reactie
code language-https 
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

{
    "parameters": {
        "existing": {
            "mvpd": "Cablevision",
            "domain": "adobe.com"
            "redirectUrl": "https://www.adobe.com"
        }
}

1. Ophalen van verificatiesessie met ontbrekende parameters

Verzoek
code language-https 
GET /api/v2/sessions/REF30/8BLW4RW HTTP/1.1

    Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)
Reactie
code language-https 
HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

{
    "parameters": {
        "existing": {
            "mvpd": "Cablevision",
            "domain": "adobe.com"
        },
        "missing": ["redirectUrl"]
}
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b