Registra app OAuth

Versione 4.0.23.6 (più recente)

Registrare un'app client OAuth2

Registra dettagli che identificano un'app web esterna o un'app nativa come client di accesso OAuth2 dell'istanza di Looker. La registrazione dell'app deve fornire un comando client_guid e Redirect_uri univoco che l'app presenterà nelle richieste di accesso OAuth. Se i parametri client_guid e Redirect_uri nella richiesta di accesso non corrispondono ai dettagli dell'app registrati con l'istanza di Looker, si presume che la richiesta sia una falsificazione e viene rifiutata.

Richiesta

POST /oauth_client_apps/{client_guid}
Tipo di dati
Descrizione
Richiesta
HTTPRequest
percorso
Percorso HTTP
Espandi definizione HTTPPath...
guida_client
string
L'ID univoco di questa applicazione
body
HTTPBody
Espandi definizione HTTPBody...
body
App client OAuth
Espandi definizione OauthClientApp...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
guida_client
string
L'ID univoco globale di questa applicazione
URI_di_reindirizzamento
string
L'uri con cui l'applicazione riceverà un codice di autenticazione tramite reindirizzamento del browser.
nome_visualizzazione
string
Il nome visualizzato dell'applicazione.
description
string
Una descrizione dell'applicazione che verrà mostrata agli utenti.
abilitato
boolean
Se il valore è true, le richieste OAuth2 e API verranno accettate da questa app. Se il valore è false, tutte le richieste di questa app verranno rifiutate. Se viene disattivato, i token esistenti non sono convalidati.
group_id
string
Se configurato, solo gli utenti di Looker che sono membri del gruppo possono utilizzare questa app web con Looker. Se group_id non è impostato, qualsiasi utente Looker può usare questa app per accedere a questa istanza di Looker
token_invalid_before
string
Tutti i codici di autorizzazione, i token di accesso e i token di aggiornamento emessi per questa applicazione prima di questa data e per tutti gli UTENTI non saranno validi.
utenti_attivati
della query
Query HTTP
Espandi definizione HTTPQuery in corso...
campi
string
Campi richiesti:

Risposta

200: app client OAuth

Tipo di dati
Descrizione
(oggetto)
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
guida_client
string
L'ID univoco globale di questa applicazione
URI_di_reindirizzamento
string
L'uri con cui l'applicazione riceverà un codice di autenticazione tramite reindirizzamento del browser.
nome_visualizzazione
string
Il nome visualizzato dell'applicazione.
description
string
Una descrizione dell'applicazione che verrà mostrata agli utenti.
abilitato
boolean
Se il valore è true, le richieste OAuth2 e API verranno accettate da questa app. Se il valore è false, tutte le richieste di questa app verranno rifiutate. Se viene disattivato, i token esistenti non sono convalidati.
group_id
string
Se configurato, solo gli utenti di Looker che sono membri del gruppo possono utilizzare questa app web con Looker. Se group_id non è impostato, qualsiasi utente Looker può usare questa app per accedere a questa istanza di Looker
token_invalid_before
string
Tutti i codici di autorizzazione, i token di accesso e i token di aggiornamento emessi per questa applicazione prima di questa data e per tutti gli UTENTI non saranno validi.
utenti_attivati
Espandi definizione di Pubblico...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
string
ID univoco
first_name
string
Nome
last_name
string
Cognome
nome_visualizzazione
string
Nome completo da visualizzare (disponibile solo se sono impostati sia nome che cognome)
url_avatar
string
URL dell'immagine dell'avatar (potrebbe essere generico)
url
string
Link per acquistare questo articolo

400: Richiesta errata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

404: Non trovata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

409: Risorsa già esistente

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

422: Errore di convalida

Tipo di dati
Descrizione
messaggio
string
Error details (Dettagli errore)
Espandi definizione ValidationErrorDetails...
campo
string
Campo con errore
codice
string
Codice di errore
messaggio
string
Messaggio informativo sull'errore
documentazione_url
string
Link alla documentazione
documentazione_url
string
Link alla documentazione

429: Troppe richieste

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

Esempi