Registro de cambios de la API

Ampliamos la API sin romperla: pueden aparecer en cualquier momento endpoints nuevos, parámetros opcionales nuevos y campos de respuesta nuevos, así que ignora los campos que no conozcas. Nada se elimina ni cambia de tipo sobre la marcha. Todo lo que rompería una integración se anuncia aquí con al menos 12 meses de antelación, con cabeceras Deprecation y Sunset en las operaciones afectadas y un correo a los propietarios de los espacios de trabajo, y la forma antigua sigue funcionando durante todo ese periodo. Las reglas completas están en versiones y retirada de la API.

Las entradas se agrupan en Añadido, Cambiado, Obsoleto y Eliminado. Todavía no se ha marcado nada como obsoleto ni se ha eliminado nada.

2026-11-06

Añadido

• Librerías cliente oficiales para PHP (helpfalcon/helpfalcon-php), Node.js (@helpfalcon/api) y Python (helpfalcon), generadas a partir del documento OpenAPI, y una colección de Postman. Consulta las librerías cliente.
• API de perfiles y eventos en la API compatible con Zendesk, con la forma de la de Zendesk: PUT /zd/api/v2/user_profiles?identifier=, GET /zd/api/v2/users/{user_id}/profiles, POST /zd/api/v2/user_profiles/events, GET /zd/api/v2/users/{user_id}/events y más. Los perfiles de varios sistemas se resuelven en un solo cliente por correo, teléfono o id externo.
• Marketplace de apps: los desarrolladores envían a revisión apps hechas con el framework de apps; los administradores instalan las apps revisadas con un clic.
• Configuración como código: GET y POST /zd/api/v2/helpfalcon/config.yaml descargan y suben los campos, formularios, reglas, SLA y vistas de una cuenta en YAML, con modo de prueba.
• API compatible con Zendesk: actualizar, show_many y borrar usuarios; crear, actualizar, borrar y buscar organizaciones; valoraciones de satisfacción; macros con aplicar; vistas con ejecutar y recuentos; exportación de búsquedas.

1.0.0

• Primera versión pública de la API REST (/api), documentada en la referencia de la API, y de la API compatible con Zendesk (/zd/api/v2).