Publiez votre profil | Laboratoire collaboratif international de permaculture

La plupart des organisations rejoignent la carte facilement — en l'ajout de votre organisation via notre formulaire, sans aucun code. Cette page s'adresse aux réseaux de permaculture et aux développeurs qui préfèrent publier et héberger leur propre Murmures profils, et de garder leurs données entièrement entre leurs mains.

Ce guide s'adresse aux réseaux et organisations de permaculture régionaux qui souhaitent voir leurs données apparaître sur la carte du CoLab Permaculture International — et, de par son fonctionnement, sur toute autre carte construite sur le Murmures protocole en même temps.

L'idée derrière cela est simple. Vous publiez vos données une fois, dans un format ouvert, et vous les conservez. Nous (et toute autre personne) les rassemblons sur nos cartes. Lorsque vous modifiez vos données, toutes les cartes qui vous référencent sont également modifiées. Vous n'avez jamais à remplir la base de données de quelqu'un d'autre.

Comment ça marche, en trois étapes

1. Décrivez chaque organisation sous la forme d’un PROFIL Murmurations (un petit document JSON)
2. HÉBERGEZ ce profil à une URL stable que vous contrôlez
3. ENVOYEZ l’URL du profil à l’INDEX Murmurations
                        │
                        ▼
   Nous interrogeons l’index à la recherche des balises auxquelles nous faisons confiance → nous récupérons votre profil → celui-ci apparaît sur notre carte

Il n'y a aucun compte à ouvrir chez nous, et aucune clé d'API à surveiller. Vous restez la source de vérité, et l'index ne fait que pointer vers vous.

La seule chose qui vous relie à notre carte : une balise

Notre carte rassemble les profils qui portent une étiquette que nous avons convenue avec vous. Posez-nous des questions pour la balise de votre réseau — quelque chose comme réseau-pc : permaculture-bretagne — et ajoutez-le au profil de votre étiquettes array. Cette balise indique à notre agrégateur : “ ce profil appartient à la carte de la permaculture ”.”

Détenez-vous des données qu'aucun schéma ne couvre encore, comme le type de sol ou les précipitations moyennes ? Jetez un œil Prolonger avec vos propres données plus loin. Notre carte rend automatiquement tout champ documenté, et nous serons heureux de vous aider à le standardiser afin que d'autres réseaux adoptent la même approche.

Préféreriez-vous ne pas écrire de JSON à la main ?

Il n'est pas nécessaire d'écrire du JSON ni de faire tourner un serveur pour participer. Il existe plusieurs façons plus douces d'entrer.

Le plus simple est le nôtre Ajouter votre organisation Remplissez-le, et une fois que l'un de nos modérateurs l'aura consulté, votre organisation apparaîtra sur la carte. Aucun code, aucun hébergement et rien à maintenir par la suite.

Si vous préférez utiliser les outils Murmurations plus larges (qui font partie de MurmurMaps), il existe aussi des options hébergées :

Une organisation — le Générateur de Profils. Remplissez le formulaire web sur https://murmurmaps.murmurations.network/profile-generator, choisissez les schémas, et il héberge à la fois le profil et le soumet à l'index pour vous. Vous obtenez un profil modifiable auquel vous pouvez revenir et mettre à jour, sans avoir besoin de votre propre site web ou serveur.
Un réseau entier à la fois — l'Importateur par lots. Téléverser un CSV à https://murmurmaps.murmurations.network/batch-importer et valide, héberge et soumet chaque ligne. Quelques règles s'appliquent :
- Jusqu'à 1 000 lignes par lot.
- Les la première colonne doit être Oid — un identifiant unique et stable pour chaque organisation que vous ne réaffectez jamais, car c'est ainsi que les mises à jour ultérieures sont mises en correspondance.
- Les en-têtes de colonne doivent correspondre aux noms des champs du schéma exactement. Les champs imbriqués utilisent la notation par points (géolocalisation.lat); les tableaux utilisent la notation entre crochets (balises[0], urls[0].url).
- Pour mettre à jour plus tard, téléchargez à nouveau un CSV révisé avec le même Oids.
Vous avez déjà du JSON hébergé ? — le metteur à jour d'index. Collez une URL de profil à https://murmurmaps.murmurations.network/index-updater soumettre ou actualiser.

