Revendedores/Lista de integración

Lista de verificación para revendedores

Si revendes la API de Wokey a tus propios usuarios, revisa la lista de abajo en orden. Cada punto enlaza a los detalles completos.

Lista de verificaciónlink

  1. 1

    Envía X-End-User-Id en cada solicitud

    Cuando una clave atiende a muchos usuarios finales, este encabezado indica a qué usuario final pertenece una solicitud. Si un usuario final sigue infringiendo las políticas, Wokey restringe solo a ese usuario y tus demás usuarios siguen funcionando. Las cuentas empresariales y de revendedor también pueden revisar los usuarios restringidos y levantar las restricciones en la consola.

    ID de usuario final y límites →

  2. 2

    Detecta los rechazos del modelo

    Un rechazo igual devuelve HTTP 200, así que debes detectarlo a partir de los campos de la respuesta. Cuando encuentres uno, pide a tu usuario que cambie el contenido en lugar de reintentar la misma solicitud.

    Rechazos del modelo →

  3. 3

    Detén pronto a los usuarios infractores

    Los rechazos repetidos provocan límites de tasa, suspensiones de modelos y cargos por infracción. Con o sin X-End-User-Id, las infracciones cuentan contra tu cuenta, así que filtra el contenido antes de enviar solicitudes a Wokey.

    Cargos por infracción y límites →

  4. 4

    Maneja los errores según el código de estado

    Distingue saldo insuficiente (402), límites de tasa (429) y errores upstream (502, 504, 529), y avisa o reintenta según corresponda. Incluye el encabezado de respuesta x-wokey-request-id cuando contactes a soporte.

    Códigos de error →

  5. 5

    Supervisa el saldo y el uso

    Consulta el saldo de la cuenta con /v1/dashboard/balance, y el uso y el límite restante por clave con /v1/usage y /v1/key. Recarga antes de que se agote el saldo.

    Saldo y uso →

  6. 6

    Elige un proveedor cuando lo necesites

    Cuando un modelo tiene varios proveedores, usa provider en el cuerpo de la solicitud para exigir o excluir proveedores.

    Enrutamiento de proveedores →