Autenticación | RFCCheck

Cada llamada al API se autentica con una llave API enviada en el encabezado x-api-key. Las llaves están ligadas a una cuenta o a una organización y heredan el plan y saldo de ese propietario.

RFCCheck, CURPCheck e INECheck comparten cuentas: una llave llama a los endpoints de RFC, CURP e INE, en rfccheck.com, curpcheck.com o inecheck.com, y cada llamada se descuenta del mismo plan y saldo.

Generar una llave

Abre Llaves API en tu panel y haz clic en Crear llave. Ponle una etiqueta a la llave para que el tú del futuro pueda distinguir tu llave de CI de tu llave de producción.

Las llaves se muestran una sola vez al crearlas. Copia la tuya a un gestor de secretos (1Password, AWS Secrets Manager, Doppler, .env, los secrets de tu proveedor de CI) antes de cambiar de página. Si pierdes una llave, elimínala y crea una nueva. No hay manera de recuperarla.

Usar una llave

Envía la llave en el encabezado x-api-key en cada solicitud:

curl bash

curl -X POST https://rfccheck.com/v1/rfc/verify \
  -H "x-api-key: rfc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"rfc": "XAXX010101000"}'

JavaScript (fetch) js

await fetch("https://rfccheck.com/v1/rfc/verify", {
  method: "POST",
  headers: {
    "x-api-key": process.env.RFCCHECK_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ rfc: "XAXX010101000" }),
});

Python (requests) python

import os, requests

requests.post(
    "https://rfccheck.com/v1/rfc/verify",
    headers={"x-api-key": os.environ["RFCCHECK_API_KEY"]},
    json={"rfc": "XAXX010101000"},
)

Rotación de llaves

Rota las llaves cuando un compañero deje el equipo o cuando una llave pudo haberse expuesto. El patrón recomendado: crea la nueva llave, despliégala a tu gestor de secretos, cambia el tráfico y después elimina la llave anterior desde el panel.

Llaves de organización

Las llaves creadas dentro de una organización (bajo /org/:slug/api-keys) se cobran contra el plan y saldo de la organización, no contra la cuenta personal de quien las creó. Usa llaves de organización cuando el costo deba atribuirse a un equipo en lugar de a una persona.

Respuestas de error

401 Unauthorized: la llave falta, está mal formada o ha sido eliminada.
402 Payment Required: la llave se autenticó, pero el propietario no tiene créditos restantes ni saldo prepagado.
429 Too Many Requests: límite de tasa excedido. Espera y reintenta.