Ces outils hébergés sont le moyen le plus simple de commencer, bien qu'ils impliquent que quelqu'un d'autre détient vos données. Héberger le JSON sur votre propre domaine — ce que le reste de ce guide couvre — vous donne le plus de contrôle et la plus forte revendication sur l'entrée de votre propre organisation. Choisissez ce qui correspond à la capacité de votre réseau.

Les schémas

Un profil déclare quelle schémas il suit en schémas_liés. Une organisation de permaculture devrait lier les deux de ceux-ci :

Schéma	But	URL de la bibliothèque
`organisations_schema-v1.0.0`	L'identité de base de tout groupe, projet ou organisation	https://library.murmurations.network/v2/schemas/organizations_schema-v1.0.0
`permaculture_addon_schema-v1.0.0`	Champs spécifiques à la permaculture	https://library.murmurations.network/v2/schemas/permaculture_addon_schema-v1.0.0

`organisations_schema-v1.0.0` champs

Requis : schémas_liés, nom.

Champ	Type	Notes
`schémas_liés`	tableau	Obligatoire. Listez tous les schémas que je relie, par exemple. `["organisations_schema-v1.0.0","permaculture_module_schema-v1.0.0"]`
`nom`	chaîne	Obligatoire. Le nom de l'organisation
`surnom`	chaîne	Nom court ou alternatif
`url_principale`	chaîne	Votre site web. Fortement recommandé — nous l'utilisons pour reconnaître la même organisation sur différents réseaux (déduplication)
`étiquettes`	tableau	Mots-clés et types. Mettez votre balise réseau convenue ici pour que nous te réunissions
`urls`	tableau	Autres liens : `{ "name": "Facebook", "url": "https://…" }`
`description`	chaîne	L'organisation joue un rôle crucial dans la réussite de tout projet ou entreprise. Elle consiste à structurer les ressources, qu'elles soient humaines, matérielles ou financières, de manière efficace pour atteindre des objectifs prédéfinis. Une bonne organisation implique une planification minutieuse, une définition claire des rôles et responsabilités, ainsi qu'une coordination harmonieuse des différentes tâches. Elle permet d'optimiser le temps, de minimiser les gaspillages et d'améliorer la productivité. Sans une organisation adéquate, même les idées les plus brillantes risquent de ne jamais se concrétiser ou de rencontrer des obstacles insurmontables.
`mission`	chaîne	Mission ou objectif
`état`	chaîne (énumération)	`actif` · `achevé` · `annulé` · `en attente` · `en_planification`
`adresse_complète`	chaîne	Adresse postale
`pays_iso_3166`	chaîne (énumération)	Code pays à deux lettres, par exemple. `Royaume-Uni`, `KE`, `DEDANS`
`géolocalisation`	objet	`{ "lat" : , "lon" : }` — a dû apparaître sur la carte
`image`	chaîne	URL du logo
`image d'en-tête`	chaîne	URL de la bannière
`images`	tableau	Plus d'images
`rss`	chaîne	URL du flux RSS
`relations`	tableau	Liens vers d'autres profils Murmurations
`commence à` / `se termine à`	nombre	Horodatages Unix (pour les entités limitées dans le temps)
`coordonnées`	objet	`{ "email": "bonjour@org.example", "contact_form": "https://org.example/contact" }`
`téléphone`	chaîne	Numéro de téléphone
`portée géographique`	chaîne (énumération)	`local` · `régional` · `national` · `international`
`identifiant_unique`	chaîne	Un identifiant stable que vous contrôlez. S'il est présent, nous l'utilisons comme clé de déduplication la plus forte.

`permaculture_addon_schema-v1.0.0` champs

Requis : schémas_liés (déjà traité ci-dessus).

