Informes adicionales
Obtenga datos de informes adicionales: cargas de archivos, respuestas de texto y enlaces públicos
Datos adicionales de informes
Además de las métricas agregadas estándar, SurveyNinja le permite recuperar detalles adicionales sobre los informes: archivos subidos por los encuestados y respuestas de texto para widgets individuales.
Estos endpoints utilizan el UUID público del informe y los identificadores de widgets dentro de él. Esto es conveniente si desea integrar un informe en su sistema, pero ocasionalmente necesita obtener archivos adjuntos "crudos" o respuestas de texto.
Descripción general de endpoints
| HTTP | Endpoint | Propósito |
|---|---|---|
| GET | /quiz/{id}/report/{report_uuid}/files | Obtener archivos de widgets del informe (tipo "file") |
| GET | /quiz/{id}/report/{report_uuid}/inputs | Obtener respuestas de texto para un widget de informe |
Archivos de widgets del informe
El endpoint GET /quiz/{id}/report/{report_uuid}/files devuelve la lista de archivos adjuntos a un widget de tipo file en el informe.
La respuesta incluye los campos url, name y ext para cada archivo.
Parámetros de ruta
id— ID de la encuesta.report_uuid— UUID público del informe.
Parámetros de consulta
| Parámetro | Tipo | Descripción |
|---|---|---|
| widget_id | string | UUID de la pregunta (question_uuid del widget en el informe). |
| widget_hash | string | UUID de la versión del widget (widget_hash en shared_report_widgets). |
| limit | integer | Número de registros (predeterminado: 50). |
| offset | integer | Desplazamiento (predeterminado: 0). |
Respuestas de texto de widgets
El endpoint GET /quiz/{id}/report/{report_uuid}/inputs devuelve respuestas de texto para widgets de tipo input, email, phone, etc.
Parámetros de consulta
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
| widget_id | UUID | — | Filtrar por ID de widget |
| widget_hash | UUID | — | Filtrar por hash de versión del widget |
| limit | integer | 50 | Número máximo de registros |
| offset | integer | 0 | Desplazamiento para paginación |
curl -X GET "https://api.surveyninja.io/api/v3/service/quiz/123/report/abc-report-uuid/inputs?limit=50&offset=0" \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Accept: application/json"