1. Quizes
Maat.ai API
  • v4
    • Authentication
      • Get AccessToken by Email
    • BlackLists
      • OFAC Generate Report
      • PEPS Generate Report
      • SAT69
      • SAT69-B
    • Dextract
      • Extract information
    • Files
      • Upload file
    • SocialEconomic
      • Generate Report
      • Download PDF
    • SAT
      • Validate RFC
    • Quizes
      • Import answers from API
        POST
  1. Quizes

Import answers from API

POST
/api/v4/quiz/answers/import/api

Importación de Respuestas de Cuestionarios#

Este endpoint realiza una solicitud POST para importar respuestas de cuestionarios y combinarlas con información previamente registrada. La solicitud debe incluir un cuerpo de solicitud en formato JSON con los campos "templates" que representan los cuestionarios destino, "combined_from" para indicar cuestionarios previamente llenados y "answers" para enviar respuestas adicionales.
⚠️ IMPORTANTE: Es necesario enviar correctamente las keys de los cuestionarios en los campos templates y combined_from para evitar errores en el procesamiento#

Ejemplo de Solicitud#

{
    "user_id": 0,
    "templates": [
        "template_key_1",
        "template_key_2"
    ],
    "combined_from": [
        "template_key_from_1",
        "template_key_from_2"
    ],
    "answers": [
        {
            "question": "question_key",
            "answer": "answer text"
        }
    ]
}

Ejemplo de Respuesta#

{
    "data": {
        "combined_from": {
            "failed": null,
            "processed": [
                "template_key_1", "template_key_2"
            ]
        },
        "templates": {
            "failed": [
               "template_key_from_2"
            ],
            "processed": [
                "template_key_from_1"
            ]
        }
    },
    "message": "Answers saved",
    "success": true
}
IMPORTANTE:
Si alguno de los elementos enviados en templates o combined_from no fue procesado con éxito, se reflejará en el nodo failed, en caso contrario se visualizará en el nodo processed dentro de la respuesta.
El nodo combined_from es opcional. En caso de no enviarse, se tomará como única fuente de llenado la información proporcionada en el campo answers para completar los cuestionarios destino.
En caso de error general, la respuesta incluirá el campo code_message, el cual puede variar dependiendo del tipo de error (por ejemplo: invalid_request, server_error).

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Answers imported
application/json
Bodyapplication/json

🟢200Answers not imported
🟠400Invalid request
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/api/v4/quiz/answers/import/api' \
--header 'x-api-key: {{api-key}}' \
--header 'service: {{service}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": 0,
  "templates": [
    "template_key_1", "template_key_2"
  ],
  "combined_from": [
    "template_key_from_1", "template_key_from_2"
  ],
  "answers": [
    {
      "question": "question_key",
      "answer": "answer text"
    }
  ]
}'
Respuesta Ejemplo de Respuesta
200 - Answers imported
{
    "data": {
        "combined_from": {
            "failed": null,
            "processed": [
                "allquizes"
            ]
        },
        "templates": {
            "failed": null,
            "processed": [
                "datos_personales_del_usuario"
            ]
        }
    },
    "message": "Answers saved",
    "success": true
}
Modificado en 2026-05-25 23:26:07
Anterior
Quizes
Built with