Différences

Ci-dessous, les différences entre deux révisions de la page.

--- cdrc:web:api_rest [2025/08/05 09:56] – créée bertrand
+++ cdrc:web:api_rest [2025/08/05 10:05] (Version actuelle) – [Utilisation] bertrand
@@ Ligne 1: / Ligne 1: @@
 ====== 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.
@@ Ligne 38: / Ligne 38: @@
 | latitude						   | GPS latitude (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)
 ===== Utilisation =====
-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
-Pour commencer, vous pouvez simplement lancer une requête simple du type :
+<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>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>
 https://web-services-arar.mom.fr/api-banadora/v_results?limit=3