api.activar.dev · v1

API de activación — documentación

Genera el ID de confirmación (CID) de activación de Windows y Office con una llamada HTTP. Autenticación por clave Bearer, cobro solo por CID generado, bitácora de cada petición y claves con tope diario configurable.

Base

La API vive en https://api.activar.dev. Todas las respuestas son JSON. El body máximo permitido es de 8 192 bytes y cada petición de CID tiene un límite de 90 segundos de proceso.

Autenticación

La API tiene dos grupos de rutas:

  • Rutas autenticadas (/v1/cid, /v1/balance, /v1/movs, /v1/usage, /v1/topup, /v1/shop/buy) exigen tu clave en el header Authorization: Bearer <tu clave>. Emites y gestionas tus claves en el bot de Telegram (@cidiid_bot, comando /api); cada clave se entrega una sola vez — guardamos solo su hash — y puede rotarse o revocarse cuando quieras.
  • Herramientas públicas gratuitas (/v1/checkkey, /v1/validate-iid, /v1/generate-iid) aceptan un token Turnstile — humano en un navegador — o tu clave Bearer — para integrar desde un servidor, sin Turnstile. El catálogo /v1/shop y los checks /healthz//readyz también son públicos, sin llave ni token.

Identificador de petición

Cada respuesta exitosa lleva un request_id: guárdalo. Es la referencia exacta en la bitácora si necesitas soporte o auditoría de un cobro.

POST /v1/cid

El endpoint principal: entra un ID de instalación (IID), sale el ID de confirmación (CID) que activa Windows u Office por la vía telefónica de Microsoft, sin llamada y sin cuenta Microsoft.

POSThttps://api.activar.dev/v1/cid
# generar un CID
curl -X POST https://api.activar.dev/v1/cid \
  -H "Authorization: Bearer gc_live_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"iid":"00269538026695922170826852518480286383828529569486954"}'

Body

CampoTipoNotas
iidstringEl ID de instalación completo, con o sin guiones. Se valida su checksum; uno inválido se rechaza sin cobro.

Respuesta 200

{
  "ok": true,
  "cid": "012345-678901-234567-890123-456789-012345-678901-234567",
  "blocks": ["012345","678901","234567","890123","012345","678901","678901","234567"],
  "cached": false,
  "source": "soap",
  "charged": 0.1,
  "request_id": "uuid-de-la-peticion",
  "balance": 4.90
}
CampoQué significa
cidEl ID de confirmación listo para teclear en el asistente de activación.
blocksEl mismo CID partido en bloques de 6, como lo pide el asistente.
cachedtrue si el CID ya se había generado antes — se entrega de inmediato y no se cobra de nuevo.
chargedLo cobrado por esta petición, en USD. 0.0 en aciertos de caché.
balanceTu saldo resultante, en USD.

Tiempos

Un acierto de caché responde en milisegundos. Una generación nueva normalmente tarda segundos; el límite duro del sistema es de 90 segundos — si se pasa, responde 503 TIMEOUT sin cobrar y puedes reintentar.

GET /v1/balance

Saldo actual, cap diario y gasto del día (UTC) de tu clave.

# consulta
curl https://api.activar.dev/v1/balance \
  -H "Authorization: Bearer gc_live_TU_CLAVE"
{
  "balance": 4.90,
  "currency": "USD",
  "cap_diario_cents": 500,
  "gastado_hoy_cents": 10
}

GET /v1/usage

Bitácora de consumo de tu clave: las últimas peticiones con su resultado, cobro y duración. Parámetro opcional limit (1–200, default 50).

curl "https://api.activar.dev/v1/usage?limit=20" \
  -H "Authorization: Bearer gc_live_TU_CLAVE"

GET /healthz · GET /readyz

Monitoreo simple. /healthz confirma que el servicio vive; /readyz confirma que la base responde y reporta los slots de generación libres. Ambas públicas, sin autenticación.

Errores

