Vous avez reçu un message "Your GitLab account has been locked ..." ? Pas d'inquiétude : lisez cet article https://docs.gricad-pages.univ-grenoble-alpes.fr/help/unlock/

Commit 80bfbcc7 authored by Jerome Touvier's avatar Jerome Touvier
Browse files

add POST doc

parent c9539f24
Pipeline #51383 passed with stage
in 33 seconds
......@@ -151,7 +151,6 @@ The second example specifies the duration of 2 hours prior today’s midnight (U
| | samplerate | Timespans from data with differing sample rates are grouped together. |
| | overlap | Not applicable. |
### Output options
| Parameters | Examples | Discussion |
......@@ -172,8 +171,6 @@ The second example specifies the duration of 2 hours prior today’s midnight (U
| | latestupdate | update-date (past to present), network, station, location, channel, time-range, quality, sample-rate |
| | latestupdate_desc | update-date (present to past), network, station, location, channel, time-range, quality, sample-rate |
<br/>
## /query method additional parameters
### Merge options
......@@ -189,7 +186,36 @@ The second example specifies the duration of 2 hours prior today’s midnight (U
| show | | Comma separated list (example show=latestupdate). |
| | latestupdate | Display the last date of data update. |
<br/>
## HTTP POST queries
/extent and /query methods can be accessed via HTTP POST. All of the parameters that can be submitted with the GET method are allowed in POST.
The general form of a POST is parameter=value pairs, one per line, followed by an arbitrary number of channel and, optionally, time window selection lines:
parameter=\<value\> \
parameter=\<value\> \
parameter=\<value\> \
Net Sta Loc Chan [StartTime EndTime] \
Net Sta Loc Chan [StartTime EndTime] \
...
Start time and end times can be specified globally, such as:
... \
start=2020-10-01T00:00:00 \
end=2020-10-01T00:01:00\
Net1 Sta1 Loc1 Chan1 \
Net2 Sta2 Loc2 Chan2 \
...
or per line:
... \
Net1 Sta1 Loc1 Chan1 2020-10-01T00:00:00 2020-10-01T00:01:00 \
Net2 Sta2 Loc2 Chan2 2020-10-02T00:00:00 2020-10-02T00:02:00 \
...
If not given, the start and end times default to the fully available time range. Additionally, global time ranges can be mixed with individual time ranges.
## Date and time formats
......
......@@ -173,8 +173,6 @@ Le second exemple désigne les 2 dernières heures avant minuit (heure UTC) du j
| | latestupdate | date de mise à jour (du plus ancien au plus récent), network, station, location, channel, période de temps, quality, sample-rate |
| | latestupdate_desc | date de mise à jour (du plus récent au plus ancien), network, station, location, channel, période de temps, quality, sample-rate |
<br/>
## Paramètres additionnels pour /query
### Options de fusion
......@@ -190,7 +188,36 @@ Le second exemple désigne les 2 dernières heures avant minuit (heure UTC) du j
| show | | Liste de paramètres séparés par des virgules (exemple show=latestupdate). |
| | latestupdate | Affiche la date de mise à jour des données. |
<br/>
## Requêtes HTTP POST
Les méthodes /extent et /query peuvent être employées avec le protocole HTTP POST. Tous les paramètres valident avec HTTP GET sont utilisables avec HTTP POST.
La forme générale d'une requête POST est un ensemble de paires parameter=value, une par ligne, suivies d'un nombre arbitraire de canaux et d'une fenêtre temporelle optionnelle :
parameter=\<value\> \
parameter=\<value\> \
parameter=\<value\> \
Net Sta Loc Chan [StartTime EndTime] \
Net Sta Loc Chan [StartTime EndTime] \
...
La fenêtre temporelle peut être précisée globalement :
... \
start=2020-10-01T00:00:00 \
end=2020-10-01T00:01:00 \
Net1 Sta1 Loc1 Chan1 \
Net2 Sta2 Loc2 Chan2 \
...
ou par ligne :
... \
Net1 Sta1 Loc1 Chan1 2020-10-01T00:00:00 2020-10-01T00:01:00 \
Net2 Sta2 Loc2 Chan2 2020-10-02T00:00:00 2020-10-02T00:02:00 \
...
La fenêtre temporelle globale peut être utilisée conjointement avec des fenêtres temporelles individuelles. Si aucune information temporelle n’est précisée, la période maximale de disponibilité est utilisée.
## Formats des dates et des heures
......
......@@ -335,7 +335,6 @@ les valeurs par défaut sont en majuscules</code></pre>
</tr>
</tbody>
</table>
<p><br/></p>
<h2 id="paramètres-additionnels-pour-query">Paramètres additionnels pour /query</h2>
<h3 id="options-de-fusion-1">Options de fusion</h3>
<table>
......@@ -386,7 +385,28 @@ les valeurs par défaut sont en majuscules</code></pre>
</tr>
</tbody>
</table>
<p><br/></p>
<h2 id="requêtes-http-post">Requêtes HTTP POST</h2>
<p>Les méthodes /extent et /query peuvent être employées avec le protocole HTTP POST. Tous les paramètres valident avec HTTP GET sont utilisables avec HTTP POST.</p>
<p>La forme générale d’une requête POST est un ensemble de paires parameter=value, une par ligne, suivies d’un nombre arbitraire de canaux et d’une fenêtre temporelle optionnelle :</p>
<p>parameter=&lt;value&gt;<br />
parameter=&lt;value&gt;<br />
parameter=&lt;value&gt;<br />
Net Sta Loc Chan [StartTime EndTime]<br />
Net Sta Loc Chan [StartTime EndTime]<br />
</p>
<p>La fenêtre temporelle peut être précisée globalement :</p>
<p><br />
start=2020-10-01T00:00:00<br />
end=2020-10-01T00:01:00<br />
Net1 Sta1 Loc1 Chan1<br />
Net2 Sta2 Loc2 Chan2<br />
</p>
<p>ou par ligne :</p>
<p><br />
Net1 Sta1 Loc1 Chan1 2020-10-01T00:00:00 2020-10-01T00:01:00<br />
Net2 Sta2 Loc2 Chan2 2020-10-02T00:00:00 2020-10-02T00:02:00<br />
</p>
<p>La fenêtre temporelle globale peut être utilisée conjointement avec des fenêtres temporelles individuelles. Si aucune information temporelle n’est précisée, la période maximale de disponibilité est utilisée.</p>
<h2 id="formats-des-dates-et-des-heures">Formats des dates et des heures</h2>
<pre><code>YYYY-MM-DDThh:mm:ss[.ssssss] ex. 1997-01-31T12:04:32.123
YYYY-MM-DD ex. 1997-01-31 (une heure de 00:00:00 est supposée)
......
......@@ -312,7 +312,6 @@ format-options :: [format=&lt;TEXT|geocsv|json|request|zip&gt;]</code></p
</tr>
</tbody>
</table>
<p><br/></p>
<h2 id="query-method-additional-parameters">/query method additional parameters</h2>
<h3 id="merge-options-1">Merge options</h3>
<table>
......@@ -358,7 +357,28 @@ format-options :: [format=&lt;TEXT|geocsv|json|request|zip&gt;]</code></p
</tr>
</tbody>
</table>
<p><br/></p>
<h2 id="http-post-queries">HTTP POST queries</h2>
<p>/extent and /query methods can be accessed via HTTP POST. All of the parameters that can be submitted with the GET method are allowed in POST.</p>
<p>The general form of a POST is parameter=value pairs, one per line, followed by an arbitrary number of channel and, optionally, time window selection lines:</p>
<p>parameter=&lt;value&gt;<br />
parameter=&lt;value&gt;<br />
parameter=&lt;value&gt;<br />
Net Sta Loc Chan [StartTime EndTime]<br />
Net Sta Loc Chan [StartTime EndTime]<br />
</p>
<p>Start time and end times can be specified globally, such as:</p>
<p><br />
start=2020-10-01T00:00:00<br />
end=2020-10-01T00:01:00<br />
Net1 Sta1 Loc1 Chan1<br />
Net2 Sta2 Loc2 Chan2<br />
</p>
<p>or per line:</p>
<p><br />
Net1 Sta1 Loc1 Chan1 2020-10-01T00:00:00 2020-10-01T00:01:00<br />
Net2 Sta2 Loc2 Chan2 2020-10-02T00:00:00 2020-10-02T00:02:00<br />
</p>
<p>If not given, the start and end times default to the fully available time range. Additionally, global time ranges can be mixed with individual time ranges.</p>
<h2 id="date-and-time-formats">Date and time formats</h2>
<pre><code>YYYY-MM-DDThh:mm:ss[.ssssss] ex. 1997-01-31T12:04:32.123
YYYY-MM-DD ex. 1997-01-31 (a time of 00:00:00 is assumed)
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment