LoginService

Version : 2.1 · Décembre 2025

Le LoginService authentifie un utilisateur et renvoie un authToken requis par tous les autres services Shivah WS.

---

Méthodes

Méthode	Description
getAuth	Crée un jeton d'authentification pour l'utilisateur indiqué si les identifiants sont valides

getAuth

Action : http://dpd.com/common/service/LoginService/2.1/getAuth

Entrée :

Nom	Élément
parameters	types:getAuth

Sortie :

Nom	Élément
parameters	types:getAuthResponse

Erreurs :

Nom	Élément
parameters	types_authentication:authenticationFault

---

Exemples

getAuth — SOAP

POST {baseUrl}/services/LoginService

Corps de la requête :

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ns="http://dpd.com/common/service/types/LoginService/2.1">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:getAuth>
      <delisId>{your delisId}</delisId>
      <password>{your password}</password>
      <messageLanguage>de_CH</messageLanguage>
    </ns:getAuth>
  </soapenv:Body>
</soapenv:Envelope>

Réponse (succès) :

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <getAuthResponse xmlns="http://dpd.com/common/service/types/LoginService/2.1">
      <return>
        <delisId>{your delisId}</delisId>
        <customerUid>{your customerUid}</customerUid>
        <authToken>{your authToken}</authToken>
        <depot>{your sendingDepot}</depot>
        <authTokenExpires>2026-10-01T09:59:28.0000000Z</authTokenExpires>
      </return>
    </getAuthResponse>
  </soap:Body>
</soap:Envelope>

Réponse (erreur) :

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <soap:Fault>
      <faultcode>soap:Server</faultcode>
      <faultstring>Authentication failed</faultstring>
      <detail>
        <ns:authenticationFault xmlns:ns="http://dpd.com/common/service/types/Authentication/2.0">
          <errorCode>UNAUTHORIZED</errorCode>
          <errorMessage>AUTH-INVALID-CREDENTIALS: Unauthorized, invalid credentials...</errorMessage>
        </ns:authenticationFault>
      </detail>
    </soap:Fault>
  </soap:Body>
</soap:Envelope>

getAuth — REST

POST {baseUrl}/services/LoginService/getAuth

Corps de la requête :

{
  "delisID": "{your delisId}",
  "password": "{your password}",
  "messageLanguage": "de_CH"
}

Réponse (succès) :

{
  "getAuthResponse": {
    "return": {
      "delisId": "{your delisId}",
      "customerUid": "{your customerUid}",
      "authToken": "{your authToken}",
      "depot": "{your sendingDepot}",
      "authTokenExpires": "2021-07-16T05:39:03.9133333Z"
    }
  },
  "status": {
    "type": "OK",
    "code": "200",
    "message": "valid"
  }
}

Réponse (erreur) :

{
  "getAuthResponse": null,
  "status": {
    "type": "AuthenticationFault",
    "code": "DELICOM_ERR_AUTHENTICATION",
    "message": "Authentication failure, check delisId and password."
  }
}

---

Types complexes

Espace de noms : types

URL : http://dpd.com/common/service/types/LoginService/2.1

Login

Contient les informations de connexion renvoyées après une authentification réussie.

Champ	Type / Occurrence	Description
delisId	xsd:string / 1..1	Le DELIS-Id de l'utilisateur
customerUid	xsd:string / 1..1	L'UID client de l'utilisateur (généralement identique au DELIS-Id pour les comptes non secondaires)
authToken	xsd:string / 1..1	JWT (HS256) nécessaire aux autres appels de services web. Longueur variable — prévoyez au moins 2048 caractères
depot	xsd:string / 1..1	Le dépôt auquel l'utilisateur est rattaché
authTokenExpires	xsd:dateTime / 1..1	Date et heure UTC d'expiration du jeton

getAuth

Champ	Type / Occurrence	Description
delisId	xsd:string / 1..1	Le DELIS-Id de l'utilisateur
password	xsd:string / 1..1	Le mot de passe de l'utilisateur
messageLanguage	xsd:string / 1..1 · length: 5	Langue des messages : de_CH, fr_CH, it_CH, en_CH

getAuthResponse

Champ	Type / Occurrence	Description
return	types:Login / 1..1	L'objet de résultat de connexion

Espace de noms : types_authentication

URL : http://dpd.com/common/service/types/Authentication/2.0

authenticationFault

Champ	Type / Occurrence	Description
errorCode	xsd:string / 1..1	Le code d'erreur
errorMessage	xsd:string / 1..1 · maxLength: 255	Le texte du message d'erreur

---

Éléments

Espace de noms : types

Élément	Type	Description
getAuth	types:getAuth / 1..1	Paramètre d'entrée de getAuth
getAuthResponse	types:getAuthResponse / 1..1	Paramètre de sortie de getAuth

Espace de noms : types_authentication

Élément	Type	Description
authenticationFault	Type complexe anonyme	Élément d'erreur d'authentification

---

Points d'accès

Environnement	Protocole	URL
Stage	SOAP	https://shivah-st.dpd.ch/external/soap/services/LoginService
Live	SOAP	https://shivah.dpd.ch/external/soap/services/LoginService
Stage	REST	https://shivah-st.dpd.ch/external/rest/services/LoginService/getAuth
Live	REST	https://shivah.dpd.ch/external/rest/services/LoginService/getAuth