postFormsData

Creando un objeto para guardar la información de los datos del formulario

FormData.postFormsData(data, langCode)

Los métodos que utilizan una solicitud POST aceptan un objeto en el cuerpo de la solicitud que contiene los campos de datos del formulario, los cuales corresponden al tipo de información que se está enviando. A continuación se presentan ejemplos de objetos de datos de formulario para diferentes tipos de datos.

const value = await FormData.postFormsData(data, langCode);

---

Ejemplo con un atributo de tipo simple "string", "number", "float"

{
  "marker": "last_name",
  "type": "string",
  "value": "Nombre de usuario"
}

---

Ejemplo con un atributo de tipo simple "date", "dateTime", "time"

{
  "marker": "birthday",
  "type": "date",
  "value": {
    "fullDate": "2024-05-07T21:02:00.000Z",
    "formattedValue": "08-05-2024 00:02",
    "formatString": "DD-MM-YYYY HH:mm"
  }
}

---

Ejemplo con un atributo de tipo simple "text"

{
  "marker": "about",
  "type": "text",
  "value": {
    "htmlValue": "<p>Hola mundo</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
}

---

Ejemplo con un atributo de tipo simple "textWithHeader"

{
  "marker": "about",
  "type": "textWithHeader",
  "value": {
    "header": "Título",
    "htmlValue": "<p>Hola Mundo</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
}

---

Ejemplo con un atributo de tipo simple "image" o "groupOfImages"

{
  "marker": "avatar",
  "type": "image",
  "value": [
    {
      "filename": "files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "downloadLink": "http://my-site.com/cloud-static/files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "size": 392585,
      "previewLink": "",
      "params": {
        "isImageCompressed": true
      }
    }
  ]
}

---

Ejemplo con un atributo de tipo simple "files"

{
  "marker": "picture",
  "type": "file",
  "value": [
    {
      "filename": "files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "downloadLink": "http://my-site.com/cloud-static/files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "size": 392585
    }
  ]
}

---

Ejemplo con un atributo de tipo simple "radioButton" o "list"

{
  "marker": "selector",
  "type": "list",
  "value": [
    {
      "title": "rojo",
      "value": "1",
      "extended": {
        "value": "rojo",
        "type": "string"
      }
    }
  ]
}

---

Ejemplo con atributo de tipo "entity" (lista anidada)

{
  "formIdentifier": "entity_form",
  "formData": {
    "en_US": [
      {
        "marker": "entity-marker",
        "type": "entity",
        "value": [25, 32, 24]
      }
    ]
  }
}

Valor - identificadores numéricos para páginas e identificadores de cadena para productos. Los identificadores de productos deben incluir el prefijo 'p-', por ejemplo, 'p-1-', 'p-2-', etc. p-[parentId]-[productId]

---

Ejemplo con atributo de tipo "timeInterval"

{
  "formIdentifier": "reg",
  "formData": {
    "en_US": [
      {
        "marker": "interval",
        "type": "timeInterval",
        "value": [
          [
            "2025-02-11T16:00:00:000Z",
            "2025-02-13T16:00:00:000Z"
          ]
        ]
      }
    ]
  }
}

Valor — un array de arrays de intervalos en formato ISO 8601. Por ejemplo, 2025-02-11T16:00:00:000Z

2025 — año; 02 — mes; 11 — día del mes; T — separador entre la fecha y la hora; 16:00:00 — hora en formato horas:minutos:segundos; 000Z — milisegundos e indicación de zona horaria. Z significa que la hora está especificada en formato UTC.

---

Ejemplo

const body = {
  "formIdentifier": "contact_us",
  "formData": [
    {
      "marker": "last_name",
      "type": "string",
      "value": "Andrey"
    }
  ]
}

const value = await FormData.postFormsData(body)

Esquema (cuerpo)

formIdentifier: string
Identificador de texto del objeto formulario (marcador)
ejemplo: my-form

formData: FormDataLangType
Datos enviados por el formulario
ejemplo:

[
  {
    "marker": "name_field",
    "type": "string",
    "value": "Nombre"
  }
]

fileQuery: object
fileQuery para subir archivos con el formulario
ejemplo:

{
  "type": "page",
  "entity": "editor",
  "id": 3492
}

Este método devuelve un objeto FormDataEntity creado. Si deseas cambiar el idioma, simplemente pásalo como el segundo argumento.

Ejemplo de retorno:

{
  "id": 1764,
  "formIdentifier": "my-form",
  "time": "2025-05-09T18:32:46.834Z",
  "formData": {
    "marker": "name_1",
    "value": "Nombre",
    "type": "string"
  }
}

Esquema

id: number
identificador del objeto
ejemplo: 1764

formIdentifier: string
Identificador de texto del objeto formulario (marcador)
ejemplo: my-form

time: Date
Fecha y hora de modificación del formulario
ejemplo: 2025-05-09T18:32:46.834Z

formData: FormDataLangType
Datos enviados por el formulario
ejemplo:

[
  {
    "marker": "marker_1",
    "value": "Nombre"
  }
]