• a [[thing]].
  • See [[go/agora server/git]] for implemented endpoints, in particular app/agora.py.
  • Back here on [[2023-12-16]] thinking of [[markdown on git]] and what comes next.
    • I think this has to do with the [[Fediverse]]: how to share it and integrate it together.
    • And, more generally, with [[what we choose to do with the Internet]].

agora bridge api§

• [[agora bridge]] offers an api to write to the agora.
  • pull the [[stoa]]

• [[2022-06-09 00:27:03]] [[@flancian:matrix.org]] (link):
  • I think a form sounds reasonable, but if we can build it quickly on top of the belated [[agora bridge api]], that’ll leave us with a nice base to build other stuff on top of it

• [[BrigitteDietz@ohai.social]] https://ohai.social/@BrigitteDietz/109359779223006109 pull

• In [[Google Cloud]]:
  • #go https://console.cloud.google.com/apis/credentials/consent?authuser=1&project=anagora
  • #push [[oauth]]
    • nice [[oauth 2.0 playground]]
      • https://developers.google.com/oauthplayground/#step2&url=https%3A%2F%2Fgrumpygamer.com%2Freturn_to_monkey_island&content_type=application%2Fjson&http_method=GET&useDefaultOauthCred=unchecked&oauthEndpointSelect=Google&oauthAuthEndpointValue=https%3A%2F%2Faccounts.google.com%2Fo%2Foauth2%2Fv2%2Fauth&oauthTokenEndpointValue=https%3A%2F%2Foauth2.googleapis.com%2Ftoken&includeCredentials=unchecked&accessTokenType=bearer&autoRefreshToken=unchecked&accessType=offline&prompt=consent&response_type=code&wrapLines=on
      • https://developers.google.com/oauthplayground/#step3&url=https%3A%2F%2Fgrumpygamer.com%2Freturn_to_monkey_island&content_type=application%2Fjson&http_method=GET&useDefaultOauthCred=unchecked&oauthEndpointSelect=Google&oauthAuthEndpointValue=https%3A%2F%2Faccounts.google.com%2Fo%2Foauth2%2Fv2%2Fauth&oauthTokenEndpointValue=https%3A%2F%2Foauth2.googleapis.com%2Ftoken&includeCredentials=unchecked&accessTokenType=bearer&autoRefreshToken=unchecked&accessType=offline&prompt=consent&response_type=code&wrapLines=on
    • #push [[bearer token]]
      • ‘Authorization: [[Bearer]]‘:
        • https://datatracker.ietf.org/doc/html/rfc6750
        • [[authentication schemes]] https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication

• [[flancian@social.coop]] https://social.coop/@flancian/111641933443720886 pull

• [[2023-12-25 16:11:52+00:00]] @[[flancian@social.coop]] (link):

  • unofficial [[bard api]]: https://github.com/dsdanielpark/Bard-API

    [[amazing bard prompts]]: https://github.com/dsdanielpark/amazing-bard-prompts

• [[flancia.org]]: https://bsky.app/profile/did:plc:xu4fhdxwmrptiwfvq5ymbkxx/post/3kw37bm7jqb23 pull

• [[flancia.org]]: https://bsky.app/profile/did:plc:xu4fhdxwmrptiwfvq5ymbkxx/post/3kws5n46mav2g pull

• [[jonny@neuromatch.social]] https://neuromatch.social/@jonny/109634869235794426 pull

Get : Récupérer des informations§

Depuis l’API vous avez la possibilité de récupérer différentes informations en provenance de Communecter :

• [citoyens] Citoyen
• [organizations] Organisation
• [projects] Projet
• [events] Événement
• [needs] Besoin
• [news] News

Récupérer toutes les entités§

/ph/communecter/data/get/type/[projects || citoyens || organizations || events || needs || news]

Exemple : /ph/communecter/data/get/type/organizations/

