API Formulaires

La divulgation progressive des champs de formulaire et la validation des données de formulaire sont prises en charge par notre API d'interaction avec les formulaires (Forms Interaction API).

L'agent de démonstration Transport illustre comment utiliser cette fonctionnalité ; veuillez cliquer sur l'onglet Code pour voir le code YAML de cet agent, et notez son schéma JSON Schema intégré dans output.schema.properties.

Créez une clé API pour utiliser l'API Formulaires en préversion, par exemple avec curl :

curl --no-progress-meter -X 'POST' 'https://api.aish.li/v1/form?agent=demo%2Ftransport' \
  -H 'X-API-Key: sk_...' \
  | jq .

renvoie :

{
  "sessionID": "uXxvDmOLaYkGU0qIMpd359Q",
  "mapForm": {
    "nextQuestion": "Do you need a ride? Just let me know your origin, destination, day and time you're interested in!\n",
    "isFormComplete": false
  }
}

Vous pouvez ensuite utiliser le sessionID renvoyé pour soumettre la saisie de l'utilisateur et valider ou divulguer progressivement les champs restants, par exemple :

curl --no-progress-meter -X 'POST' \
  'https://api.aish.li/v1/form/uXxvDmOLaYkGU0qIMpd359Q?agent=demo%2Ftransport' \
  -H 'X-API-Key: sk_...' \
  -d 'John Doe, de Novello à Barolo' \
  | jq .

qui renverra :

{
  "sessionID": "uXxvDmOLaYkGU0qIMpd359Q",
  "mapForm": {
    "data": {
      "origin_longitude": 7.9258,
      "origin_date_time": "2026-09-26T15:09Z",
      "destination_latitude": 44.6104,
      "origin": "Novello",
      "name": "John Doe",
      "destination": "Barolo",
      "destination_longitude": 7.9414,
      "origin_latitude": 44.5894
    },
    "isFormComplete": true
  }
}