Autenticando

Para autenticar com o Connect API, você deve obter um OAuth2 token de acesso.

A client_id e client_secret são obtidos de um aplicativo no Certta Trust. Veja Aplicativos para mais detalhes.

Obtain OAuth2 access token

post

/token

Obtain an access token using the client credentials grant type.

Corpo

grant_typestring · enumObrigatório

Grant type to use.

Example: client_credentialsValores possíveis:

client_idstringOpcional

Client ID obtained from application.

Example: your_client_id_here

client_secretstringOpcional

Client secret obtained from application.

Example: your_client_secret_here

Respostas

200

Access token response

application/json

access_tokenstringOpcionalExample: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.EkN-DOsnsuRjRO6BxXemmJDm3HbxrbRzXglbN2S4sOkopdU4IsDxTI8jO19W_A4K8ZPJijNLis4EZsHeY559a4DFOd50_OqgHs3wqrZdmxrjkgBF-yBYa7ULEqZV5B8fEVFsv-JOXOgVBB65PFhHhKWEZrFuEiN9JbkmfUWEhMfBZjKpPVuJCnKn1KvwHKFGKVJ8-SHOJDjV5Y4dRQqn-sxiSJsJbL0j1zKJVPJb8kqGhVQcOLG8RNu7nKkKKoMjV3JrJKvPdVT8J9wJKFk1kJo

token_typestringOpcionalExample: Bearer

expires_inintegerOpcionalExample: 3600

400

Invalid request

application/json

401

Invalid client credentials or refresh token

application/json

post/token

POST /oauth2/token HTTP/1.1
Host: api.us.prd.caf.io
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 89

"'grant_type=client_credentials&client_id=your_client_id&client_secret=your_client_secret'"

{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.EkN-DOsnsuRjRO6BxXemmJDm3HbxrbRzXglbN2S4sOkopdU4IsDxTI8jO19W_A4K8ZPJijNLis4EZsHeY559a4DFOd50_OqgHs3wqrZdmxrjkgBF-yBYa7ULEqZV5B8fEVFsv-JOXOgVBB65PFhHhKWEZrFuEiN9JbkmfUWEhMfBZjKpPVuJCnKn1KvwHKFGKVJ8-SHOJDjV5Y4dRQqn-sxiSJsJbL0j1zKJVPJb8kqGhVQcOLG8RNu7nKkKKoMjV3JrJKvPdVT8J9wJKFk1kJo",
  "token_type": "Bearer",
  "expires_in": 3600
}

Aviso importante sobre autenticação e integrações

Todas as integrações com as APIs da Certta devem ser implementadas exclusivamente via backend/lado do servidor. Integrações no lado do cliente ou baseadas no frontend podem ser bloqueadas e aumentar significativamente o risco de exposição da chave de autenticação.

A Certta monitora continuamente o uso e a exposição das chaves de autenticação. Qualquer chave identificada como exposta, comprometida ou usada em implementações não conformes será revogada imediatamente, o que pode resultar na interrupção da operação associada, sem aviso prévio.

É responsabilidade do integrador garantir conformidade com os padrões de autenticação recomendados e as melhores práticas de segurança descritas nesta documentação.