updateFormsDataByid

Met à jour des données de formulaire par ID. 🔐 Cette méthode nécessite une autorisation.

Description

Met à jour un enregistrement de données de formulaire soumis et renvoie l'enregistrement mis à jour sous forme d'IUpdateFormsData.

Passez les nouveaux champs dans body.formData, indexés par code de langue : { formData: { en_US: [...] } }. Contrairement à postFormsData(), cette méthode n'enveloppe pas formData par locale à votre place ; un tableau plat est stocké tel quel, et l'enregistrement n'apparaît alors plus dans getFormsDataByMarker() pour cette langue. Sans formData, l'API renvoie 400 ("Provide a valid formData").

Seul formData est pris dans le corps ; les autres champs sont ignorés. L'heure de l'enregistrement et, pour les formulaires autres que de notation, son auteur sont définis à partir de l'appelant. Seul l'utilisateur qui a soumis l'enregistrement peut le mettre à jour ; les autres reçoivent 403.

.updateFormsDataByid(

,

);

Schéma des paramètres

Schema

id(required): number
ID des données du formulaire.
exemple : 1

body: object
Champs à mettre à jour : formData, indexé par code de langue. Sans formData, l'API renvoie 400.

Exemples

Exemple minimal

// 1. auth
const authData = [
  {
    marker: 'email',
    value: 'john@example.com',
  },
  {
    marker: 'password',
    value: '123456',
  },
];
await AuthProvider.auth('email', {
  authData,
});
// 2. update your form data record by id
const result = await FormData.updateFormsDataByid(
  1621, // FormData ID.
  {
    formData: {
      en_US: [
        {
          marker: 'name',
          type: 'string',
          value: 'John Smith',
        },
      ],
    },
  },
);

Exemple de réponse

{
  "id": 1621,
  "formIdentifier": "test-form",
  "time": "2026-10-28T07:18:30.456Z",
  "formData": {
    "en_US": [
      {
        "marker": "name",
        "type": "string",
        "value": "John Smith"
      }
    ]
  },
  "userIdentifier": "john@example.com",
  "entityIdentifier": "blog",
  "parentId": null,
  "fingerprint": null,
  "isUserAdmin": false,
  "formModuleId": 2
}

Schéma de réponse

Schéma : IUpdateFormsData

id: number
ID de l'enregistrement de données de formulaire.
exemple : 12345

formIdentifier: string
Marqueur du formulaire.
exemple : "contact_form"

time: string
Date et heure de l'envoi.
exemple : "2023-10-01T12:00:00Z"

formData: FormDataType[]
Champs du formulaire indexés par code de langue, par exemple { en_US: [...] }.

userIdentifier: string
Identifiant (login) de l'utilisateur qui a envoyé le formulaire.
example: "john@example.com"

entityIdentifier: string
Identifiant de l'entité.
exemple : "blog"

parentId: null | number
ID de l'enregistrement parent.
exemple : null

fingerprint: null | string
Empreinte de l'appareil de l'expéditeur.
exemple : null

isUserAdmin: boolean
Indique si l'enregistrement a été envoyé par un administrateur.
exemple : false

formModuleId: number
ID du module de formulaire.
exemple : 2

---