Suppression d’un rôle d’un contact à un site météo¶

Ce web-service permet de supprimer un rôle d’un contact sur une site météo.

Paramètres HTTP¶

Paramètre	Valeur
Route	contatcsitemeteo
Méthode	DELETE
Contenu	un rôle d’un contact sur un site météo

Droit de gestion¶

Pour supprimer un rôle d’un contact, il faut être administrateur du site météo.

Règles techniques¶

le contact doit exister et être actif.
le site météo doit exister
Le dernier rôle ADM d’un site météo ne peut pas être supprimé
Le rôle à ajouter doit appartenir à la liste suivante: ADM, POLE2, POLE3, POLE4, VISU.

Contenu de la requête HTTP¶

La requête HTTP doit contenir un json hydrométrie contenant un rôle d’un contact sur un site météo.

Json hydrométrie¶

Schéma de validation¶

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://phyc.org/ws/supprimerContactSiteMeteo.json",
  "type": "object",
  "properties": {
    "Scenario": {
      "type": "object"
    },
    "RefHyd": {
      "type": "object",
      "properties": {
        "SitesMeteo": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "CdSiteMeteo": {"type": "string"},
              "RolsContactSiteMeteo": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "CdContact": {"type":  "string"},
                    "RoleContactSiteMeteo": {"type":  "string"}
                  },
                  "required": ["CdContact", "RoleContactSiteMeteo"],
                  "additionalProperties": false
                },
                "minItems": 1
              }
            },
            "required": ["CdSiteMeteo", "RolsContactSiteMeteo"],
            "additionalProperties": false
          },
          "minItems": 1
        }
      },
      "required": ["SitesMeteo"],
      "additionalProperties": false
    }
  },
  "required": ["Scenario", "RefHyd"],
  "additionalProperties": false
}

Les attributs RefHyd (associé à l’objet Refhyd) et Scenario sont obligatoires;
L’objet RefHyd ne doit contenir qu’un seul attribut SitesMeteo associé à une liste non vide d’objets SiteMeteo;
L’objet SiteMeteo doit contenir les attributs CdSiteMeteo et RolsContactSiteMeteo;
L’attribut RolsContactSiteMeteo doit être une liste non vide d’objets RolContactSiteMeteo;
L’objet RolContactSiteMeteo doit contenir uniquement les attributs CdContact et RoleContactSiteMeteo.

Erreurs¶

La PHyC émet des erreurs si:

le paramètre idsession n’est pas fourni ou est périmé
l’utilisateur ne dispose pas des droits pour supprimer un rôle au site météo
le json n’est pas conforme
suppression d’un rôle non autorisé
le site météo n’existe pas
le contact n’existe pas ou n’est pas actif

Réponse du web-service¶

En cas de succès, le web-service retournera un json hydrométrie contenant le rôle du contact désactivé.

Le web-service rajoutera les attributs DtFinContactSiteMeteo et DtMajRoleContactSiteMeteo au rôle du contact.