Champ	Type	Notes / valeurs autorisées
`type_organisation`	tableau (énumération)	`Association` · `Réseau` · `Groupe` · `Projet` · `École ou académie de permaculture` · `Organisation ou coopérative de designers en permaculture` · `Autre organisation`
`domaines_permaculture`	tableau (énumération)	`Environnement bâti` · `Culture et Éducation` · `Santé et bien-être` · `Finances et économie` · `Aménagement et gestion des terres et de la nature` · `Régime foncier et gouvernance communautaire` · `Outils et Technologie`
`manières de s'impliquer`	tableau (énumération)	`Adhérer en tant que membre` · `Bénévole` · `Faire un don` · `Visitez-nous` · `Achetez nos produits ou services` · `Inscrivez-vous à nos activités` · `Autres - consultez notre site web ou nos réseaux sociaux pour plus de détails`
`but`	chaîne	Texte libre
`nombre_de_membres`	nombre
`nombre_de_bénéficiaires`	nombre
`portée_géographique_description`	chaîne	Texte libre décrivant votre portée
`leadership_tags`	tableau	Leadership, gouvernance, direction, management, pilotage, impulsion, management d'équipe, management de projet, dynamique de groupe, prise de décision, stratégie, vision, inspiration, motivation, influence, communication, autonomisation, confiance, responsabilité, intégrité, courage, résilience, adaptabilité, innovation, résolution de problèmes, coaching, mentorat, développement des talents, performance, résultats, excellence opérationnelle, culture d'entreprise, changement, transformation, engagement, collaboration, gestion des conflits, éthique, crédibilité, jugement, perspicacité, force de caractère, leadership situationnel, leadership transformationnel, leadership serviteur, leadership authentique, leadership charismatique, leadership d'entreprise.
`date_ajoutée`	nombre	Timestamp Unix

Les valeurs d'énumération doivent correspondre exactement, y compris la casse et l'apostrophe dans des créateurs'. Tout ce qui est en dehors de la liste échouera à la validation.

Un exemple de profil complet

{
  "linked_schemas": [
    "organizations_schema-v1.0.0",
    "permaculture_addon_schema-v1.0.0"
  ],
  "name": "Permaculture Association Britain",
  "nickname": "PAB",
  "primary_url": "https://www.permaculture.org.uk",
  "description": "Association caritative regroupant des membres et soutenant la permaculture à travers toute la Grande-Bretagne.",
  "tags" : ["permaculture", "pc-network:permaculture-britain"],
  "urls": [
    { "name": "Forum", "url": "https://www.permaculture.org.uk/forums" }
  ],
  "country_iso_3166" : "GB",
  "geolocation" : { "lat" : 51,5074, "lon" : -0,1278 },
  "image": "https://www.permaculture.org.uk/logo.png",
  "contact_details": { "email": "hello@permaculture.org.uk" },
  "geographic_scope": "national",
  "status": "active",
  "unique_id": "pab-uk",
  "org_type": ["Association", "Réseau"],
  "permaculture_domains": ["Culture et éducation", "Gestion des terres et de la nature"],
  "ways_to_get_involved": ["Devenir membre", "Faire du bénévolat", "Faire un don"]
}

Les deux schémas liés sont fusionnés en un seul objet plat, c'est pourquoi les champs d'organisation et les champs de complément permaculture se trouvent côte à côte.

Héberger le profil

Servez ce JSON à un URL stable et accessible publiquement que tu contrôles, avec Content-Type : application/json. N'importe lequel de ceux-ci fera l'affaire :

Un fichier statique sur votre site, tel que https://your-org.example/murmurations.json
Un point de terminaison CMS ou une fonction sans serveur qui renvoie le JSON
Un fichier généré dans votre pipeline CI/CD

Si vous publiez beaucoup organisations — un réseau avec des dizaines de membres — donnent à chacune sa propre URL, par exemple https://your-network.example/murmurations/{slug}.json.

Soumission à l'index

Indiquez à l'Index Murmurations où se trouve votre profil. Il le récupérera, le validera et commencera à le proposer aux agrégateurs, y compris à nous.

POST https://index.murmurations.network/v2/nodes
Content-Type : application/json
{ "profile_url" : "https://your-org.example/murmurations.json" }

Une réponse réussie renvoie un id_du_nœud Le SHA-256 de votre profile_url) et un état. Vous pouvez le vérifier à tout moment :

GET https://index.murmurations.network/v2/nodes/{node_id}

