Aller au contenu

API publique. Les infos du site, en JSON.

Profil, offres, réalisations, articles, avis et contact : tout ce que publie vp-prog.ch, en lecture seule, pour vos outils, vos intégrations ou vos assistants IA.

v1URL de basehttps://vp-prog.ch/api/v1Spécification OpenAPI

Console

Choisissez un endpoint et envoyez une vraie requête.

GET /api/v1?lang=fr
Exemple de réponse · Les listes sont abrégées à leur premier élément dans ces exemples.
{
  "data": {
    "name": "VP Prog API",
    "version": "1",
    "description": "Applications sur mesure pour PME en Suisse romande.",
    "documentation": "https://vp-prog.ch/api",
    "openapi": "https://vp-prog.ch/api/v1/openapi.json",
    "endpoints": [
      {
        "method": "GET",
        "path": "/api/v1",
        "url": "https://vp-prog.ch/api/v1",
        "summary": "API index: name, version, endpoints and links to the documentation."
      }
    ]
  },
  "meta": {
    "lang": "fr",
    "version": "1"
  }
}

Référence

  • GET /api/v1

    Index de l’API : nom, version, endpoints et liens vers la documentation.

    lang
    Langue des textes : fr (par défaut) ou en. Sinon, l’en-tête Accept-Language est utilisé.
  • GET /api/v1/profile

    Vincent Porret et VP Prog : rôle, parcours, lieu et liens publics.

    lang
    Langue des textes : fr (par défaut) ou en. Sinon, l’en-tête Accept-Language est utilisé.
  • GET /api/v1/services

    Les offres, avec leur prix de départ en CHF (à confirmer pour chaque projet).

    lang
    Langue des textes : fr (par défaut) ou en. Sinon, l’en-tête Accept-Language est utilisé.
  • GET /api/v1/projects

    Les études de cas clients.

    lang
    Langue des textes : fr (par défaut) ou en. Sinon, l’en-tête Accept-Language est utilisé.
  • GET /api/v1/projects/{slug}

    Une étude de cas.

    lang
    Langue des textes : fr (par défaut) ou en. Sinon, l’en-tête Accept-Language est utilisé.
    slug
    Identifiant de l’étude de cas, tel que listé par /projects. Exemple : villars-seminaires
  • GET /api/v1/posts

    Les articles du blog, du plus récent au plus ancien.

    lang
    Langue des textes : fr (par défaut) ou en. Sinon, l’en-tête Accept-Language est utilisé.
  • GET /api/v1/posts/{slug}

    Un article du blog.

    lang
    Langue des textes : fr (par défaut) ou en. Sinon, l’en-tête Accept-Language est utilisé.
    slug
    Identifiant de l’article, tel que listé par /posts. Exemple : automatiser-nest-pas-simplifier
  • GET /api/v1/reviews

    Les avis Google, cités mot pour mot dans leur langue d’origine, et leur nombre total.

    lang
    Langue des textes : fr (par défaut) ou en. Sinon, l’en-tête Accept-Language est utilisé.
  • GET /api/v1/contact

    Comment me joindre : page de contact et lien de prise de rendez-vous.

    lang
    Langue des textes : fr (par défaut) ou en. Sinon, l’en-tête Accept-Language est utilisé.

Erreurs :400 paramètre invalide · 404 introuvable · 405 méthode non autorisée · 429 trop de requêtes

Utilisation

  • Gratuite, sans clé

    Lecture seule, GET uniquement. Ouverte à tous les sites (CORS), sans cookie ni donnée personnelle.

  • Limite de débit

    Une limite douce par adresse IP protège le service. Au-delà, l’API répond 429 avec l’en-tête Retry-After.

  • Stable

    Rien de cassant dans la v1 : un changement incompatible partira dans une v2, sous une autre URL.

  • Cache

    Les réponses sont mises en cache une heure et portent un ETag : renvoyez-le avec If-None-Match pour recevoir 304.

Un besoin d’intégration ?

Relier vos outils à vos données, c’est mon métier. Parlons de votre projet.

Me contacter