B2B (v1)

Demande un service absent du catalogue (lettre, calculateur, outil IA) pour votre organisation (gratuit)

post/v1/requests

Request

  • Base URL: https://api.vitef.com
  • URL: https://api.vitef.com/v1/requests
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Rend la requête rejouable sans effet en double pendant 24 h (UUID v4 recommandé). Même clé et même requête : la première réponse est renvoyée avec Idempotent-Replayed: true, sans nouvel envoi ni nouveau débit. Même clé pour une autre requête : 422 idempotency_key_reused. Requête identique encore en cours : 409 idempotency_in_progress.

Example:6f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87

Request body

kind'letter' | 'calculator' | 'ai_tool' | 'other'

Nature du service demandé : lettre, calculateur, outil IA ou autre.

messagestring required
querystring

Recherche d’origine, si la demande suit une recherche sans résultat.

sourcestring

Page d’où vient la demande (chemin).

emailstring email

Facultatif : prévenu quand le service est en ligne.

Example request

{
  "kind": "calculator",
  "message": "Un calculateur de frais de notaire pour un terrain à bâtir.",
  "query": "frais de notaire terrain",
  "email": "produit@agence.fr"
}

Response

Demande enregistrée

idstring required
kind'letter' | 'calculator' | 'ai_tool' | 'other' required

Nature du service demandé : lettre, calculateur, outil IA ou autre.

messagestring required
querystring
status'new' | 'planned' | 'done' | 'rejected' required

new : reçue ; planned : prévue ; done : en ligne ; rejected : non retenue.

createdAtstring required

Example response

{
  "id": "0287cbed-be47-4c7d-861f-a23a4445e774",
  "kind": "calculator",
  "message": "Un calculateur de frais de notaire pour un terrain à bâtir.",
  "query": "frais de notaire terrain",
  "status": "new",
  "createdAt": "2026-09-24T08:12:03.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.