Skip to content

Criar tokens de acesso​

POST
/users/accessTokens

Para criar um token de acesso, utilize o método POST na rota /users/accessTokens. Este método requer os seguintes parâmetros:

  • ttl: Tempo de vida do token de acesso

Caso tenha dúvidas sobre os valores de ttl, consulte Tempo de vida do token de API.

Este método retorna um objeto com os dados do token de acesso criado, incluindo:

  • id: Identificador único do token de acesso
  • ttl: Tempo de vida do token de acesso
  • created: Data de criação do token de acesso

Importante:

  • O token de acesso deve ser enviado no cabeçalho da requisição, no campo Authorization.
  • Gere um token para cada usuário, e não um único token para toda a conta. Os limites de requisições são contados por usuário. Consulte Rate Limit.

Corpo da Requisição​

JSON
{
"ttl": "1209600"
}

Respostas​

Request was successful
JSON
{
"id": "string",
"ttl": 0,
"created": "string"
}

Exemplos​

cURL
curl -X POST \
'https://api.api4com.com/api/v1/users/accessTokens' \
 -H "Content-Type: application/json"
JavaScript
fetch('https://api.api4com.com/api/v1/users/accessTokens', {method:'POST',headers:{'Content-Type':'application/json'}})
  .then(response => response.json())
  .then(data => console.log(data));
PHP
<?php
$url = 'https://api.api4com.com/api/v1/users/accessTokens';
$method = 'POST';
$headers = [
    'Content-Type' => 'application/json',
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
Python
import requests

url = 'https://api.api4com.com/api/v1/users/accessTokens'

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers)
print(response.json())

Released under the MIT License.