Guide : formulaire sans agent
Vos écrans, les listes de Kelki, aucun modèle d'IA. Le parcours reprend celui du formulaire « Rappelez-moi » de kelki.ai : le service, le délai, le lieu, vos coordonnées, puis l'accord.
Les écrans types
- Le service. Métier choisi par la personne (après
POST /trade-matchesou dansGET /trades), puis une prestation deservices. « Autre besoin » (other_need_label) ouvre un champ libreother_needde 3 à 160 caractères. - Le délai. Un libellé de
delays(urgent: truesignale les délais urgents). - Le lieu. Champ « ville ou code postal » →
GET /places?q=…→ la personne choisit un lieu ; gardez sonid. Pas d'adresse précise. - Les coordonnées. Nom (2 à 80 caractères), téléphone au format E.164 valide pour le pays de la demande (
+33639980042), e-mail (il reçoit la confirmation) ; précisions facultatives (message, 2 000 caractères au plus, aucune donnée de santé). - Le récapitulatif et l'accord.
POST /requests, puisrecapet le texte d'accord mot pour mot, case non cochée, puisPOST /requests/{request_id}/confirmation(règles).
Listes fermées
Les valeurs de service et de delay doivent venir exactement des listes du métier, dans la langue de la demande. Une valeur hors liste est refusée :
{
"type": "https://kelki.ai/api/problems/validation_failed",
"title": "Demande invalide",
"status": 422,
"code": "validation_failed",
"errors": [{"pointer": "/service", "detail": "Prestation hors liste pour Plombier.",
"allowed": ["Recherche de fuite", "Réparation de fuite", "Débouchage", "Autre besoin"]}]
}
errors[].pointer désigne le champ ; allowed donne les valeurs acceptées : votre écran peut proposer la correction directement. Le schéma est fermé : tout champ inconnu est refusé.
Les champs de POST /requests
| Champ | Règle |
|---|---|
trade_id | identifiant d'un métier ouvert à l'API |
service | une valeur de services du métier |
other_need | obligatoire avec « Autre besoin » (3 à 160 caractères) |
delay | un libellé de delays |
place_id | identifiant renvoyé par GET /places |
contact | name, phone, email de la personne à rappeler |
message | facultatif, 2 000 caractères au plus, pas de donnée de santé |
reference | facultatif : votre référence (ex. numéro de réservation), sans donnée personnelle |
end_user_ref | facultatif : pseudonyme stable de l'utilisateur chez vous (jamais un e-mail ou un numéro) |
country, lang | facultatifs : FR et la langue principale du pays par défaut |
Corriger un brouillon
PATCH /requests/{request_id} (application/merge-patch+json) au statut draft : le récapitulatif est recalculé, l'accord doit être redonné ensuite. DELETE annule et efface les coordonnées.