Crie uma conta no portal, depois aceda a As minhas aplicações para criar uma aplicação. O seu Segredo de aplicação é apresentado na criação — copie-o e guarde-o num local seguro. Assim que a aplicação for aprovada, pode utilizá-la nas suas chamadas. Consulte o guia de início para mais detalhes.

O ambiente Sandbox (https://sandbox-api.stef.com) é dedicado a testes — sem quotas, dados fictícios. O ambiente Produção (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 a implementação de um mecanismo de renovação automática (refresh token). Consulte o guia de autenticação.

Atingiu o limite de pedidos do seu plano. Verifique os cabeçalhos 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 Postman através do botão dedicado.