Winkstec Perú API

Autenticación

Cada petición lleva tu clave en la cabecera Authorization.

Authorization: Bearer wk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Buenas prácticas

  • Úsala sólo desde tu servidor. Una clave en el JavaScript de una web o dentro de una app la puede copiar cualquiera. La API no responde a peticiones de navegador (no hay CORS) por esa razón.
  • Una clave por sistema. Si una se filtra, revocas sólo esa.
  • Restringe por IP las claves de producción si tu servidor tiene IP fija. Desde otra IP responderá 403 ip_no_permitida.
  • Te avisamos por correo cada vez que se crea una clave en tu cuenta.

Errores de autenticación

CódigoEstadoQué pasó
clave_faltante401No enviaste la cabecera Authorization.
clave_invalida401La clave no existe, fue revocada o tu correo no está confirmado.
ip_no_permitida403La clave está restringida a otras IP.
cuenta_suspendida403La cuenta fue suspendida. Escríbenos.
demasiados_intentos429Diez claves inválidas seguidas desde tu IP la bloquean 15 minutos.