API de données

L’API ne fournit pas encore de données. Tant qu’elle n’est pas ouverte, toute requête est refusée, aucune clé n’est délivrée et rien de ce qui figure sur cette page n’est assuré de fonctionner. Cette page décrit ce qui sera proposé.

Un point d’accès par comparaison (mobile, internet, tv, phone). Il renvoie les offres que meconomy.ch affiche avec une preuve conservée, chacune avec sa source et le lecteur indiqué dans evidence.reader : parser (MEconomyBot, depuis la page du fournisseur), official (une source officielle) ou human (une personne lors d’un relevé accompagné).

Non inclus : les prix saisis à la main, les autres comparaisons, le texte propre du fournisseur et les fichiers de preuve conservés. Lorsqu’un chiffre n’est pas indiqué, le champ vaut null, ce qui signifie « non indiqué », et non « aucun ».

Demandez-la par la page de contact avec le sujet « Clé API », en indiquant l’organisation ou le projet et l’usage prévu. Les clés sont gratuites et délivrées par MEconomy. Une clé est délivrée par organisation ou par projet.

Gardez la clé secrète et sur un serveur. Les requêtes depuis une page de navigateur ne sont pas prises en charge : l’API n’envoie aucun en-tête CORS, et une clé dans le code d’une page est visible de toute personne qui ouvre la page.

Envoyez une requête GET avec la clé dans l’en-tête Authorization. Le seul paramètre est provider, facultatif, un slug de fournisseur. Une clé dans l’adresse est refusée.

curl -H "Authorization: Bearer mek_your-key" \
  "https://meconomy.ch/api/v1/mobile/offers?provider=example"

La forme d’une réponse, chaque champ étant indiqué par son type ; l’exemple ne contient aucune valeur. Le corps a le format meconomy-offers-v1, l’heure de génération, le nombre d’offres, le nombre d’offres écartées parce qu’un enregistrement n’a pas passé nos contrôles, la licence et le périmètre.

{
  "format": "meconomy-offers-v1",
  "vertical": "<mobile | internet | tv | phone>",
  "provider": "<string | null>",
  "generated_at": "<string>",
  "count": "<integer>",
  "withheld": "<integer>",
  "licence": {
    "id": "CC-BY-4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "MEconomy, meconomy.ch"
  },
  "scope": "<string>",
  "offers": [
    {
      "offer_id": "<string>",
      "provider": "<string>",
      "vertical": "<string>",
      "plan_name": "<string>",
      "currency": "<string>",
      "price_unit": "<string>",
      "price": "<number>",
      "price_after": "<number | null>",
      "promo_kind": "<string>",
      "promo_months": "<integer | null>",
      "valid_until": "<string | null>",
      "offer_until": "<string | null>",
      "list_price": "<number | null>",
      "setup_fee": "<number | null>",
      "setup_fee_promo": "<number | null>",
      "setup_fee_after": "<number | null>",
      "initial_free_months": "<integer | null>",
      "min_term_months": "<integer | null>",
      "condition_kind": "<string>",
      "availability_scope": "<string>",
      "now": {
        "price": "<number>",
        "price_after": "<number | null>",
        "display": "<string>",
        "cheapest_eligible": "<boolean>"
      },
      "evidence": {
        "source_url": "<string>",
        "read_at": "<string>",
        "last_checked_at": "<string>",
        "evidence_sha256": "<string>",
        "parser_version": "<string>",
        "reader": "<string>"
      }
    }
  ]
}

• 600 appels par jour et par clé. Le compteur repart à 00:00 UTC.
• Les réponses 200 et 429 portent RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset (secondes jusqu’à la remise à zéro) ; les autres erreurs n’en portent pas.
• Lorsque la limite est atteinte, la réponse est 429 avec Retry-After.

Une erreur a la forme {"error": {"code": "…", "message": "…"}} avec le statut ci-dessous.

Les données sont sous licence CC BY 4.0. Mentionnez « MEconomy, meconomy.ch » avec un lien vers https://meconomy.ch partout où vous les affichez. Les prix sont des faits tels que nous les avons relevés au moment indiqué ; ils peuvent changer à tout instant, et la page du fournisseur fait foi. Aucune garantie. Nous pouvons révoquer une clé partagée, revendue ou utilisée au-delà de sa limite.

Pour chaque clé, nous conservons le nom de l’organisation ou du projet, une adresse e-mail de contact, l’usage indiqué et un décompte quotidien des appels par comparaison ; aucune adresse IP et aucun contenu de requête. Nous les conservons tant que la clé est active. 12 mois après la révocation d’une clé, nous effaçons le nom, l’adresse e-mail de contact et l’usage ; les décomptes quotidiens restent. Plus de détails dans la déclaration de protection des données.

La version 1 ne fait que gagner des champs. Une modification qui en supprime ou en renomme un devient la version 2, annoncée sur cette page 90 jours à l’avance.