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

Editar un formulario

POST https://api.afer.pro/api/v1/forms/{id}
Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/api/v1/forms/{formularioId}

Cambiar ajustes, abrir o cerrar, y las preguntas.

Solo cambia lo que mandes. Con preguntas va la lista completa en orden: las que llevan preguntaId se actualizan, las nuevas se crean y las que faltan se quitan (si ya tenían respuestas, se retiran conservando los datos, y no se les puede cambiar el tipo). Con anadir_preguntas, se añaden al final.

Admite además cualquier ajuste de crearFormulario (acceso, anonimo, confidencial, fecha_cierre…).

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.

formularioIdstring
obligatorio
El formulario.
preguntasarray
opcional
La lista completa de preguntas.
anadir_preguntasarray
opcional
Preguntas a añadir al final.
estadostring
opcional
abierto para que se pueda responder; cerrado para dejar de aceptar respuestas.

Ejemplo de petición

curl -X POST 'https://api.afer.pro/api/v1/forms/aBc123XyZ' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "estado": "abierto"
}'
<?php

$data = [
  'estado' => 'abierto',
];

$ch = curl_init('https://api.afer.pro/api/v1/forms/aBc123XyZ');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
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',
    'Content-Type: application/json',
]);

$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/forms/aBc123XyZ', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'afer_tk_TU_TOKEN',
    'X-API-SECRET': 'afer_sk_TU_SECRET'
  },
  body: JSON.stringify({
      "estado": "abierto"
  })
});

const resultado = await respuesta.json();

Respuesta

200 · application/json
{
    "errorCode": 200,
    "errorMsg": "",
    "data": {
        "formularioId": "aBc123…",
        "estado": "abierto"
    }
}