Validez d'abord — cela évite bien des ennuis. Vous pouvez vérifier un profil avant vous hébergez ou soumettez quoi que ce soit en envoyant le profil complet JSON au validateur :

  POST https://index.murmurations.network/v2/validate
  Content-Type: application/json
  { …votre profil JSON complet, y compris linked_schemas… }

Il renvoie soit un succès, soit une liste d'erreurs précises, au niveau du champ, chacune avec un pointeur JSON tel que /géolocalisation/lat. Aucun hébergement n'est requis.

Mise à jour. Modifiez votre JSON hébergé, puis soumettre le même profile_url encore — la re-soumission est ce qui fait que l'index recherche à nouveau. Ceci est important : l'index ne vérifie pas les profils sains selon un calendrier, donc une modification de votre fichier n'est pas prise en compte tant que vous ne le renvoyez pas. Renoyer un contenu inchangé ne nuit en rien et ne changera pas votre horodatage.
Suppression. Mettre le profil hors ligne afin que son URL cesse de retourner le JSON 404 est la façon habituelle), puis appeler SUPPRIMER https://index.murmurations.network/v2/nodes/{node_id}. L'index vérifie d'abord l'URL et refusera tant que le profil est toujours servi. Alternativement, définissez un expire champ (un estampille temporelle Unix) dans le profil, et l'index le supprime automatiquement une fois que ce moment est passé. Dans un cas comme dans l'autre, il disparaît alors des cartes qui l'agrègent, y compris la nôtre.

Vous pouvez tout répéter en toute sécurité. Il existe un environnement de test complet — https://test-index.murmurations.network/v2 pour la validation et la soumission, et https://test-library.murmurations.network/v2 pour les schémas — vous pouvez donc essayer des choses sans toucher à la production. Aucun compte ni clé API n'est nécessaire, n'importe où.

Extraits de code

Chaque extrait (a) construit un objet de profil et (b) soumet son URL hébergée à l'index. Adapter le profil à vos propres données, et héberger le JSON sérialisé à URL du profil.

TypeScript / Node

type Geo = { lat : nombre ; lon : nombre } ;
interface PermacultureProfile {
  linked_schemas : chaîne de caractères[] ;
  name : chaîne de caractères ;
  primary_url? : chaîne de caractères ;
  tags? : chaîne de caractères[] ;
  country_iso_3166?: chaîne de caractères;
  geolocation?: Geo;
  org_type?: chaîne de caractères[];
  permaculture_domains?: chaîne de caractères[];
  ways_to_get_involved?: chaîne de caractères[];
  unique_id?: chaîne de caractères;
}
const profile : PermacultureProfile = {
  linked_schemas : ["organizations_schema-v1.0.0", "permaculture_addon_schema-v1.0.0"],
  name : "Permaculture Association Britain",
  primary_url : " https://www.permaculture.org.uk ",
  tags : [" permaculture ", " pc-network:permaculture-britain "],
  country_iso_3166 : "GB",
  geolocation : { lat : 51,5074, lon : -0,1278 },
  org_type : ["Association", "Réseau"],
  permaculture_domains: ["Culture et éducation"],
  ways_to_get_involved: ["Devenir membre", "Devenir bénévole"],
  unique_id: "pab-uk",
};
// 1. Hébergez vous-même JSON.stringify(profile) à cette URL, puis :
const profileUrl = "https://www.permaculture.org.uk/murmurations.json";
// 2. Enregistrez-le dans l'index.
const res = await fetch("https://index.murmurations.network/v2/nodes", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ profile_url: profileUrl }),
});
console.log(res.status, await res.json());

Python

import json
import requests
profile = {
    "linked_schemas": [
        "organizations_schema-v1.0.0",
        "permaculture_addon_schema-v1.0.0",
    ],
    "name": "Permaculture Association Britain",
    "primary_url": "https://www.permaculture.org.uk",
    "tags": ["permaculture", "pc-network:permaculture-britain"],
    "country_iso_3166": "GB",
    "geolocation": {"lat": 51.5074, "lon": -0.1278},
    "org_type": ["Association", "Réseau"],
    "permaculture_domains": ["Culture et éducation"],
    "ways_to_get_involved": ["Devenir membre", "Faire du bénévolat"],
    "unique_id": "pab-uk",
}
# 1. Hébergez ce fichier JSON à une URL que vous contrôlez :
with open("murmurations.json", "w", encoding="utf-8") as f:
    json.dump(profile, f, ensure_ascii=False, indent=2)
