Publication de jaugeages hydro (**déprécié**)
=============================================

Ce web-service permet de publier des jaugeages

Paramètres HTTP
---------------

========= =============
Paramètre Valeur
========= =============
Route     jaugeage
Méthode   GET
========= =============

Paramètres URL
--------------

========= ============================ ========= ===
Nom       Description                  Type      O/F
========= ============================ ========= ===
cdentites liste de codes de station    list(str) O
          et/ou de codes de site
dtdebut   date de début                datetime  F
dtfin     date de fin                  datetime  F
dtmaj     date de mise à jour          datetime  F
========= ============================ ========= ===

Droit de publication
--------------------

Les droits de publication appliqués pour ce service web sont liés aux entités hydro.

Pour publier un jaugeage dans son intégralité, il doit avoir les bons droits sur le site de jaugeage
et les bons droits sur les stations associées aux hauteurs de jaugeage.

Si l'entité est un site hydrométrique :
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Les jaugeages d'un site hydro public sont publics.
IL n'est pas nécessaires d'être authentifié pour les publier.

L'authentification est obligatoire pour les autres sites hydro.

Dans le cas d'un site restreint, l'utilisateur doit avoir le profil institutionnel ou posséder un 
rôle sur le site.

Et dans le cas d'un site privé, l'utilisateur doit posséder un 
rôle sur le site.

Si l'entité est une station hydrométrique:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

L'utilisateur doit au préalable posséder des bons droits sur le site de la station.

Les hauteurs de jaugeage d'une station hydrométrique publique sont publics.
Il n'est pas nécessaire de s'authentifier pour les publier. 

pour les autres stations, l'authentification est obligatoire

Dans le cas d'une station restreinte, "H publique", "Q public" ou "publiques sans courbes",
l'utilisateur doit avoir le profil institutionnel ou posséder un rôle sur la station pour publier
des hauteurs de jaugeages.

Et dans le cas d'une station privée, l'utilisateur doit posséder un rôle sur la station.

Réponse du web-service
----------------------

Le web-service renvoie un json hydrométrie contenant les jaugeages à publier.

Le json hydrométrie contient les deux propriétés Scenario et Donnees.

Donnees
^^^^^^^

L'objet Donnees contiendra l'unique propriété Jaugeages.

Jaugeages est une liste d'objets Jaugeage non vide.

Jaugeage
^^^^^^^^

L'objet Jaugeage contiendra les propriétés suivantes:

- CdJaugeage
- DtJaugeage
- DebitJaugeage
- DtDebJaugeage
- DtFinJaugeage
- SectionMouilJaugeage
- PerimMouilleJaugeage
- LargMiroirJaugeage
- ModeJaugeage
- ComJaugeage
- VitesseMoyJaugeage
- VitesseMaxJaugeage
- VitesseMoySurfaceJaugeage
- CdSiteHydro
- HauteursJaugeage : liste non vide d'objets HauteurJaugeage
- DtMajJaugeage
- NumJaugeage
- IncertCalJaugeage
- IncertRetenueJaugeage
- QualifJaugeage
- ComPrivJaugeage
- CourbesTarage : liste non vide d'objets CourbeTarage 

HauteurJaugeage
^^^^^^^^^^^^^^^

- CdStationHydro
- SysAltiStationJaugeage
- CoteRetenueStationJaugeage
- CoteDebutStationJaugeage
- CoteFinStationJaugeage
- DnStationJaugeage
- DistanceStationJaugeage
- StationFille : objet StationFille
- DtDebRefAlti

StationFille
^^^^^^^^^^^^

L'objet StationFille contient l'unique propriété CdStationHydro.

CourbeTarage
^^^^^^^^^^^^

Propriétés de l'objet CourbeTarage:

- CdCourbeTarage
- LbCourbeTarage


Exemple
^^^^^^^

.. code-block:: json
   :caption: Jaugeages au format json

   {
     "Scenario": {},
     "Donnees": {
       "Jaugeages": [
         {
           "CdJaugeage": 0,
           "DtJaugeage": "2022-01-01T09:30:00",
           "DebitJaugeage": "2000",
           "DtDebJaugeage": "2022-01-01T09:00:00",
           "DtFinJaugeage": "2022-01-01T10:00:00",
           "SectionMouilJaugeage": 198.5,
           "PerimMouilleJaugeage": 205.3,
           "LargMiroirJaugeage": 156.4,
           "ModeJaugeage": 2,
           "ComJaugeage": "Cmnt",
           "VitesseMoyJaugeage": 0.86,
           "VitesseMaxJaugeage": 0.97,
           "VitesseMoySurfaceJaugeage": 0.91,
           "CdSiteHydro": "A1234567",
           "HauteursJaugeage" : [
             {
               "CdStationHydro":"A123456789",
               "SysAltiStationJaugeage": 31,
               "CoteRetenueStationJaugeage": 87.4,
               "CoteDebutStationJaugeage": 86.5,
               "CoteFinStationJaugeage": 88.9,
               "DnStationJaugeage": 841.2,
               "DistanceStationJaugeage": -54,
               "StationFille": "0"
             }
           ],
           "DtMajJaugeage": "2023-01-01T00:00:00",
           "NumJaugeage": 0,
           "IncertCalJaugeage": 15.6,
           "IncertRetenueJaugeage": 14.7,
           "QualifJaugeage": 1,
           "ComPrivJaugeage": "Cmnt privé",
           "CourbesTarage" : [
             {
               "CdCourbeTarage": 0,
               "LbCourbeTarage": "Lb"
             }
           ] 
         }
       ]
     }
   }
