HubMix

Documentation

Données des annonces et attribution

Ce que vous recevez des annonces collectées selon leur source, l’attribution et le lien obligatoires, la durée de conservation et comment un éditeur retire ses annonces.

Quand une question porte sur des emplois, des logements, des événements ou des cours, Gaspard répond avec des annonces collectées sur les sites publics de leurs auteurs (employeurs, régies, agendas, catalogues de cours) et les renvoie sous forme de cartes (listings). Ces annonces restent le travail de leurs auteurs : les textes et les photos sont protégés par le droit d’auteur, les coordonnées des personnes par la loi sur la protection des données (nLPD), et la loi contre la concurrence déloyale (LCD, art. 5 let. c) interdit de reprendre le résultat du travail d’autrui par un procédé technique. C’est pourquoi chaque source a un niveau de redistribution qui décide de ce que vous recevez par l’API.

Les trois niveaux #

Niveau Ce que vous recevez Exemples
internal Rien : ces annonces ne sortent jamais de HubMix, ni en carte, ni dans la réponse de Gaspard Sources dont les conditions interdisent toute reproduction, sources retirées à la demande de leur auteur
facts Les faits seulement, avec le lien et l’attribution (voir ci-dessous) Le niveau par défaut : sites des régies, des employeurs, agendas
full Tout le contenu, avec le lien et l’attribution Flux envoyés par une régie partenaire sous accord écrit, contenus sous licence libre (manuels OpenStax CC BY, Wikipédia CC BY-SA)

Chaque carte indique son niveau dans redistribution. Vous ne recevez jamais internal.

Les champs d’une carte #

Champ facts full
title, kind, url, source_name, attribution ✓ ✓
city (localité, jamais la rue) ✓ ✓
organisation (nom de l’employeur, de la régie, de l’organisateur) ✓ ✓
starts_at, deadline (début, délai de postulation, disponible dès) ✓ ✓
price (loyer, salaire ou prix, sous forme de montant) ✓ ✓
detail (type, taux, pièces, surface, catégorie, lieu) ✓ ✓
summary (extrait de la description) — ✓

Au niveau facts, une carte ne contient jamais la description rédigée par l’auteur, ses photos, le nom, l’e-mail ou le téléphone d’une personne de contact, ni l’adresse exacte. Un salaire écrit en toutes lettres (« selon expérience… ») n’est pas un montant : price est alors vide.

Gaspard applique la même règle à ce qu’il écrit : pour une annonce facts, il ne lit que ces faits, il ne peut donc ni citer ni paraphraser la description. Pour le reste, il renvoie à l’annonce d’origine.

JSON
{
  "kind": "housing",
  "title": "Studio meublé proche du campus",
  "url": "https://www.exemple-agence.fr/location/lyon-1234",
  "source_name": "Agence Exemple",
  "attribution": "Source : Agence Exemple",
  "redistribution": "facts",
  "city": "Lyon",
  "organisation": "Agence Exemple",
  "deadline": "2026-11-01",
  "price": "680 EUR/mois",
  "detail": "studio, 1 pièce, 22 m²",
  "summary": null
}

Les passages de la base de connaissances #

POST /knowledge/search suit les mêmes niveaux : un passage d’une source facts arrive avec son titre, sa source et son lien, mais un text vide ; affichez le titre et renvoyez vers la source. Les passages full (Wikipédia) gardent leur texte : respectez leur licence (source.licence, CC BY-SA 4.0 : attribution et partage dans les mêmes conditions).

Vos obligations #

  • Pas de copie durable. Gardez une carte au plus 24 heures. Au-delà, redemandez-la à Gaspard ; une annonce qui n’est plus renvoyée (expirée, retirée, source passée en internal) doit disparaître de votre application.
  • Pas d’extraction en masse. L’API sert à répondre à vos utilisateurs, pas à constituer ou revendre une base d’annonces : n’interrogez pas Gaspard pour aspirer le catalogue.
  • Pas de complément. N’ajoutez pas aux cartes facts ce qu’elles ne contiennent pas (description, photos, contacts) en le récupérant ailleurs.
  • Le niveau peut changer. Une source peut passer de full à facts, ou être retirée : lisez redistribution à chaque réponse plutôt que de le supposer.

Retirer mes annonces #

Vous publiez des annonces (régie, employeur, organisateur) et ne voulez pas qu’elles soient transmises aux développeurs qui utilisent Gaspard ? Écrivez-nous à contact@dealmood-solutions.com en indiquant l’adresse de votre site. Votre source passe au niveau internal dès le traitement de la demande : vos annonces ne sortent plus par l’API, ni en carte, ni dans les réponses de Gaspard.

Vous souhaitez au contraire que vos annonces soient diffusées en entier (descriptions et photos comprises), ou nous envoyer un flux (IDX, JSON, RSS) ? Le niveau full demande un accord écrit : contactez-nous à la même adresse.