Documentação Akrus · v1 em prévia
Valide a integração antes de depender dela.
Use cenários controlados para provar leitura, continuidade e tratamento de falhas no ambiente autorizado.
Nesta página
Prepare o cenário
Combine com a equipe a origem do ambiente, a conta e os dados de validação. Confirme plano Scale efetivo, credencial e escopos. Não crie cobranças reais para preencher exemplos e não provoque indisponibilidade no serviço.
Exercite erros, timeout e respostas inesperadas com um transporte simulado no seu sistema. Testes reais de revogação, isolamento ou limites precisam usar contas e credenciais destinadas a essa validação.
Matriz de homologação
| Cenário | Resultado esperado |
|---|---|
| 200 com registros | Envelope v1 validado; registros gravados uma vez por id. |
| 200 com data vazio e next_cursor null | Sucesso sem registros, sem erro artificial ou loop. |
| Mais de uma página e timestamps iguais | Todos os ids esperados preservados, sem depender de offset ou datas reconstruídas. |
| Falha no meio da persistência | Retomada sem perda nem duplicação de efeitos locais. |
| 401 | Processo suspenso até revisar a credencial. |
| 403 | Diagnóstico considera plano efetivo e escopo. |
| 400 ou 404 | Parâmetro ou rota corrigidos antes de repetir. |
| 429 | Espera pelo Retry-After e coordenação da cota compartilhada. |
| 503, timeout ou falha de rede | Tentativas limitadas, espera progressiva e nenhum avanço indevido do checkpoint. |
| JSON inválido ou envelope inesperado | Falha explícita; resposta não tratada como lista vazia. |
| Campo adicional ou estado desconhecido | Leitura compatível, sem classificar o desconhecido como pago ou ativo. |
| Venda antiga reembolsada ou acesso revogado | Reconciliação atualiza o registro previamente sincronizado. |
| Duas contas conectadas | Dados, logs autorizados e checkpoints separados. |
| Troca de chave | Nova credencial validada; anterior revogada; segredo ausente nos logs. |
Ver tabela completa (14 linhas)Mostrar menos
Critérios para iniciar a operação
Funcionalidade
- Escopos cobrem somente os recursos utilizados.
- Paginação termina e a retomada foi exercitada.
- A aplicação distingue falha de leitura de ausência de dados.
- Relatórios informam sua última atualização.
Continuidade
- Existe responsável técnico e canal de suporte acordado.
- Consultas podem ser interrompidas sem perder o checkpoint.
- Há procedimento de revogação e troca de credencial.
- Volume e frequência cabem na cota, com margem para novas tentativas.
Modelo de registro de validação
Preencha com evidências do seu ambiente; nunca anexe a credencial.
Integração:
Responsável técnico:
Ambiente autorizado:
Data e hora com fuso:
Recurso e escopos:
Cenário executado:
Resultado esperado:
Resultado observado:
Status HTTP / error.code:
Evidência sem segredos:
Pendências e responsável:Alinhe o ambiente de validação
Informe o objetivo, os recursos consultados, o volume estimado e os cenários que precisam de dados controlados.
Referência conferida em 8 de outubro de 2026. Relatar uma dúvida na documentação.