[comment]: # ({c28978f7-c28978f7})
# token.create

[comment]: # ({/c28978f7-c28978f7})

[comment]: # ({4af2c2dc-3cdde1b6})
### Descrição  
  
`object token.create(object/array tokens)`  
  
Este método permite criar novos tokens.

::: noteclassic
Apenas o tipo de usuário *Super admin* tem permissão para gerenciar tokens para outros usuários.
::: 

::: noteclassic
Um token criado por este método deve ser [gerado](generate) antes de ser usado.
:::

[comment]: # ({/4af2c2dc-3cdde1b6})

[comment]: # ({b3691541-b3691541})
### Parâmetros  
  
`(objeto/array)` Tokens para criar.  
  
O método aceita tokens com as [propriedades de token padrão](object).

[comment]: # ({/b3691541-b3691541})

[comment]: # ({da7805eb-da7805eb})
### Valores de retorno  
  
`(object)` Retorna um objeto contendo os IDs dos tokens criados na propriedade `tokenids`. A ordem dos IDs retornados corresponde à ordem dos tokens passados.

[comment]: # ({/da7805eb-da7805eb})

[comment]: # ({b41637d2-b41637d2})
### Exemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({5c95af71-119ef871})
#### Criar um token  
  
Crie um token habilitado que nunca expire e autentique o usuário de ID 2.

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "token.create",
    "params": {
        "name": "Your token",
        "userid": "2"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

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

Create a disabled token that expires at January 21st, 2021. This token
will authenticate current user.

Request:

```json
{
    "jsonrpc": "2.0",
    "method": "token.create",
    "params": {
        "name": "Your token",
        "status": "1",
        "expires_at": "1611238072"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

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

[comment]: # ({/5c95af71-119ef871})

[comment]: # ({5c90c156-5c90c156})
### Fonte

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

[comment]: # ({/5c90c156-5c90c156})