Los errores son JSON estables: {"detail": {"code", "message"}}. Este envelope es el MISMO en toda la API (checkkey incluido). Un 502/503 jamás viene con cobro — si hubo un cobro, la operación ya trae su CID. La lista de códigos:

HTTPCódigoQué significa¿Se cobró?
400IID_INVALIDEl IID no tiene el formato de un ID de instalaciónNo
400IID_CHECKSUM_INVALIDEl IID no pasa la validación de dígito de controlNo
401KEY_MISSINGFalta el header AuthorizationNo
401KEY_INVALIDLa clave no existe o no coincideNo
403KEY_PENDINGLa clave se emitió pero aún no confirmas su entrega por DM en el botNo
403KEY_REVOKEDLa clave fue revocadaNo
402NO_BALANCESaldo insuficiente para el precio del CIDNo
429CAP_DIARIOAlcanzaste el tope diario de gasto de tu claveNo
429RATE_LIMITEDDemasiadas peticiones seguidas — respeta el Retry-AfterNo
409—El IID ya está en proceso por otra petición; espera su resultado o el vencimientoNo
502UPSTREAM_ERRORMicrosoft rechazó la generación; no reintentar en automáticoNo
503BUSYSin slots libres ahora; reintenta con Retry-AfterNo
503TIMEOUTLa generación rebasó 90 s; seguro reintentarNo
503CACHE_UNAVAILABLEEl cache está temporalmente caído; reintentaNo
413PAYLOAD_TOO_LARGEBody mayor a 8 192 bytesNo
Regla de oro del cobro

El cobro es atómico con la entrega: cada petición queda registrada en tu bitácora con su cobro exacto (charged) o con cobro cero si falló. Nunca hay un cobro sin CID ni un CID sin su registro.

Herramientas públicas gratuitas

El validador de claves (/v1/checkkey), el de IDs de instalación (/v1/validate-iid), el generador (/v1/generate-iid) y el lector de capturas por OCR (/v1/ocr/iid) son gratuitos y no tocan tu saldo. Anti-abuso: aceptan un token Turnstile (lo emite el widget de Cloudflare cuando usas la web en un navegador) o tu clave Bearer — si integras desde un servidor, manda Authorization: Bearer <tu clave> y no necesitas Turnstile. El límite anti-abuso depende de cómo entres: por IP (visitante anónimo con Turnstile, ~6/min) o por tu clave (integrador con Bearer, cuota propia por minuto) — una key/sesión no comparte la IP de tu proveedor.

POSThttps://api.activar.dev/v1/checkkey
# una clave
curl -X POST https://api.activar.dev/v1/checkkey \
  -H "Content-Type: application/json" \
  -d '{"key":"AAAAA-BBBBB-CCCCC-DDDDD-EEEEE","turnstile":"<token-turnstile>"}'
# lote (hasta 10)
curl -X POST https://api.activar.dev/v1/checkkey \
  -H "Content-Type: application/json" \
  -d '{"keys":["AAAAA-...","BBBBB-..."],"turnstile":"<token-turnstile>"}'

El veredicto te dice si la clave es válida y cuántas activaciones le quedan, para que la uses de inmediato. Respuesta 200:

{"ok": true, "veredicto": "Válida — 7255 activaciones restantes",
  "detalle": "Clave MAK/volumen con activaciones disponibles",
  "producto": "Office 2024 Pro Plus VL MAK", "error_code": null,
  "remaining": "7255", "usable": 1}

Errores: 400 TURNSTILE_FAIL · 400 CLAVE_INVALIDA · 413 DEMASIADAS_CLAVES · 429 RATE_LIMITED · 503 CHECKKEY_NO_CONFIG.

POSThttps://api.activar.dev/v1/validate-iid
# valida un ID de instalación (54 = Windows, 63 = Office)
curl -X POST https://api.activar.dev/v1/validate-iid \
  -H "Content-Type: application/json" \
  -d '{"iid":"631436-...","turnstile":"<token-turnstile>"}'
{"ok": true, "iid": "631436…7696", "valido": true, "tipo": "office",
  "longitud": 63, "checksum": "ok", "grupos_ok": 9, "grupos_total": 9,
  "motivo": "63 dígitos con dígito de control correcto"}