Pour voir la description du résultat aller dans la rubrique [[https://github.com/pixelhumain/communecter/wiki/5—-Doc-de-l’API#les-attributs]]

Paramétrer la recherche§

Vous avez la possibilité d’ajouter des paramètres pour peaufiner votre recherche :

• [id] Identifiant
• [tags] Tags
• [insee] Code Insee
• [format] Format

Récupérer une entité via son identifiant§

/ph/communecter/data/get/type/(projects || citoyens || organizations || events || news)/id/[id_entity]

Exemple : /ph/communecter/data/get/type/organizations/id/57186ed894ef47210d7b242d

Rechercher par tags§

Vous avez la possibilité de paramétrer la recherche des entités en fonctions des tags. Vous pouvez ajouter plusieurs tags qui devront être séparé par une virgule. Par défauts, si vous avez mis plusieurs tags, il suffit pour l’entité d’avoir un de ces tags pour être affiché. Si vous souhaitez que l’entité possède tout les tags alors il faut mettre le paramètre suivant : /multiTags/true

Exemple :

• /ph/communecter/data/get/type/organizations/tags/NuitDebout
• /ph/communecter/data/get/type/organizations/tags/NuitDebout,Commun
• /ph/communecter/data/get/type/organizations/tags/NuitDebout,Commun/multiTags/true

Rechercher par Insee§

Si vous connaissez le code Insee de votre commune, vous pouvez faire une recherche via ce code Insee. Exemple : /ph/communecter/data/get/type/organizations/insee/33402

Formats§

L’API prend en compte différents formats pour le résultat. Par défaut, c’est le format que propose Communecter. Nous prenons aussi en comptes les formats suivant :

• SCHEMA /ph/communecter/data/get/type/organizations/format/schema
• PLP /ph/communecter/data/get/type/citoyens/format/plp
• RSS /ph/api/news/get/format/rss
• KML /ph/api/event/get/format/kml
• GEOJSON /ph/api/person/get/format/geojson
• CSV /ph/api/person/get/format/csv

Attention certains formats ne retourne pas forcement toutes les entités, voici la liste pour chaque format.

COMMUNECTER

• [citoyens] Citoyen
• [organizations] Organisation
• [projects] Projet
• [events] Événement
• [needs] Besoin
• [news] News

SCHEMA

• [citoyens] Citoyen
• [organizations] Organisation
• [projects] Projet
• [events] Événement
• [needs] Besoin
• City
• [news] News

PLP

• [citoyens] Citoyen

KML

• [citoyens] Citoyen
• [organizations] Organisation
• [projects] Projet
• [events] Événement
• [needs] Besoin
• City
• [news] News

GEOJSON

• [citoyens] Citoyen
• [organizations] Organisation
• [projects] Projet
• [events] Événement
• [needs] Besoin
• City
• [news] News

CSV

*[organizations] Organisation

Les attributs§

Ici, vous aurez la description de tout les attribues des différentes entités qui sont retournés via l’API.

Format Communecter§

Exemple : meta :

• limit Nombre d’entités retournée
• next url retournant la suite des entités
• previous url retournant la liste précédente des entités

entities toutes les entités en leurs identifiants en clé

• name Nom de l’entité
• image Url de l’image de profil de l’entité
• urlCommunecter Url de la fiche de l’entité sur Communecter
• urlApi Url qui retourne les informations d’une entité via l’API
• address
  • streetAddress Numéro et nom de la rue
  • postalCode Code postal
  • addressLocality Nom de la commune
  • addressCountry Nom du Pays
  • codeInsee Code Insee de la commune
• geo
  • latitude
  • longitude
• geoPosition Autre format pour la position géographique de l’entité
• shortDescription Courte description de l’entité
• description Description de l’entité.
• email L’email de l’entité.
• phone L’ensemble des numéros de téléphones de l’entité ( fixe, mobile et fax)
• socialNetwork L’ensemble des liens vers les autres réseaux sociaux de l’entité
• tags Tous les tags associés à l’entité
• links Les différents liens que l’entité a avec les autres :
  • memberOf Liste des organisations dont l’entité est membre
  • projects Liste des projets dont l’entité contribue
  • events Liste des événements dont l’entité est invitée ou participe
  • followers Liste des citoyens dont l’entité suit.
  • members Liste des citoyens membres de l’entité.
  • needs Liste des besoins de l’entité.

Convert : Récupérer des données en onthologie PH§

Depuis l’API, vous avez la possibilité de convertir les données sous différents format que vous possédez directement en onthologie PH.

• [geojson] GeoJson

• [wikipedia] Json issu de l’API de Wikidata

• [datagouv] Json issu de l’API de Data.gouv

• [osm] Json issu de l’API de Open Street Map

• [ods] JSon issu de l’API de OpenDataSoft (on intéroge uniquement la base SIRENE)

• [datanova] Json issu de l’API de Datanova

• [poleemploi] Json issu de l’API de Pôle Emploi

• [educstruct] Json issu de l’API de ScanR(structures de recherche)

• [educetab] Json issu de l’API de ScanR (établissements impliqués dans la recherche)

• [educmembre] Json issu de l’API de ScanR (membre des universités de France)

• [educecole] Json issu de l’API de ScanR (école doctorales accrédités)

Obtenir l’ontologie ph pour un type d’élément donnée via une url§

/ph/communecter/api/convert/geojson/type/[organizations || citoyens || events || projects]?url="http://votreurl"

Exemple : `/ph/communecter/api/convert/type/organizations?url=http://umap.openstreetmap.fr/en/datalayer/276610/

Cas particuliers : les Umap§

L’API permet de convertir les données geojson d’une umap donné via la paramètre "url"

Exemple : /ph/communecter/api/convert/type/organizations?url=http://umap.openstreetmap.fr/fr/map/carte-pour-faire-des-tests_62176#13/44.7825/-0.3700

On peut aussi mettre en paramètre l’url courte d’une umap (visible en appuyant sur le bouton partager à gauche de la umap):

Exemple : /ph/communecter/api/convert/type/organizations?url=http://u.osmfr.org/m/62176/

Attention pour le moment, il faut que l’url soit en "http" et non pas en "https", retirez le "s" si tel est le cas.

Obtenir l’ontologie ph pour un type d’élément donnée via un fichier§

Il faut envoyer à l’API le paramètre "file" via méthode POST. (en utilisant curl ou RESTED par exemple)

Obtenir l’ontologie ph pour une url intérrogeant une API externe§

/ph/communecter/api/convert/[type interop]?url="http://votreurlinterop"

Exemple Wikidata :§

/ph/api/convert/wikipedia?url=https://www.wikidata.org/wiki/Special:EntityData/[wikidataID].json pull

Pour la ville de Saint-Louis dont le WikidataID est Q47045, l’exemple serait :

/ph/api/convert/wikipedia?url=https://www.wikidata.org/wiki/Special:EntityData/Q47045.json pull

On va pouvoir récupérer le wikidataID de la ville est ainsi filtrer l’enssemble des éléments qui ont pour propriété P:131 (located in the administrative territorial entity) le wikidataID de la ville.

Exemple Data.gouv :§

/ph/api/convert/datagouv?url=https://www.data.gouv.fr/api/1/spatial/zone/fr/town/[insee]/datasets

Pour la ville de Rodez, dont l’insse est 12202, l’exemple serait :

/ph/api/convert/datagouv?url=https://www.data.gouv.fr/api/1/spatial/zone/fr/town/12202/datasets

On va pouvoir ensuite obtenir l’enssemble des datasets de la ville mentionné et au final parcourir l’enssemble des données des différents jeux de données de la ville.

Exemple OpenStreetMap :§

/ph/api/convert/osm?url=http://overpass-api.de/api/interpreter?data=[out:json];node[%22name%22](poly:[geoshape]);out;

Pour la ville de Saint-Louis, l’exemple serait :

/ph/api/convert/osm?url=http://overpass-api.de/api/interpreter?data=[out:json];node[%22name%22](poly:%22-21.303505996763%2055.403919253998%20-21.292626813288%2055.391189163162%20-21.282029142394%2055.381522536523%20-21.256155186265%2055.392395046639%20-21.232012804782%2055.387888015185%20-21.211100938923%2055.390619722192%20-21.199480966855%2055.382654775478%20-21.185882138486%2055.385961778627%20-21.173346518752%2055.389949958731%20-21.16327583783%2055.399563417107%20-21.14709868917%2055.405379688232%20-21.166028899095%2055.414700890276%20-21.184085220909%2055.432085218794%20-21.190290936422%2055.440880800108%20-21.195166490948%2055.462318490892%20-21.237553168259%2055.459769285867%20-21.258726107298%2055.463692709631%20-21.286021128961%2055.455515913879%20-21.294777773557%2055.419916682666%20-21.303505996763%2055.403919253998%22);out;

On va pouvoir filtrer l’enssemble des noeuds qui sont présent dans le geoshape fourni et enfin filtrer tous les noeuds qui possède au moins le tag "name"

Exemple OpenDataSoft :§

/ph/api/convert/ods?url=https://data.opendatasoft.com/api/records/1.0/search/?dataset=sirene%40public&sort=datemaj&facet=categorie&facet=proden&facet=libapen&facet=siege&facet=libreg_new&facet=saisonat&facet=libtefen&facet=depet&facet=libnj&facet=libtca&facet=liborigine&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Saint-Louis, l’exemple serait :

/ph/api/convert/ods?url=https://data.opendatasoft.com/api/records/1.0/search/?dataset=sirene%40public&sort=datemaj&facet=categorie&facet=proden&facet=libapen&facet=siege&facet=libreg_new&facet=saisonat&facet=libtefen&facet=depet&facet=libnj&facet=libtca&facet=liborigine&rows=30&start=0&geofilter.polygon=(-21.303505996763,55.403919253998),(-21.292626813288,55.391189163162),(-21.282029142394,55.381522536523),(-21.256155186265,55.392395046639),(-21.232012804782,55.387888015185),(-21.211100938923,55.390619722192),(-21.199480966855,55.382654775478),(-21.185882138486,55.385961778627),(-21.173346518752,55.389949958731),(-21.16327583783,55.399563417107),(-21.14709868917,55.405379688232),(-21.166028899095,55.414700890276),(-21.184085220909,55.432085218794),(-21.190290936422,55.440880800108),(-21.195166490948,55.462318490892),(-21.237553168259,55.459769285867),(-21.258726107298,55.463692709631),(-21.286021128961,55.455515913879),(-21.294777773557,55.419916682666),(-21.303505996763,55.403919253998)

On va pouvoir filtrer l’enssemble des éléments présent dans le geofilter fournit.

On peut filtrer les éléments par thématique en mentionnant des refine.libapen dans l’url.

L’exemple suivant fait la même chose que l’exemple précédent sauf qu’il filtre tous les éléments qui sont dans le secteur d’activité : Pratique dentaire

/ph/api/convert/ods?url=https://data.opendatasoft.com/api/records/1.0/search/?dataset=sirene%40public&facet=categorie&facet=proden&facet=libapen&facet=siege&facet=libreg_new&facet=saisonat&facet=libtefen&facet=depet&facet=libnj&facet=libtca&facet=liborigine&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)&refine.libapen=Pratique%20dentaire

Exemple Datanova :§

/ph/api/convert/datanova?url=https://datanova.laposte.fr/api/records/1.0/search/?dataset=laposte_poincont&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Bordeaux l’exemple serait :

/ph/api/convert/datanova?url=https://datanova.laposte.fr/api/records/1.0/search/?dataset=laposte_poincont&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)

On récupère l’enssemble des enseignes La Poste présent dans le geofilter donné.

Exemple Pôle Emploi :§

L’url à passer en paramètre est du type :

/ph/api/convert?url=https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search_sql?sql=SELECT%20%2A%20FROM%20%22421692f5%2Df342%2D4223%2D9c51%2D72a27dcaf51e%22%20WHERE%20%22CITY_CODE%22=%27[insee]%27%

Pour la ville de Saint-Louis, l’url serait :

/ph/api/convert?url=https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search_sql?sql=SELECT%20%2A%20FROM%20%22421692f5%2Df342%2D4223%2D9c51%2D72a27dcaf51e%22%20WHERE%20%22CITY_CODE%22=%2797414%27%

L’essemble du procesus est le suivant :

• On demande à avoir un token :

https://entreprise.pole-emploi.fr/connexion/oauth2/access_token?realm=%2Fpartenaire

avec en paramètre POST :

• grant_type = client_credential
• client_id = [identifiant]
• scope = [mot de passe]

Ensuite on lance la requête :

https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search_sql?sql=SELECT%20%2A%20FROM%20%22421692f5%2Df342%2D4223%2D9c51%2D72a27dcaf51e%22%20WHERE%20%22CITY_CODE%22=%27[insee]%27%

Pour la ville de Saint-Louis :

https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search_sql?sql=SELECT%20%2A%20FROM%20%22421692f5%2Df342%2D4223%2D9c51%2D72a27dcaf51e%22%20WHERE%20%22CITY_CODE%22=%2797414%27%

Il faut indiquer en paramètre POST ses identifiants du Pôle Emploi (inscription sur https://www.emploi-store-dev.fr/) et aussi mettre un token dans le HEADER : "Authorization: Bearer [token]".

On récupère donc l’enssemble des offres d’emplois filtré par insee.

Exemple ScanR :§

ScanR comporte 4 jeux de données que l’on peut intéroger :

• Structure de recherche publique :

/ph/api/convert/educstruct?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-structures-recherche-publiques-actives&facet=numero_national_de_structure&facet=annee_de_creation&facet=tutelles&facet=type_de_tutelle&facet=nature_de_tutelle&facet=nature_de_structure&facet=type_de_structure&facet=niveau_de_structure&facet=domaine_scientifique&facet=panel_erc&facet=theme_de_recherche&facet=commune&facet=unite_urbaine&facet=departement&facet=region&facet=pays&facet=comue&facet=region_avant_2016&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Saint-Louis,l’exemple serait :

/ph/api/convert/educstruct?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-structures-recherche-publiques-actives&facet=numero_national_de_structure&facet=annee_de_creation&facet=tutelles&facet=type_de_tutelle&facet=nature_de_tutelle&facet=nature_de_structure&facet=type_de_structure&facet=niveau_de_structure&facet=domaine_scientifique&facet=panel_erc&facet=theme_de_recherche&facet=commune&facet=unite_urbaine&facet=departement&facet=region&facet=pays&facet=comue&facet=region_avant_2016&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)

• Etablissement impliqués dans la recherche :

/ph/api/convert/educetab?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-etablissements-publics-prives-impliques-recherche-developpement&facet=siren&facet=libelle&facet=date_de_creation&facet=categorie&facet=libelle_ape&facet=tranche_etp&facet=categorie_juridique&facet=wikidata&facet=commune&facet=unite_urbaine&facet=departement&facet=region&facet=pays&facet=badge&facet=region_avant_2016&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Bordeaux, l’exemple serait :

/ph/api/convert/educetab?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-etablissements-publics-prives-impliques-recherche-developpement&facet=siren&facet=libelle&facet=date_de_creation&facet=categorie&facet=libelle_ape&facet=tranche_etp&facet=categorie_juridique&facet=wikidata&facet=commune&facet=unite_urbaine&facet=departement&facet=region&facet=pays&facet=badge&facet=region_avant_2016&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)

• Membres des universités de France :

/ph/api/convert/educmembre?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-iuf-les-membres&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Bordeaux, l’exemple serait :

/ph/api/convert/educmembre?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-iuf-les-membres&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)

• Liste des écoles doctorales accréditées

/ph/api/convert/educecole?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-ecoles_doctorales_annuaire&facet=numero&facet=groupe_disciplinaire&facet=toutes_les_disciplines&facet=discipline_principale&facet=localisation&facet=liste_tous_etablissements&facet=laboratoires_rattaches&facet=annee_de_creation&facet=annee_accreditation&facet=etablissement_support&facet=liste_codes_tous_etablissements&facet=identifiants_des_laboratoires&facet=libelle_unite_urbaine&facet=libelle_departement&facet=libelle_academie&facet=libelle_region&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Bordeaux, l’exemple serait :

/ph/api/convert/educecole?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-ecoles_doctorales_annuaire&facet=numero&facet=groupe_disciplinaire&facet=toutes_les_disciplines&facet=discipline_principale&facet=localisation&facet=liste_tous_etablissements&facet=laboratoires_rattaches&facet=annee_de_creation&facet=annee_accreditation&facet=etablissement_support&facet=liste_codes_tous_etablissements&facet=identifiants_des_laboratoires&facet=libelle_unite_urbaine&facet=libelle_departement&facet=libelle_academie&facet=libelle_region&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)

#REST Services

• Almost every actions could be exposed as a REST service.

#Documentation about REST Services

Register a new user§

• url : xxxxx.communecter.org/communecter/person/register

• params dans le post :

  • name string
  • username string. Unique on the plateforme
  • email well formated email
  • cp existing postalCode
  • geoPosLatitude float
  • geoPosLongitude float
  • pwd : non encrypted password
  • city String Insee code
  • pendingUserId String. Si l’utilisateur est déjà en base de données (il a été invité et son profil est temporaire), son identifiant est passé en paramètre. Dans ce cas l’utilisateur n’est pas créé, mais il est mis à jour.

• Retour (json) :

  • result boolean
  • msg String : message d’erreur
  • id identifiant de l’utilisateur nouvellement créé.

• Fonctionnement :

  • L’utilisateur est créé en base de données.
  • Il n’est pas encore validé et ne pourra pas se logguer
  • Un mail lui est envoyé avec un lien de validation pour activer son compte
  • En version bêta, il y a un flag betaTester qui est positionné pour filtrer les utilisateurs bêta testeur. Par défaut, il est à false.

Le code utilisé est ici : citizenToolKit/controllers/person/RegisterAction.php (lien mort)

Get : Récupérer des informations§

Depuis l’API vous avez la possibilité de récupérer différentes informations en provenance de Communecter :

• [citoyens] Citoyen
• [organizations] Organisation
• [projects] Projet
• [events] Événement
• [needs] Besoin
• [news] News

Récupérer toutes les entités§

/ph/communecter/data/get/type/[projects || citoyens || organizations || events || needs || news]

Exemple : /ph/communecter/data/get/type/organizations/

Pour voir la description du résultat aller dans la rubrique [[https://github.com/pixelhumain/communecter/wiki/5—-Doc-de-l’API#les-attributs]]

Paramétrer la recherche§

Vous avez la possibilité d’ajouter des paramètres pour peaufiner votre recherche :

• [id] Identifiant
• [tags] Tags
• [insee] Code Insee
• [format] Format

Récupérer une entité via son identifiant§

/ph/communecter/data/get/type/(projects || citoyens || organizations || events || news)/id/[id_entity]

Exemple : /ph/communecter/data/get/type/organizations/id/57186ed894ef47210d7b242d

Rechercher par tags§

Vous avez la possibilité de paramétrer la recherche des entités en fonctions des tags. Vous pouvez ajouter plusieurs tags qui devront être séparé par une virgule. Par défauts, si vous avez mis plusieurs tags, il suffit pour l’entité d’avoir un de ces tags pour être affiché. Si vous souhaitez que l’entité possède tout les tags alors il faut mettre le paramètre suivant : /multiTags/true

Exemple :

• /ph/communecter/data/get/type/organizations/tags/NuitDebout
• /ph/communecter/data/get/type/organizations/tags/NuitDebout,Commun
• /ph/communecter/data/get/type/organizations/tags/NuitDebout,Commun/multiTags/true

Rechercher par Insee§

Si vous connaissez le code Insee de votre commune, vous pouvez faire une recherche via ce code Insee. Exemple : /ph/communecter/data/get/type/organizations/insee/33402

Formats§

L’API prend en compte différents formats pour le résultat. Par défaut, c’est le format que propose Communecter. Nous prenons aussi en comptes les formats suivant :

• SCHEMA /ph/communecter/data/get/type/organizations/format/schema
• PLP /ph/communecter/data/get/type/citoyens/format/plp
• RSS /ph/api/news/get/format/rss
• KML /ph/api/event/get/format/kml
• GEOJSON /ph/api/person/get/format/geojson
• CSV /ph/api/person/get/format/csv

Attention certains formats ne retourne pas forcement toutes les entités, voici la liste pour chaque format.

COMMUNECTER

• [citoyens] Citoyen
• [organizations] Organisation
• [projects] Projet
• [events] Événement
• [needs] Besoin
• [news] News

SCHEMA

• [citoyens] Citoyen
• [organizations] Organisation
• [projects] Projet
• [events] Événement
• [needs] Besoin
• City
• [news] News

PLP

• [citoyens] Citoyen

KML

• [citoyens] Citoyen
• [organizations] Organisation
• [projects] Projet
• [events] Événement
• [needs] Besoin
• City
• [news] News

GEOJSON

• [citoyens] Citoyen
• [organizations] Organisation
• [projects] Projet
• [events] Événement
• [needs] Besoin
• City
• [news] News

CSV

*[organizations] Organisation

Les attributs§

Ici, vous aurez la description de tout les attribues des différentes entités qui sont retournés via l’API.

Format Communecter§

Exemple : meta :

• limit Nombre d’entités retournée
• next url retournant la suite des entités
• previous url retournant la liste précédente des entités

entities toutes les entités en leurs identifiants en clé

• name Nom de l’entité
• image Url de l’image de profil de l’entité
• urlCommunecter Url de la fiche de l’entité sur Communecter
• urlApi Url qui retourne les informations d’une entité via l’API
• address
  • streetAddress Numéro et nom de la rue
  • postalCode Code postal
  • addressLocality Nom de la commune
  • addressCountry Nom du Pays
  • codeInsee Code Insee de la commune
• geo
  • latitude
  • longitude
• geoPosition Autre format pour la position géographique de l’entité
• shortDescription Courte description de l’entité
• description Description de l’entité.
• email L’email de l’entité.
• phone L’ensemble des numéros de téléphones de l’entité ( fixe, mobile et fax)
• socialNetwork L’ensemble des liens vers les autres réseaux sociaux de l’entité
• tags Tous les tags associés à l’entité
• links Les différents liens que l’entité a avec les autres :
  • memberOf Liste des organisations dont l’entité est membre
  • projects Liste des projets dont l’entité contribue
  • events Liste des événements dont l’entité est invitée ou participe
  • followers Liste des citoyens dont l’entité suit.
  • members Liste des citoyens membres de l’entité.
  • needs Liste des besoins de l’entité.

Convert : Récupérer des données en onthologie PH§

Depuis l’API, vous avez la possibilité de convertir les données sous différents format que vous possédez directement en onthologie PH.

• [geojson] GeoJson

• [wikipedia] Json issu de l’API de Wikidata

• [datagouv] Json issu de l’API de Data.gouv

• [osm] Json issu de l’API de Open Street Map

• [ods] JSon issu de l’API de OpenDataSoft (on intéroge uniquement la base SIRENE)

• [datanova] Json issu de l’API de Datanova

• [poleemploi] Json issu de l’API de Pôle Emploi

• [educstruct] Json issu de l’API de ScanR(structures de recherche)

• [educetab] Json issu de l’API de ScanR (établissements impliqués dans la recherche)

• [educmembre] Json issu de l’API de ScanR (membre des universités de France)

• [educecole] Json issu de l’API de ScanR (école doctorales accrédités)

Obtenir l’ontologie ph pour un type d’élément donnée via une url§

/ph/communecter/api/convert/geojson/type/[organizations || citoyens || events || projects]?url="http://votreurl"

Exemple : `/ph/communecter/api/convert/type/organizations?url=http://umap.openstreetmap.fr/en/datalayer/276610/

Cas particuliers : les Umap§

L’API permet de convertir les données geojson d’une umap donné via la paramètre "url"

Exemple : /ph/communecter/api/convert/type/organizations?url=http://umap.openstreetmap.fr/fr/map/carte-pour-faire-des-tests_62176#13/44.7825/-0.3700

On peut aussi mettre en paramètre l’url courte d’une umap (visible en appuyant sur le bouton partager à gauche de la umap):

Exemple : /ph/communecter/api/convert/type/organizations?url=http://u.osmfr.org/m/62176/

Attention pour le moment, il faut que l’url soit en "http" et non pas en "https", retirez le "s" si tel est le cas.

Obtenir l’ontologie ph pour un type d’élément donnée via un fichier§

Il faut envoyer à l’API le paramètre "file" via méthode POST. (en utilisant curl ou RESTED par exemple)

Obtenir l’ontologie ph pour une url intérrogeant une API externe§

/ph/communecter/api/convert/[type interop]?url="http://votreurlinterop"

Exemple Wikidata :§

/ph/api/convert/wikipedia?url=https://www.wikidata.org/wiki/Special:EntityData/[wikidataID].json pull

Pour la ville de Saint-Louis dont le WikidataID est Q47045, l’exemple serait :

/ph/api/convert/wikipedia?url=https://www.wikidata.org/wiki/Special:EntityData/Q47045.json pull

On va pouvoir récupérer le wikidataID de la ville est ainsi filtrer l’enssemble des éléments qui ont pour propriété P:131 (located in the administrative territorial entity) le wikidataID de la ville.

Exemple Data.gouv :§

/ph/api/convert/datagouv?url=https://www.data.gouv.fr/api/1/spatial/zone/fr/town/[insee]/datasets

Pour la ville de Rodez, dont l’insse est 12202, l’exemple serait :

/ph/api/convert/datagouv?url=https://www.data.gouv.fr/api/1/spatial/zone/fr/town/12202/datasets

On va pouvoir ensuite obtenir l’enssemble des datasets de la ville mentionné et au final parcourir l’enssemble des données des différents jeux de données de la ville.

Exemple OpenStreetMap :§

/ph/api/convert/osm?url=http://overpass-api.de/api/interpreter?data=[out:json];node[%22name%22](poly:[geoshape]);out;

Pour la ville de Saint-Louis, l’exemple serait :

/ph/api/convert/osm?url=http://overpass-api.de/api/interpreter?data=[out:json];node[%22name%22](poly:%22-21.303505996763%2055.403919253998%20-21.292626813288%2055.391189163162%20-21.282029142394%2055.381522536523%20-21.256155186265%2055.392395046639%20-21.232012804782%2055.387888015185%20-21.211100938923%2055.390619722192%20-21.199480966855%2055.382654775478%20-21.185882138486%2055.385961778627%20-21.173346518752%2055.389949958731%20-21.16327583783%2055.399563417107%20-21.14709868917%2055.405379688232%20-21.166028899095%2055.414700890276%20-21.184085220909%2055.432085218794%20-21.190290936422%2055.440880800108%20-21.195166490948%2055.462318490892%20-21.237553168259%2055.459769285867%20-21.258726107298%2055.463692709631%20-21.286021128961%2055.455515913879%20-21.294777773557%2055.419916682666%20-21.303505996763%2055.403919253998%22);out;

On va pouvoir filtrer l’enssemble des noeuds qui sont présent dans le geoshape fourni et enfin filtrer tous les noeuds qui possède au moins le tag "name"

Exemple OpenDataSoft :§

/ph/api/convert/ods?url=https://data.opendatasoft.com/api/records/1.0/search/?dataset=sirene%40public&sort=datemaj&facet=categorie&facet=proden&facet=libapen&facet=siege&facet=libreg_new&facet=saisonat&facet=libtefen&facet=depet&facet=libnj&facet=libtca&facet=liborigine&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Saint-Louis, l’exemple serait :

/ph/api/convert/ods?url=https://data.opendatasoft.com/api/records/1.0/search/?dataset=sirene%40public&sort=datemaj&facet=categorie&facet=proden&facet=libapen&facet=siege&facet=libreg_new&facet=saisonat&facet=libtefen&facet=depet&facet=libnj&facet=libtca&facet=liborigine&rows=30&start=0&geofilter.polygon=(-21.303505996763,55.403919253998),(-21.292626813288,55.391189163162),(-21.282029142394,55.381522536523),(-21.256155186265,55.392395046639),(-21.232012804782,55.387888015185),(-21.211100938923,55.390619722192),(-21.199480966855,55.382654775478),(-21.185882138486,55.385961778627),(-21.173346518752,55.389949958731),(-21.16327583783,55.399563417107),(-21.14709868917,55.405379688232),(-21.166028899095,55.414700890276),(-21.184085220909,55.432085218794),(-21.190290936422,55.440880800108),(-21.195166490948,55.462318490892),(-21.237553168259,55.459769285867),(-21.258726107298,55.463692709631),(-21.286021128961,55.455515913879),(-21.294777773557,55.419916682666),(-21.303505996763,55.403919253998)

On va pouvoir filtrer l’enssemble des éléments présent dans le geofilter fournit.

On peut filtrer les éléments par thématique en mentionnant des refine.libapen dans l’url.

L’exemple suivant fait la même chose que l’exemple précédent sauf qu’il filtre tous les éléments qui sont dans le secteur d’activité : Pratique dentaire

/ph/api/convert/ods?url=https://data.opendatasoft.com/api/records/1.0/search/?dataset=sirene%40public&facet=categorie&facet=proden&facet=libapen&facet=siege&facet=libreg_new&facet=saisonat&facet=libtefen&facet=depet&facet=libnj&facet=libtca&facet=liborigine&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)&refine.libapen=Pratique%20dentaire

Exemple Datanova :§

/ph/api/convert/datanova?url=https://datanova.laposte.fr/api/records/1.0/search/?dataset=laposte_poincont&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Bordeaux l’exemple serait :

/ph/api/convert/datanova?url=https://datanova.laposte.fr/api/records/1.0/search/?dataset=laposte_poincont&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)

On récupère l’enssemble des enseignes La Poste présent dans le geofilter donné.

Exemple Pôle Emploi :§

L’url à passer en paramètre est du type :

/ph/api/convert?url=https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search_sql?sql=SELECT%20%2A%20FROM%20%22421692f5%2Df342%2D4223%2D9c51%2D72a27dcaf51e%22%20WHERE%20%22CITY_CODE%22=%27[insee]%27%

Pour la ville de Saint-Louis, l’url serait :

/ph/api/convert?url=https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search_sql?sql=SELECT%20%2A%20FROM%20%22421692f5%2Df342%2D4223%2D9c51%2D72a27dcaf51e%22%20WHERE%20%22CITY_CODE%22=%2797414%27%

L’essemble du procesus est le suivant :

• On demande à avoir un token :

https://entreprise.pole-emploi.fr/connexion/oauth2/access_token?realm=%2Fpartenaire

avec en paramètre POST :

• grant_type = client_credential
• client_id = [identifiant]
• scope = [mot de passe]

Ensuite on lance la requête :

https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search_sql?sql=SELECT%20%2A%20FROM%20%22421692f5%2Df342%2D4223%2D9c51%2D72a27dcaf51e%22%20WHERE%20%22CITY_CODE%22=%27[insee]%27%

Pour la ville de Saint-Louis :

https://api.emploi-store.fr/partenaire/infotravail/v1/datastore_search_sql?sql=SELECT%20%2A%20FROM%20%22421692f5%2Df342%2D4223%2D9c51%2D72a27dcaf51e%22%20WHERE%20%22CITY_CODE%22=%2797414%27%

Il faut indiquer en paramètre POST ses identifiants du Pôle Emploi (inscription sur https://www.emploi-store-dev.fr/) et aussi mettre un token dans le HEADER : "Authorization: Bearer [token]".

On récupère donc l’enssemble des offres d’emplois filtré par insee.

Exemple ScanR :§

ScanR comporte 4 jeux de données que l’on peut intéroger :

• Structure de recherche publique :

/ph/api/convert/educstruct?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-structures-recherche-publiques-actives&facet=numero_national_de_structure&facet=annee_de_creation&facet=tutelles&facet=type_de_tutelle&facet=nature_de_tutelle&facet=nature_de_structure&facet=type_de_structure&facet=niveau_de_structure&facet=domaine_scientifique&facet=panel_erc&facet=theme_de_recherche&facet=commune&facet=unite_urbaine&facet=departement&facet=region&facet=pays&facet=comue&facet=region_avant_2016&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Saint-Louis,l’exemple serait :

/ph/api/convert/educstruct?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-structures-recherche-publiques-actives&facet=numero_national_de_structure&facet=annee_de_creation&facet=tutelles&facet=type_de_tutelle&facet=nature_de_tutelle&facet=nature_de_structure&facet=type_de_structure&facet=niveau_de_structure&facet=domaine_scientifique&facet=panel_erc&facet=theme_de_recherche&facet=commune&facet=unite_urbaine&facet=departement&facet=region&facet=pays&facet=comue&facet=region_avant_2016&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)

• Etablissement impliqués dans la recherche :

/ph/api/convert/educetab?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-etablissements-publics-prives-impliques-recherche-developpement&facet=siren&facet=libelle&facet=date_de_creation&facet=categorie&facet=libelle_ape&facet=tranche_etp&facet=categorie_juridique&facet=wikidata&facet=commune&facet=unite_urbaine&facet=departement&facet=region&facet=pays&facet=badge&facet=region_avant_2016&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Bordeaux, l’exemple serait :

/ph/api/convert/educetab?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-etablissements-publics-prives-impliques-recherche-developpement&facet=siren&facet=libelle&facet=date_de_creation&facet=categorie&facet=libelle_ape&facet=tranche_etp&facet=categorie_juridique&facet=wikidata&facet=commune&facet=unite_urbaine&facet=departement&facet=region&facet=pays&facet=badge&facet=region_avant_2016&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)

• Membres des universités de France :

/ph/api/convert/educmembre?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-iuf-les-membres&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Bordeaux, l’exemple serait :

/ph/api/convert/educmembre?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-iuf-les-membres&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)

