Respuesta · Autenticación · Claves
Autenticación de la API de cuotas Pinnacle
Respuesta: en REST (/v1/*) y MCP, envía tu clave como x-api-key: ps_live_..., Authorization: Bearer ps_live_... o ?key=ps_live_.... El WebSocket (/v1/stream) lee la cabecera x-api-key o ?key=; no lee una cabecera Bearer. Mejor la cabecera: las URL acaban en los logs. Guía completa: docs/authentication.
curl#
curl -H "x-api-key: $PINNFEED_KEY" https://pinnfeed.io/v1/account
Respuestas de error#
| Respuesta | Causa |
|---|---|
401 missing_key | No enviaste clave |
401 invalid_key | Clave desconocida o revocada |
403 plan_lacks_ws | Clave Free u Hobby en /v1/stream |
cierre 4001 key_revoked | Revocaste la clave con el socket abierto |
Buenas prácticas#
- Una clave por app o entorno; Free admite una clave activa y los planes de pago hasta 20.
- La clave completa se muestra una sola vez; PinnFeed solo guarda un hash y el prefijo.
- Nunca pongas la clave en código de navegador o de app móvil: usa un backend propio.
- Para rotar: crea la nueva, despliégala y revoca la antigua.
Builder (€99/mes) para WebSocket e histórico de cierre. Prueba de 3 días; se requiere tarjeta y se cobra después del día 3 salvo que canceles. REST gratis: registro.
Contenido educativo para mayores de 18 años.
Preguntas frecuentes#
¿Una sola clave para REST y WebSocket?#
Sí. El límite REST por segundo es por clave; las conexiones WebSocket y los deportes son por cuenta.
¿Dónde roto las claves?#
En el panel → claves API: crea, renombra o revoca.
¿Puedo ver una clave otra vez?#
No. Si la pierdes, crea otra y revoca la anterior.