Connexion

Version 4.0.23.4

Présenter les identifiants client pour obtenir un jeton d'autorisation

L'API Looker met en œuvre le schéma OAuth2 Octroi des identifiants de mot de passe du propriétaire de ressource. Les identifiants client requis pour cette connexion doivent être obtenus en créant une clé API3 sur un compte utilisateur dans la console d'administration Looker. La clé API3 consiste en un client_id public et un client_secret privé.

Le jeton d'accès renvoyé par login doit être utilisé dans l'en-tête d'autorisation HTTP des requêtes API suivantes, comme suit:

Authorization: token 4QDkCyCtZzYgj4C2p2cj3csJH7zqS5RzKs2kTnG4

Remplacez "4QDkCy..." par la valeur access_token renvoyée par login. Le mot token est un littéral de chaîne qui doit être inclus exactement comme indiqué.

Cette fonction peut accepter les paramètres client_id et client_secret en tant que paramètres de requête d'URL ou en tant que paramètres www-form-urlencoded dans le corps de la requête HTTP. Étant donné qu'il existe un faible risque que les paramètres d'URL soient visibles par les nœuds intermédiaires sur la route réseau (proxys, routeurs, etc.), le fait de transmettre des identifiants dans le corps de la requête est considéré comme plus sûr que les paramètres d'URL.

Exemple de transmission d'identifiants dans le corps de la requête HTTP:

POST HTTP /login
Content-Type: application/x-www-form-urlencoded

client_id=CGc9B7v7J48dQSJvxxx&client_secret=nNVS9cSS3xNpSC9JdsBvvvvv

Bonne pratique:

Transmettez toujours les identifiants dans les paramètres du corps. Transmettez les identifiants dans les paramètres de requête d'URL uniquement lorsque vous ne pouvez pas transmettre de paramètres du corps en raison de l'application, d'un outil ou d'autres limites.

Pour obtenir plus d'informations et des exemples détaillés sur l'autorisation de l'API Looker, consultez S'authentifier auprès de l'API Looker 3.

Demande

POST /login
Type de données
Description
Demande
HTTPRequest
query
Requête HTTP
Développer la définition de la requête HTTP...
client_id
string
client_id de la clé API3.
client_secret
string
client_secret fait partie de la clé API3.

Réponse

200: Jeton d'accès avec des métadonnées.

Type de données
Description
(objet)
AccessToken (jeton d'accès)
access_token
string
Jeton d'accès utilisé pour les appels d'API
token_type
string
Type de jeton
expires_in
integer
Nombre de secondes avant l'expiration du jeton
refresh_token
string
Jeton d'actualisation permettant d'obtenir un jeton d'accès

400 Bad Request

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

404: introuvable

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation