Endpoints

De ShopServer is bereikbaar door gebruik te maken van WCF (Windows Communication Foundation). Via een HTTPS verbinding is een WCF service (.svc) op te vragen waarlangs alle methodes beschikbaar gesteld worden. Dit wordt ook wel een endpoint genoemd.

Elke ShopServer update krijgt een eigen endpoint URL. Op die URL zijn de methods te vinden die horen bij die update versie. Een volgende update krijgt weer een nieuwe endpoint URL terwijl de oude endpoint URL’s actief blijven. De oude endpoint URL’s veranderen niet qua inhoud of werking en blijven dus werken, zolang het endpoint door NedFox ondersteund wordt.

De meest recente endpoint op dit moment is ShopServerService201605.svc. Door eventueel ?wsdl toe te voegen aan deze endpoint wordt de WSDL representatie getoond. Op dat moment is de endpoint ook via Soap 1.2 bereikbaar voor bijvoorbeeld PHP integraties.

Op de productie omgeving zijn de endpoints bereikbaar op https://shopserver.nedfox.net/ gevolgd door bovenstaande endpoint naam.

PHP

Let op: In PHP is het gebruik van SOAP libraries vereist. Omdat PHP bij elk request opnieuw de WSDL definities van de server download is het noodzakelijk om deze definities eenmaal te downloaden en 'lokaal' op te slaan. De WSDL definities kunnen in de toekomst immers veranderen als gevolg van een update van de ShopServer. Door gebruik te maken van de ten tijde van het ontwikkelen van de ShopServer lokaal opgeslagen WSDL definitie zal de definitie voor de PHP sourcecode niet meer veranderen. De ShopServer server omgeving zorgt zelf voor de backward comptabiliteit van oudere WSDL aanvragen door middel van de eerder genoemde verschillende endpoints.

Om een WSDL definitie lokaal op te kunnen slaan heeft NedFox een WSDL export web pagina ontwikkeld. Deze is op te vragen via http://wsdlexporter.shopserver.nedfox.net/ gevolgd door de jaar en maand component van de gewenste endpoint. Voorbeeld: http://wsdlexporter.shopserver.nedfox.net/201410

Het is dus belangrijk om wanneer er gebruik gemaakt gaat worden van een ander endpoint, daar eerst nieuwe wsdl proxies voor aan te maken.