Publication des rôles de contacts de sites météo
================================================

Ce web-service permet de publier les rôles de contacts sur des sites météo.

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

========= =================
Paramètre Valeur
========= =================
Route     contactssitemeteo
Méthode   POST
========= =================

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

Les paramètres doivent être transmis dans le contenu de la requête au format format JSON.

============ ============================= ========= ===
Nom          Description                   Type      O/F
============ ============================= ========= ===
cdsitesmeteo Liste de codes de sites météo list(str  O
dtmaj        Date de mise à jour           datetime  F     
actif        Rôle actif                    bool      F
============ ============================= ========= ===

Paramètre actif
^^^^^^^^^^^^^^^

Par défaut le web-service ne renvoie que les rôles actifs.

Avec le paramètre actif=false, le web-service renvoie uniquement les rôles désactivés.

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

Les droits de publication appliqués pour ce service web sont ceux liés
aux sites météo passés en paramètre (paramètre cdsitesmeteo).

Pour un site météo public (affichage public = true),
n'importe quel utilisateur peut avoir accès aux données du site qu'il soit authentifié ou non.

Pour accéder aux données d'un site météo privé (affichage public = false), l'authentification de
l'utilisateur est obligatoire, et le contact doit être lié au site avec n’importe quel rôle pour
pouvoir afficher ses données.

.. _contactsitemeteo:

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

Le web-servie renvoie un json hydrométrie contenant des objets SiteMeteo
contenant chacun une liste d'objets RolContactSiteMeteo.

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

RefHyd
^^^^^^

L'objet RefHyd contiendra l'unique propriété SitesMeteo.

SitesMeteo est une liste d'objets SiteMeteo non vide.

SiteMeteo
^^^^^^^^^

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

- CdSiteMeteo
- RolsContactSiteMeteo : liste non vide d'objets RolContactSiteMeteo.

RolContactSiteMeteo
^^^^^^^^^^^^^^^^^^^

Chaque objet RolContactSiteMeteo pourra contenir les propriétés suivantes:

- CdContact
- RoleContactSiteMeteo
- DtDebutContactSiteMeteo
- DtFinContactSiteMeteo
- DtMajRoleContactSiteMeteo

Exemple
^^^^^^^

.. code-block:: json
   :caption: Rôles de contacts sur des sites météo au format json

   {
     "Scenario": {},
     "RefHyd": {
       "SitesMeteo": [
         {
           "CdSiteMeteo": "00000000",
           "RolsContactSiteHydro": [
             {
               "CdContact": "0",
               "RoleContactSiteMeteo": "ADM",
               "DtDebutContactSiteMeteo": "2010-01-01T00:00:00", 
               "DtFinContactSiteMeteo": "2020-01-01T00:00:00",
               "DtMajRoleContactSiteMeteo": "2021-01-01T00:00:00"
             }
           ]
         }
       ]
     }

