services.krediidiinfo.ee - User contributions [en]

Sandbox

2012-05-30T12:04:22Z

Sass:

asd1
<multilang>@de|"Das ist ein deutscher Text." @en|"This is an English text."</multilang>
asd2
<multilang />
asd3

Sandbox

2012-05-30T10:18:28Z

Sass:

asd1
<multilang>
@de|"Das ist ein deutscher Text."
@en|"This is an English text."
</multilang>
asd2
<multilang />
asd3

Sandbox

2012-05-30T10:11:59Z

Sass:

asd1
<multilang>
@et|"Eesti keeles, oo jaaa."
@en|"This is an English text."
</multilang>
asd2

Tehniline tugi

2012-05-02T12:20:49Z

Sass:

Tehniline tugi

Vladimir Rüntü

tel: +372 665 9631

e-post: vladimir.runtu@krediidiinfo.ee

Tehniline tugi

2012-05-02T12:20:32Z

Sass:

Tehniline tugi.

Vladimir Rüntü
tel: +372 665 9631
e-post: vladimir.runtu@krediidiinfo.ee

Main Page

2012-05-02T12:19:07Z

Sass: /* Krediidiinfo veebiteenused */

Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.

= Tutvustus =
* [[Mis asi on veebiteenus? | Mis on veebiteenus?]]

= Krediidiinfo veebiteenused =
* [[KiReport]]
* [[KiDocExchange]]
* [[KiCompanyBasic]]
* [[KiCompany]]
* [[KiCreditManagement]]

= Arendajatele =
* [[Krediidiinfo veebiteenuste arhitektuur]]
* [[Autentimine]]
* [[Veebiteenuste silumine]]
* [[Veatöötlus]]
* [[Veakoodid]]
* [[SOAP teenuse testimine]]
* [[Tehniline tugi]]
* Kasutatavad standardid/protokollid
** [http://www.w3schools.com/xml/default.asp XML]
** [http://www.w3schools.com/schema/default.asp XML Schema]
** [http://www.w3schools.com/soap/default.asp SOAP]
** [http://www.w3schools.com/wsdl/default.asp WSDL]

= Näidised =
* [[KiCompanyBasic | KiCompanyBasic - '''Tasuta liides!''']]

KiReport en

2012-03-05T11:46:10Z

Sass: /* WSDL */

{| align="right"
| [[Image:Flag of Estonia.svg|border|30px]] [[KiReport|eesti keeles]]
|}
= Introduction =

KiReport is the name of a Web Service based on SOAP protocol for requesting reports about companies and persons. Requested reports are in XML format.

= WSDL =

WSDL is located at [http://services.krediidiinfo.ee/KiReport.wsdl http://services.krediidiinfo.ee/KiReport.wsdl].

= Methods =

== ''getReport'' ==

Report requesting

{| style="border-style: solid; border-width: 1px;"
!
! Name
! Type
! Description
|-
| Input:
| productCode
| xs:string
| Report (product) code
|-
| 
| subjectCode
| xs:string
| Subject code. (Depending on report subject can be a registry code of a company, personal identity code, etc)
|-
| Output::
| xml
| xs:string
| Requested report in XML format.
|}

=Example in PHP =

Example of using KiReport in PHP:

<code><pre>
<?php
/**
* Example of using KiReport web service of Krediidiinfo AS
* Certificate issued by Krediidiinfo is needed to use KiReport interface.
*
* @author Rait Kapp <rait@krediidiinfo.ee>
* @created 18.09.2007
*/

$wsdl_url = 'http://services.krediidiinfo.ee/KiReport.wsdl';
$server_url = 'https://services.krediidiinfo.ee/soap.php?name=KiReport';

$params = array('location' => $server_url
, 'login' => 'online_code' // Online Code issued by Krediidiinfo client management. Make sure that login value is string type (PHP bug?).
, 'password' => 'passwd'

/* If you want to use certificate, then uncomment this block and comment params login and password!
, 'local_cert' => 'path/certificate.pem' // Here goes path to certificate file.
, 'passphrase' => 'passwd' // Here goes password of certificate.
*/
// , 'proxy_host' => 'cache.neti.ee' // If necessary use proxy and proxy port.
// , 'proxy_port' => 8080
, 'encoding' => 'ISO-8859-13'
);

$client = new SoapClient($wsdl_url, $params);

$productCode = 'RAXXXE';
$subjectCode = '00000000';

$xml = $client->getReport($productCode, $subjectCode);

print_r($xml);

?>
</pre></code>

= Debugging =

Developers can always use example report ''RAXXXE'' (''productCode'') for debugging. It is free of charge. The XML Schema of ''RAXXXE'' can be obtained from [http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd].

The example of ''RAXXXE'':

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<report xmlns="http//www.krediidiinfo.ee/schemas/report/RAXXXE.xsd">
<date_tag>2007-10-23</date_tag>
<date_time>2007-10-23T10:10:42</date_time>
<int_tag>12345</int_tag>
<decimal_tag>123456.789</decimal_tag>
<string_tag>I am a string</string_tag>
<codes_tag>&amp; ' &quot; &lt; &gt;</codes_tag>
<est_character_tag>õ ä ö ü Õ Ä Ö Ü</est_character_tag>
<subject_code>00000000</subject_code>
</report>
</pre>

The input parameter ''subjectCode'' value is always assigned to the tag ''subject_code''.

= Error Codes =

==-20101 No permission for PRODUCT_CODE! ==

Krediidiinfo has not granted permission for client to request certain report. To get permissions contact [[Klienditugi| client support]].

KiReport en

2012-03-05T11:45:16Z

Sass: vigane url

{| align="right"
| [[Image:Flag of Estonia.svg|border|30px]] [[KiReport|eesti keeles]]
|}
= Introduction =

KiReport is the name of a Web Service based on SOAP protocol for requesting reports about companies and persons. Requested reports are in XML format.

= WSDL =

WSDL can be obtained from: [http://services.krediidiinfo.ee/KiReport.wsdl KiReport.wsdl].

= Methods =

== ''getReport'' ==

Report requesting

{| style="border-style: solid; border-width: 1px;"
!
! Name
! Type
! Description
|-
| Input:
| productCode
| xs:string
| Report (product) code
|-
| 
| subjectCode
| xs:string
| Subject code. (Depending on report subject can be a registry code of a company, personal identity code, etc)
|-
| Output::
| xml
| xs:string
| Requested report in XML format.
|}

=Example in PHP =

Example of using KiReport in PHP:

<code><pre>
<?php
/**
* Example of using KiReport web service of Krediidiinfo AS
* Certificate issued by Krediidiinfo is needed to use KiReport interface.
*
* @author Rait Kapp <rait@krediidiinfo.ee>
* @created 18.09.2007
*/

$wsdl_url = 'http://services.krediidiinfo.ee/KiReport.wsdl';
$server_url = 'https://services.krediidiinfo.ee/soap.php?name=KiReport';

$params = array('location' => $server_url
, 'login' => 'online_code' // Online Code issued by Krediidiinfo client management. Make sure that login value is string type (PHP bug?).
, 'password' => 'passwd'

/* If you want to use certificate, then uncomment this block and comment params login and password!
, 'local_cert' => 'path/certificate.pem' // Here goes path to certificate file.
, 'passphrase' => 'passwd' // Here goes password of certificate.
*/
// , 'proxy_host' => 'cache.neti.ee' // If necessary use proxy and proxy port.
// , 'proxy_port' => 8080
, 'encoding' => 'ISO-8859-13'
);

$client = new SoapClient($wsdl_url, $params);

$productCode = 'RAXXXE';
$subjectCode = '00000000';

$xml = $client->getReport($productCode, $subjectCode);

print_r($xml);

?>
</pre></code>

= Debugging =

Developers can always use example report ''RAXXXE'' (''productCode'') for debugging. It is free of charge. The XML Schema of ''RAXXXE'' can be obtained from [http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd].

The example of ''RAXXXE'':

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<report xmlns="http//www.krediidiinfo.ee/schemas/report/RAXXXE.xsd">
<date_tag>2007-10-23</date_tag>
<date_time>2007-10-23T10:10:42</date_time>
<int_tag>12345</int_tag>
<decimal_tag>123456.789</decimal_tag>
<string_tag>I am a string</string_tag>
<codes_tag>&amp; ' &quot; &lt; &gt;</codes_tag>
<est_character_tag>õ ä ö ü Õ Ä Ö Ü</est_character_tag>
<subject_code>00000000</subject_code>
</report>
</pre>

The input parameter ''subjectCode'' value is always assigned to the tag ''subject_code''.

= Error Codes =

==-20101 No permission for PRODUCT_CODE! ==

Krediidiinfo has not granted permission for client to request certain report. To get permissions contact [[Klienditugi| client support]].

KiDocExchange

2010-10-19T08:35:57Z

Sass: /* Näidis PHP-s */

{| align="right"
| [[Image:Flag of the United Kingdom.svg|border|30px]] [[KiDocExchange__en|In English]]
|}

= Tutvustus =

KiDocExchange on Krediidiinfo veebiteenus failide saatmiseks Krediidiinfosse.

= WSDL =

KiDocExchange veebiteenuse WSDL fail on aadressil [http://services.krediidiinfo.ee/KiDocExchange.wsdl http://services.krediidiinfo.ee/KiDocExchange.wsdl].

= Järgnevusdiagramm =

Järgnevusdiagrammil on näidatud KiDocExchange meetodite väljakutsumise järjekorrad.

[[Image:KiDocExchange_Upload_Sequence_Diagram.jpg]]

== Meetodid ==

=== startUpload ===

Failide üleslaadimise initsialiseerimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameeter:
| fileName
| xs:string
| Faili nimi
|-
| Väljundparameeter:
| docID
| xs:integer
| Unikaalne faili id Krediidiinfo serveris.
|}

=== uploadChunk ===

Laetakse serverisse ning lisatakse juba serveris olevale failile lõppu osa failist. Kliendid võivad kogu faili saata ka ühe osana. Failide jupitamist on soovitav kasutada desktop lahendustes suurte failide saatmisel.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| Sisendparameetrid:
| docID
| xs:integer
| Faili identifikaator.
|-
|
| chunk
| xs:base64Binary
| Järgmine faili osa.
|-
| Väljundparameeter:
|
|
| None
|}

=== finishUpload ===

Faili üleslaadimise lõpetamine.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| Sisendparameetrid:
| docID
| xs:integer
| Faili identifikaator
|-
|
| md5
| xs:string
| Üles laetud faili MD5 kontrollsumma.
|-
| Väljundparameeter:
| errorCode
| xs:integer
| Kui 0, siis faili üleslaadimine õnnestus. Kui negatiivne, siis tekkis mingi viga (vt veakoodide).
|}

=== downloadChunk ===

Faili alamosa allalaadimine Krediidiinfo failiserverist.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| Sisendparameetrid:
| docID
| xs:integer
| Faili identifikaator
|-
|
| start
| xs:integer
| Positsioon failis, millest alates andmeid alla laetakse (positsiooni lugemine algab nullist)
|-
|
| count
| xs:integer
| Alla laetava tüki suurus baitides.
|-
| Väljundparameeter:
| chunk
| xs:base64Binary
| Faili alamosa
|}

=== getDownloadQueue ===

Krediidiinfo serveris kliendi poolt allalaadimist ootavate failide loetelu.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| Väljundparameeter:
| queue
| DownloadQueueArray
| Massiiv DownloadQueueType tüüpi elementidest
|}

DownloadQueueType on assiotsiatiivne massiiv, millel on järgmised elemendid:

{| style="border-style: solid; border-width: 1px"
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| docID
| xs:integer
| faili id
|-
| fileName
| xs:string
| faili nimi
|}

=== getStatusCode ===

Tagastatakse üles laetud faili staatus serveris.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! colspan="2" style="text-align: left;" | Kirjeldus
|-
| Sisendparameeter:
| docID
| xs:integer
| colspan="2" |Faili identifikaator
|-
| Output Parameters:
| status_code
| xs:integer
| colspan="2" | Faili staatuse kood:
|-
| colspan="3" |
| align="right" | 0
| Fail on töödeldud
|-
| colspan="3" |
| align="right" | 2
| Toimub faili üles laadimine
|-
| colspan="3" |
| align="right" | 3
| Toimub faili töötlemine
|-
|-
| colspan="3" |
| align="right" | 4
| Fail on edukalt üles laetud ning ootab töötlemist
|-
| colspan="3" |
| align="right" | -1
| Tundmatu viga. Täpsema info saamiseks võtke ühendust tehnilise teoga. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.
|-|-
| colspan="3" |
| align="right" | -10003
| MD5 kontroll ebaõnnestus. Kliendi saadetud MD5 kontrollsumma ei langenud kokku serveri poolt arvutatud MD5 kontrollsummaga.
|-
| colspan="3" |
| align="right" | -xxxxx
| Faili töötlemine ebaõnnestus. Täpsema info saamiseks võta ühendust tehnilise toega. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.
|}

=== getStatusMsg ===

Tagastatakse staatust täpsustav info.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| Sisendparameeter:
| docID
| xs:integer
| Faili identifikaator
|-
| Väljundparameeter:
| statusMsg
| xs:string
| Faili staatust täpsustav info
|}

