Veebiteenuste silumine

In English

Serveri testimine

Krediidiinfo SOAP serverisse on sisse ehitatud mõningad silumist ja serveri testimist hõlbustavad võimalused.

SOAP serverit saab kontrollida brauseris päringuga https://services.krediidiinfo.ee/soap.php?ping.

Tulemuseks on vastus: KI SOAP server is working!

Võimalus on teha tühipäringut aadressiga https://services.krediidiinfo.ee/soap.php?dummy_response. Päringu tulemuseks on standartne SOAP veateade kujul:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
        <SOAP-ENV:Body>
                <SOAP-ENV:Fault>
                        <faultcode>SOAP-ENV:Server</faultcode>
                        <faultstring>Bad Request. Can't find HTTP_RAW_POST_DATA [DUMMY RESPONCE]</faultstring>
                </SOAP-ENV:Fault>
        </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Päringut saab kasutada arenduse esimeses faasis programmi või ühenduse testimiseks.

Veebiteenuste silumine

Mõningaid veebiteenuseid saab käivitada silumise režiimis. Silumise režiimis suhtleb server kliendiga, kuid kliendi poolt saadetud päringuid ei töödelda rakendusskeskkonnas vaid silumiseks loodud testkeskkonnas.

Silumise režiimis päringute jaoks tuleb veebiteenuse URL-i lõppu lisada parameeter debug.

Näiteks KiDocExchange liidese korral, mille URL on:

https://services.krediidiinfo.ee/soap.php?name=KiDocExchange

tuleks kasutada URL-i:

https://wservices.krediidiinfo.ee/soap.php?name=KiDocExchange&debug

NB! Silumise režiimis tehtavate päringute jaoks peab Krediidiinfo andma kasutajale vastava õiguse. Kui seda õigust ei ole, siis tekib pärimisel viga koodiga -20004.

Veaolukorrad

Kui SOAP päring ebaõnnestub, siis server saadab tagasi vea teate ja koodi standartse SOAP veateatega. SOAP veavastuses on Fault märgend, mille alammärgendissedetails lisatakse täiendavat informatsiooni vea kohta.

   * Fault\details\errorcode - Vea kood
   * Fault\details\exception_name - Eriolukorra nimi
   * Fault\details\line_no - Rea number, kus veaolukord tekkis.

Vea koodist, exceptioni nimest ja rea numbrist on abi Krediidiinfo tehnilisel toel vea täpsema põhjuse tuvastamiseks.

Vea tekkimisel tasub veakoodi tähendust otsida kõigepealt veebiteenuse dokumentatsioonist, seejärel üldistest veakoodidest ning kui ikka veakoodi tähendust ei leita, pöörduda Krediidiinfo tehnilise toe poole.