API publique AirConcierge

L'API publique AirConcierge permet d'accéder aux fiches publiques de conciergeries en France. Elle est pensée pour une intégration simple et des réponses JSON claires.

Ce que permet l'API

• Rechercher des conciergeries par texte, localisation et services
• Paginer les résultats
• Récupérer une fiche conciergerie par ID
• Consulter le schéma OpenAPI pour les intégrations typées

Endpoints disponibles

• GET /api
  • Retourne l'index API avec ?format=json
  • Redirige les requêtes navigateur vers la documentation localisée
• GET /api/openapi
  • Retourne le schéma OpenAPI 3.1
• GET /api/concierges
  • Liste et filtre les fiches publiques
• GET /api/concierges/{id}
  • Retourne une fiche publique

Paramètres principaux

GET /api/concierges accepte :

• q : recherche texte
• location : filtre de localisation
• services : liste de services séparés par des virgules
• limit : taille de page (max 50)
• offset : décalage de pagination
• lang : en ou fr

Format des réponses

Les réponses de liste incluent :

• data : fiches conciergeries
• pagination : limit, offset, returned, total, hasMore
• language : langue de localisation utilisée

Les champs de profil incluent des informations publiques comme id, businessName, location, services, website, description, rating et reviewCount.

Authentification et erreurs

Les endpoints publics ne nécessitent actuellement pas d'authentification.

Côté client, il faut gérer :

• 429 (limitation de débit)
• 5xx (erreurs serveur temporaires)

OpenAPI et documentation

• Index JSON : /api?format=json
• Schéma OpenAPI : /api/openapi
• Documentation humaine : /en/api et /fr/api

Conclusion

L'API publique AirConcierge offre une interface claire et pratique pour découvrir des prestataires de conciergerie à partir de données publiques structurées.