GOURVIA pour les développeurs

GOURVIA expose une API publique en lecture seule, décrite par une spécification OpenAPI, ainsi que des fichiers lisibles par les agents (llms.txt, plan du site, négociation Markdown). Cette page explique comment les utiliser. Aucune clé API n'est nécessaire pour les routes publiques.

Spécification OpenAPI

La spécification OpenAPI 3 des routes publiques est disponible au format JSON à l'adresse https://gourvia.online/openapi.json. Elle décrit uniquement les routes publiques en lecture seule ; les routes réservées aux comptes n'y figurent pas.

Démarrage rapide

Repères d'un pays (devise, salaire minimum, types de contrats) : curl -s https://gourvia.online/api/countries/FR

Contenu de l'accueil en Markdown : curl -s -H 'Accept: text/markdown' https://gourvia.online/

Guide pour les agents : curl -s https://gourvia.online/llms.txt

Plan du site : curl -s https://gourvia.online/sitemap.xml

Routes publiques

Les routes sous /api/public/, /api/seo/, /api/blog/ et /api/countries/{CC} sont publiques et en lecture seule. {CC} est l'un des codes pays suivants : FR, BE, CH, ES, DE, GB, CA, US, HT, SN, CI, CM, MA, TN, CD.

Authentification et clés API

Les routes publiques ne demandent ni clé ni compte. Les autres routes de l'API sont réservées aux utilisateurs connectés (candidats, recruteurs, administrateurs) et exigent une authentification. GOURVIA n'émet pas de clés API pour des intégrations tierces à ce jour.

Environnement de test

Il n'existe pas d'environnement bac à sable séparé : les routes publiques sont en lecture seule et sans effet de bord, vous pouvez les appeler directement.

Bonnes pratiques et contact

Respectez le fichier robots.txt, mettez les réponses en cache lorsque c'est possible et limitez la fréquence des appels. Pour une demande d'intégration ou un signalement, écrivez à support@gourvia.online.