token.create

Opis

object token.create(object/array tokens)

Ta metoda umożliwia tworzenie nowych tokenów.

Uprawnienie Manage API tokens permission jest wymagane, aby rola użytkownika mogła zarządzać tokenami innych użytkowników.

Token utworzony tą metodą musi również zostać wygenerowany, zanim będzie można go użyć.

Parametry

(object/array) Tokeny do utworzenia.

Metoda akceptuje tokeny ze standardowymi właściwościami tokenu.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory utworzonych tokenów we właściwości tokenids. Kolejność zwróconych identyfikatorów odpowiada kolejności przekazanych tokenów.

Przykłady

Utwórz token

Utwórz włączony token, który nigdy nie wygasa i uwierzytelnia użytkownika o ID 2.

Żądanie:

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

Odpowiedź:

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

Utwórz wyłączony token, który wygasa 21 stycznia 2021 roku. Ten token będzie uwierzytelniał bieżącego użytkownika.

Żądanie:

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

Odpowiedź:

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

Źródło

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