Programadores · SDKs
SDKs AuthGuard (TypeScript, Python, Java, .NET, Go)
Os SDKs cobrem a superfície de integração (não a API de administração), com o mesmo comportamento nas cinco linguagens.
O que cobrem?
| Área | O que fazem |
|---|---|
| Pedidos de aprovação | Token máquina (client_credentials), criar com Idempotency-Key, ler, cancelar, esperar pela decisão |
| Webhooks | Verificação HMAC-SHA-256 Standard Webhooks dos eventos |
| Recibos | Verificação do resumo do pedido e da ligação do recibo (passos 1 a 3) |
| OpenID Connect | Descoberta, URL de autorização com PKCE S256, verificação do retorno, troca do código, validação do ID token com o JWKS |
Que SDKs existem?
| SDK | Pacote |
|---|---|
| TypeScript / Node.js | @authguard/sdk |
| Python | authguard-sdk (importa authguard) |
| Java | pt.authguard:authguard-sdk |
| .NET | AuthGuard.Sdk |
| Go | pasta sdks/go (pacote authguard) |
Todos estão na versão 0.1.0. Ainda não estão publicados nos registos públicos: instale-os a partir do repositório (pasta sdks/) que o fornecedor lhe entrega.
Comportamento comum
- Repetem com espera exponencial e variação aleatória em 429, 502, 503, 504 e erros de rede nas chamadas idempotentes. Chamadas não idempotentes (cancelar, trocar o código) só são repetidas quando o servidor respondeu 429/503 com
Retry-After. - Respeitam
Retry-Afteraté 60 segundos. - Tempo limite por tentativa de 10 segundos por omissão.
- Não escrevem registos; segredos e tokens nunca aparecem em mensagens de erro.
Contrato e testes
O contrato é o OpenAPI docs/openapi/authguard-v1.yaml. Os testes de todos os SDKs usam as mesmas respostas gravadas e vetores de teste (pasta sdks/fixtures), também usados pelo servidor, por isso assinam os mesmos bytes.
Códigos de erro deste artigo
Esta página ajudou?
Obrigado. A resposta fica guardada apenas neste browser; não enviamos nada.
Lamentamos. Experimente:
- pesquisar com o texto exato da mensagem ou o código de erro
- consultar o índice de códigos de erro
- falar com o administrador da sua organização