postFormsData

Criando um objeto de dados de formulário para salvar informações

FormData.postFormsData(data, langCode)

Métodos com uma solicitação POST aceitam como corpo da solicitação um objeto com o campo de dados do formulário, que corresponde ao tipo de informação sendo enviada. Os seguintes são exemplos de objetos de dados de formulário para diferentes tipos de dados.

---

Exemplo com um atributo de tipo simples "string", "number", "float"

{
  "marker": "last_name",
  "type": "string",
  "value": "Nome de Usuário"
}

---

Exemplo com um atributo de tipo simples "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"
  }
}

---

Exemplo com um atributo de tipo simples "text"

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

---

Exemplo com um atributo de tipo simples "textWithHeader"

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

---

Exemplo com um atributo de tipo simples "image" ou "groupOfImages"

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

---

Exemplo com um atributo de tipo simples "files"

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

---

Exemplo com um atributo de tipo simples "radioButton" ou "list"

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

---

Exemplo com atributo de tipo "entity" (lista aninhada)

{
  "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 string para produtos. Identificadores para produtos devem incluir o prefixo 'p-', por exemplo, 'p-1-', 'p-2-', etc. p-[parentId]-[productId]

---

Exemplo com 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 no formato ISO 8601. por exemplo 2025-02-11T16:00:00:000Z

2025 — ano; 02 — mês; 11 — dia do mês; T — separador entre data e hora; 16:00:00 — hora no formato horas:minutos:segundos; 000Z — milissegundos e indicação de fuso horário. Z significa que a hora está especificada no formato UTC.

---

Exemplo

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

const value = await FormData.postFormsData(body)

Esquema (corpo)

formIdentifier: string
Identificador de texto do objeto de formulário (marcador)
exemplo: meu-form

formData: FormDataLangType
Dados enviados pelo formulário
exemplo:

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

fileQuery: objeto
fileQuery para upload de arquivos com o formulário
exemplo:

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

Este método retorna um objeto FormDataEntity criado. Se você quiser mudar o idioma, basta passá-lo como segundo argumento.

Exemplo de retorno:

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

Esquema

id: número
identificador do objeto
exemplo: 1764

formIdentifier: string
Identificador de texto do objeto de formulário (marcador)
exemplo: meu-form

time: Data
Data e hora da modificação do formulário
exemplo: 2025-05-09T18:32:46.834Z

formData: FormDataLangType
Dados enviados pelo formulário
exemplo:

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

.