= Veakoodid =

<table>
<tr>
<td>Kood</td>
<td>Kirjeldus</td>
</tr>
<tr>
<td>0</td>
<td>Success</td>
</tr>
<tr>
<td></td>
<td>Päringu töötlus õnnestus.</td>
</tr>
<tr>
<td>-10001</td>
<td>Access denied</td>
</tr>
<tr>
<td></td>
<td>Üritatakse pöörduda faili poole, mis kuulub kellelegi teisele.</td>
</tr>
<tr>
<td>-10002</td>
<td>File does not exists</td>
</tr>
<tr>
<td></td>
<td>Kasutati faili identifikaatorit, mida ei eksisteeri.</td>
</tr>
<tr>
<td>-10003</td>
<td>MD5 failure</td>
</tr>
<tr>
<td></td>
<td>Kliendi saadetud MD5 ei lange kokku serveri poolt arvutatud MD5-ga</td>
</tr>
</table>

= Näidis PHP-s =

Programm laeb faili Krediidiinfo serverisse ning seejärel laeb sama faili alla. Lõpus kontrollitakse, kas üles ja alla laetud faili sisu on sama. Programmi põhimõte sobib KiDocExchange liidese testimiseks.

NB! Failide üles- ja allalaadimine toimub silumismoodis (SOAP serveri urli lõpus on parameeter ''debug''. Kõik katsetused teha silumise moodis).

<pre>
<?php
/**
* Example of uploading and downloading files using KiDocExchange interface.
* @author Rait Kapp <rait@krediidiinfo.ee>
* @created 27.04.2007
*/
$wsdl_url = 'http://services.krediidiinfo.ee/KiDocExchange.wsdl';
$params = array('location' => 'https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug'
, 'login' => 'username' // <-- username. Make sure username is string type (PHP bug?).
, 'password' => 'password' // <-- password
, 'proxy_host' => 'cache.neti.ee'
, 'proxy_port' => 8080
);

