A2SP Webservices

Laatste updates

Utrecht, 4 September 2018 10:10:47. Klik hier om de laatste updates te zien.

--RDW Transactionele diensten--

Handleidingen RDW SOAP webservices

URL's

De URL's bevatten een versie nummer en een dienst in het pad. De hostname verwijst naar de omgeving. NB: De productie omgeving is drievoudig uitgevoerd. A2SP kan als het nodig is schakelen tussen die omgevingen, maar de URL blijft constant. Zie onderstaand voorbeelden voor Raadplegen Voertuig (RV):

Acceptatie zonder RDW certificaat:
Acceptatie met RDW certificaat:
Productie met RDW certificaat:
/apiacceptatie.cartalk.nl/7.1/Soap/Rv?wsdl
/rdwapiacceptatie.cartalk.nl/7.1/Soap/Rv?wsdl
/rdwapi.cartalk.nl/7.1/Soap/Rv?wsdl

Versie 7.1 Vanaf 1 april 2017

Documentatie diensten:

Aanvullende documentatie:

--Voertuiginformatie--

Cartalk aansluitingstypes

Er zijn 3 manieren om met Cartalk te communiceren:
  1. Op basis van een vooraf vastgesteld statisch IP adres middels een URL voor het request en met XML als response
  2. Op basis van een SOAP call op basis van een username / password
  3. Op basis van een URL (GET /POST request) met XML als response en op basis van username/password
Optie 1 is alleen bruikbaar onder de volgende voorwaarden:
  1. De facturatie loopt altijd via de eigenaar van de aansluiting. Bij 2 en 3 is het wel mogelijk direct andere gebruikers met een A2SP account te facturen en is de eigenaar van de aansluiting alleen een facilitator/provider.
  2. Het betreft 1 of meer statische IP adressen die alleen door de eigenaar van de aansluiting gebruikt worden. Bij shared hosting van web applicaties worden IP adressen vaak gedeeld door verschillende partijen. In het geval van shared hosting is 1 dus geen optie. Optie 2 en 3 zijn dan wel mogelijk.
  3. Een statisch IP adres van een proxy is sterk af te raden.

Optie 2 is gemakkelijk en snel te implementeren. Belangrijk is wel dat uw ontwikkelplatform SOAP direct ondersteund. De voor- en nadelen zijn dezelfde als voor elke SOAP aansluiting.

Optie 3 is geschikt als SOAP geen wenselijke optie is. Het request is een http request (GET/POST) en het antwoord is een XML bericht.

Performance

Theoretisch gezien is 1 het snelst, daarna 3 en daarna 2. In de praktijk is dit verschil te verwaarlozen.

Handleidingen Cartalk services

Documentatie wordt per aansluiting aangeleverd met een beschrijving van het query-type van de velden en de interface van optie 1. De andere interfaces staan hieronder beschreven.
  1. Cartalk SOAP service (PDF) - - 401-277-2157 - 785-924-3226
  2. Cartalk Simplified REST (PDF)

Voertuigtaxatie

Deze SOAP service is bereikbaar via de volgende URL:
Productie: /webservices.cartalk.nl/1.1/Soap/TaxatieVoertuig?wsdl

Code Samples

Deze meeste SOAP client libs werken 'out-of-the-box'. De combinatie SOAP met Cartalk Voertuig Info en .NET is iets lastiger. Dit 2047463803 bevat voorbeelden om de communicatie tussen .NET en Cartalk SOAP goed te laten verlopen. NB: RDW diensten en SOAP in combinatie met .NET werkt precies zoals verwacht (daar zijn de constructies in het document dus niet nodig).

Tooling

SoapUI is een veelgebruikt tool om services te testen en als referentie implementatie voor een SOAP client. Deze tool ondersteunt ook cliënt certificaten. De open source versie is gratis te downloaden. Let op: versie 4.6.4 lijkt niet goed met het RDW cliënt certificaat te werken. Versie 4.6.1 doet dat wel.

Disclaimer

De documentatie op deze site is zorgvuldig samengesteld. Desondanks kunnen er geen rechten aan worden ontleend. A2SP © 2018