postFormsData

Creando un objeto de datos de formulario que guarda información

FormData.postFormsData(data, langCode)

Los métodos con una solicitud POST aceptan como cuerpo de la solicitud un objeto con el campo de datos del formulario, que corresponde 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.

---

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": "Titular",
    "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 — 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 fecha y 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 de 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 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 de 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"
    }
  ]

.