$client = new SoapClient($wsdl_url, $params);

// Uploading file.
$content = 'I am a little test file!';
$docID = $client->startUpload('test.txt');
$client->uploadChunk($docID, $content);

$md5 = md5($content);
$result = $client->finishUpload($docID, $md5);
if ($result != 0) {
die("upload failed.! Error code: {$result}\n");
}

// Downloading file
$start = 0;
$count = 512; // can be a big number if you do not have to display download progress.
$data = '';
while ($chunk = $client->downloadChunk($docID, $start, $count)) {
$start += $count;
$data .= $chunk;
}

if ($content != $data) {
echo "Something is not right!\n";
} else {
echo "We got back: {$data}\n";
}

?>
</pre>

KiReport en

2010-10-19T08:34:49Z

Sass:

{| align="right"
| [[Image:Flag of Estonia.svg|border|30px]] [[KiReport|eesti keeles]]
|}
= Introduction =

KiReport is the name of a Web Service based on SOAP protocol for requesting reports about companies and persons. Requested reports are in XML format.

= WSDL =

WSDL can be obtained from: [http://services.krediidiinfo.ee/KiDocExchange.wsdl http://services.krediidiinfo.ee/KiReport.wsdl].

= Methods =

== ''getReport'' ==

Report requesting

{| style="border-style: solid; border-width: 1px;"
!
! Name
! Type
! Description
|-
| Input:
| productCode
| xs:string
| Report (product) code
|-
| 
| subjectCode
| xs:string
| Subject code. (Depending on report subject can be a registry code of a company, personal identity code, etc)
|-
| Output::
| xml
| xs:string
| Requested report in XML format.
|}

=Example in PHP =

Example of using KiReport in PHP:

<code><pre>
<?php
/**
* Example of using KiReport web service of Krediidiinfo AS
* Certificate issued by Krediidiinfo is needed to use KiReport interface.
*
* @author Rait Kapp <rait@krediidiinfo.ee>
* @created 18.09.2007
*/

$wsdl_url = 'http://services.krediidiinfo.ee/KiReport.wsdl';
$server_url = 'https://services.krediidiinfo.ee/soap.php?name=KiReport';

$params = array('location' => $server_url
, 'login' => 'online_code' // Online Code issued by Krediidiinfo client management. Make sure that login value is string type (PHP bug?).
, 'password' => 'passwd'

/* If you want to use certificate, then uncomment this block and comment params login and password!
, 'local_cert' => 'path/certificate.pem' // Here goes path to certificate file.
, 'passphrase' => 'passwd' // Here goes password of certificate.
*/
// , 'proxy_host' => 'cache.neti.ee' // If necessary use proxy and proxy port.
// , 'proxy_port' => 8080
, 'encoding' => 'ISO-8859-13'
);

$client = new SoapClient($wsdl_url, $params);

$productCode = 'RAXXXE';
$subjectCode = '00000000';

$xml = $client->getReport($productCode, $subjectCode);

print_r($xml);

?>
</pre></code>

= Debugging =

Developers can always use example report ''RAXXXE'' (''productCode'') for debugging. It is free of charge. The XML Schema of ''RAXXXE'' can be obtained from [http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd http://www.krediidiinfo.ee/schemas/report/RAXXXE.xsd].

The example of ''RAXXXE'':

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<report xmlns="http//www.krediidiinfo.ee/schemas/report/RAXXXE.xsd">
<date_tag>2007-10-23</date_tag>
<date_time>2007-10-23T10:10:42</date_time>
<int_tag>12345</int_tag>
<decimal_tag>123456.789</decimal_tag>
<string_tag>I am a string</string_tag>
<codes_tag>&amp; ' &quot; &lt; &gt;</codes_tag>
<est_character_tag>õ ä ö ü Õ Ä Ö Ü</est_character_tag>
<subject_code>00000000</subject_code>
</report>
</pre>

The input parameter ''subjectCode'' value is always assigned to the tag ''subject_code''.

= Error Codes =

==-20101 No permission for PRODUCT_CODE! ==

Krediidiinfo has not granted permission for client to request certain report. To get permissions contact [[Klienditugi| client support]].

File:Debtors info.png

2009-12-21T09:15:49Z

Sass: uploaded a new version of "File:Debtors info.png": FS#3239

Main Page

2009-09-17T13:49:40Z

Sass: +soap teenuse testimine

Lehelt leiate Krediidiinfo veebiteenuste dokumentatsioonid ja näidised.

= Tutvustus =
* [[Mis asi on veebiteenus? | Mis on veebiteenus?]]

= Krediidiinfo veebiteenused =
* [[KiReport]]
* [[KiDocExchange]]
* [[KiInvoiceMediator]]
* [[KiCompanyBasic]]
* [[KiCompany]]
* [[KiCreditManagement]]

= Arendajatele =
* [[Krediidiinfo veebiteenuste arhitektuur]]
* [[Autentimine]]
* [[Veebiteenuste silumine]]
* [[Veatöötlus]]
* [[Veakoodid]]
* [[SOAP teenuse testimine]]
* [[Tehniline tugi]]
* Kasutatavad standardid/protokollid
** [http://www.w3schools.com/xml/default.asp XML]
** [http://www.w3schools.com/schema/default.asp XML Schema]
** [http://www.w3schools.com/soap/default.asp SOAP]
** [http://www.w3schools.com/wsdl/default.asp WSDL]

= Näidised =
* [[KiCompanyBasic | KiCompanyBasic - '''Tasuta liides!''']]

Testimine123

2009-09-17T12:33:25Z

Sass: moved Testimine123 to SOAP teenuse testimine

#REDIRECT [[SOAP teenuse testimine]]

SOAP teenuse testimine

2009-09-17T12:33:25Z

Sass: moved Testimine123 to SOAP teenuse testimine

Krediidiinfo AS SOAP teenuse testimine kasutades <tt>curl</tt> programmi ning [[KiCompany]] teenust. Analoogselt saab testida ka teisi Krediidiinfo AS SOAP teenuseid.

Autentimiseks saab kasutada sertifikaadi ja selle võtme paari kui ka http basic authentication kasutajat ning parooli. Peale paroolide või sertifikaadi olemasolu, peab Krediidiinfo AS kliendihaldus olema andnud õiguse kasutada [[KiCompany]] teenust.

Kui järgnevad testid kliendi keskkonnas õnnestuvad, saab väita, et kliendile väljastatud sertifikaat või parool on õige ning õigused [[KiCompany]] kasutamiseks paigas.

== Võrgu test ==

Keskkond, millest päring tehakse, peab saama ühenduda <tt>services.krediidiinfo.ee</tt> serverisse tcp porti <tt>443<tt/>. Krediidiinfo AS poolt ei ole IP põhiseid piiranguid sellele serverile.

Testimaks, ega mõni tulemüür vahele ei sega võib kasutada programmi <tt>netcat</tt>:
nc -z -vv services.krediidiinfo.ee 443
Mõnes operatsioonisüsteemis on binaari nimi teine:
netcat -z -vv services.krediidiinfo.ee 443

Positiivne tulemus on:
Connection to services.krediidiinfo.ee 443 port [tcp/https] succeeded!

Näited negatiivsetest tulemustest on:
nc: connect to services.krediidiinfo.ee port 443 (tcp) failed: Connection refused

nc: connect to services.krediidiinfo.ee port 443 (tcp) failed: Connection timed out

Samuti peaks olema võimalik ühenduda sama serveri tcp porti <tt>80</tt>, kust leiab [http://www.w3.org/TR/wsdl wsdl] failid ning sellesama wiki. Kui test ei õnnestu, tuleks pöörduda oma võrguadministraatori poole.

== SOAP päringu näide ==

Esiteks peab teadma, mis teenuse pihta päring teha. Antud näites kasutame [[KiCompany]] teenust, seega päringu URI on <tt>https://services.krediidiinfo.ee/soap.php?name=KiCompany</tt>.

Teiseks on vaja SOAP päringut ennast, hoiame seda teksifailis nimega <tt>data.txt</tt>, faili sisu järgnev:
<pre>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body>
<m:findCompanies xmlns:m="urn:KiCompany" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<name xsi:type="xsd:string">kredi</name>
<count xsi:type="xsd:int">10</count>
</m:findCompanies>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>

Antud päring otsib firmasid, mis algavad stringiga <tt>kredi</tt> ning ei kuva rohkem kui 10 esimest vastust. (Päring on tasuline!)

== curl kasutamine ==

Testimiseks on mugav kasutada käsurea programmi <tt>curl</tt>. Krediidiinfo AS SOAP teenuse kasutamiseks peab <tt>curl</tt> olema kompileeritud SSL toega ning oskama https protokolli. Veenduge selles käsuga <tt>curl --version</tt>, tulemus:

curl 7.19.6 (x86_64-redhat-linux-gnu) libcurl/7.19.6 NSS/3.12.4.1 Beta zlib/1.2.3 libidn/0.6.14 libssh2/0.18
Protocols: tftp ftp telnet dict ldap ldaps http file '''https''' ftps scp sftp
Features: GSS-Negotiate IDN IPv6 Largefile '''SSL''' libz

=== curl SOAP päring kasutades autentimiseks HTTP Basic Authentication'it ===

Krediidiinfo AS poolt on teile väljastatud kasutajanimi ja parool, siin näites olgu kasutajanimi "1234" ning parool "abc123".

curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki>

-d määrab päringu. @ märk failinime ees ütleb curl'ile, et tegemist on päringufaili, mitte päringu endaga.

-u määrab kasutaja ja parooli, mis on eraldatud kooloniga.

=== curl SOAP päring kasutades autentimiseks sertifikaati ja võtit ===

Päringu tegemiseks on esiteks vaja Krediidiinfo AS poolt väljasatud sertifikaadi faili PEM formaadis, antud näites on failinimeks <tt>cert.pem</tt>. Välja näeb umbes selline:
<pre>
-----BEGIN CERTIFICATE-----
MIIEPpuguyIHJPOHuiGIOGilUYGOIGIYFGuyFUassafDFSDFpuASDaaGA1UEBhMC
RUUxETAPiugUIOuphLBLUpuGIUIGigIPUbhpuiGIPYBuYBUKBLJYHFGuohGDVQQK
Ew9LcmVkaWlkaWluZm8gQVMxCzAJBgNVBAsTAklUMSEwHwYDVQQDExhzZXJ2aWNl
cy5rcmhlkjghGHGuZm8uZWUxITAfBgkqhkiG9w0BCQEWEml0QGtyZWRpaWRpaW5m
by5lZTAeFw0wOTglgkGIOUGpguPIUgvIpiughphPhOPOUhpBHIUGMQswCQYDVQQG
EwJFRTEQMA4GA1UECBMHRXN0b25pYTEQMA4GA1UEBxMHVGFsbGlubjEYMBYGA1UE
VMtxvrdTVDhtRBDJrdYRBDRVBDTJrbDJBYYJRdYrdjbyRBUYRdBYJRdRRbUJrRYJ
MTCMjfgukfgKGYGOYOUYGOygouYalsuUUGS4OCtgtrmzLw==
-----END CERTIFICATE-----
</pre>

Teiseks sertifikaadi võtme faili PEM formaadis, siin failinimeks <tt>key.pem</tt>. See fail on salajane ning kindlasti emaili teel või muul krüptimata viisil mitte vahendada!

Samas võib selle faili sisu otsa liita <tt>cert.pem</tt> failile <tt>(cat key.pem >> cert.pem)</tt>, siis ei pea võtmefaili <tt>curl</tt>'le eraldi ette näitama. Paljud programmid nõuavad just kokku liidetud varianti. Näeb umbes selline välja, DSA variandi puhul on natuke rohkem erinevusi:
<pre>
-----BEGIN RSA PRIVATE KEY-----
Proc-Type: 4,ENCRYPTED
DEK-Info: DES-EDE3-CBC,C1AA09832249D61D

P85/RJFo2AX638mWtcOTglgkGIOUGpguPIUgvIpiughphPhOPOUhi0I+l5s+JSn5c
jx69XBvi5L+Ytci9RW3zUiWrUDv89IY6DEmwluLX39/gX0TW7U+wos5b7ng/sNLQ
tMyzCtIDACoGb5xHl48c3vY3JUzhrzQWNt2vuFjpGJI1lSOH8h0MdbQEA8iFKIOZ
ng0po3SPW8c5wJtnLuKy8uZWUxITAfBgkqhkiG9w0BCQEWEml08uZWUxITAfBgkq
oHeRz6KkZyXo7vbCbDXSFTuSHiwVwslF7hHbmmiPc4RYxB2EWfTjSUe8Fti9SWPa
iJY0OisiQbePnEigZhfRboVZmQZFPWopgy8uZWUxITAfBgkqhkiG9w0BCQEWEml0
8W1aXSBnNqtla1fmKKId9OkhiAZvavtKug8C9i27R2KR63h6uwq3ktwYtV1YWTHK
Orx8Mf3HIGXpRSJJqjvZUu+xNrM06VcVajY9SJmt7OYXvSo5nKYguwbfGNh/FA7F
Eo1KoKhQeGvWfCQzhEobc/QyegnklbaCUZhePoiL0Jk6Otgsav+2AA==
-----END RSA PRIVATE KEY-----
</pre>

Peab teadma ka sertifikaadi võtme parooli, kui võti on krüpteeritud. Antud näites olgu parool <tt>abcd1234</tt>.

Päringu teostamine:

curl -d @data.txt -cert $PWD/cert.pem:abcd1234 --key $PWD/key.pem <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki>

-d võti määrab päringu, @ failinime ees ütleb curl'ile, et tegemist on päringufaili, mitte päringu endaga.

--cert võti määrab sertifikaadi faili asukoha. Tuleb kasutada "absolute path"-i. curl ei otsi faili antud kataloogist, seetõttu ka <tt>$PWD</tt> antud näites.
Kui võti on krüpteeritud, saab parooli määrata serdifikaadi failinime taga, eraldades selle failinimest kooloniga.

--key määrab võtmefaili asukoha. Kui sertifikaat ja võtmefail on üheks liidetud, siis seda ei ole vaja määrata.
Seetõttu määrataksegi võtme parool --cert juures, mitte siin.

== SOAP päringu tulemused ==

=== Õnnestunud päring ===

Õnnestunud tulemus (lisatud reavahetused loetavuse parandamiseks):
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:KiCompany"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:findCompaniesResponse>
<companies SOAP-ENC:arrayType="ns1:CompanyIDData[10]" xsi:type="ns1:CompanyIDDataArray">
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">11517686</regCode>
<name xsi:type="xsd:string">KREDICO OÜ</name>
</item>
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">90006012</regCode>
<name xsi:type="xsd:string">KREDIIDI JA EKSPORDI GARANTEERIMISE SITHASUTUS KREDEX</name>
</item>
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">10704587</regCode>
<name xsi:type="xsd:string">KREDIIDI JÄRELVALVE OÜ</name><
/item>
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">11626688</regCode>
<name xsi:type="xsd:string">KREDIIDIBÜROO OÜ</name>
</item>
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">11676404</regCode>
<name xsi:type="xsd:string">KREDIIDIGRUPP OÜ</name>
</item>
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">11602506</regCode>
<name xsi:type="xsd:string">KREDIIDIHALDUS OÜ</name>
</item>
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">10256137</regCode>
<name xsi:type="xsd:string">KREDIIDIINFO AS</name>
</item>
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">11693223</regCode>
<name xsi:type="xsd:string">KREDIIDIKAITSE GRUPP OÜ</name>
</item>
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">11344317</regCode>
<name xsi:type="xsd:string">KREDIIDIKASSA AS</name>
</item>
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">11574371</regCode>
<name xsi:type="xsd:string">KREDIIDIKONTROLL OÜ</name>
</item>
</companies>
</ns1:findCompaniesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>

=== Vigased päringud ===

Viga GET parameetris (KiCompany asemel KiCompan):
curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompan</nowiki>
<pre>
<?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>Incorrect HTTP GET parameter 'name' value!</faultstring>
<faultactor></faultactor>
<detail>
<errorcode>-20002</errorcode>
<line_no>157</line_no>
</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>

Vigane kasutaja või parool või sertifikaat:
curl -d @data.txt -u 1234:abZZ23 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki>
<pre>
Krediidiinfo veebiteenuse kasutaja autentimine ebaõnnestus! Abi saamiseks võtke ühendust Krediidiinfoga telefonil (+372) 6659600.
</pre>

Kasutajal ei ole õigust [[KiCompany]] kasutamiseks, pöörduge kliendihalduse poole:
curl -d @data.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki>
<pre>
<?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>Access denied for KiCompany!</faultstring>
<faultactor></faultactor>
<detail>
<errorcode>-20003</errorcode>
<line_no>106</line_no></detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>

SOAP päring puudub:
curl -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki>
<pre>

</pre>
(tulemust pole)

SOAP päringus endas on viga:
curl -d @vigane.txt -u 1234:abc123 <nowiki>https://services.krediidiinfo.ee/soap.php?name=KiCompany</nowiki>
<pre>
<?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:Client</faultcode>
<faultstring>Bad Request</faultstring>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>
või
<pre>
<?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:VersionMismatch</faultcode>
<faultstring>Wrong Version</faultstring>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>

SOAP teenuse testimine

2009-09-17T12:20:48Z

Sass: v2

SOAP teenuse testimine

2009-09-16T13:34:51Z

Sass: nipetnäpet

KiCompany SOAP teenuse testimine kasutades <tt>curl</tt> programmi ning autentimiseks sertifikaadi ja selle võtme paari. Kui see test kliendi keskkonnas õnnestub, siis saab väita, et kliendile väljastatud sertifikaat toimib ning õigused KiCompany kasutamiseks paigas.

Vaja läheb kahte või kolme faili ning toimivat SSL toega curl programmi. Keskkond, millest päring tehakse, peab saama ühendada services.krediidiinfo.ee serverisse porti 443, Krediidiinfo AS poolt ei ole IP põhiseid piiranguid sellele teenusele.

Testimaks, ega mõni tulemüür vahele ei sega võib kasutada programmi netcat:
nc -z -vv services.krediidiinfo.ee 443
või mõnes opsüsteemis
netcat -z -vv services.krediidiinfo.ee 443

Positiivne tulemus on:
Connection to services.krediidiinfo.ee 443 port [tcp/https] succeeded!

Samuti peaks olema võimalik ühenduda ka porti 80, kust leiab wsdl failid. Kui test ei õnnestu, tuleks pöörduda oma võrgu administraatori poole.

Päringu tegemiseks on esiteks vaja sertifikaadi faili PEM formaadis, antud näites on failinimeks <tt>cert.pem</tt>. Välja näeb umbes selline:
<pre>
-----BEGIN CERTIFICATE-----
MIIEPpuguyIHJPOHuiGIOGilUYGOIGIYFGuyFUYGpioghIPUgpuigÜkGA1UEBhMC
RUUxETAPiugUIOuphLBLUpuGIUIGigIPUbhpuiGIPYBuYBUKBLJYHFGuohGDVQQK
Ew9LcmVkaWlkaWluZm8gQVMxCzAJBgNVBAsTAklUMSEwHwYDVQQDExhzZXJ2aWNl
cy5rcmVkaWlkaWluZm8uZWUxITAfBgkqhkiG9w0BCQEWEml0QGtyZWRpaWRpaW5m
by5lZTAeFw0wOTglgkGIOUGpguPIUgvIpiughphPhOPOUhpBHIUGMQswCQYDVQQG
EwJFRTEQMA4GA1UECBMHRXN0b25pYTEQMA4GA1UEBxMHVGFsbGlubjEYMBYGA1UE
VMtxvrdTVDhtRBDJrdYRBDRVBDTJrbDJBYYJRdYrdjbyRBUYRdBYJRdRRbUJrRYJ
MTCMjfgukfgKGYGOYOUYGOygouYalsuUUGS4OCtgtrmzLw==
-----END CERTIFICATE-----
</pre>

Teiseks ka sertifikaadi võtme faili PEM formaadis, siin failinimeks <tt>key.pem</tt>. See fail on salajane ning ei tohi kellegagi jagada ning kindlasti emaili teel või muul krüptimata viisil mitte vahendada!

Samas võib selle faili sisu otsa liita <tt>cert.pem</tt> failile <tt>(cat key.pem >> cert.pem)</tt>, siis ei pea võtmefaili <tt>curl</tt>'le eraldi ette näitama. Näeb umbes selline välja, DSA variandi puhul on natuke rohkem erinevusi:
<pre>
-----BEGIN RSA PRIVATE KEY-----
Proc-Type: 4,ENCRYPTED
DEK-Info: DES-EDE3-CBC,C1AA09832249D61D

P85/RJFo2AX638mWtcOTglgkGIOUGpguPIUgvIpiughphPhOPOUhi0I+l5s+JSn5c
jx69XBvi5L+Ytci9RW3zUiWrUDv89IY6DEmwluLX39/gX0TW7U+wos5b7ng/sNLQ
tMyzCtIDACoGb5xHl48c3vY3JUzhrzQWNt2vuFjpGJI1lSOH8h0MdbQEA8iFKIOZ
ng0po3SPW8c5wJtnLuKy8uZWUxITAfBgkqhkiG9w0BCQEWEml08uZWUxITAfBgkq
oHeRz6KkZyXo7vbCbDXSFTuSHiwVwslF7hHbmmiPc4RYxB2EWfTjSUe8Fti9SWPa
iJY0OisiQbePnEigZhfRboVZmQZFPWopgy8uZWUxITAfBgkqhkiG9w0BCQEWEml0
8W1aXSBnNqtla1fmKKId9OkhiAZvavtKug8C9i27R2KR63h6uwq3ktwYtV1YWTHK
Orx8Mf3HIGXpRSJJqjvZUu+xNrM06VcVajY9SJmt7OYXvSo5nKYguwbfGNh/FA7F
Eo1KoKhQeGvWfCQzhEobc/QyegnklbaCUZhePoiL0Jk6Otgsav+2AA==
-----END RSA PRIVATE KEY-----
</pre>

Peab teadma ka sertifikaadi võtme parooli, kui võti on krüpteeritud. Antud näites olgu parool <tt>abcd1234</tt>.

Kolmandaks on vaja soap päringut, hoiame seda teksifailis nimega <tt>data.txt</tt>, faili sisu järgnev:
<pre>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body>
<m:findCompanies xmlns:m="urn:KiCompany" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<name xsi:type="xsd:string">krediidiinfo</name>
<count xsi:type="xsd:int">10</count>
</m:findCompanies>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>

Antud päring otsib firmasid, mis algavad stringiga <tt>krediidiinfo</tt> ning ei kuva rohkem kui 10 esimest vastust. (Päring on tasuline!)

Päringu teostamine:
<pre>
curl -d @data.txt -cert $PWD/cert.pem:abcd1234 --key $PWD/key.pem https://services.krediidiinfo.ee/soap.php?name=KiCompany
</pre>

-d võti määrab päringu, @ failinime ees ütleb curl'ile, et tegemist on päringufaili, mitte päringu endaga.

--cert võti määrab sertifikaadi faili asukoha. Tuleb kasutada "absolute path"-i. curl ei otsi faili antud kataloogist, seetõttu ka <tt>$PWD</tt> antud näites.
Kui võti on krüpteeritud, saab võtme ette anda nagu näites serdifikaadi failinime taga, eraldades selle failinimest kooloniga. Kui parooli käsureal ei määra, küsitakse seda vajadusel peale curli käivitamist.

--key määrab võtmefaili asukoha. Kui sertifikaat ja võtmefail on üheks liidetud, siis seda võtit vaja ei ole.

Õnnestunud tulemus (lisatud reavahetused loetavuse parandamiseks):
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:KiCompany"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:findCompaniesResponse>
<companies SOAP-ENC:arrayType="ns1:CompanyIDData[1]" xsi:type="ns1:CompanyIDDataArray">
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">10256137</regCode>
<name xsi:type="xsd:string">KREDIIDIINFO AS</name>
</item>
</companies>
</ns1:findCompaniesResponse>
</SOAP-ENV:Body></SOAP-ENV:Envelope>
</pre>

SOAP teenuse testimine

2009-09-16T13:01:17Z

Sass: ver1

KiCompany SOAP teenuse testimine kasutades <tt>curl</tt> programmi ning autentimiseks sertifikaadi ja selle võtme paari. Kui see test kliendi keskkonnas õnnestub, siis saab väita, et kliendile väljastatud sertifikaat toimib ning õigused KiCompany kasutamiseks paigas.

Vaja läheb kahte või kolme faili ning toimivat SSL toega curl programmi. Keskkond, millest päring tehakse, peab saama ühendada services.krediidiinfo.ee serverisse porti 443, Krediidiinfo AS poolt ei ole IP põhiseid piiranguid sellele teenusele.

Testimaks, ega mõni tulemüür vahele ei sega võib kasutada programmi netcat:
nc -z -vv services.krediidiinfo.ee 443
või
netcat -z -vv services.krediidiinfo.ee 443

Positiivne tulemus on:
Connection to services.krediidiinfo.ee 443 port [tcp/https] succeeded!

Samuti peaks olema võimalik ühenduda ka porti 80, kust leiab wsdl failid.

Esiteks on vaja sertifikaadi faili PEM formaadis, antud näites on failinimeks <tt>cert.pem</tt>. Välja näeb umbes selline:
<pre>
-----BEGIN CERTIFICATE-----
MIIEPpuguyIHJPOHuiGIOGilUYGOIGIYFGuyFUYGpioghIPUgpuigÜkGA1UEBhMC
RUUxETAPiugUIOuphLBLUpuGIUIGigIPUbhpuiGIPYBuYBUKBLJYHFGuohGDVQQK
Ew9LcmVkaWlkaWluZm8gQVMxCzAJBgNVBAsTAklUMSEwHwYDVQQDExhzZXJ2aWNl
cy5rcmVkaWlkaWluZm8uZWUxITAfBgkqhkiG9w0BCQEWEml0QGtyZWRpaWRpaW5m
by5lZTAeFw0wOTglgkGIOUGpguPIUgvIpiughphPhOPOUhpBHIUGMQswCQYDVQQG
EwJFRTEQMA4GA1UECBMHRXN0b25pYTEQMA4GA1UEBxMHVGFsbGlubjEYMBYGA1UE
VMtxvrdTVDhtRBDJrdYRBDRVBDTJrbDJBYYJRdYrdjbyRBUYRdBYJRdRRbUJrRYJ
MTCMjfgukfgKGYGOYOUYGOygouYalsuUUGS4OCtgtrmzLw==
-----END CERTIFICATE-----
</pre>

Teiseks ka sertifikaadi võtme faili PEM formaadis, siin failinimeks <tt>key.pem</tt>. See fail on salajane ning ei tohi kellegagi jagada ning kindlasti emaili teel või muul krüptimata viisil mitte vahendada!

Samas võib selle faili sisu otsa liita <tt>cert.pem</tt> failile <tt>(cat key.pem >> cert.pem)</tt>, siis ei pea võtmefaili <tt>curl</tt>'le eraldi ette näitama. Näeb umbes selline välja, DSA variandi puhul on natuke rohkem erinevusi:
<pre>
-----BEGIN RSA PRIVATE KEY-----
Proc-Type: 4,ENCRYPTED
DEK-Info: DES-EDE3-CBC,C1AA09832249D61D

P85/RJFo2AX638mWtcOTglgkGIOUGpguPIUgvIpiughphPhOPOUhi0I+l5s+JSn5c
jx69XBvi5L+Ytci9RW3zUiWrUDv89IY6DEmwluLX39/gX0TW7U+wos5b7ng/sNLQ
tMyzCtIDACoGb5xHl48c3vY3JUzhrzQWNt2vuFjpGJI1lSOH8h0MdbQEA8iFKIOZ
ng0po3SPW8c5wJtnLuKy8uZWUxITAfBgkqhkiG9w0BCQEWEml08uZWUxITAfBgkq
oHeRz6KkZyXo7vbCbDXSFTuSHiwVwslF7hHbmmiPc4RYxB2EWfTjSUe8Fti9SWPa
iJY0OisiQbePnEigZhfRboVZmQZFPWopgy8uZWUxITAfBgkqhkiG9w0BCQEWEml0
8W1aXSBnNqtla1fmKKId9OkhiAZvavtKug8C9i27R2KR63h6uwq3ktwYtV1YWTHK
Orx8Mf3HIGXpRSJJqjvZUu+xNrM06VcVajY9SJmt7OYXvSo5nKYguwbfGNh/FA7F
Eo1KoKhQeGvWfCQzhEobc/QyegnklbaCUZhePoiL0Jk6Otgsav+2AA==
-----END RSA PRIVATE KEY-----
</pre>

Peab teadma ka sertifikaadi võtme parooli, kui võti on krüpteeritud. Antud näites olgu parool <tt>abcd1234</tt>.

Kolmandaks on vaja soap päringut, hoiame seda teksifailis nimega <tt>data.txt</tt>, faili sisu järgnev:
<pre>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<SOAP-ENV:Body>
<m:findCompanies xmlns:m="urn:KiCompany" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<name xsi:type="xsd:string">krediidiinfo</name>
<count xsi:type="xsd:int">10</count>
</m:findCompanies>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
</pre>

Antud päring otsib firmasid, mis algavad stringiga <tt>krediidiinfo</tt> ning ei kuva rohkem kui 10 esimest vastust. (Päring on tasuline!)

Päringu teostamine:
<pre>
curl -d @data.txt -cert $PWD/cert.pem:abcd1234 --key $PWD/key.pem https://services.krediidiinfo.ee/soap.php?name=KiCompany
</pre>

-d võti määrab päringu, @ failinime ees ütleb curl'ile, et tegemist on päringufaili, mitte päringu endaga.

--cert võti määrab sertifikaadi faili asukohta. Tuleb kasutada "absolute path"-i, curl ei otsi faili antud kataloogist, seetõttu ka <tt>$PWD</tt> antud näites.
Kui võti on krüpteeritud, saab võtme ette anda nagu näites serdifikaadi faili taga, eraldades selle failinimest kooloniga. Kui parooli käsureal ei määra, küsitakse seda peale curli käivitamist.

--key määrab võtmefaili asukoha. Kui sertifikaat ja võtmefail on üheks liidetud, siis seda võtit vaja ei ole.

Õnnestunud tulemus (lisatud reavahetused loetavuse parandamiseks):
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:KiCompany"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:findCompaniesResponse>
<companies SOAP-ENC:arrayType="ns1:CompanyIDData[1]" xsi:type="ns1:CompanyIDDataArray">
<item xsi:type="ns1:CompanyIDData">
<regCode xsi:type="ns1:regCode">10256137</regCode>
<name xsi:type="xsd:string">KREDIIDIINFO AS</name>
</item>
</companies>
</ns1:findCompaniesResponse>
</SOAP-ENV:Body></SOAP-ENV:Envelope>
</pre>

Talk:Main Page

2008-09-19T11:22:58Z

Sass: Removing all content from page

Talk:Main Page

2008-09-19T09:54:36Z

Sass:

Discussion ehk Talk lehed on avatud kõigile aruteluks.

Talk:Main Page

2008-09-19T09:51:15Z

Sass: Removing all content from page

KiDocExchange

2008-08-13T12:05:26Z

Sass: typo koodi kommentaaris

= Tutvustus =

KiDocExchange on Krediidiinfo veebiteenus failide saatmiseks Krediidiinfosse.

= WSDL =

KiDocExchange veebiteenuse WSDL fail on aadressil [http://services.krediidiinfo.ee/KiDocExchange.wsdl http://services.krediidiinfo.ee/KiDocExchange.wsdl].

= Järgnevusdiagramm =

Järgnevusdiagrammil on näidatud KiDocExchange meetodite väljakutsumise järjekorrad.

[[Image:KiDocExchange_Upload_Sequence_Diagram.jpg]]

== Meetodid ==

=== startUpload ===

Failide üleslaadimise initsialiseerimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameeter:
| fileName
| xs:string
| Faili nimi
|-
| Väljundparameeter:
| docID
| xs:integer
| Unikaalne faili id Krediidiinfo serveris.
|}

=== uploadChunk ===

Laetakse serverisse ning lisatakse juba serveris olevale failile lõppu osa failist. Kliendid võivad kogu faili saata ka ühe osana. Failide jupitamist on soovitav kasutada desktop lahendustes suurte failide saatmisel.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| Sisendparameetrid:
| docID
| xs:integer
| Faili identifikaator.
|-
|
| chunk
| xs:base64Binary
| Järgmine faili osa.
|-
| Väljundparameeter:
|
|
| None
|}

=== finishUpload ===

Faili üleslaadimise lõpetamine.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| Sisendparameetrid:
| docID
| xs:integer
| Faili identifikaator
|-
|
| md5
| xs:string
| Üles laetud faili MD5 kontrollsumma.
|-
| Väljundparameeter:
| errorCode
| xs:integer
| Kui 0, siis faili üleslaadimine õnnestus. Kui negatiivne, siis tekkis mingi viga (vt veakoodide).
|}

=== downloadChunk ===

Faili alamosa allalaadimine Krediidiinfo failiserverist.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| Sisendparameetrid:
| docID
| xs:integer
| Faili identifikaator
|-
|
| start
| xs:integer
| Positsioon failis, millest alates andmeid alla laetakse (positsiooni lugemine algab nullist)
|-
|
| count
| xs:integer
| Alla laetava tüki suurus baitides.
|-
| Väljundparameeter:
| chunk
| xs:base64Binary
| Faili alamosa
|}

=== getDownloadQueue ===

Krediidiinfo serveris kliendi poolt allalaadimist ootavate failide loetelu.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| Väljundparameeter:
| queue
| DownloadQueueArray
| Massiiv DownloadQueueType tüüpi elementidest
|}

DownloadQueueType on assiotsiatiivne massiiv, millel on järgmised elemendid:

{| style="border-style: solid; border-width: 1px"
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| docID
| xs:integer
| faili id
|-
| fileName
| xs:string
| faili nimi
|}

=== getStatusCode ===

Tagastatakse üles laetud faili staatus serveris.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! colspan="2" style="text-align: left;" | Kirjeldus
|-
| Sisendparameeter:
| docID
| xs:integer
| colspan="2" |Faili identifikaator
|-
| Output Parameters:
| status_code
| xs:integer
| colspan="2" | Faili staatuse kood:
|-
| colspan="3" |
| align="right" | 0
| Fail on töödeldud
|-
| colspan="3" |
| align="right" | 2
| Toimub faili üles laadimine
|-
| colspan="3" |
| align="right" | 3
| Toimub faili töötlemine
|-
|-
| colspan="3" |
| align="right" | 4
| Fail on edukalt üles laetud ning ootab töötlemist
|-
| colspan="3" |
| align="right" | -1
| Tundmatu viga. Täpsema info saamiseks võtke ühendust tehnilise teoga. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.
|-|-
| colspan="3" |
| align="right" | -10003
| MD5 kontroll ebaõnnestus. Kliendi saadetud MD5 kontrollsumma ei langenud kokku serveri poolt arvutatud MD5 kontrollsummaga.
|-
| colspan="3" |
| align="right" | -xxxxx
| Faili töötlemine ebaõnnestus. Täpsema info saamiseks võta ühendust tehnilise toega. Rohkem infot vea teate kohta võib saada meetodiga getStatusMsg.
|}

=== getStatusMsg ===

Tagastatakse staatust täpsustav info.

{| style="border-style: solid; border-width: 1px"
!
! style="text-align: left;" | Nimi
! style="text-align: left;" | Tüüp
! style="text-align: left;" | Kirjeldus
|-
| Sisendparameeter:
| docID
| xs:integer
| Faili identifikaator
|-
| Väljundparameeter:
| statusMsg
| xs:string
| Faili staatust täpsustav info
|}

= Veakoodid =

<table>
<tr>
<td>Kood</td>
<td>Kirjeldus</td>
</tr>
<tr>
<td>0</td>
<td>Success</td>
</tr>
<tr>
<td></td>
<td>Päringu töötlus õnnestus.</td>
</tr>
<tr>
<td>-10001</td>
<td>Access denied</td>
</tr>
<tr>
<td></td>
<td>Üritatakse pöörduda faili poole, mis kuulub kellelegi teisele.</td>
</tr>
<tr>
<td>-10002</td>
<td>File does not exists</td>
</tr>
<tr>
<td></td>
<td>Kasutati faili identifikaatorit, mida ei eksisteeri.</td>
</tr>
<tr>
<td>-10003</td>
<td>MD5 failure</td>
</tr>
<tr>
<td></td>
<td>Kliendi saadetud MD5 ei lange kokku serveri poolt arvutatud MD5-ga</td>
</tr>
</table>

= Näidis PHP-s =

Programm laeb faili Krediidiinfo serverisse ning seejärel laeb sama faili alla. Lõpus kontrollitakse, kas üles ja alla laetud faili sisu on sama. Programmi põhimõte sobib KiDocExchange liidese testimiseks.

NB! Failide üles- ja allalaadimine toimub silumismoodis (SOAP serveri urli lõpus on parameeter ''debug''. Kõik katsetused teha silumise moodis).

<pre>
<?php
/**
* Example of uploading and downloading files using KiDocExchange interface.
* @author Rait Kapp <rait@krediidiinfo.ee>
* @created 27.04.2007
*/
$wsdl_url = 'http://www.krediidiinfo.ee/services/KiDocExchange.wsdl';
$params = array('location' => 'https://services.krediidiinfo.ee/soap.php?name=KiDocExchange&debug'
, 'login' => 'username' // <-- username. Make sure username is string type (PHP bug?).
, 'password' => 'password' // <-- password
, 'proxy_host' => 'cache.neti.ee'
, 'proxy_port' => 8080
);

$client = new SoapClient($wsdl_url, $params);

// Uploading file.
$content = 'I am a little test file!';
$docID = $client->startUpload('test.txt');
$client->uploadChunk($docID, $content);

$md5 = md5($content);
$result = $client->finishUpload($docID, $md5);
if ($result != 0) {
die("upload failed.! Error code: {$result}\n");
}

// Downloading file
$start = 0;
$count = 512; // can be a big number if you do not have to display download progress.
$data = '';
while ($chunk = $client->downloadChunk($docID, $start, $count)) {
$start += $count;
$data .= $chunk;
}

if ($content != $data) {
echo "Something is not right!\n";
} else {
echo "We got back: {$data}\n";
}

?>
</pre>

KiCompany

2008-01-09T15:17:30Z

Sass: /* WSDL */

= Tutvustus =

KiCompany on Krediidiinfo SOAP protokollil põhinev veebiteenus ettevõtete põhiandmete pärimiseks. Liides on mõeldud klientidele, kes soovivad integreerida oma süsteemi [http://firmaparing.krediidiinfo.ee firmapäringu] funktsionaalsust.

= WSDL =

KiCompany WSDL asub aadressil [http://services.krediidiinfo.ee/KiCompany.wsdl http://services.krediidiinfo.ee/KiCompany.wsdl].

= Meetodid =

== getName ==

Ettevõtte nime pärimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| Ettevõtte äriregistri kood.
|-
| Väljundparameeter:
| name
| xs:string
| Ettevõtte nimi. Kui ettevõtte nime ei leita (sellise nimega ettevõtet ei eksisteeri, ettevõtte äriregistrikood vigane vms), siis on väljundparameetri väärtuseks tühistring.
|}

== findCompanies ==

Ettevõtete otsimine nime järgi. Tulemuseks on massiiv, mis sisaldab otsingustringile sobivate ettevõtete nimesid ja äriregistrikoode.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| Ettevõtte äriregistri kood
|-
| 
| count
| xs:int
| Leitud ettevõtete maksimaalne arv, mis meetodi tulemuses võib olla. (Meetod ei tagasta korraga rohkem kui 100 ettevõtet)
|-
| Väljundparameeter:
| companies
| ResultCompanyIDDataArray
| Indekseeritud massiiv, mille elementideks on ResultCompanyIDData tüüpi elemendid.
|}

ResultCompanyIDData on kirje järgmise struktuuriga:

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| regCode
| xs:string
| Ettevõtte äriregistri kood
|-
| name
| xs:string
| Ettevõtte nimi.
|}

== getBasicData ==

Ettevõtte põhiandmete pärimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| Ettevõtte äriregistri kood.
|-
| Väljundparameeter:
| data
| CompanyBasicDataType
| Kirje ettevõtte andmetega.
|}

