API Demandes de devis

Cette API permet à n'importe quel site web (landing page, site vitrine, formulaire de contact…) d'envoyer une demande de devis directement dans la base Requests de Cleaning Service. Chaque demande est enregistrée, rattachée automatiquement à un prospect, et une tâche commerciale de suivi est créée.

Endpoint

Envoyez une requête POST avec un corps application/json. Le CORS est ouvert (Access-Control-Allow-Origin: *), l'appel peut donc être effectué directement depuis le navigateur du visiteur.

Authentification

Aucun token n'est nécessaire : l'endpoint est public pour faciliter l'intégration côté site tiers. La provenance est identifiée automatiquement grâce au domaine émetteur (voir Sources automatiques). Une protection anti-bot par honeypot est en place (voir Anti-spam).

Sources automatiques (le domaine émetteur)

Chaque demande est rattachée à une source : le domaine du site qui l'a envoyée. Si ce domaine n'existe pas encore, il est créé automatiquement dans la base des sources — aucune configuration préalable n'est nécessaire.

Le domaine est déterminé dans cet ordre de priorité :

1. le champ source_domain du corps JSON (recommandé), ex. cleanoffice.ch
2. sinon, le domaine extrait de source_url
3. sinon, l'en-tête HTTP Origin
4. sinon, l'en-tête HTTP Referer

Champs acceptés

Tous les champs sont optionnels sauf qu'il faut fournir au moins un moyen de contact (email ou phone). Les champs inconnus sont conservés tels quels dans raw_json.

Exemples

cURL

# Envoi d'une demande de devis
curl -X POST https://api.cs-sa.ch/public/quote-requests \
  -H "Content-Type: application/json" \
  -d '{
    "source_domain": "cleanoffice.ch",
    "name": "Marie Dupont",
    "email": "marie@exemple.ch",
    "phone": "+41 79 123 45 67",
    "company": "Exemple SA",
    "service": "Nettoyage de bureaux",
    "city": "Genève",
    "postal_code": "1200",
    "surface": "250 m2",
    "message": "Bonjour, je souhaite un devis pour l'entretien de nos bureaux."
  }'

JavaScript (fetch)

await fetch("https://api.cs-sa.ch/public/quote-requests", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    source_domain: "cleanoffice.ch",
    name: form.name.value,
    email: form.email.value,
    phone: form.phone.value,
    service: form.service.value,
    message: form.message.value,
    source_url: location.href
  })
});

Formulaire HTML prêt à coller

Exemple complet de formulaire de demande de devis, avec envoi en JavaScript et champ honeypot.

<form id="devis">
  <input name="name" placeholder="Nom" required />
  <input name="email" type="email" placeholder="Email" required />
  <input name="phone" placeholder="Téléphone" />
  <input name="service" placeholder="Prestation souhaitée" />
  <textarea name="message" placeholder="Votre message"></textarea>
  <!-- honeypot anti-bot : garder caché en CSS -->
  <input name="company_website" tabindex="-1" autocomplete="off"
         style="position:absolute;left:-9999px" />
  <button type="submit">Demander un devis</button>
</form>

<script>
document.getElementById("devis").addEventListener("submit", async (e) => {
  e.preventDefault();
  const f = e.target;
  const payload = Object.fromEntries(new FormData(f).entries());
  payload.source_domain = location.hostname;
  payload.source_url = location.href;
  const r = await fetch("https://api.cs-sa.ch/public/quote-requests", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(payload)
  });
  if (r.ok) { f.reset(); alert("Merci ! Votre demande a bien été envoyée."); }
  else { alert("Une erreur est survenue, réessayez."); }
});
</script>

Réponses

201 · Succès

{
  "ok": true,
  "id": 42,
  "source": "cleanoffice.ch",
  "prospect_id": 18,
  "task_id": 143
}

400 · Contact manquant

{
  "error": "missing_contact",
  "message": "Un email ou un téléphone est requis."
}

Anti-spam (honeypot)

Ajoutez un champ caché nommé company_website à votre formulaire, masqué en CSS (ex. position:absolute;left:-9999px). Un humain ne le remplira jamais ; un robot oui. Si ce champ est rempli, la demande est silencieusement ignorée (réponse 201 mais rien n'est enregistré) — cela évite d'alerter le bot.

Que se passe-t-il après l'envoi ?

1. 1 La source (le domaine émetteur) est retrouvée ou créée automatiquement.
2. 2 La demande est enregistrée dans la base Requests (payload complet conservé).
3. 3 Un prospect est créé (ou réutilisé si l'email/téléphone existe déjà).
4. 4 Une tâche commerciale de suivi (priorité haute) est générée.
5. 5 La demande apparaît dans le manager (menu Demandes) et dans l'app vendeurs (onglet Alertes).