Les WSDL définissent le contrat de service des web services SOAP exposés par FlowerDocs Core.
Ils sont exposés par chaque FlowerDocs Core sous le chemin /services
et publiés en ligne ici.
Authentification
Les requêtes SOAP nécessitent d’être authentifiées pour être acceptées par FlowerDocs Core. Pour cela, il est nécessaire de fournir un jeton utilisateur sous la forme d’un en-tête de l’enveloppe SOAP.
Génération d’un jeton
Le jeton à fournir peut être généré à l’aide du service AuthenticationWSService
qui expose l’opération login :
POST
/core/services/authentication
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:aut="https://flower.com/docs/ws/api/authentication">
<soapenv:Header/>
<soapenv:Body>
<aut:loginRequest>
<aut:scope>{{scope}}</aut:scope>
<aut:user>{{user}}</aut:user>
<aut:password>{{password}}</aut:password>
</aut:loginRequest>
</soapenv:Body>
</soapenv:Envelope>
Fournir le jeton
Pour authentifier un client, le jeton doit être fourni à chaque requête.
Il doit être fourni sous la forme d’un en-tête SOAP sous le namespace flower
:
<soapenv:Header>
<flower:token>{{token}}</flower:token>
<soapenv:Header>
Le namespace flower
peut être défini en ajoutant la définition du préfixe xmlns:flower="flower"
comme attribut du noeud soapenv:Envelope
.