API RouteProof

Branchez RouteProof à une IA ou à vos logiciels : boutique en ligne, ERP, Zapier, Make, votre site.

1. Obtenir une clé

Dans la console : Réglages › API et assistant IA › Créer une clé. Deux niveaux de droits : Lire et modifier, ou Lecture seulement. La clé (rp_…) n'est affichée qu'une fois. Elle ne donne accès qu'aux données de votre compagnie, et vous pouvez la révoquer en tout temps.

2. Assistant IA (MCP)

RouteProof parle le protocole MCP, compris par Claude, ChatGPT, Cursor et d'autres. Adresse du serveur :

https://ochoafleet.netlify.app/mcp/VOTRE_CLÉ

Ou bien https://ochoafleet.netlify.app/mcp avec l'en-tête Authorization: Bearer VOTRE_CLÉ. Outils offerts : whoami, list_tasks, get_task, create_task, update_task, assign_tasks, cancel_task, list_workers, list_routes, summary.

3. API REST

Base : https://ochoafleet.netlify.app/api/v1. En-tête obligatoire : Authorization: Bearer rp_…. Les réponses sont en JSON et les dates au format AAAA-MM-JJ.

	Chemin	Rôle
GET	/me	Compagnie, date du jour, nombre d'employés actifs et de tâches ouvertes
GET	/tasks	Liste. Filtres : date, from, to, status (open, unassigned, assigned, in_progress, completed, failed, cancelled), worker, q, limit (300 max). Sans filtre : les tâches du jour.
GET	/tasks/{id ou code}	Détail complet avec la preuve (photos, signature, GPS) et l'historique
POST	/tasks	Créer une tâche. L'adresse est géocodée automatiquement.
PATCH	/tasks/{id}	Modifier une tâche qui n'est pas terminée
POST	/tasks/{id}/cancel	Annuler une tâche pas encore commencée ({"reason": "…"})
POST	/assign	{"ids": [...], "worker": "nom ou id"}. Sans worker : désassigne.
GET	/workers	Employés actifs : statut en service, dernière position, avancement du jour
GET	/routes?date=	Routes du jour
GET	/summary?from=&to=	Bilan d'une période : tâches par statut et par employé, échecs avec leur raison

Créer une tâche

curl -X POST https://ochoafleet.netlify.app/api/v1/tasks \
  -H "Authorization: Bearer rp_VOTRE_CLÉ" -H "Content-Type: application/json" \
  -d '{
    "code": "CMD-1042",
    "type": "dropoff",
    "address": "1500 boul. Taschereau, Longueuil, QC J4K 2X9",
    "date": "2026-10-20",
    "instructions": "Laisser à la réception",
    "recipient_name": "Marie Tremblay",
    "recipient_phone": "514 555-0101",
    "worker": "Marc"
  }'

Champs acceptés :

• address (obligatoire) ;
• code, type, date, instructions, address_notes ;
• recipient_name, recipient_phone, recipient_email ;
• worker, complete_after, complete_before (ISO 8601), quantity ;
• lat et lon, si vous voulez sauter le géocodage.

Valeurs de type : installation, retrait, verification, nettoyage, graffiti, dropoff, pickup, retour, autre.

Erreurs et limites

• 401 : clé invalide ou révoquée.
• 403 : clé en lecture seule, ou essai terminé.
• 404 : introuvable.
• 429 : plus de 120 requêtes par minute.
• 400 : donnée invalide. Le message dit quoi corriger.

Le corps d'une erreur a toujours la forme {"error": "…"}.

Besoin d'aide ?

514 623-8065 · juandavid@groupeochoainc.com