Obtenir les identifiants de l’appareil

Récupérer les informations d’identification d’appareil (public_key, refresh_token ou rotating_refresh_token) associées à un utilisateur précis.

GET https://{tenantDomain}/api/v2/device-credentials

Go

Go

package example

import (
    context "context"

    management "github.com/auth0/go-auth0/management/management"
    client "github.com/auth0/go-auth0/management/management/client"
    option "github.com/auth0/go-auth0/management/management/option"
)

func do() {
    client := client.NewClient(
        option.WithToken(
            "<token>",
        ),
    )
    request := &management.ListDeviceCredentialsRequestParameters{
        Page: management.Int(
            1,
        ),
        PerPage: management.Int(
            1,
        ),
        IncludeTotals: management.Bool(
            true,
        ),
        Fields: management.String(
            "fields",
        ),
        IncludeFields: management.Bool(
            true,
        ),
        UserId: management.String(
            "user_id",
        ),
        ClientId: management.String(
            "client_id",
        ),
        Type: management.DeviceCredentialTypeEnumPublicKey.Ptr(),
    }
    client.DeviceCredentials.List(
        context.TODO(),
        request,
    )
}

200

[
  {
    "client_id": "AaiyAPdpYdesoKnqjj8HJqRn4T5titww",
    "device_id": "550e8400-e29b-41d4-a716-446655440000",
    "device_name": "iPhone Mobile Safari UI/WKWebView",
    "id": "dcr_0000000000000001",
    "user_id": "usr_5457edea1b8f33391a000004"
  }
]

Autorisations

bearerAuthoAuth2ClientCredentials

Authorization · string · header · requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paramètres de requête

page · integer

Indice de page des résultats à renvoyer. La première page est 0.

Plage requise: x >= 0

per_page · integer

Nombre de résultats par page. Un maximum de 1000 résultats est autorisé pour ce point de terminaison.

Plage requise: 1 <= x <= 100

include_totals · boolean

Renvoyez les résultats dans un objet contenant le nombre total de résultats (true) ou sous forme de tableau direct de résultats (false, valeur par défaut).

fields · string

Liste de champs séparés par des virgules à inclure ou à exclure (selon la valeur fournie pour include_fields) dans le résultat. Laissez vide pour récupérer tous les champs.

include_fields · boolean

Indique si les champs spécifiés doivent être inclus (true) ou exclus (false).

user_id · string

user_id des appareils à récupérer.

client_id · string

client_id des appareils à récupérer.

type · enum<string>

Type d’identifiants à récupérer. Doit être public_key, refresh_token ou rotating_refresh_token. La propriété prendra par défaut la valeur refresh_token lorsqu’une pagination est demandée Type d’identifiant à récupérer. Doit être public_key, refresh_token ou rotating_refresh_token. La propriété prendra par défaut la valeur refresh_token lorsque la pagination est demandée

Options disponibles: public_key, refresh_token, rotating_refresh_token

Réponse

200

application/json

Informations d’identification d’appareil récupérées avec succès.

object[]

object

client_id · string · défaut: AaiyAPdpYdesoKnqjj8HJqRn4T5titww

client_id de l’application à laquelle cette information d’identification est associée.

device_id · string · défaut: 550e8400-e29b-41d4-a716-446655440000

Identifiant unique de l’appareil. REMARQUE : ce champ n’est généralement pas renseigné pour les refresh_tokens et les rotating_refresh_tokens

device_name · string · défaut: iPhone Mobile Safari UI/WKWebView

Agent utilisateur pour cet appareil

id · string · défaut: dcr_0000000000000001

ID de cet appareil.

type · enum<string>

Type d’information d’identification. Peut être public_key, refresh_token ou rotating_refresh_token.

Options disponibles: public_key, refresh_token, rotating_refresh_token

user_id · string · défaut: usr_5457edea1b8f33391a000004

user_id auquel cette information d’identification est associée.