API Modèles de Champs

Endpoints pour la gestion des modèles de champs réutilisables dans vos services multi-service.

SDK: client.multiService.fieldTemplate

Les modèles de champs permettent de créer des champs de formulaire réutilisables pour vos services. Ils définissent la structure et les contraintes de validation des données collectées lors de la création de rendez-vous.

Endpoints

Lister les modèles

Liste tous les modèles de champs de l’application.


POST /app/{appId}/multi-service/fields/list

Requête

Champ	Type	Requis	Description
`apiKey`	string	Oui	Clé API


curl -X POST https://api.applite.ai/app/{appId}/multi-service/fields/list \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "your_api_key"
  }'

Réponse


{
  "success": true,
  "data": [
    {
      "id": "template_123",
      "appId": "app_id",
      "ref": "quantity",
      "label": "Quantité",
      "description": "Nombre d'unités souhaitées",
      "type": "NUMBER",
      "min": 1,
      "max": 100,
      "minLength": null,
      "maxLength": null,
      "regex": null,
      "required": true,
      "multiplier": true,
      "useSelect": false,
      "options": [],
      "createdAt": "2024-01-15T10:00:00.000Z",
      "updatedAt": "2024-01-15T10:00:00.000Z"
    },
    {
      "id": "template_456",
      "appId": "app_id",
      "ref": "service_type",
      "label": "Type de service",
      "description": null,
      "type": "SELECT",
      "min": null,
      "max": null,
      "minLength": null,
      "maxLength": null,
      "regex": null,
      "required": true,
      "multiplier": false,
      "useSelect": true,
      "options": [
        {
          "id": "opt_1",
          "templateId": "template_456",
          "label": "Standard",
          "value": "standard",
          "description": "Service standard",
          "price": 0
        },
        {
          "id": "opt_2",
          "templateId": "template_456",
          "label": "Premium",
          "value": "premium",
          "description": "Service premium avec priorité",
          "price": 5000
        }
      ],
      "createdAt": "2024-01-10T08:00:00.000Z",
      "updatedAt": "2024-01-10T08:00:00.000Z"
    }
  ]
}

Erreurs

Code	Description
`not-authorized`	Clé API invalide
`app-not-found`	Application non trouvée

Types de champs

Type	Description	Options de validation
`TEXT`	Texte libre	`minLength`, `maxLength`, `regex`
`NUMBER`	Valeur numérique	`min`, `max`
`SELECT`	Liste à choix unique	`options`
`MULTIPLE_SELECT`	Liste à choix multiples	`options`
`EMAIL`	Adresse email	Validation email intégrée
`PHONE`	Numéro de téléphone	Validation téléphone intégrée
`DATE`	Date	-
`ADDRESS`	Adresse postale	-

Multiplicateur de prix

Lorsque multiplier: true, la valeur du champ multiplie le prix de base du service :


Prix total = Prix de base × Valeur du champ multiplicateur + Somme des suppléments d'options