Collections
Baixe a Postman Collection e o Environment da API Conta Simples para testar os endpoints rapidamente.
Postman Collection & Environment
Use a collection pronta para testar a API Conta Simples diretamente no Postman, Insomnia ou Bruno — sem precisar configurar cada request manualmente.
A collection foi gerada a partir do OpenAPI 3.0.3 oficial da API e contém apenas os endpoints documentados.
Downloads
Postman Collection
Formato Postman Collection v2.1 com os 3 endpoints da API, exemplos de request/response e script automático de token.
Environment — Sandbox
Variáveis pré-configuradas para o ambiente Sandbox (baseUrl, clientId, clientSecret, token).
Como importar e usar
Importe a Collection no Postman
- Abra o Postman e clique em Import (canto superior esquerdo).
- Arraste o arquivo
postman_collection.jsonou clique em Upload Files e selecione-o. - A collection API Conta Simples aparecerá na barra lateral com 3 pastas: Autenticação, Cartões & Transações e Anexos.
Importe o Environment
- No Postman, clique no ícone de engrenagem (canto superior direito) e selecione Import.
- Selecione o arquivo
postman_environment_sandbox.json. - O environment Conta Simples — Sandbox ficará disponível no seletor de environments.
Selecione o Environment
No canto superior direito do Postman, abra o seletor de environments e escolha Conta Simples — Sandbox.
Isso garante que todas as variáveis (baseUrl, clientId, clientSecret, token) sejam aplicadas automaticamente nos requests.
Preencha suas credenciais
- Clique no environment Conta Simples — Sandbox para editá-lo.
- Preencha os valores de:
clientId— sua API KeyclientSecret— seu API Secret
- Salve o environment.
As credenciais são obtidas no Internet Banking da Conta Simples. Consulte o guia de Autenticação para mais detalhes.
Gere o token de acesso
- Na collection, abra a pasta Autenticação e clique em Obter Token de Acesso.
- Clique em Send.
- Se as credenciais estiverem corretas, o token será salvo automaticamente na variável
{{token}}(via script de test da collection). - Agora todos os outros requests usarão esse token no header
Authorization: Bearer {{token}}.
O token expira em 1 hora. Execute este request novamente quando o token expirar.
Teste os endpoints
Com o token ativo, abra qualquer request da collection e clique em Send:
- Extrato de Cartão — ajuste
startDate,endDateelimitno body. - Download de Anexo — preencha o
attachmentIdobtido na resposta do extrato.
Compatibilidade
A collection usa o formato Postman Collection v2.1, que é compatível com:
| Ferramenta | Importação |
|---|---|
| Postman | Nativa — importe diretamente via Import |
| Insomnia | Suporta importação de Postman Collection v2.x via Import/Export |
| Bruno | Suporta importação de Postman Collection via menu Collection → Import |
| Thunder Client (VS Code) | Suporta importação de Postman Collection v2.1 |
Conteúdo da collection
A collection contém 3 endpoints organizados em pastas:
| Pasta | Endpoint | Método |
|---|---|---|
| Autenticação | /oauth/v1/access-token | POST |
| Cartões & Transações | /statements/v1/credit-card | POST |
| Anexos | /attachments/v1/content/{attachmentId} | GET |
Variáveis utilizadas
| Variável | Descrição | Valor padrão (Sandbox) |
|---|---|---|
{{baseUrl}} | URL base da API | https://api-sandbox.contasimples.com |
{{clientId}} | API Key | (vazio — preencha com sua credencial) |
{{clientSecret}} | API Secret | (vazio — preencha com sua credencial) |
{{token}} | Token JWT | (preenchido automaticamente pelo script) |
Para mais detalhes sobre os endpoints, consulte a API Reference.
Last updated today
Built with Documentation.AI