curl --request POST 'https://gyra-core.gyramais.com.br/auth/authenticate' \
--header 'gyra-client-id: SEU_CLIENT_ID' \
--header 'gyra-client-secret: SEU_CLIENT_SECRET'
const resposta = await fetch("https://gyra-core.gyramais.com.br/auth/authenticate", {
method: "POST",
headers: {
"gyra-client-id": process.env.GYRA_CLIENT_ID,
"gyra-client-secret": process.env.GYRA_CLIENT_SECRET,
},
});
const { accessToken, expiresAt } = await resposta.json();
import requests
resposta = requests.post(
"https://gyra-core.gyramais.com.br/auth/authenticate",
headers={
"gyra-client-id": client_id,
"gyra-client-secret": client_secret,
},
)
token = resposta.json()["accessToken"]
{
"id": "6612a7f3a1b2c3d400000000",
"createdAt": "2026-07-31T13:40:02.118Z",
"updatedAt": "2026-07-31T13:40:02.118Z",
"expiresAt": "2026-08-01T13:40:02.114Z",
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"userId": "6612a7f3b4c5d6e700000000",
"loggedOutAt": null,
"organizationId": "6612a7f30000000000000001"
}
{
"code": 400,
"message": "ClientId inválido."
}
{
"code": 401,
"message": "ClientSecret inválido."
}
Referência da API
Gerar Token
Troca o par de credenciais da organização por um token de acesso válido por 24 horas.
POST
/
auth
/
authenticate
curl --request POST 'https://gyra-core.gyramais.com.br/auth/authenticate' \
--header 'gyra-client-id: SEU_CLIENT_ID' \
--header 'gyra-client-secret: SEU_CLIENT_SECRET'
const resposta = await fetch("https://gyra-core.gyramais.com.br/auth/authenticate", {
method: "POST",
headers: {
"gyra-client-id": process.env.GYRA_CLIENT_ID,
"gyra-client-secret": process.env.GYRA_CLIENT_SECRET,
},
});
const { accessToken, expiresAt } = await resposta.json();
import requests
resposta = requests.post(
"https://gyra-core.gyramais.com.br/auth/authenticate",
headers={
"gyra-client-id": client_id,
"gyra-client-secret": client_secret,
},
)
token = resposta.json()["accessToken"]
{
"id": "6612a7f3a1b2c3d400000000",
"createdAt": "2026-07-31T13:40:02.118Z",
"updatedAt": "2026-07-31T13:40:02.118Z",
"expiresAt": "2026-08-01T13:40:02.114Z",
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"userId": "6612a7f3b4c5d6e700000000",
"loggedOutAt": null,
"organizationId": "6612a7f30000000000000001"
}
{
"code": 400,
"message": "ClientId inválido."
}
{
"code": 401,
"message": "ClientSecret inválido."
}
Quando usar
Chame esta rota no início da integração para obter o token que vai no headerAuthorization de todas as outras chamadas. O token vale 24 horas a partir da emissão (campo expiresAt). Gere um novo antes de expirar.
Autenticação
A rota é pública: não exige token. As credenciais vão em dois headers. Gere o par em Configurações, API & MCP, conforme Chaves de API.Parâmetros
| Nome | Local | Tipo | Obrigatório | Descrição |
|---|---|---|---|---|
gyra-client-id | header | string | sim | Client ID da credencial. |
gyra-client-secret | header | string | sim | Client Secret da credencial, mostrado uma única vez na criação. |
Resposta
| Campo | Descrição |
|---|---|
accessToken | Token JWT. Envie como Authorization: Bearer <accessToken>. |
expiresAt | Data e hora em que o token deixa de valer (24 horas após a emissão). |
id | ID da sessão criada. |
userId | ID do usuário técnico da credencial. |
organizationId | Organização dona da credencial. Todas as chamadas feitas com o token ficam restritas a ela. |
loggedOutAt | Sempre null na emissão. |
createdAt / updatedAt | Datas de criação da sessão. |
curl --request POST 'https://gyra-core.gyramais.com.br/auth/authenticate' \
--header 'gyra-client-id: SEU_CLIENT_ID' \
--header 'gyra-client-secret: SEU_CLIENT_SECRET'
const resposta = await fetch("https://gyra-core.gyramais.com.br/auth/authenticate", {
method: "POST",
headers: {
"gyra-client-id": process.env.GYRA_CLIENT_ID,
"gyra-client-secret": process.env.GYRA_CLIENT_SECRET,
},
});
const { accessToken, expiresAt } = await resposta.json();
import requests
resposta = requests.post(
"https://gyra-core.gyramais.com.br/auth/authenticate",
headers={
"gyra-client-id": client_id,
"gyra-client-secret": client_secret,
},
)
token = resposta.json()["accessToken"]
{
"id": "6612a7f3a1b2c3d400000000",
"createdAt": "2026-07-31T13:40:02.118Z",
"updatedAt": "2026-07-31T13:40:02.118Z",
"expiresAt": "2026-08-01T13:40:02.114Z",
"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"userId": "6612a7f3b4c5d6e700000000",
"loggedOutAt": null,
"organizationId": "6612a7f30000000000000001"
}
{
"code": 400,
"message": "ClientId inválido."
}
{
"code": 401,
"message": "ClientSecret inválido."
}
Erros
| Código | Mensagem | Causa |
|---|---|---|
400 | "ClientId inválido." | O gyra-client-id não corresponde a nenhuma credencial (inclusive credencial revogada). |
401 | "ClientSecret inválido." | O gyra-client-secret não confere com o client id. |
401 | "Token de acesso inválido." | Resposta das outras rotas quando o token está ausente, malformado ou expirado. Gere outro aqui. |
Headers
Response
Sessao criada: accessToken (JWT) e expiresAt (24 horas apos a emissao).

