Integración API Headless (visión general)

Si desea construir su propia interfaz de usuario de evaluación (web/móvil) e integrarse con B5.ly a través de API:

• Referencia interactiva: /developer/b5plus-v2.reference.html
• Especificación OpenAPI: /developer/b5plus-v2.openapi.yaml
• Colección Postman: /developer/b5plus-v2.postman.json
• Guía de integración para socios: /developer/b5plus-partner-headless-guide.md

Flujo de trabajo recomendado:

1. Iniciar sesión de evaluación (v1)
2. Obtener ítems y renderizar preguntas
3. Enviar respuestas y finalizar para obtener resultId
4. Crear reporte pagado (v2) para obtener reportId
5. Obtener JSON del reporte y renderizar resultados

Visibilidad en el portal:

• En el Portal de Socios, puede ver un registro de compras de reportes (débitos de crédito + IDs de reporte + IDs de resultado) en /portal/activity (los IDs de reporte enlazan a la vista del reporte en el portal). Utilice el filtro de Fuente (Todos / Portal / API) y Exportar CSV para conciliación.
• El ID de resultado corresponde al resultId devuelto por el flujo headless (a veces aparece como extResultId / ext_result_id).
• Clientes/Listas/Reportes en el portal están basados en invitaciones/listas; las llamadas headless por API no crean esas filas automáticamente, por lo que los reportes generados por API pueden no incluir nombre/correo/lista/paquete en el portal (cuando aplica, puede mostrarse un marcador como API-<ResultID>).
• Guarde partnerUserRef, resultId y reportId en su sistema si necesita conciliación a nivel de cliente.