• Liste des écoles doctorales accréditées

/ph/api/convert/educecole?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-ecoles_doctorales_annuaire&facet=numero&facet=groupe_disciplinaire&facet=toutes_les_disciplines&facet=discipline_principale&facet=localisation&facet=liste_tous_etablissements&facet=laboratoires_rattaches&facet=annee_de_creation&facet=annee_accreditation&facet=etablissement_support&facet=liste_codes_tous_etablissements&facet=identifiants_des_laboratoires&facet=libelle_unite_urbaine&facet=libelle_departement&facet=libelle_academie&facet=libelle_region&rows=30&start=0&geofilter.polygon=[geofilter]

Pour la ville de Bordeaux, l’exemple serait :

/ph/api/convert/educecole?url=https://data.enseignementsup-recherche.gouv.fr/api/records/1.0/search/?dataset=fr-esr-ecoles_doctorales_annuaire&facet=numero&facet=groupe_disciplinaire&facet=toutes_les_disciplines&facet=discipline_principale&facet=localisation&facet=liste_tous_etablissements&facet=laboratoires_rattaches&facet=annee_de_creation&facet=annee_accreditation&facet=etablissement_support&facet=liste_codes_tous_etablissements&facet=identifiants_des_laboratoires&facet=libelle_unite_urbaine&facet=libelle_departement&facet=libelle_academie&facet=libelle_region&rows=30&start=0&geofilter.polygon=(44.810795852605,-0.5738778170842),(44.817148298105,-0.57643460444186),(44.823910193873,-0.58695822406613),(44.818476638462,-0.60304723869607),(44.822474304509,-0.61064859861704),(44.824937843733,-0.61415033833008),(44.835177466959,-0.61079419661495),(44.841384923705,-0.62771243191386),(44.860667021743,-0.63833642556746),(44.871658097695,-0.63105127891779),(44.86227970331,-0.61630176568479),(44.854215265872,-0.59460939385687),(44.865671076253,-0.57646019656194),(44.869188961886,-0.57608874140575),(44.909402227434,-0.58088555560083),(44.908480410411,-0.57648917779388),(44.916666965125,-0.54773554113942),(44.889099273803,-0.53553255107571),(44.869138522062,-0.54141014437767),(44.868086689933,-0.53680669655034),(44.861267174723,-0.53784686147751),(44.848134506953,-0.53761462401784),(44.842390488778,-0.5422310311368),(44.836291776079,-0.54665943781219),(44.829021270567,-0.53642317794196),(44.822772234064,-0.53766321563778),(44.813135278103,-0.55606047183132),(44.810795852605,-0.5738778170842)

