Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

U kunt SoapUI (https://www.soapui.org/downloads/soapui.html)  gebruiken om de webservice van Cloudplan te testen.  Het programma SoapUI kan voorbeeldrequests genereren op basis van de WSDL.  

Hieronder staat kort beschreven hoe u dat kunt doen:



Image Modified

Start SoapUI en kies voor new Soap project

Image Modified

Ga naar https://api.cloudplan.nl/v1 en kopieer het adres van de WSDL

Image Modified

Plak het adres in het venster en druk op ok.

SoapUI genereert nu voorbeeld XML voor inloggen en uitloggen via de webservice met behulp van de informatie in de authenticatie wsdl.

Image Modified

Rechtermuisknop op project, en kies voor 'add wsdl'. 

Image Modified

Plak hier het adres van WSDL van de resourceservice . (zie  https://api.cloudplan.nl/v1 voor het adres) toe en druk op Ok.

Image Modified

Nu we de authenticatieservice en resourceservice hebben toegevoegd kunnen we inloggen en resources ophalen.

Om in te loggen, open het voorbeeldrequest van de login en vul hier gebruikersnaam en wachtwoord in. Druk daarna op de groene knop.

Image Modified

Als de authenticatie is gelukt, verschijnt het authenticatietoken in de respons. 

Image Modified

Open het voorbeeld voor getResources en plak de eerder verkregen authenticationtoken bij <token>.


Info

De matcher bepaalt welke gegevens worden opgehaald.  Binnen een matcher zijn diverse elementen beschikbaar om op te zoeken. Sommige elementen hoeven niet gespecificeerd te worden. Deze zijn te herkennen aan het Optional commentaar boven de tag.


Bewerk het voorbeeld zodat het eruitziet zoals hier links en druk weer op de groene knop om de

gegevens naar de webservice te sturen

resources op te halen.  De webservice zal alle gevonden resources terugsturen.


Warning

In dit voorbeeld worden alle resources opgehaald. Als u zeer veel resources verwacht kunt u hiermee een zware belasting van de webservice veroorzaken.  Planning.nl kan de verbinding dan verbreken en voorkomen dat u de webserver

overbelast

verder (over)belast.  Laat bij grote hoeveelheden data de matcher nooit leeg, zodat de webservice niet alles

terugstuurt

ophaalt maar de hoeveelheid data beperkt.

De webservice zal alle gevonden resources terugsturen.

Warning

Let op bij delete.. dat de matcher niet leeggelaten wordt. Cloudplan zal alle gevonden gegevens verwijderen! Hetzelfde geldt voor een push.!