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 headerAuthorization: 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/shopy los checks/healthz//readyztambié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.
# 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
| Campo | Tipo | Notas |
|---|---|---|
| iid | string | El 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
}
| Campo | Qué significa |
|---|---|
| cid | El ID de confirmación listo para teclear en el asistente de activación. |
| blocks | El mismo CID partido en bloques de 6, como lo pide el asistente. |
| cached | true si el CID ya se había generado antes — se entrega de inmediato y no se cobra de nuevo. |
| charged | Lo cobrado por esta petición, en USD. 0.0 en aciertos de caché. |
| balance | Tu 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:
| HTTP | Código | Qué significa | ¿Se cobró? |
|---|---|---|---|
| 400 | IID_INVALID | El IID no tiene el formato de un ID de instalación | No |
| 400 | IID_CHECKSUM_INVALID | El IID no pasa la validación de dígito de control | No |
| 401 | KEY_MISSING | Falta el header Authorization | No |
| 401 | KEY_INVALID | La clave no existe o no coincide | No |
| 403 | KEY_PENDING | La clave se emitió pero aún no confirmas su entrega por DM en el bot | No |
| 403 | KEY_REVOKED | La clave fue revocada | No |
| 402 | NO_BALANCE | Saldo insuficiente para el precio del CID | No |
| 429 | CAP_DIARIO | Alcanzaste el tope diario de gasto de tu clave | No |
| 429 | RATE_LIMITED | Demasiadas peticiones seguidas — respeta el Retry-After | No |
| 409 | — | El IID ya está en proceso por otra petición; espera su resultado o el vencimiento | No |
| 502 | UPSTREAM_ERROR | Microsoft rechazó la generación; no reintentar en automático | No |
| 503 | BUSY | Sin slots libres ahora; reintenta con Retry-After | No |
| 503 | TIMEOUT | La generación rebasó 90 s; seguro reintentar | No |
| 503 | CACHE_UNAVAILABLE | El cache está temporalmente caído; reintenta | No |
| 413 | PAYLOAD_TOO_LARGE | Body mayor a 8 192 bytes | No |
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.
# 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.
# 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.
# 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.
# 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_idde 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/buyentrega 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).
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.