Códigos de saída
Toda execução do kobana termina com um destes códigos, para que um script decida o que fazer sem interpretar o JSON do erro:
| Código | Significado |
|---|---|
0 | Sucesso |
1 | Erro da API (resposta 4xx ou 5xx, inclusive o 401 de um token recusado) ou de rede |
2 | Erro de autenticação detectado no próprio CLI: nenhum token configurado, data de expiração do token salvo vencida ou arquivo de credenciais ilegível. Comando ou flag desconhecidos também saem com 2, pelo leitor de argumentos |
3 | Erro de validação: JSON inválido em --params ou --json, parâmetro de caminho faltando ou produto desconhecido em kobana schema, antes de qualquer requisição; ou --output-format desconhecido, depois que a resposta chega |
4 | Erro de schema: kobana schema com um endpoint que a spec embutida não descreve |
5 | Erro interno |
kobana banking bank-billets get --params '{"id": 123}' > boleto.json
case $? in
0) echo "ok" ;;
2) kobana auth login ;; # sem token ou token salvo vencido
1) echo "a API recusou; confira o token e o pedido" >&2 ;;
*) echo "falhou" >&2 ;;
esac
Próximos passos
- Uso: sintaxe, recursos e exemplos.
- Flags globais:
--dry-run,--output-formate as demais.