Tuotantoliittymäkuvaus
https://go.nepton.com/API/SOAPWebService.asmx
Varmistathan myös tarpeellisten IP-osoitteiden avaukset. Ohje täältä.
Henkilötietojen sovellusliittymät tarjoavat ulkoisille järjestelmille pääsyn tiettyihin Neptonin ominaisuuksiin ja tietoihin. Liittymän WSDL-kuvaus löytyy osoitteesta https://go.nepton.com/API/SOAPWebService.asmx?wsdl.
Pyyntö on välitettävä SOAP-pyyntönä POST-metodia käyttäen. HTTP-otsikko "Content-Type" tulee olla arvolla "text/xml; charset=utf-8".
Seuraavissa artikkeleissa on aihekohtaiset ohjeet:
- Tunnistautuminen henkilötietojen sovellusliittymiin
- Henkilötietojen sovellusliittymien vastausviestit ja -koodit
- Henkilötietojen sovellusliittymä
- Yksiköiden sovellusliittymä
Huomioithan, että:
- Lähetettävän XML:n pitää olla kelvollista (valid XML)
- Merkistökoodauksen tulee olla UTF-8
Paras tapa varmistaa XML:n oikeellisuus on käyttää SOAP-kirjastoja pyyntöjen ja vastauksien käsittelyyn. Esimerkiksi PHP:n SoapClient tai .NET:in WCF Web Service Reference toimivat.
Jos XML generoidaan käyttämättä siihen mitään XML-kirjastoa, tulee pitää mielessä että seuraavat merkit tulee esittää niiden entityinä.
| Merkki | Entity |
|---|---|
& |
& |
< |
< |
> |
> |
Jos XML:ssä halutaan esimerkiksi esittää salasana "HpR9cHN&f8C<", se pitäisi tehdä seuraavasti:
<UserPassword>HpR9cHN&f8C<</UserPassword>