AlchemyCode API docs

Changelog

Historial de versiones del contrato público. Los cambios incompatibles se anuncian con al menos 90 días de anticipación y se publican en una nueva versión de ruta (/v2).

v1.0.0 · 31 de octubre de 2026

Primera versión pública 31 oct 2026 beta por invitación

Servicios publicados

Plataforma

  • Autenticación con API keys ck_live_ / ck_test_, scopes y rotación.
  • Empresas por cuenta con e.firma y credenciales IMSS/Infonavit cifradas (envelope, DEK por cuenta).
  • Trabajos asíncronos con 202, polling, wait hasta 25 s, cancelación y retención de 72 h.
  • Webhooks firmados con HMAC SHA-256 y reintentos con backoff (6 intentos, timeout 10 s).
  • Errores application/problem+json con code estable y request_id.
  • Medición por cuenta, empresa y servicio; consumo de IA (tokens y costo estimado) separado.
  • Sandbox determinista con llaves ck_test_.
  • OpenAPI 3.1 en /openapi.yaml.

Notas de beta

  • El acceso es sólo por invitación; el registro público está cerrado.
  • Sin costo durante la beta. El consumo se mide en unidades; los precios de lista (Starter, Growth, Enterprise) están preparados pero no se cobran.
  • Plan inicial: Invitación · Beta con 2,000 unidades al mes, 60 rpm + 10 de ráfaga y 5 empresas.
  • El sandbox consume cuota: sus datos son simulados, pero las unidades se descuentan.
  • La disponibilidad comprometida en beta es 99.5 % mensual, con mantenimientos programados avisados en Estado.
  • Los eventos job.succeeded y job.failed están activos; job.canceled, quota.threshold y credential.expiring están declarados en el contrato y se habilitarán durante la beta.

Compatibilidad

  • Los campos nuevos son aditivos: tu cliente debe ignorar campos desconocidos.
  • Retiramos un campo o cambiamos su tipo sólo en una versión mayor de la ruta.
  • Los códigos de error no se renombran; si un código cambia de significado, se publica uno nuevo.
  • Los límites de plan pueden subir sin aviso; bajarlos se anuncia con 30 días.

Historial

VersiónFechaCambios
v1.0.02026-10-31Primera versión pública: 8 servicios, empresas, llaves, trabajos y webhooks.
Para reportar un problema de contrato (no de un caso particular) escribe a equipo@alchemycode.dev con el endpoint y la versión. Los casos operativos se atienden con el request_id.