Errores: 400 TURNSTILE_FAIL · 400 IID_INVALID.

POSThttps://api.activar.dev/v1/generate-iid
# genera un IID BIEN FORMADO (office=63 dígitos | windows=54)
curl -X POST https://api.activar.dev/v1/generate-iid \
  -H "Content-Type: application/json" \
  -d '{"tipo":"office","turnstile":"<token-turnstile>"}'
{"ok": true, "iid": "7261494-9505773-…", "tipo": "office", "longitud": 63,
  "nota": "IID con dígito de control correcto (pasa el validador); NO es el IID de un equipo real: activarlo daría error de Microsoft."}

Errores: 400 TURNSTILE_FAIL · 400 TIPO_INVALIDO.

POSThttps://api.activar.dev/v1/ocr/iid
# sube una captura de la ventana de activación y obtén el IID (54=Windows, 63=Office)
curl -X POST https://api.activar.dev/v1/ocr/iid \
  -H "Authorization: Bearer <tu-key>" \
  -F "file=@captura.png;type=image/png"
# en navegador: manda el token Turnstile igual que las otras herramientas
{"ok": true, "iid": "0017131-4976841-…", "tipo": "office", "longitud": 63,
  "checksum_ok": true, "motor": "multipass", "latencia_ms": 452}

Usa el mismo pipeline de OCR del bot, gratuito y sin tocar tu saldo (como las otras herramientas; el cobro solo ocurre cuando pides el CID con /v1/cid). El IID se te devuelve ya formateado; el chequeo de cifra de control (checksum_ok) te dice si es un Office de 63 dígitos estructuralmente válido. Límite: imagen JPEG/PNG de hasta 5 MiB y 20 MP · cuota de OCR estricta (visitante anónimo ~6/min por IP; integrador con Bearer 3/min por su clave, ya que Tesseract corre en nuestra CPU). Errores: 400 TURNSTILE_FAIL · 400 OCR_UNREADABLE · 400 OCR_AMBIGUOUS · 413 PAYLOAD_TOO_LARGE · 415 UNSUPPORTED_IMAGE · 422 OCR_NO_IID.

El resto de la API

Además de los endpoints de arriba, la v1 ya expone:

  • POST /v1/checkkey — verificación gratuita de claves (Turnstile o Bearer; límite por IP anónimo o por cuota de tu key), con lote de hasta 10 claves. Es el mismo sistema que usa el panel (spec arriba).
  • POST /v1/auth/telegram — login web con el botón de Telegram; devuelve una sesión que usas como Authorization: Bearer sess_….
  • GET /v1/movs — bitácora de movimientos de saldo (recargas y cobros), con el request_id de cada operación.
  • POST /v1/topup — recarga de saldo por Binance Pay, USDT/USDC (BEP-20 y TRC-20) o PayPal.
  • GET /v1/shop · POST /v1/shop/buy — catálogo público de claves y compra con saldo; /v1/shop/buy entrega la clave en la respuesta.
  • GET /v1/shop/dl-pack — descarga del instalador oficial (ZIP) para claves de volumen (MAK/LTSC): setup.exe + configuration.xml + setup.bat, generado al vuelo.
  • POST /v1/validate-iid · /v1/generate-iid — validador y generador de IDs de instalación (spec arriba).
  • POST /v1/ocr/iid — lector de capturas por OCR: sube una imagen y recibe el IID (54=Windows / 63=Office). Gratuito (spec arriba).
Sin cobro si no entrega

La regla de oro aplica a todos: si la respuesta falla con un 502/503 o un error de generación, no hubo cobro (o el CID ya quedó registrado con su cobro). La bitácora /v1/movs es la prueba de cada operación.

Consigue tu clave de API en el bot

Manda /api en el bot: emites tu clave, la recibes por mensaje directo y gestionas sus topes. Tu saldo de Telegram es el mismo que consume la API.