Pular para o conteúdo
Cuidaro Desenvolvedores API v1 · 2026-10-26 OpenAPI Site do Cuidaro

Comece aqui

Autenticação

OAuth 2.0 client_credentials. O token é opaco, vale 1 hora e vai no cabeçalho Authorization: Bearer.

Requisição

cURL

curl -X POST 'https://cuidaro.com.br/api/v1/oauth/token' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"grant_type":"client_credentials","client_id":"cli_exemplo","client_secret":"cs_exemplo"}'

PHP

// composer require guzzlehttp/guzzle
$client = new \GuzzleHttp\Client(['base_uri' => 'https://cuidaro.com.br/api/v1/']);

$response = $client->request('POST', 'oauth/token', [
    'headers' => ['Accept' => 'application/json'],
    'json' => [
        'grant_type' => 'client_credentials',
        'client_id' => 'cli_exemplo',
        'client_secret' => 'cs_exemplo',
    ],
    'http_errors' => false,
]);

$data = json_decode((string) $response->getBody(), true);

Node.js

const response = await fetch('https://cuidaro.com.br/api/v1/oauth/token', {
  method: 'POST',
  headers: { 'Accept': 'application/json', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "grant_type": "client_credentials",
    "client_id": "cli_exemplo",
    "client_secret": "cs_exemplo"
  }),
});
const data = response.status === 204 ? null : await response.json();

Python

import requests

response = requests.request(
    "POST",
    "https://cuidaro.com.br/api/v1/oauth/token",
    headers={"Accept": "application/json"},
    json={
        "grant_type": "client_credentials",
        "client_id": "cli_exemplo",
        "client_secret": "cs_exemplo",
    },
    timeout=15,
)
data = response.json() if response.status_code != 204 else None
Resposta 200
{
  "access_token": "cat_exemplo",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "services:read services:write"
}
  • Credenciais no corpo (JSON ou formulário). HTTP Basic não é aceito.
  • Guarde o token em cache e reaproveite. Não há refresh token: ao expirar (401 AUTH_TOKEN_EXPIRED), peça outro.
  • scope é opcional e restringe o token a parte dos escopos da integração.
  • A emissão tem limite de 10 por minuto por IP. Não peça um token por requisição.

Referência: POST /oauth/token e GET /me.

Referência gerada a partir do contrato OpenAPI 3.1 da API v1 (versão 2026-10-26), conferido contra o código por teste automatizado. Dúvidas: suporte@cuidaro.com.br.