#REST Services

• Almost every actions could be exposed as a REST service.

#Documentation about REST Services

Register a new user§

• url : xxxxx.communecter.org/communecter/person/register

• params dans le post :

  • name string
  • username string. Unique on the plateforme
  • email well formated email
  • cp existing postalCode
  • geoPosLatitude float
  • geoPosLongitude float
  • pwd : non encrypted password
  • city String Insee code
  • pendingUserId String. Si l’utilisateur est déjà en base de données (il a été invité et son profil est temporaire), son identifiant est passé en paramètre. Dans ce cas l’utilisateur n’est pas créé, mais il est mis à jour.

• Retour (json) :

  • result boolean
  • msg String : message d’erreur
  • id identifiant de l’utilisateur nouvellement créé.

• Fonctionnement :

  • L’utilisateur est créé en base de données.
  • Il n’est pas encore validé et ne pourra pas se logguer
  • Un mail lui est envoyé avec un lien de validation pour activer son compte
  • En version bêta, il y a un flag betaTester qui est positionné pour filtrer les utilisateurs bêta testeur. Par défaut, il est à false.

Le code utilisé est ici : citizenToolKit/controllers/person/RegisterAction.php (lien mort)

• [[flancian]] https://social.coop/@flancian/107320059508817443 pull

• [[flancian]] https://twitter.com/flancian/status/1462717868836065280 pull

