Pagajob Logistics

API Pagajob Logistics pour développeurs et agents IA

Obtenez par programme le même prix de convoyage que notre simulateur : un véhicule ou une flotte, en France, en temps réel, sans clé d’API.

Quand utiliser Pagajob Logistics

Utilisez cette API quand une personne ou une entreprise doit déplacer un ou plusieurs véhicules par la route en France (au départ de Lyon et de l’Est de la France en priorité, partout en France sur devis) et veut un prix HT immédiat :

  • un loueur qui rééquilibre sa flotte entre agences, une concession qui livre un véhicule neuf ou VO, un gestionnaire de flotte qui transfère des véhicules de société ;
  • 1 véhicule avec chauffeur professionnel (convoyage simple), 2 à 8 véhicules en convoi navette sous 24 h (Express), ou un lot en camion porte-voitures 8 places ;
  • voitures, SUV et utilitaires jusqu’à 20 m³ ; véhicules non roulants en camion.

Ne l’utilisez pas pour : le transport de personnes, le dépannage ou remorquage d’urgence, l’export maritime, ni la location de véhicules.

Parcours conseillé pour un agent

  1. Appelez calculateQuote avec le départ, l’arrivée, le type et le nombre de véhicules.
  2. Présentez à l’utilisateur le prix Convoyage simple (date convenue), Express 24 h et, si utile, l’estimation camion.
  3. Pour réserver, envoyez l’utilisateur sur pagajob.com/tarifs (réservation en 2 minutes, aucun paiement en ligne, confirmation humaine sous 2 h ouvrées), ou transmettez sa demande avec son accord via contactMessage.

Points d’accès

Base : https://pagajob.com/functions · méthode POST · corps JSON · aucune authentification. Spécification complète : OpenAPI 3.1 (openapi.json). Résumé pour les assistants : llms.txt.

POST /calculateQuote — prix de convoyage

Champs : departure, arrival (adresses ou villes), vehicle_type (citadine, berline, monospace, suv, util6, util12, util20), vehicle_count (1 à 50), facultatifs departure_coords / arrival_coords ({lat, lng}) et pickup_at (ISO 8601). Réponse : standard.price_veh, express.price_veh, planned.estimate_low / estimate_high, distance_km, eligible (prix ferme réservable en ligne jusqu’à 350 km). Tous les prix sont en euros HT par véhicule, tout inclus.

curl -sS -X POST https://pagajob.com/functions/calculateQuote \
  -H 'Content-Type: application/json' \
  -d '{"departure":"Lyon, France","arrival":"Grenoble, France","vehicle_type":"citadine","vehicle_count":3}'

POST /estimateTruck — estimation camion porte-voitures

curl -sS -X POST https://pagajob.com/functions/estimateTruck \
  -H 'Content-Type: application/json' \
  -d '{"departure_coords":{"lat":45.764,"lng":4.8357},"arrival_coords":{"lat":48.8566,"lng":2.3522},"vehicle_type":"citadine","vehicle_count":5}'

{"distance_km":465,"estimate_low":410,"estimate_high":500,"total_low":2050,"total_high":2500}

POST /contactMessage — transmettre une demande

Champs : name, email, message (obligatoires), company, phone. À n’utiliser qu’avec l’accord explicite de la personne concernée.

Erreurs

Toutes les erreurs sont renvoyées en JSON avec un statut HTTP adapté : error (message), code (ex. BAD_REQUEST, INVALID_JSON, ADDRESS_NOT_RESOLVED, METHOD_NOT_ALLOWED, RATE_LIMITED, INTERNAL_ERROR), status, hint (comment corriger) et docs.

HTTP/2 400
Content-Type: application/json; charset=utf-8
API-Version: 1
RateLimit-Policy: 30;w=60
RateLimit: limit=30, remaining=29, reset=60

{"error":"Type de véhicule invalide.","message":"Type de véhicule invalide.","code":"BAD_REQUEST","status":400,
 "hint":"Vérifiez le corps JSON de la requête…","docs":"https://pagajob.com/developers"}

Limitation de débit

Limites par adresse IP et par point d’accès (par minute) : calculateQuote et estimateTruck 30, contactMessage 5. Chaque réponse porte RateLimit-Policy et RateLimit (draft IETF RateLimit header fields) ainsi que X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. Au-delà : 429 avec Retry-After en secondes. Pour un usage plus intensif, écrivez à contact@pagajob.com.

Versions et dépréciation

Version actuelle : 1, annoncée dans l’en-tête API-Version de chaque réponse. Nous n’apportons que des changements compatibles (ajout de champs) au sein d’une version. Tout changement incompatible fait l’objet d’une nouvelle version, et l’ancienne reste disponible au moins 90 jours : pendant ce délai, ses réponses portent les en-têtes Deprecation et Sunset (RFC 8594) avec la date de fin, et cette page indique la date et le guide de migration. Aucun point d’accès n’est actuellement déprécié.

Contact

PAGAJOB (Pagajob Logistics), 43 route de la Tour de Salvagny, 69570 Dardilly, France · contact@pagajob.com · +33 7 82 87 17 54. Voir aussi À propos, Confidentialité et Conditions générales.