DevSupAi Developer Portal

DevSupAi Developer Resources & API

Accédez aux spécifications machine-readable, aux manifestes d'agents IA (MCP) et à la documentation d'intégration de Locatool Pro conçus par l'équipe technique DevSupAi.

OpenAPI 3.1 (JSON)

Spécification REST complète au format JSON pour Swagger, Postman et les agents IA.

Consulter openapi.json

OpenAPI 3.1 (YAML)

Définition OpenAPI en syntaxe YAML standard, lisible pour les pipelines CI/CD.

Consulter openapi.yaml

MCP Manifest

Manifeste officiel Model Context Protocol pour Claude Desktop, Cursor et Ora.

Consulter mcp.json

Fichier LLMs.txt

Index d'ingestion optimisé pour les modèles de langage et le web sémantique.

Consulter llms.txt

Exemple d'Appel API : Envoi de Document par E-mail

Endpoint : POST /api/email/send-document

cURLBash

curl -X POST https://locatool.devsupai.fr/api/email/send-document \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "organizationId": "org_demo123",
    "to": "client@example.com",
    "subject": "Votre devis de location Locatool Pro",
    "documentHtml": "<h1>Devis #2026-101</h1><p>Matériel réservé...</p>",
    "documentType": "devis"
  }'

TypeScript / Node.jsFetch API

const res = await fetch("https://locatool.devsupai.fr/api/email/send-document", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify({
    organizationId: "org_demo123",
    to: "client@example.com",
    subject: "Votre devis de location",
    documentHtml: "<h1>Devis #2026-101</h1>",
    documentType: "devis",
  }),
});

const data = await res.json();
console.log("Message ID:", data.messageId);

Standard de Réponses d'Erreurs JSON

Gestion des Erreurs pour Agents & Développeurs

Toutes les réponses d'erreur de l'API Locatool Pro renvoient un objet JSON standardisé avec code machine, message explicite, conseil de résolution et lien vers la documentation.

{ "error": { "code": "MISSING_REQUIRED_FIELDS", "message": "Champs requis manquants (organizationId, to, subject, documentHtml, documentType)", "resolution": "Fournissez tous les champs obligatoires dans le corps JSON de la requête.", "documentation_url": "https://locatool.devsupai.fr/openapi.json" } }

Besoin d'aide sur l'intégration ?

L'équipe technique DevSupAi est disponible pour vous accompagner dans vos déploiements et connexions API.

Consulter la Documentation Contacter l'équipe DevSupAi