| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| cdrc:web:api_rest [2025/08/05 09:58] – [Utilisation] bertrand | cdrc:web:api_rest [2025/08/05 10:05] (Version actuelle) – [Utilisation] bertrand |
|---|
| ====== API REST sur BANADORA ====== | ====== API REST sur BANADORA ====== |
| |
| À l'URL https://web-services-arar.mom.fr/api-banadora/ est accessible une API REST pour consulter les résultats de datation présent dans la base BANADORA, consultable aussi sur https://banadora.mom.fr. | À l'URL https://web-services-arar.mom.fr/api-banadora/ est accessible une API REST pour consulter les résultats de datation présents dans la base BANADORA, consultable aussi sur https://banadora.mom.fr. |
| |
| Cette API permet d'accéder à une vue //v_results// regroupant l’essentiel des informations sur un échantillons et les résultats de datation associés. | Cette API permet d'accéder à une vue //v_results// regroupant l’essentiel des informations sur un échantillons et les résultats de datation associés. |
| | latitude | GPS latitude (WGS84) | | | latitude | GPS latitude (WGS84) | |
| | longitude | GPS longitude (WGS84) | | | longitude | GPS longitude (WGS84) | |
| | banadora_web_site_result_url | URL de la page du résultat correspondant sur le site principal banadora.mom.fr | | | banadora_web_site_result_url | URL de la page du résultat correspondant sur le site principal banadora.mom.fr, permettant ainsi de référencer/citer l'origine de l'information, et aussi d'obtenir quelques informations complémentaire (archéologue/géologue à l'origine de la demande…) | |
| |
| les retours sont triés (ORDER BY) sur le nom de l'échantillon (sample_name) | les retours sont triés (ORDER BY) sur le nom de l'échantillon (sample_name) |
| <note tip>Cette API REST est basée sur PostgREST, les opérateurs et filtres utilisables peuvent être consulté sur l'aide officielle : https://postgrest.org/en/stable/references/api/tables_views.html#operators</note> | <note tip>Cette API REST est basée sur PostgREST, les opérateurs et filtres utilisables peuvent être consulté sur l'aide officielle : https://postgrest.org/en/stable/references/api/tables_views.html#operators</note> |
| |
| Pour commencer, vous pouvez simplement lancer une requête simple du type : | <note tip>Pour faire vos essais, vous pouvez bien sûr les faire avec votre navigateur web ou en ligne de commande (curl) ou avec un logiciel comme [[https://www.usebruno.com/|Bruno]]</note> |
| | |
| | Pour commencer, vous pouvez simplement lancer une requête simple du type :\\ |
| | ([[https://web-services-arar.mom.fr/api-banadora/v_results?limit=3]]) |
| <code bash> | <code bash> |
| https://web-services-arar.mom.fr/api-banadora/v_results?limit=3 | https://web-services-arar.mom.fr/api-banadora/v_results?limit=3 |
