Revendedores/Checklist de integração

Checklist para revendedores

Se você revende a API da Wokey para os seus próprios usuários, percorra a lista abaixo em ordem. Cada item leva aos detalhes completos.

Checklistlink

  1. 1

    Envie X-End-User-Id em todas as requisições

    Quando uma chave atende muitos usuários finais, este cabeçalho informa a qual usuário final a requisição pertence. Se um usuário final continuar violando as políticas, a Wokey restringe apenas esse usuário e seus demais usuários continuam funcionando. Contas empresariais e de revenda também podem consultar os usuários restritos e remover as restrições no console.

    ID de usuário final e limites →

  2. 2

    Detecte recusas do modelo

    Uma recusa ainda retorna HTTP 200, então detecte-a pelos campos da resposta. Ao encontrar uma, peça ao seu usuário que altere o conteúdo em vez de repetir a mesma requisição.

    Recusas do modelo →

  3. 3

    Barre cedo os usuários infratores

    Recusas repetidas levam a limites de taxa, suspensões de modelo e taxas por violação. Com ou sem X-End-User-Id, as violações contam contra a sua conta, então filtre o conteúdo antes de enviar requisições à Wokey.

    Taxas por violação e limites →

  4. 4

    Trate erros pelo código de status

    Diferencie saldo insuficiente (402), limites de taxa (429) e erros upstream (502, 504, 529), e avise ou tente novamente conforme o caso. Inclua o cabeçalho de resposta x-wokey-request-id ao entrar em contato com o suporte.

    Códigos de erro →

  5. 5

    Monitore saldo e uso

    Consulte o saldo da conta com /v1/dashboard/balance, e o uso e o limite restante por chave com /v1/usage e /v1/key. Recarregue antes que o saldo acabe.

    Saldo e uso →

  6. 6

    Escolha um fornecedor quando precisar

    Quando um modelo tem vários fornecedores, use provider no corpo da requisição para exigir ou excluir fornecedores.

    Roteamento de fornecedores →