profile_url = "https://www.permaculture.org.uk/murmurations.json"
# 2. Soumettez-le à l'index :
res = requests.post(
    "https://index.murmurations.network/v2/nodes",
    json={"profile_url": profile_url},
    timeout=15,
)
print(res.status_code, res.json())

PHP

[
        'organizations_schema-v1.0.0',
        'permaculture_addon_schema-v1.0.0',
    ],
    'name' => 'Permaculture Association Britain',
    'primary_url' => 'https://www.permaculture.org.uk',
    'tags' => ['permaculture', 'pc-network:permaculture-britain'],
    'country_iso_3166' => 'GB',
    'geolocation' => ['lat' => 51,5074, 'lon' => -0,1278],
    'org_type' => ['Association', 'Réseau'],
    'permaculture_domains' => ['Culture et éducation'],
    'ways_to_get_involved' => ['Devenir membre', 'Devenir bénévole'],
    'unique_id' => 'pab-uk',
];
// 1. Hébergez ce fichier JSON à une URL que vous contrôlez :
file_put_contents('murmurations.json', json_encode($profile, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES));
$profileUrl = 'https://www.permaculture.org.uk/murmurations.json';
// 2. Envoyez-le à l'index :
$ch = curl_init('https://index.murmurations.network/v2/nodes');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['profile_url' => $profileUrl]),
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE) . "n" . $response . "n";
curl_close($ch);

Dédoublonnage et transmissions

Si deux réseaux répertorient la même organisation, notre carte les fusionne en une seule entrée et affiche la mis à jour le plus récemment profil. Il les fait correspondre sur un partage url_principale (normalisé) ou un partagé identifiant_unique. Plusieurs choses en découlent :

Toujours régler url_principale, et idéalement identifiant_unique également. C'est ainsi que nous savons que deux entrées correspondent à la même organisation.
Lorsqu'un réseau régional reprend une organisation que le CoLab avait répertoriée comme provisoire, le réseau publie simplement un profil plus récent, et celui-ci devient l'entrée canonique en soi.
Si deux réseaux sont en désaccord sur qui doit référencer une organisation, il n'existe pas d'autorité centrale pour trancher. Le CoLab peut vous aider à en discuter, mais il ne peut pas outrepasser un réseau. En pratique, le mécanisme ci-dessus tend à régler les choses : celui que l'organisation elle-même reconnaît maintient son profil à jour, et c'est le profil le plus récent qui est affiché. Si nécessaire, un opérateur peut également épingler un profil particulier comme étant le canonique sur notre propre carte.

Prolonger avec vos propres données

Détenez-vous des données qu'aucun schéma existant ne couvre – type de sol, précipitations moyennes, zone climatique ? Vous avez trois options, par ordre de préférence.

Une brève note : aujourd'hui permaculture_addon_schema-v1.0.0 n'a aucun champ environnemental ou quantitatif — aucun sol, aucune pluie ni aucun climat. Pour des données comme celles-ci, il n'existe encore aucun champ, donc les options 2 ou 3 s'appliquent.

Réutiliser un schéma partagé s'il en existe déjà un. Naviguer dans bibliothèque premièrement. Si le champ est déjà standardisé, ajoutez simplement ce schéma à votre schémas_liés. Notre carte rend automatiquement tout champ documenté, donc rien ne change de notre côté.

2. Proposer un nouveau schéma partagé — la bonne voie à long terme. C'est ainsi que précipitations_annuelles_moyennes_mm devient un domaine convenu plutôt que cinq incompatibles. En bref : parlez-nous Premièrement, puisque nous gérons les schémas de permaculture et aidons les réseaux à converger vers des noms partagés ; puis bifurquer Bibliothèque de Murmures, ajoutez un fichier de schéma draft-07 sous /schémas/, et ouvrez une pull request vers le test la branche. Elle est mise en ligne dans l'environnement de test lorsqu'elle est fusionnée, et les mainteneurs la promeuvent ensuite test → principal pour la production. Une chose à savoir : vous ne pouvez pas auto-héberger un schéma et pointer schémas_liés à votre propre URL. schémas_liés tient schéma nu Noms, que l'index résout uniquement contre la bibliothèque centrale, de sorte qu'un nouveau champ partagé passe toujours par cette pull request.

