Descreva a tarefa
Um desenvolvedor precisa documentar uma nova API REST, incluindo diagramas, exemplos de uso e especificações técnicas completas.
Dê contexto ao ONE 26
O ONE 26 cria diagramas de arquitetura e sequência, gera exemplos de código funcionais em múltiplas linguagens, organiza endpoints em tabelas formatadas e produz documentação completa no formato OpenAPI.
Contexto necessário
Descreva os endpoints da sua API (métodos, paths, parâmetros). Se tiver o código da API ou exemplos de payloads, compartilhe. Indique as linguagens preferidas para os exemplos (Python, JavaScript, cURL, etc.).
O que o ONE 26 responde
O ONE 26 analisa e extrai informações, criando uma resposta estruturada com os resultados.
API de Pagamentos - Documentação
Endpoints Mapeados
| Método | Endpoint | Descrição | Auth |
|--------|----------|-----------|------|
| POST | /transactions | Criar transação | Bearer |
| GET | /transactions/{id} | Consultar status | Bearer |
| POST | /transactions/{id}/refund | Estornar | Bearer |
| GET | /transactions | Listar transações | Bearer |
Diagrama de Sequência
Criado fluxo completo: Cliente → API → Gateway → Banco
Exemplo Python
```python
import requests
response = requests.post(
'https://api.example.com/transactions',
headers={'Authorization': 'Bearer TOKEN'},
json={'amount': 10000, 'currency': 'BRL'}
)
print(response.json())
```
Exemplo JavaScript
```javascript
const response = await fetch('https://api.example.com/transactions', {
method: 'POST',
headers: {
'Authorization': 'Bearer TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({ amount: 10000, currency: 'BRL' })
});
```
Códigos de Erro
• 400: Payload inválido
• 401: Token expirado
• 422: Transação recusada
• 500: Erro interno
Documentação OpenAPI 3.0 disponível para download.
Prompts de follow-up
Continue a conversa com o ONE 26 para refinar, expandir ou explorar mais:
Gere uma collection do Postman
Arquivo importável para testes
Adicione exemplos de tratamento de erros
Documentação de error codes
Dicas e truques
- Forneça exemplos de payloads reais (sanitizados)
- Indique padrões de autenticação utilizados
- Mencione rate limits e quotas da API
Casos de Uso Relacionados