• [[go]] https://github.com/WICG/file-system-access
  • [[firefox]] doesn’t support these and it would probably be better if it would
    • [[position]] https://github.com/mozilla/standards-positions/issues/154
    • [[bug]] https://github.com/mozilla/standards-positions/issues/154

• [[2022-08-20 16:32:21]] [[@flancian:matrix.org]] (link):
  • I’m going to finally bring up the [[flask api]] for [[agora bridge]]

IBM Watson Visual Recognition API§

Watson Vs OpenCV§

Watson§

• Set of APIs
• Comes with pre-packaged models
  • Identity, faces, age, gender
  • Celebrities & food
• Can create custom classifiers quickly
• Not good for real-time video
• Scalable, but expensive

OpenCV§

• Python package
• Comes with pre-packaged modules
  • Faces, eyes
• Can create custom classifiers, but with more difficulty
• Can handle real-time videos
• Learning curve
• Bugs, but free

• [[librebits]] https://masto.nobigtech.es/@librebits/108251399588880774 pull

• [[flancian]] https://social.coop/@flancian/107395169884885628 pull
• [[flancian]] https://social.coop/@flancian/107395169884885628 pull

• [[flancian]] https://social.coop/@flancian/107949020725656123 pull

• [[flancian]] https://twitter.com/flancian/status/1467525296450678784 pull