Si vous souhaitez un exemple concret — prenant un champ de sol ou de pluie depuis le stade “ aucun champ n'existe ” jusqu'à “ en direct sur la carte ”, avec le fichier de schéma réel et les étapes pour le tester d'abord — Prenez contact et nous vous guiderons.

3. Besoin d'un terrain sur la carte aujourd'hui, avant qu'un schéma n'existe ?** Parce que les schémas n'interdisent pas les propriétés supplémentaires, vous pouvez ajouter vos propres champs à un profil (utilisez des noms en minuscules, séparés par des tirets bas, par exemple. "pluie_annuelle_moyenne_mm": 850et ils passeront la validation et seront stockés. Nos pages de détails affichent déjà ces champs avec une étiquette lisible. Traitez cela comme une solution temporaire uniquement : ces champs ne sont pas validés par le schéma, les autres agrégateurs qui ne lisent que les champs déclarés les ignoreront, et cela repose sur le comportement actuel de l'index qui n'est pas une fonctionnalité garantie. Indiquez-nous les champs supplémentaires que vous utilisez et nous accélérerons leur standardisation dans le cadre de l'option 2.

La convergence, c'est-à-dire que tout le monde cherche à utiliser le même schéma partagé, constitue l'objectif principal. Publiez ouvertement, reliez les schémas partagés, et vos données deviendront utiles bien au-delà de notre seule carte.

Questions que les réseaux demandent souvent

À quelle vitesse mes données apparaissent-elles, et à quelle vitesse les mises à jour sont-elles visibles ? Il y a deux sauts, et tous deux sont basés sur la demande. Premièrement, l'index n'apprend un changement que lorsque vous soumettez à nouveau votre profile_url, car il n'interroge pas les profils sains. Deuxièmement, chaque carte réinterroge l'index selon son propre calendrier — le nôtre se synchronise toutes les heures — de sorte qu'une mise à jour atteint notre carte environ une heure après que vous ayez soumis à nouveau. Il n'y a pas de diffusion globale ; chaque agrégateur extrait.

Comment supprimer quelqu'un ou honorer une demande de “ supprimer mes données ” ? Mettre le profil hors ligne et appeler SUPPRIMER …/v2/nodes/{node_id} Voir Soumission à l'index. Suppression arrêtée nouveau l'agrégation et efface l'index, mais elle ne peut pas rétracter les copies qu'une carte a déjà téléchargées – celles-ci s'effacent lors de la prochaine resynchronisation de chaque carte. Gardez cela à l'esprit avant de publier, les gens.

Puis-je publier des personnes, des projets ou des événements, pas seulement des organisations ? Oui. Murmurations a d'autres schémas, tels que schéma_personnes, et notre carte est indépendante de tout schéma : elle affiche tous les types de profils, avec des filtres disponibles. Mais les données personnelles sont sensibles. L'index est entièrement public ; ne publiez donc que le nom, les coordonnées ou l'adresse d'une personne avec leur consentement explicite, et publier le minimum nécessaire. Les données de l'organisation sont illimitées ; les données des membres et des personnes relèvent de la responsabilité légale du réseau de publication.

Comment le CoLab gère-t-il la confidentialité et le RGPD pour les données il publie ?** Nous appliquons une politique RGPD et une case à cocher de consentement. Le CoLab ne publie les données personnelles des membres du CoLab qui ont explicitement consenti, et uniquement les champs qu'ils ont acceptés. Retirer son consentement est l'interrupteur : lorsqu'une personne se désinscrit, nous cessons de publier ses informations, retirons le profil de la ligne, et — comme tout le processus est rafraîchi toutes les heures — ses données disparaissent des cartes en environ une heure. Nous ne pouvons parler que de la partie nous Publier ; tout autre réseau qui publie des personnes doit exécuter son propre équivalent — une base légale pour publier, une étape de consentement claire et un moyen rapide de se retirer. Murmurations lui-même ne vous donne aucune de ces structures, puisque l'index est simplement public, il doit donc vivre avec le réseau de publication.

