Llaves y autenticación
Cada petición lleva una llave de API en la cabecera Authorization:
curl https://api.wfskills.com/v1/me -H "Authorization: Bearer hw_test_<your_key>"
Guarda las llaves en tu servidor. Una llave en un navegador o en una app móvil se puede copiar.
Llaves de prueba y de producción
- Una llave de prueba empieza con
hw_test_. Responde las entradas del sandbox y no gasta créditos. - Una llave de producción empieza con
hw_live_. Gasta créditos en cada estimación.
Permisos
| Permiso | Permite |
|---|---|
estimates:write | Crear, responder y borrar estimaciones. |
estimates:read | Leer y listar estimaciones. |
tasks:read | Listar trabajos y regiones. |
usage:read | Leer el uso y el saldo. |
webhooks:manage | Administrar los endpoints de webhook y leer los eventos. |
customers:write | Administrar clientes, con el add-on Registros. |
records:read | Leer registros, con el add-on Registros. |
records:write | Escribir y borrar registros, con el add-on Registros. |
Cada llave creada en el panel trae los cinco primeros permisos, y los tres del add-on Registros cuando la cuenta lo tiene. Una petición sin el permiso que necesita responde 403 con el código scope_missing.
Administra las llaves
Administra las llaves en el panel. Cada cambio pide tu contraseña si no la confirmaste en los últimos 10 minutos.
- Crear: el panel muestra el secreto una sola vez. Guárdalo de inmediato.
- Rotar: recibes una llave nueva con el mismo nombre, permisos y direcciones. La anterior sigue funcionando hasta 7 días.
- Revocar: la llave deja de funcionar al instante. No se puede deshacer.
Restringe una llave a tus servidores
Al crear la llave, anota las direcciones desde las que llaman tus servidores, hasta 10, como IP individuales o rangos CIDR. Una llamada desde otra dirección responde 403 con el código ip_not_allowed. Para cambiar las direcciones, crea una llave nueva. Durante la beta, una llave de producción necesita al menos una dirección.