Base URL https://api.afer.pro Referencia aferapp.com Reservar demo

Listar formularios

GET https://api.afer.pro/api/v1/forms
Alias en castellano (v0, sigue operativo): 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.

Autenticación

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.

estadostring
opcional
borrador, abierto o cerrado.
buscarstring
opcional
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

200 · application/json
{
    "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
            }
        ]
    }
}