Listar formularios
https://api.afer.pro/api/v1/forms
GET https://api.afer.pro/api/v1/forms
Los formularios de la empresa con su estado, quién responde, enlace y número de respuestas.
Encuestas de satisfacción, evaluaciones, inscripciones… Cada formulario dice quién lo responde (publico, empresa o invitacion), si es anónimo o confidencial, su enlace para responder y cuántas respuestas tiene.
Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →
Este endpoint requiere autenticación. La empresa tiene que tener el módulo de formularios activado (si no, 403). A nombre de una persona, como en el panel: administración y RRHH; los confidenciales, solo RRHH y quien los creó.
Parámetros del cuerpo
El cuerpo de la petición es un objeto JSON con Content-Type: application/json.
estadostringopcional | borrador, abierto o cerrado. |
buscarstringopcional | Texto en el título o la descripción. |
Ejemplo de petición
curl -X GET 'https://api.afer.pro/api/v1/forms' \
-H 'X-API-KEY: afer_tk_TU_TOKEN' \
-H 'X-API-SECRET: afer_sk_TU_SECRET'
<?php
$ch = curl_init('https://api.afer.pro/api/v1/forms');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'X-API-KEY: afer_tk_TU_TOKEN',
'X-API-SECRET: afer_sk_TU_SECRET',
]);
$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/forms', {
method: 'GET',
headers: {
'X-API-KEY': 'afer_tk_TU_TOKEN',
'X-API-SECRET': 'afer_sk_TU_SECRET'
}
});
const resultado = await respuesta.json();
Respuesta
{
"errorCode": 200,
"errorMsg": "",
"data": {
"total": 1,
"formularios": [
{
"formularioId": "aBc123…",
"titulo": "Satisfacción de clientes · octubre",
"estado": "abierto",
"acceso": "publico",
"anonimo": false,
"confidencial": false,
"enlace": "https://prosuite.aferapp.com/formulario/?f=…",
"num_preguntas": 4,
"respuestas": 37
}
]
}
}