Veebiteenuste silumine

From services.krediidiinfo.ee
Revision as of 09:57, 3 September 2009 by Rait (talk | contribs) (BUGFIX: näited olid valele urlile, mis nõudis sertifkaati)
Jump to: navigation, search

Serveri testimine

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

Sertifikaati või 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 sertifikaadi 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

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.