Webservices dans le portail de données TEMPO

Le portail de données TEMPO fournit un ensemble de web services qui permettent aux utilisateurs d'accéder aux données stockées dans le portail. Ces services sont conçus pour être faciles à utiliser et à intégrer à d'autres systèmes.

Ils sont fournis en tant que services RESTful.

Utilisation

Les services web sont disponibles sans aucune authentification. Par conséquent, seules les données publiques sont accessibles.

Spécification OpenAPI

L'ensemble des services web pour le portail de données TEMPO est auto-décrit en utilisant la spécification OpenAPI à openapi/openapi.json.

L'interface Swagger UI est utilisée pour explorer et tester les services web. Elle fournit une interface pour interagir avec les services web et comprendre leur comportement. L'interface affiche la documentation écrite au format OpenAPI, y compris les ressources REST, les paramètres et les schémas de réponse. L'interaction avec l'interface fournit la commande Curl, la requête HTTP et la réponse, ce qui facilite l'intégration avec d'autres systèmes.

Développez les détails d'une ressource en utilisant l'icône de la flèche vers le bas pour obtenir

• la liste et la description des paramètres,
• les types de médias acceptés,
• un bouton Try it out pour interagir avec la ressource REST,
• un exemple de valeur et le schéma de données pour la réponse,
• la réponse réelle après avoir utilisé le bouton Try it out.

Description technique des services web

Le portail de données TEMPO propose 15 points d'accès pour les données, les métadonnées et les utilitaires.

Données :

• /pheno/additionaldata
• /pheno/cache

Métadonnées :

• /pheno/contact
• /pheno/source
• /pheno/license
• /pheno/site
• /pheno/site/commune
• /pheno/site/country
• /pheno/site/department
• /pheno/site/region
• /pheno/stage
• /pheno/stage/mainevent
• /pheno/taxon
• /pheno/taxon/children

Utilitaire :

• /pheno/ping

Toutes les réponses sont au format JSON et suivent la structure générique :

{
  "pagination": {
    "firstCursor": 0,
    "lastCursor": 0,
    "pageSize": 0,
    "totalCount": 0
  },
  "status": {
    "code": 0,
    "message": "string"
  },
  "data": [
    {
      "someattribute": "somevalue"
    }
  ]
}

La pagination est utilisée pour servir 15 000 valeurs. Le nombre maximum de valeurs par réponse peut être modifié en utilisant le paramètre pageSize (maximum 200 000 valeurs). Pour obtenir la valeur suivante, prenez la valeur lastCursor de la dernière réponse comme valeur de paramètre pour cursor pour la prochaine requête.

Utilisations externes des services web

Les services web du portail de données TEMPO sont utilisés depuis mai 2025 par le PEP725 (Pan European Phenology Project) pour obtenir des données pour certaines sources de données.