Saltar al contenido principal

Términos de la API y un código de error nuevo

Cambios que no rompen la versión 2026-10-05.

Estimaciones asíncronas y webhooks

Cambios que no rompen la versión 2026-10-05. Nada cambia para una petición que no pide lo nuevo.

  • POST /v1/estimates y los seguimientos aceptan mode: async. La respuesta es 202 con status: processing, y la estimación termina en segundo plano. Consulta Estimaciones asíncronas.
  • Una estimación puede tener ahora el estado processing o failed, y una fallida trae error. Los dos ocurren solo con mode: async.
  • Los endpoints de webhook reciben eventos firmados: estimate.completed, estimate.failed, credits.low, credits.exhausted, api_key.rotated, api_key.expiring, api_key.suspicious_activity y webhook.test. Consulta Webhooks.
  • Operaciones nuevas: /v1/webhook_endpoints con prueba y rotación del secreto, y /v1/events con reenvío. Necesitan el permiso webhooks:manage, que ahora traen todas las llaves creadas en el panel, también las que ya existían.
  • Entradas nuevas del sandbox: sandbox:async y sandbox:failed.
  • Códigos de error nuevos: webhook_url_rejected, webhook_endpoint_limit y event_not_redeliverable.
  • Los códigos de error y los estados de una estimación pueden crecer. Trata un código de error que no conozcas por su estado HTTP, y un estado que no conozcas como no terminado.

El add-on Registros

Cambios que no rompen la versión 2026-10-05. Las cuentas sin el add-on Registros no ven ningún cambio.

  • /v1/customers guarda a tus clientes finales, con el teléfono y el correo cifrados. Cada estimación puede nombrar uno en customer_id, y GET /v1/customers/{id}/estimates las lista. Consulta Registros.
  • /v1/records/{collection}/{id} guarda cualquier objeto JSON de hasta 64 KB con tu propio id. Gana la escritura con el updated_at_ms más reciente.
  • Permisos nuevos: customers:write, records:read y records:write. Las llaves los ganan al activar el add-on.
  • Una estimación ligada a un cliente responde con customer_id. Las que no tienen uno responden igual que antes.
  • Código de error nuevo: records_cap_reached, al pasar de 50,000 clientes y registros en un entorno.

Pasos más claros, en inglés y en español

Cambios que no rompen la versión 2026-10-05. Ningún campo cambia.

  • steps[].text llega en el idioma de locale cuando hay traducción: español para es, es-MX y es-ES, con números en el formato del país.
  • locale_fallback vale en solo cuando al menos una línea llegó en inglés.
  • En inglés, steps[].text usa el plural de la unidad y dice "labor hours", como en "Rate: $72.00/hr, going rate for fence work". Las cifras no cambian.
  • Las cuatro respuestas sandbox: con estado 200 son ahora copias de lo que devolvió el estimador para descripciones reales de estos trabajos.
  • tenant_suspended responde con el título "Account suspended" y model_unavailable con "Estimator unavailable". Lee code, no title.
  • El contrato declara las cabeceras de respuesta y le pone una etiqueta a cada operación.
  • GET /v1 responde sin llave, con la versión actual y los enlaces a la documentación y al contrato.
  • Cada detail de error dice ahora qué hacer después.

Versión 2026-10-05

La primera versión de la API de estimaciones en https://api.wfskills.com/v1.

  • POST /v1/estimates cotiza un trabajo desde texto, una conversación o hasta cuatro fotos.
  • POST /v1/estimates/{id}/follow-up responde la pregunta de una estimación con estado needs_detail.
  • GET, DELETE y la lista de estimaciones; GET /v1/tasks, /v1/regions, /v1/usage, /v1/balance y /v1/me.
  • Las llaves test responden ocho entradas del sandbox y no gastan créditos.