token.create

Descrizione

object token.create(object/array tokens)

Questo metodo consente di creare nuovi token.

Per il ruolo utente è richiesta l'autorizzazione Manage API tokens per gestire i token di altri utenti.

Un token creato con questo metodo deve anche essere generato prima di poter essere utilizzato.

Parametri

(object/array) Token da creare.

Il metodo accetta token con proprietà token standard.

Valori di ritorno

(object) Restituisce un oggetto contenente gli ID dei token creati sotto la proprietà tokenids. L'ordine degli ID restituiti corrisponde all'ordine dei token passati.

Esempi

Creare un token

Creare un token abilitato che non scade mai e autentica l'utente con ID 2.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "token.create",
    "params": {
        "name": "Your token",
        "userid": "2"
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "tokenids": [
            "188"
        ]
    },
    "id": 1
}

Creare un token disabilitato che scade il 21 gennaio 2021. Questo token autenticherà l'utente corrente.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "token.create",
    "params": {
        "name": "Your token",
        "status": "1",
        "expires_at": "1611238072"
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "tokenids": [
            "189"
        ]
    },
    "id": 1
}

Fonte

CToken::create() in ui/include/classes/api/services/CToken.php.