Aller au contenu principal

Tickets (formulaires publics)

Soumission et suivi de tickets sans authentification. Côté console, les signalements se traitent dans Signalements.

SDK : client.public.tickets.*

Liste des formulaires​

GET /public/tickets/forms?page=1&pageSize=20

Formulaires publics et actifs, paginés (data + meta).

SDK : getForms(params?)

Détail d’un formulaire​

GET /public/tickets/forms/:id

Champs : id, title, description, status, isPublic, cityId, cityGroupId, fields[].

Un champ : id, type (TEXT | NUMBER | CHOICE | MULTIPLE_CHOICE | RATING | DATE | LOCATION | PHOTO | YES_NO), label, required, order, options?, minValue?, maxValue?.

SDK : getForm(id)

Créer un ticket​

POST /public/tickets
Content-Type: application/json
{
  "ticketFormId": "form-uuid",
  "values": [
    { "fieldId": "field-uuid", "value": "Ma réponse", "photoUrl": null }
  ],
  "deviceId": "optionnel",
  "conversationId": "optionnel"
}

Réponse : { "ticket": { ... }, "accessKey": "…" }. Conservez accessKey pour le suivi.

Statuts ticket : OUVERT | EN_COURS | RESOLU | FERME.

SDK : create(data)

Suivi par clé​

GET /public/tickets/:accessKey

SDK : getByAccessKey(accessKey)