CompanyBasicDataType tüüpi kirje järgmise struktuuriga:

{| style="border-style: solid; border-width: 1px;"
! Nimi
! Tüüp
! Kirjeldus
|-
| regCode
| xs:string
| ettevõtte äriregistri kood
|-
| name
| xs:string
| ettevõtte nimi.
|-
| street
| xs:string
| tänava nimi turunduseks kasutatavas postiaadressis
|-
| postCode
| xs:string
| posti indeksi number turunduseks kasutatavas postiaadressis
|-
| city
| xs:string
| linna nimi turunduseks kasutatavas postiaadressis
|-
| legalStreet
| xs:string
| tänava nimi juriidilises aadressis
|-
| legalPostCode
| xs:string
| posti indeksi number juriidilises aadressis
|-
| legalCity
| xs:string
| linnanimi juriidilises aadressis
|-
| phones
| xs:string
| telefonide numbrid
|-
| faxes
| xs:string
| fakside numbrid
|-
| web
| xs:string
| interneti kodulehekülje URL
|-
| emails
| xs:string
| e-posti aadressid
|-
| legalForm
| xs:string
| juriidiline vorm
|-
| shareCapital
| xs:int
| osakapitali suurus
|-
| shareCapitalCur
| xs:string
| valuuta tähis, milles on osakapitali suurus antud
|-
| regTime
| xs:string
| ettevõtte registreerimise aeg Äriregistris. Formaat: yyyy-mm-dd
|-
| regPlace
| xs:string
| registriosakonna nimetus kus ettevõte registreeriti
|-
| activities
| xs:string
| ettevõtte tegevusalade loetelu. Iga tegevusala ees on string '* ' (tärn ja tühik).
|-
| status
| xs:string
| äriregistri staatuse nimetus
|-
|}

