Saltar al contenido principal
Envía tu clave de API en el encabezado Authorization de cada solicitud:
Las claves empiezan por vt_. Una clave funciona en cuanto la creas.

Obtener una clave

  1. Regístrate en querying.ai. Las cuentas nuevas empiezan con 500 créditos gratuitos.
  2. Abre Claves de API en el panel y crea una clave.
  3. Copia la clave cuando se muestre. Guárdala en una variable de entorno o en un gestor de secretos.
Una cuenta puede tener hasta 5 claves activas. Reserva un espacio para un reemplazo planificado y mantén ambas claves activas durante el cambio de los clientes:
  1. Crea una clave adicional en el panel con el alcance de motores, el límite diario de créditos y la caducidad necesarios.
  2. Actualiza todos los clientes y la verificación de firmas de webhooks para usar la nueva clave. Comprueba que las solicitudes funcionan; conserva la clave de firma anterior para las entregas de tareas enviadas con ella.
  3. Revoca la clave anterior.
La rotación del panel emite una clave nueva con la misma configuración y revoca la anterior de inmediato. Las solicitudes con la clave anterior devuelven 401; los clientes deben cambiar a la nueva clave para reanudarlas.
Usa la clave solo desde código de servidor. Cualquiera que tenga la clave puede gastar tus créditos. No la incluyas en una app de navegador, una app móvil ni un repositorio público.

Configuración de la clave

Cada clave tiene ajustes opcionales que configuras en el panel: Consulta Créditos y límites para los límites de toda la cuenta.

Qué endpoints requieren clave

Errores

Una clave ausente, mal formada, revocada o caducada devuelve 401. En los endpoints de tareas, lotes e investigación el código es MISSING_API_KEY:
Las tareas que una clave creó antes de revocarse o caducar siguen ejecutándose y se cobran, incluidos los elementos de un lote. Referencia completa de errores: Errores.