API Key de Consulta Única: automatiza tus consultas por API, Google Sheets y sistemas legacy

Si haces consultas a volumen —verificar RFC en el alta de clientes, validar CURP de empleados o revisar el NSS de una cartera completa— hacerlas una por una en la web no escala. Para eso existe tu Clave de consulta (API Key): una llave única que te permite consumir los servicios de Consulta Única sin pasar por la interfaz web, desde tu propio sistema, desde una hoja de cálculo o desde integraciones existentes. La administras desde tu portal, en la sección Ajustes → Clave de consulta.

---

¿Qué es la Clave de consulta?

Es tu llave de acceso programático a los servicios de Consulta Única. Con ella consultas NSS, RFC, CURP, Afore, IFETEL y más, de forma automatizada. El portal la describe como la llave para acceder a nuestros servicios desde tres canales:

• API Rest: integración directa en tus propios sistemas.
• Plantillas de Google Sheets: consultas masivas desde una hoja de cálculo, sin programar.
• Sistemas legacy: integraciones existentes que ya consumen la clave.

Lo importante: el consumo por API descuenta créditos del mismo paquete que usas en la web. Tus créditos son compartidos entre la plataforma y la API, así que administras un solo saldo.

---

Qué puedes hacer desde la página de tu clave

• Ver tu clave: por defecto se muestra solo el prefijo corto y el resto queda oculto, por seguridad.
• Revelar la clave completa: con el botón del ojo. La clave completa no se carga hasta que tú lo pides.
• Copiar: una vez revelada, la copias al portapapeles con un clic.
• Generar una nueva clave: rota tu llave cuando lo necesites (ver más abajo).

---

Generar una nueva clave (rotación)

Si crees que tu clave se vio comprometida —o simplemente quieres rotarla por buena práctica— usa el botón Generar Nueva Clave. Antes de ejecutarlo aparece un modal de confirmación, porque la rotación es inmediata y sin periodo de gracia:

• La clave anterior deja de funcionar de inmediato en todas tus integraciones.
• Generar una nueva clave es también la forma de revocar la anterior.
• Tendrás que actualizar la nueva clave en todos tus canales (API Rest, Google Sheets y sistemas legacy) para que sigan funcionando.

---

Casos de uso

• Onboarding / KYC: verifica RFC, CURP o NSS automáticamente al dar de alta clientes.
• Validación masiva desde Google Sheets: valida datos de facturación de una lista completa sin escribir código.
• Integración en ERP/CRM o sistemas legacy: incorpora consultas en tus flujos actuales.
• Procesos batch: ejecuta validaciones nocturnas contra la API Rest.

Ideal para despachos contables, fintechs, áreas de Recursos Humanos y empresas de verificación de identidad que necesitan consultar a escala.

---

Beneficios

• Una sola llave para tres canales.
• Rotación inmediata si necesitas invalidar la clave.
• Seguridad por defecto: la clave completa solo se revela bajo demanda.
• Escala sin trabajo manual repetitivo en la web.

---

¿Cómo empiezo a integrar?

Los detalles de integración —endpoints, formato de las peticiones y ejemplos por canal— están en nuestra documentación técnica. Si aún no tienes créditos, primero compra un paquete; al completar tu compra recibirás tu Clave de consulta por correo y podrás administrarla desde tu portal.

---

Preguntas frecuentes

¿El consumo por API gasta créditos aparte?

No. La API y la web comparten el mismo paquete de créditos; administras un solo saldo.

¿Puedo tener varias claves?

Administras una llave única. Si necesitas reemplazarla, generas una nueva, lo que invalida la anterior de inmediato.

¿Qué pasa con mis integraciones al rotar la clave?

Debes actualizar la nueva clave en todos tus canales (API Rest, Google Sheets, legacy); la anterior deja de funcionar al instante.

¿Necesito saber programar?

No necesariamente. Con las plantillas de Google Sheets puedes hacer consultas masivas sin escribir código.

---

Administra tu clave

Genera, revela o rota tu Clave de consulta desde tu portal y empieza a automatizar tus consultas a escala.