== getContactData ==

Ettevõtte kontaktandmete pärimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| ettevõtte äriregistri kood.
|-
| Väljundparameeter:
| data
| CompanyContactDataType
| kirje kontaktandmetega
|}

CompanyContactDataType tüüpi kirje on järgmise struktuuriga:

{| style="border-style: solid; border-width: 1px;"
! Nimi
! Tüüp
! Kirjeldus
|-
| street
| xs:string
| tänava nimi turunduseks kasutatavas postiaadressis
|-
| postCode
| xs:string
| posti indeksi number turunduseks kasutatavas postiaadressis
|-
| city
| xs:string
| linna nimi turunduseks kasutatavas postiaadressis
|-
| phones
| xs:string
| telefonide numbrid
|-
| faxes
| xs:string
| fakside numbrid
|-
| web
| xs:string
| interneti kodulehekülje URL
|-
| emails
| xs:string
| e-posti aadressid
|}

== getLegalPostAddress ==

Ettevõtte juriidilise aadressi pärimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| ettevõtte äriregistri kood.
|-
| Väljundparameeter:
| data
| CompanyPostAddressType
| kirje juriidilise aadressi andmetega
|}

CompanyPostAddressType tüüpi kirje on järgmise struktuuriga:

{| style="border-style: solid; border-width: 1px;"
! Nimi
! Tüüp
! Kirjeldus
|-
| street
| xs:string
| tänava nimi
|-
| postCode
| xs:string
| indeks
|-
| city
| xs:string
| linn
|}

