OAuth2-Token abrufen
Letzte Aktualisierung: 31. Dezember 2024
Erstellt für:
- Entwickler
Abrufen von OAuth2-Token
Gibt das OAuth2-Aktualisierungs-Token und Zugriffs-Token für einen authentifizierten Benutzer zurück. Dieser wird einmal aufgerufen, wenn der Benutzer einen Dokumentanbieter bereitstellt. Nachfolgende Aufrufe erfolgen, um ein aktualisiertes Zugriffstoken abzurufen.
URL
POST /any/url
Die URL ist konfigurierbar und entspricht dem Token-Endpunkt-URL-Wert auf der Seite „Benutzerdefiniertes Integrations-Setup“.
Abfrageparameter
Name | Erforderlich | Beschreibung |
---|---|---|
grant_type | Ja | Die Werte umfassen „authorization_code“ oder „refresh_token“. Der angegebene Wert gibt an, welcher der beiden Parameter an diesen API-Aufruf übergeben wird: code oder refresh_token. |
Code | Depends | Der Autorisierungs-Code wird an Adobe Workfront gesendet, unmittelbar nachdem der Benutzer auf die Schaltfläche „Gewähren“ geklickt hat. Dies ist nur erforderlich, wenn der Gewährungstyp „authorization_code“ ist. Der Autorisierungs-Code sollte kurzlebig sein und im Allgemeinen in 10 Minuten oder weniger ablaufen. |
refresh_token | Depends | Dies ist nur erforderlich, wenn nachfolgende Aufrufe zum Abrufen eines neuen Zugriffs-Tokens erfolgen, da das vorherige Zugriffs-Token abgelaufen ist. Wenn Sie diesen Wert senden, setzen Sie den Parameter grant_type auf „refresh_token“. |
client_id | Ja | Die in Workfront für diese benutzerdefinierte Integration konfigurierte Client-ID. |
client_secret | Ja | Der in Workfront für diese benutzerdefinierte Integration konfigurierte geheime Clientschlüssel. |
Antwort
Name | Typ | Beschreibung |
---|---|---|
access_token | Zeichenfolge | Ein Token, das verwendet wird, um autorisierte API-Aufrufe im Namen des Benutzers durchzuführen. Dieser sollte ablaufen, um nicht autorisierte API-Aufrufe zu verhindern. |
refresh_token | Zeichenfolge | Ein langlebiges Token, mit dem ein neues Zugriffs-Token abgerufen wird, indem diese API-Methode aufgerufen wird. |
expires_in | lang | (Optional) Die Zeit (in Sekunden), bevor das Zugriffs-Token abläuft, im Allgemeinen 3.600. |
Beispiel
POST /oauth2/token
grant_type=authorization_code
code=d9ac7asdf6asdf579d7a8
client_id=123456
client_secret=6asdf7a7a9a4af
Antwort
{
access_token:"ad8af5ad5ads759",
refresh_token:"9a0h5d87d808ads",
expires_id:3600
}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43