Crie uma conta no portal e vá a As minhas aplicações para criar uma aplicação. O seu Application Secret é apresentado no momento da criação — copie-o e guarde-o em segurança. Assim que a aplicação for aprovada, pode utilizá-la nas suas chamadas. Consulte o guia de introdução para mais detalhes. :::

O ambiente Sandbox (https://sandbox-api.stef.com) é dedicado aos testes — sem quotas, dados fictícios. O ambiente Production (https://api.stef.com) utiliza dados reais com as quotas definidas no seu plano de acesso. :::

Os tokens OAuth 2.0 expiram após 1 hora. Solicite um novo token através do endpoint /oauth2/token. Recomendamos implementar um mecanismo de atualização automática (refresh token). Consulte o guia de autenticação. :::

Atingiu o limite de pedidos do seu plano. Verifique os headers X-RateLimit-Remaining e Retry-After na resposta e implemente um backoff exponencial. Consulte as boas práticas para a gestão do rate limiting. :::

Cada API dispõe de um modo Try it na sua página de documentação neste portal. Também pode exportar a especificação OpenAPI e importá-la no Insomnia ou no Postman através do botão dedicado. :::