Guía de API keys: autenticación X-API-Key y facturación prepago por llamada

Las llamadas de desarrollador de ChefSphere se autentican con un X-API-Key en modelo estilo Firebase: presentas la clave, invocas una superficie de módulo y consumes tokens prepago de un saldo compartido. Esta guía trata higiene de claves, entornos y atribución — no SKUs de packs solos, ni pesos relativos de consumo entre módulos. Esos temas viven en tokens prepago de API y facturación multi-módulo con tokens para que cada URL mantenga intención distinta para buscadores y para tu revisión de seguridad.

Durante el acceso anticipado solicitas acceso, revisamos y las claves llegan con el onboarding cuando los packs estén disponibles para tu caso de uso. Priorizamos builders activos para que la capacidad de onboarding se mantenga enfocada.

Trata las claves como contraseñas: guárdalas en gestores de secretos, nunca las commits en binarios móviles o repos públicos, y rota cuando alguien deje el equipo. Separa claves por entorno cuando el onboarding las proporcione, para que una integración de staging filtrada no drene el saldo prepago de producción de un día para otro. Registra identificadores de clave para soporte sin registrar secretos completos en pipelines de analytics que se convierten en el incidente de mañana.

Cada llamada autenticada consume tokens según los pesos publicados de operación, desde lecturas baratas de catálogo hasta visión por IA, KYC y escrituras de checkout más pesadas. La atribución por clave es cómo detectas un job descontrolado; el tamaño del pack es cómo financias capacidad empezando en 29 $ por 200.000 tokens. Los tokens no usados permanecen en el saldo, pero una clave filtrada puede gastarlos rápido si no vigilas.

Combina esta guía con packs prepago cuando finanzas pregunte cuánta capacidad comprar, y con facturación multi-módulo cuando ingeniería pregunte qué llamadas dominan el consumo. Combínala con acceso anticipado para desarrolladores cuando necesites la ruta de solicitud explicada. La documentación ilustrativa puede mostrar formas de header; contratos de producción y claves reales siguen al acceso.

Hasta conceder el acceso anticipado, diseña clientes contra muestras OpenAPI ilustrativas y un modelo de amenazas claro de dónde vivirán las claves después. No conviertas rutas de muestra en supuestos de producción, ni inventes listas de endpoints que contradigan las superficies de módulo comercializadas. Cuando abra el acceso, compra un pack, recibe claves y llama entre módulos en un ledger sin recomprar medidores.

Las conversaciones Enterprise desde 300 $/mes pueden incluir límites dedicados y pesos personalizados, pero siguen presumiendo manejo disciplinado de claves. Un pack más grande no perdona una clave pegada en un canal de Slack. Solicita acceso anticipado con tus entornos esperados y si necesitas claves separadas para staging y producción desde el día uno.

La gestión aburrida de claves es una feature: checklists cortos de onboarding superan esquemas de auth custom ingeniosos que tu equipo móvil no puede rotar bajo presión. Prefiere posesión server-side de claves siempre que sea posible; si un cliente debe llamar directamente, asume que la clave filtrará y planifica rotación. Las revisiones de seguridad van más rápido cuando tu historia coincide con el modelo X-API-Key estilo Firebase que comercializamos en lugar de inventar gateways paralelos.

Las guías relacionadas sobre tokens prepago, facturación multi-módulo y acceso anticipado para desarrolladores completan el camino desde solicitud hasta primera llamada atribuida. Si estás listo, solicita acceso anticipado y cuéntanos qué módulos llamarás primero para que el aprovisionamiento de claves coincida con la realidad. Te contactamos por email cuando abra el onboarding.