Connexion à l'API Entrepôt
Une fois le compte existant, on va pouvoir manipuler l'API Entrepôt.
Qui suis-je ?
Un premier appel va permettre de récupérer nos informations personnelles et principalement les communautés dont nous sommes membres.
/users/me
{
"email": "dave.lopper@ign.fr",
"creation": "2023-02-01T09:45:10.725069Z",
"last_call": "2023-03-24T17:02:32.676055Z",
"communities_member": [
{
"rights": [
"ANNEX",
"UPLOAD",
"BROADCAST",
"PROCESSING",
"COMMUNITY"
],
"community": {
"name": "Communauté des tutoriels",
"technical_name": "tutoriels",
"datastore": "{datastore}",
"supervisor": "{user}",
"public": true,
"_id": "{community}"
}
}
],
"technical": false,
"administrator": false,
"_id": "{user}",
"last_name": "Lopper",
"first_name": "Dave"
}
L'identifiant de votre utilisateur est une information :
- à fournir à un gestionnaire de communauté si vous voulez la rejoindre
- à l'adresse
geoplateforme@ign.frsi vous souhaitez qu'un espace de travail soit créé pour vous (en tant que producteur ou gestionnaire de consommateur de données).
Lorsque la communauté est associée à un entrepôt, on a également dans cette réponse son identifiant. Cet identifiant d'entrepôt sera systèmatiquement présent dans les routes d'appels à l'API pour l'alimentation précisant au sein de quel entrepôt on souhaite travailler.
On voit également les droits que l'on a dans chaque communauté, limitant les actions autorisées.
La vidéo suivante montre comment avoir ces informations en utilisant l'interface Swagger.
Quelles possibilités a mon entrepôt ?
La plateforme dispose de ressources globales pour permettre l'alimentation et la diffusion de données :
- Des vérifications
- Des traitements
- Des espaces de stockage
- Des grappes de serveur de diffusion, les points d'accès
Ces ressources sont individuellement mises à disposition des entrepôts, avec quotas.
Pour voir celles accessibles par mon entrepôt (la réponse dépend des ressources qui vous ont été allouées) :
/datastores/{datastore}
{
"community": {
"contact": "contact@ign.fr",
"public": true,
"_id": "{community}"
},
"processings": [
"af012611-13eb-4a18-8d04-9b7604a031cc"
"af062611-13eb-4a18-8d04-9b7604a031cc",
"d78ff336-452c-43e8-a81d-cc7e9baa6f7e",
"af022611-13eb-4a18-8d04-9b7604a031cc",
"e2220fa2-50d8-44e9-b8eb-7e6401fd8c4c"
],
"name": "Communauté des tutoriels",
"technical_name": "tutoriels",
"endpoints": [
{
"use": 0,
"quota": 10,
"endpoint": {
"name": "Service de diffusion WMS Vecteur principal",
"technical_name": "gpf-geoserver-wms-v",
"type": "WMS-VECTOR",
"urls": [
{
"type": "WMS",
"url": "https://data-qua.priv.geopf.fr/wms-v"
}
],
"_id": "ae022611-13eb-4a18-8d04-9b7604a031cc",
"open": true,
"metadata_fi": "gpf-geoserver-wms-v"
}
},
{
"use": 0,
"quota": 10,
"endpoint": {
"name": "Service de diffusion WFS principal",
"technical_name": "gpf-geoserver-wfs",
"type": "WFS",
"urls": [
{
"type": "WFS",
"url": "https://data-qua.priv.geopf.fr/wfs"
}
],
"_id": "ae012611-13eb-4a18-8d04-9b7604a031cc",
"open": true,
"metadata_fi": "gpf-geoserver-wfs"
}
},
{
"use": 0,
"quota": 10,
"endpoint": {
"name": "Service de diffusion WMS Raster principal",
"technical_name": "gpf-rok4-server-wms-r",
"type": "WMS-RASTER",
"urls": [
{
"type": "WMS",
"url": "https://data-qua.priv.geopf.fr/wms-r"
}
],
"_id": "9cf2c4c3-c230-42d3-988a-cbe9f40f4e73",
"open": true,
"metadata_fi": "gpf-rok4-server-wms-r"
}
},{
"use": 0,
"quota": 10,
"endpoint": {
"name": "Service de diffusion WMTS/TMS principal",
"technical_name": "gpf-rok4-server-wmts-tms",
"type": "WMTS-TMS",
"urls": [
{
"type": "WMTS",
"url": "https://data-qua.priv.geopf.fr/wmts"
},
{
"type": "TMS",
"url": "https://data-qua.priv.geopf.fr/tms"
}
],
"_id": "752e99b4-c012-48af-854d-a8643f845da8",
"open": true,
"metadata_fi": "gpf-rok4-server-wmts-tms"
}
},{
"use": 0,
"quota": 10,
"endpoint": {
"name": "Service de téléchargement principal",
"technical_name": "gpf-download",
"type": "DOWNLOAD",
"urls": [
{
"type": "DOWNLOAD",
"url": "https://data-qua.priv.geopf.fr/telechargement"
}
],
"_id": "ae042611-13eb-4a18-8d04-9b7604a031cc",
"open": true,
"metadata_fi": "gpf-download"
}
},{
"use": 0,
"quota": 100,
"endpoint": {
"name": "Service de diffusion de métadonnées principal",
"technical_name": "gpf-geonetwork",
"type": "CSW",
"urls": [
{
"type": "CSW",
"url": "https://data-qua.priv.geopf.fr/csw"
}
],
"_id": "7a81b5e2-2de1-4a7b-aa18-c14b98124b5e",
"open": true,
"metadata_fi": "gpf-geonetwork"
}
}
],
"storages": {
"data": [
{
"use": 0,
"quota": 10000000000,
"storage": {
"name": "Stockage OpenIO performant pour les données pyramides des partenaires",
"type": "S3",
"labels": [
"PARTENAIRE",
"PYRAMIDE",
"PERF"
],
"_id": "ab032611-13eb-4a18-8d04-9b7604a031cc"
}
},
{
"use": 0,
"quota": 10000000000,
"storage": {
"name": "Stockage OpenIO performant pour les données archives des partenaires",
"type": "S3",
"labels": [
"PARTENAIRE",
"ARCHIVE",
"PERF"
],
"_id": "ab032611-13eb-4a18-8d04-9b7604a031cc"
}
},
{
"use": 0,
"quota": 10000000000,
"storage": {
"name": "Stockage PostgreSQL standard Partenaires",
"type": "POSTGRESQL",
"labels": [
"PARTENAIRE",
"VECTEUR"
],
"_id": "ab012611-13eb-4a18-8d04-9b7604a031cc"
}
}
],
"upload": {
"use": 0,
"quota": 10000000000,
"storage": {
"name": "Stockage OpenIO pour les livraisons",
"type": "S3",
"labels": [
"LIVRAISON",
"PERF"
],
"_id": "ab032611-13eb-4a18-8d04-9b7604a031cc"
}
},
"annexe": {
"use": 0,
"quota": 10000000000,
"storage": {
"name": "Stockage OpenIO pour les annexes",
"type": "S3",
"labels": [
"ANNEXE",
"PERF"
],
"_id": "ab032611-13eb-4a18-8d04-9b7604a031cc"
}
}
},
"active": true,
"_id": "{datastore}",
"checks": [
"bc012611-13eb-4a18-8d04-9b7604a031cc",
"bc022611-13eb-4a18-8d04-9b7604a031cc",
"bc032611-13eb-4a18-8d04-9b7604a031cc",
"bc052611-13eb-4a18-8d04-9b7604a031cc",
"b91b0336-3f3f-4c7c-a851-1dc15cdaaeaa"
]
}