• [[flancian]] https://twitter.com/flancian/status/1502972120694931456 pull

• [[2022-10-01 14:45:32]] [[@flancian:matrix.org]] (link):
  • it’s been a long detour; if only I could write a bot for the [[mastodon api]], which is so sensible, and somehow let an abstraction layer deal with twitter bullshit in the background.

• Social API design · Issue #13 · hyphacoop/api.distributed.press · GitHub

• [[flancian@social.coop]] https://social.coop/@flancian/113775769075281693 pull

• an [[api]]
  • [[reference]] https://developer.twitter.com/en/docs/api-reference-index
  • [[go]] https://developer.twitter.com/en/account/
  • [[agora]] https://developer.twitter.com/en/portal/projects/1361013271927619586/apps/20126873/keys
    • see [[private]] repo for actual keys
  • [[rate limits]] https://developer.twitter.com/en/docs/rate-limits

• [[flancian]] https://social.coop/@flancian/109077209033931803 pull
• [[flancian]] https://social.coop/@flancian/109077209065770031 pull

• [[flancian]] https://twitter.com/flancian/status/1510633124341895172 pull

• [[flancian]] https://twitter.com/flancian/status/1575174929208979457 pull

• [[flancian]] https://twitter.com/flancian/status/1575174929208979457 pull
  • Note that @an_agora is back in limited form, only with explicit mentions support on @twitter: [[flancia meet]].

(This is while we implement OAuth 2.0 User Context support in [[agora bot]] to meet the new [[Twitter API]] requirements and be able to read the bot’s own timeline.)

• [[schmidt_fu@mstdn.social]] https://mstdn.social/@schmidt_fu/109805582046272287 pull

wikipedia api§

• [[mediawiki]]
  • [[search]] https://www.mediawiki.org/wiki/API:Search pull
• [[example]]
  • search for pages using free form text
    • [[query]] https://en.wikipedia.org/w/api.php?action=query&list=search&srsearch=popper pull
      • returns a query -> search array, of which the first item is high quality. ranking can be customized with parameters. the item contain a pageid, in this case 16623 for the page for Karl Popper.
  • retrieve URL for the pageid in question and additional external resources, extlinks
    • [[query]] https://en.wikipedia.org/w/api.php?action=query&pageids=16623&prop=extlinks|info&inprop=url pull