Le CoLab publiera-t-il mon organisation sans que je le demande ? Non. Le CoLab ne publie le profil d’une organisation que lorsque celle-ci nous le demande, et uniquement lorsqu’il est lié à la permaculture, le type d’usage pour cette carte. Nous ne collectons ni ne listons des groupes sans y être invités. (Votre propre réseau peut bien entendu publier ses membres sous sa propre étiquette – c’est entre vous et eux.)

Quelles sont les données qui apparaissent réellement ? Sur le site carte: une épingle (qui doit géolocalisation) avec le nom, la localisation et les liens. Dans l'annuaire et sur la page de détails de l'organisation : chaque champ de vos schémas liés, plus les champs supplémentaires éventuels, chacun avec une étiquette lisible.

Et si votre carte — ou l'index — disparaissait ? Vos données sont portables par conception. Vous les hébergez, et vous en êtes propriétaire. Toute carte basée sur Murmurations peut agréger les mêmes profils, vous n'êtes donc jamais bloqué chez nous. C'est la principale raison de publier dans ce format ouvert plutôt que de remplir la base de données privée de quelqu'un.

Qui décide de la balise de mon réseau ? Personne ne possède l'espace de noms des tags — les tags de Murmurations sont du texte libre, et nous ne pouvons pas (et ne voudrions pas) les contrôler. Ce que le CoLab fait, c'est recommander une convention, réseau informatique : (par exemple réseau-pc : permaculture-bretagne), et gardez un registre informel afin que deux réseaux ne choisissent pas accidentellement le même. Posez-nous des questions quel tag utiliser avant de publier. Plus les réseaux adopteront la convention, mieux les données de chacun s'aligneront. Cela fonctionne par collaboration, pas par contrainte.

Ai-je besoin d'un compte ou d'une clé API ? Non — pas avec nous, et pas avec l'index. Le contrôle est prouvé par votre contrôle de l'URL du profil.

Liste de contrôle

Les liens du profil les deux schémas dans schémas_liés
☐ nom est défini ; url_principale est défini (pour la déduplication) ; géolocalisation est défini (pour la carte)
☐ Votre Étiquette de réseau est dans étiquettes
☐ Les valeurs de l'énumération correspondent exactement (type_organisation, domaines_permaculture, manières de s'impliquer, pays_iso_3166, état, portée géographique)
☐ Validé via POST /v2/validate, afin de détecter les erreurs avant la mise en ligne
☐ Le profil est hébergé sur une URL publique stable renvoyant application/json
☐ Le profile_url est soumis à https://index.murmurations.network/v2/nodes
☐ (Optionnel) vérifié par GET /v2/nœuds/{node_id}

Publier votre propre profil

Comment ça marche, en trois étapes

La seule chose qui vous relie à notre carte : une balise

Préféreriez-vous ne pas écrire de JSON à la main ?

Les schémas

`organisations_schema-v1.0.0` champs

`permaculture_addon_schema-v1.0.0` champs

Un exemple de profil complet

Héberger le profil

Soumission à l'index

Extraits de code

TypeScript / Node

Python

PHP

Dédoublonnage et transmissions

Prolonger avec vos propres données

Questions que les réseaux demandent souvent

Liste de contrôle

S'inscrire à notre lettre d'information

Publier votre propre profil

Comment ça marche, en trois étapes

La seule chose qui vous relie à notre carte : une balise

Préféreriez-vous ne pas écrire de JSON à la main ?

Les schémas

organisations_schema-v1.0.0 champs

permaculture_addon_schema-v1.0.0 champs

Un exemple de profil complet

Héberger le profil

Soumission à l'index

Extraits de code

TypeScript / Node

Python

PHP

Dédoublonnage et transmissions

Prolonger avec vos propres données

Questions que les réseaux demandent souvent

Liste de contrôle

`organisations_schema-v1.0.0` champs

`permaculture_addon_schema-v1.0.0` champs