== isRegCodeValid ==

Ettevõtte äriregistri korrektsuse kontrollimine.

{| style="border-style: solid; border-width: 1px;"
!
! Nimi
! Tüüp
! Kirjeldus
|-
| Sisendparameetrid:
| regCode
| xs:string
| Ettevõtte äriregistri kood
|-
| Väljundparameeter:
| isValid
| xs:boolean
| Tõene, kui parameetriga ette antud äriregistri kood on kaheksakohaline arv ja viimane kontrollnumber on õige.
|}

Kuidas liituda

2007-10-25T13:40:04Z

Sass: basic õigeks

Krediidiinfo veebiteenuseid (va [[KiCompanyBasic]]) saavad kasutada ainult Krediidiinfo lepingulised kliendid. Veebiteenuste kasutamiseks on vaja sõlmida lepingud, mille järel Krediidiinfo väljastab veebiteenuse kasutamiseks vajaliku(d) sertifikaadi(d).

Kliendiks registreerimiseks võtke ühendust meie [[Klienditugi | klienditoega]].

File:Circle2.svg

2007-10-25T13:20:02Z

Sass: uploaded a new version of "Image:Circle2.svg": asdasdasd

asdasdasd

File:Circle1.svg

2007-10-25T13:01:51Z

Sass: testing

testing

Sandbox

2007-10-25T12:36:16Z

Sass: New page: Sandbox. asdasd

Sandbox.

asdasd