CINXE.COM
IBAN validācijas (IBAN pārbaudītāja) API dokumentācija
<!DOCTYPE html> <!--[if IE 8 ]><html class="ie" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <![endif]--> <!--[if (gte IE 9)|!(IE)]><!--><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="lv" lang="lv"><!--<![endif]--> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!--[if IE]><meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'><![endif]--> <title>IBAN validācijas (IBAN pārbaudītāja) API dokumentācija</title> <meta name="description" content="Dokumentācija izstrādātājiem attiecībā uz IBAN komplekta (IBAN validācijas) API integrēšanu attālinātās sistēmās." /> <meta name="keywords" content="iban, validācija, API, rest, dokumentācija" /> <meta name="theme-color" content="#153570"> <meta name="apple-mobile-web-app-status-bar-style" content="#153570"> <meta name="MobileOptimized" content="width" /> <meta name="HandheldFriendly" content="true" /> <meta name="viewport" content="width=device-width, initial-scale=1"> <link href="https://www.iban.lv/validation-api" rel="canonical"> <link rel="stylesheet" type="text/css" href="/stylesheets/bootstrap.css" > <link rel="stylesheet" type="text/css" href="/stylesheets/style.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/shortcodes.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/newcustom.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/responsive.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/animate.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/font-awesome.css"> <link rel="stylesheet" type="text/css" href="/stylesheets/jquery.fancybox.css"> <style> @media print { .fa-print,.fa-exclamation-circle{display:none}.flat-general.sidebar-right .flat-wrapper .general{border-right:none}.topheader{display:none}header{display:none}.general-sidebar{display:none}.flat-general .general{width:100%}#form{display:none}.serviceinfohelp{display:none}.pricing a{display:none}.reportproblem{display:none}#form1{display:none}.flat-title-button h3,.help{display:none}.footer-widgets,.content-bottom-widgets,.footer-content .copyright a{display:none;clear:both}} </style> </head> <body> <div class="boxed"> <div class="topheader"> <div class="container"> <div class="row"> <div class="col-md-6"> <div class="top-navigator pull-left"> <ul> <li ><a href="https://www.iban.com/contact" title="Sazinieties ar mums" class="no-border"><i class="fa fa-envelope"></i> Kontakti</a></li> </ul> </div> </div> <div class="col-md-6"> <div class="top-navigator pull-right"> <ul> <li class="hidden-xs"><a href="#" class="language"><img src="/images/icon/blank.png" class="flag flag-lv" width="16" height="11" alt="lv"> LV</a> <ul> <li><a href="https://www.iban.com/" title="English" data-lang-id="en"><img src="/images/icon/blank.png" class="flag flag-gb" width="16" height="11" alt="en"> English</a></li> <li><a href="https://de.iban.com/" title="Deutsch" data-lang-id="de_DE"><img src="/images/icon/blank.png" class="flag flag-de" width="16" height="11" alt="de"> Deutsch</a></li> <li><a href="https://fr.iban.com/" title="Français" data-lang-id="fr_FR"><img src="/images/icon/blank.png" class="flag flag-fr" width="16" height="11" alt="fr"> Français</a></li> <li><a href="https://it.iban.com/" title="Italiano" data-lang-id="it_IT"><img src="/images/icon/blank.png" class="flag flag-it" width="16" height="11" alt="it"> Italiano</a></li> <li><a href="https://nl.iban.com/" title="Dutch" data-lang-id="nl_NL"><img src="/images/icon/blank.png" class="flag flag-nl" width="16" height="11" alt="nl"> Dutch</a></li> <li><a href="https://es.iban.com/" title="Español" data-lang-id="es_ES"><img src="/images/icon/blank.png" class="flag flag-es" width="16" height="11" alt="es"> Español</a></li> <li><a href="https://pt.iban.com/" title="Português" data-lang-id="pt_PT"><img src="/images/icon/blank.png" class="flag flag-pt" width="16" height="11" alt="pt"> Português</a></li> <li><a href="https://www.iban.pl/" title="Polski" data-lang-id="pl"><img src="/images/icon/blank.png" class="flag flag-pl" width="16" height="11" alt="pl"> Polski</a></li> <li><a href="https://www.iban.se/" title="Svenska" data-lang-id="sv"><img src="/images/icon/blank.png" class="flag flag-se" width="16" height="11" alt="sv"> Svenska</a></li> <li><a href="https://www.iban.fi/" title="Suomi" data-lang-id="fi"><img src="/images/icon/blank.png" class="flag flag-fi" width="16" height="11" alt="fi"> Suomi</a></li> <li><a href="https://www.iban.dk/" title="Dansk" data-lang-id="da"><img src="/images/icon/blank.png" class="flag flag-dk" width="16" height="11" alt="da"> Dansk</a></li> <li><a href="https://www.iban.co.no/" title="Norsk" data-lang-id="no"><img src="/images/icon/blank.png" class="flag flag-no" width="16" height="11" alt="no"> Norsk</a></li> <li><a href="https://www.iban.hu/" title="Magyar" data-lang-id="hu"><img src="/images/icon/blank.png" class="flag flag-hu" width="16" height="11" alt="hu"> Magyar</a></li> <li><a href="https://www.iban.gr/" title="Eλληνική" data-lang-id="el"><img src="/images/icon/blank.png" class="flag flag-gr" width="16" height="11" alt="el"> Eλληνική</a></li> <li><a href="https://www.iban.cz/" title="Čeština" data-lang-id="cs"><img src="/images/icon/blank.png" class="flag flag-cz" width="16" height="11" alt="cs"> Čeština</a></li> <li><a href="https://www.iban.si/" title="Slovenščina" data-lang-id="sv"><img src="/images/icon/blank.png" class="flag flag-si" width="16" height="11" alt="sl"> Slovenščina</a></li> <li><a href="https://www.iban.hr/" title="Hrvatski" data-lang-id="hr_HR"><img src="/images/icon/blank.png" class="flag flag-hr" width="16" height="11" alt="hr"> Hrvatski</a></li> <li><a href="https://www.iban.sk/" title="Slovenský" data-lang-id="sk"><img src="/images/icon/blank.png" class="flag flag-sk" width="16" height="11" alt="sk"> Slovenský</a></li> <!-- <li><a href="https://www.iban.lv/" title="Latviešu" data-lang-id="lv"><img src="/images/icon/blank.png" class="flag flag-lv" width="16" height="11" alt="lv"> Latviešu</a></li> --> <li><a href="https://www.iban.lt/" title="Lietuvių" data-lang-id="lt"><img src="/images/icon/blank.png" class="flag flag-lt" width="16" height="11" alt="lt"> Lietuvių</a></li> <li><a href="https://www.iban.ee/" title="Eesti" data-lang-id="et"><img src="/images/icon/blank.png" class="flag flag-ee" width="16" height="11" alt="et"> Eesti</a></li> <li><a href="https://www.iban.rs/" title="Srpski" data-lang-id="sr"><img src="/images/icon/blank.png" class="flag flag-rs" width="16" height="11" alt="sr"> Srpski</a></li> <li><a href="https://www.ibankodu.com.tr/" title="Türkçe" data-lang-id="tr"><img src="/images/icon/blank.png" class="flag flag-tr" width="16" height="11" alt="tr"> Türkçe</a></li> <li><a href="https://www.iban.ru/" title="Русский" data-lang-id="ru_RU"><img src="/images/icon/blank.png" class="flag flag-ru" width="16" height="11" alt="ru"> Русский</a></li> <li><a href="https://www.iban.bg/" title=" Български" data-lang-id="bg"><img src="/images/icon/blank.png" class="flag flag-bg" width="16" height="11" alt="bg"> Български</a></li> <li><a href="https://www.iban.com.ua/" title="Українська" data-lang-id="uk"><img src="/images/icon/blank.png" class="flag flag-ua" width="16" height="11" alt="uk"> Українська</a></li> <li><a href="https://www.iban.ma/" title="العربية" data-lang-id="ar"><img src="/images/icon/blank.png" class="flag flag-ma" width="16" height="11" alt="ar"> العربية</a></li> <li><a href="https://www.iban.co.il/" title="עברית" data-lang-id="he"><img src="/images/icon/blank.png" class="flag flag-il" width="16" height="11" alt="he"> עברית</a></li> <li><a href="https://www.iban.jp/" title="日本語" data-lang-id="ja"><img src="/images/icon/blank.png" class="flag flag-jp" width="16" height="11" alt="ja"> 日本語</a></li> <li><a href="https://www.iban.kr/" title="한국어" data-lang-id="ko"><img src="/images/icon/blank.png" class="flag flag-kr" width="16" height="11" alt="ko"> 한국어</a></li> <li><a href="https://www.iban.hk/" title="繁體中文" data-lang-id="zh-TW"><img src="/images/icon/blank.png" class="flag flag-hk" width="16" height="11" alt="zh-TW"> 繁體中文</a></li> </ul> </li> <li ></li> <li><a href="https://clients.iban.com/login/" title="Reģistrētiem lietotājiem" class="login"><i class="fa fa-lock no-border" aria-hidden="true"></i>Autorizēties</a></li> <li><a href="https://clients.iban.com/register/" title="Pieprasīt izmēģinājuma kontu" class="requesttrial hidden-xs">Pieprasīt demo</a></li> </ul> </div> </div> </div> </div> </div> <header id="header" class="header clearfix"> <div class="header-wrap clearfix"> <div class="container"> <div class="row"> <div class="col-md-12"> <div id="logo" class="logo"> <a href="/" title="IBAN sākums"> <img src="/images/logo.png" alt="IBAN logo" width="170" height="75"> </a> </div> <div class="btn-menu"> <span></span> </div> <div class="nav-wrap"> <nav id="mainnav" class="mainnav navbar-right"> <ul class="menu"> <li><a href="/iban-checker" title="Pārbaudīt IBAN numuru"><i class="fa fa-check"></i> <div class="atitle">Validēt IBAN</div></a></li> <li><a href="/calculate-iban" title="IBAN kalkulators"><i class="fa fa-retweet"></i> <div class="atitle">Aprēķināt IBAN</div></a></li> <li><a href="/products" title="Preces un pakalpojumi"><i class="fa fa-th-large" ></i> <div class="atitle">Produkti</div></a></li> <li><a href="/why-iban" title="Kādēļ izvēlēties IBAN pakalpojumus"><i class="fa fa-question-circle" aria-hidden="true"></i> <div class="atitle">Kādēļ IBAN</div></a></li> <li><a class="active" href="/developers" title="Dokumentācija izstrādātājiem"><i class="fa fa-cogs"></i> <div class="atitle">Izstrādātājiem</div></a></li> <li><a href="/pricing" title="Citi produkti un pakalpojumi"><i class="fa fa-tasks"></i> <div class="atitle">Cenas</div></a></li> </ul> </nav> </div> </div> </div> </div> </div> </header><div class="flat-row pad-bottom70px"> <div class="container"> <div class="row"> <div class="flat-wrapper"> <div class="flat-title-button"> <h1 class="title"><i class="fa fa-cogs" aria-hidden="true"></i>IBAN validācijas API V4 dokumentācija</h1> </div> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shCore.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushPhp.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushBash.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushXml.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushVb.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushJava.js"></script> <script type="text/javascript" src="/javascript/syntaxhighlighter/scripts/shBrushCSharp.js"></script> <link type="text/css" rel="stylesheet" href="../javascript/syntaxhighlighter/styles/shCoreDefault.css"/> <script language='javascript'> SyntaxHighlighter.all(); </script> <h5>Šī API veido daļu no mūsu pakalpojuma <a href="/iban-suite">IBAN komplekts</a></h5> <a name="whatis"></a> <h4>1. Kas jauns IBAN validācijas API V4?</h4> <br> Mēs pastāvīgi strādājam, lai uzlabotu mūsu pakalpojumus un nodrošinātu vēl labākus maksājumu validācijas risinājumus.<br> Iespējams, esat ievērojuši, ka IBAN komplekta API iterācija no V2 uz V4 ir izlaista.<br> Tas tika darīts, jo mēs apvienojām atsevišķas API, piemēram, SortWare v3, vienā versijas iterācijā, piem., v4. <br><br> <h4><strong>Izmaiņu žurnāls (no v2 uz v4):</strong></h4> <br> <strong>Pievienota jauna validācija (kļūda 206 un veiksmīgas izpildes paziņojums 006) – V4 API tagad pārbauda, vai IBAN ievade nesatur neatļautas rakstzīmes</strong><br> Jaunais kļūdas kods – 206 (Validācija neizdevās) – ir saistīts ar šādu paziņojumu: IBAN satur neatļautas rakstzīmes.<br> Veiksmīgas izpildes paziņojuma kods šai pārbaudei ir 006 (Validācija veiksmīga), kuru papildina šāds paziņojums: IBAN nesatur neatļautas rakstzīmes.<br> Minētais kļūdas kods jums sniegs vairāk informācijas gadījumos, kad tiek iesniegti nevēlamus simbolus saturoši IBAN.<br> Agrāk šādā gadījumā darba režīms bija atbrīvoties no visiem nevēlamajiem simboliem un vienkārši turpināt validāciju.<br> <br> <strong>Pievienota jauna validācija (kļūda 207 un veiksmīgas izpildes paziņojums 007) - Valsts neatbalsta IBAN</strong> <br> Šis validācijas slānis ļauj saņemt paziņojumu gadījumā, ja ievadītā IBAN valsts kods nav atrodams oficiālajā IBAN maksājumus atbalstošo valstu sarakstā.<br> Piemēram, izmantojot neuzticamu trešo pušu programmatūru, lietotājs var būt ģenerējis IBAN Amerikas Savienotajām Valstīm.<br> Tāds IBAN varētu izskatīties šādi: US64SVBKUS6S3300958879<br> Kā redzams, kontrolcipari ir pareizi, tādēļ attiecīgā pārbaude tiks izturēta, tomēr tas nav derīgs IBAN, jo Amerikas Savienotajās Valstīs IBAN banku maksājumiem neizmanto.<br> <br> <hr> <h4>2. Funkcijas</h4><br> IBAN validācijas API V4 ļauj izpildīt šādas darbības:<br><br> <ul class="flat-list style1"> <li>pārbaudīt IBAN derīgumu, izmantojot tā kontrolciparus;</li> <li>pārbaudīt, vai IBAN satur derīgu vietējo bankas kontu un konta numura kontrolciparus *;</li> <li>validēt IBAN garumu konkrētai valstij;</li> <li>validēt IBAN struktūru/formātu konkrētai valstij;</li> <li>validēt IBAN rakstzīmes (pārbaudīt, vai tas nesatur nederīgus simbolus);</li> <li>validēt, vai valsts kods atbalsta IBAN standartu;</li> <br> <li>identificēt IBAN izdevējbanku;</li> <li>identificēt IBAN izdevējvalsti un valsts kodu;</li> <li>identificēt IBAN izdevējbankas adresi;</li> <li>identificēt bankas BIC kodu;</li> <li>identificēt bankas SEPA atbalstu: B2B, COR1, SCC, SCT, SDD.</li> </ul> <br> * Bankas koda un konta numura validācija tiek veikta tikai noteiktām bankām un valstīm. <hr> <a name="usage"></a> <h4>3. API V4 pieprasījumi</h4><br> <br> API sistēma ļauj automatizēt IBAN validāciju, izmantojot vienkāršu HTTP GET vai POST pieprasījumu.<br> Pieļaujamie parametri ir uzskaitīti zemāk redzamajā tabulā:<br><br> <table class="table table-bordered examples"> <thead> <tr> <th width="189">Lauka nosaukums</th> <th width="103">Garums</th> <th width="69">Veids</th> <th width="487">Apraksts</th> </tr> </thead> <tbody> <tr> <td width="189">IBAN</td> <td width="103">Maks. 100</td> <td width="69">Virkne</td> <td width="487">IBAN, kuru vēlaties validēt</td> </tr> <tr> <td width="189">api_key</td> <td width="103">128</td> <td width="69">Virkne</td> <td width="487">Jūsu personīgā API atslēga</td> </tr> <tr> <td width="189">format</td> <td width="103">5</td> <td width="69">Virkne</td> <td width="487">Atbildes formāts; tiek atbalstīts XML un JSON</td> </tr> </tbody> </table> <br> *Lai iegūtu API atslēgu, lūdzu, sazinieties ar mums, rakstot uz e-pasta adresi <a href="mailto:contact@iban.com">contact@iban.com</a>, vai iegādājieties abonementu mūsu <a href="pricing">pasūtījumu noformēšanas lapā</a> <br><br> <strong>PIEMĒRS – IBAN validācija</strong><br> Ja vēlaties, varat izmantot zemāk redzamo koda paraugu, lai pārbaudītu API darbību visizplatītākajās programmēšanas valodās.<br> <br> <div id="tabbed-nav"> <ul> <li><a>CURL</a></li> <li><a>PHP</a></li> <li><a>RUBY</a></li> <li><a>PYTHON</a></li> <li><a>Perl</a></li> <li><a>JAVA</a></li> <li><a>.NET</a></li> <li><a>NODE</a></li> </ul> <div> <div> <pre class="brush: bash;"> curl "https://api.iban.com/clients/api/v4/iban/" \ -X POST \ -d format=json \ -d api_key=[YOUR_API_KEY] \ -d iban=DE46500700100927353010 </pre> </div> <div> <pre class="brush: php;"> <?php $curl = curl_init(); $post = [ 'format' => 'json', 'api_key' => '[YOUR_API_KEY]', 'iban' => 'DE46500700100927353010', ]; curl_setopt_array($curl, array( CURLOPT_URL => 'https://api.iban.com/clients/api/v4/iban/', CURLOPT_RETURNTRANSFER => true, CURLOPT_POSTFIELDS => $post )); $output = curl_exec($curl); $result = json_decode($output); print_r($result); curl_close($curl); ?> </pre> </div> <div> <pre class="brush: php;"> require 'net/http' uri = URI('https://api.iban.com/clients/api/v4/iban/') res = Net::HTTP.post_form(uri, "format" => "json", "api_key" => "[YOUR_API_KEY]","iban" => "DE46500700100927353010") puts res.body </pre> </div> <div> <pre class="brush: php;"> import requests post_data = {'format':'json', 'api_key':'[YOUR_API_KEY]','iban':'DE46500700100927353010'} response = requests.post('https://api.iban.com/clients/api/v4/iban/',post_data) print(response.text) </pre> </div> <div> <pre class="brush: php;"> use LWP::UserAgent; my $ua = LWP::UserAgent->new; my $server_endpoint = "https://api.iban.com/clients/api/v4/iban/"; my $format = 'json'; my $api_key = '[YOUR_API_KEY]'; my $iban = 'DE02100500000024290661'; my $req = HTTP::Request->new( POST => $server_endpoint ); $req->content_type('application/x-www-form-urlencoded'); my $post_data = 'format=' . $format . '&api_key=' . $api_key . '&iban=' . $iban; $req->content($post_data); my $resp = $ua->request($req); if ( $resp->is_success ) { my $message = $resp->decoded_content; print $message; } </pre> </div> <div> <h4>JAVA</h4> <pre class="brush: csharp;"> import java.io.BufferedReader; import java.io.DataOutputStream; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; import javax.net.ssl.HttpsURLConnection; import org.json.simple.JSONObject; import org.json.simple.JSONArray; import org.json.simple.parser.ParseException; import org.json.simple.parser.JSONParser; public class ibanapi { private final String USER_AGENT = "API Client/1.0"; public static void main(String[] args) throws Exception { ibanapi http = new ibanapi(); System.out.println("\nPārbauda API - Sūtīt API POST pieprasījumu"); http.sendPost(); } // HTTP POST request private void sendPost() throws Exception { String url = "https://api.iban.com/clients/api/v4/iban/"; URL obj = new URL(url); HttpsURLConnection con = (HttpsURLConnection) obj.openConnection(); //add reuqest header con.setRequestMethod("POST"); con.setRequestProperty("User-Agent", USER_AGENT); con.setRequestProperty("Accept-Language", "en-US,en;q=0.5"); String urlParameters = "api_key=[YOUR_API_KEY]&format=json&iban=DE02100500000024290661"; // Send post request con.setDoOutput(true); DataOutputStream wr = new DataOutputStream(con.getOutputStream()); wr.writeBytes(urlParameters); wr.flush(); wr.close(); int responseCode = con.getResponseCode(); System.out.println("\nSūta 'POST' pieprasījumu uz URL : " + url); System.out.println("Post parametri : " + urlParameters); System.out.println("Atbildes kods : " + responseCode); BufferedReader in = new BufferedReader( new InputStreamReader(con.getInputStream())); String inputLine; StringBuffer response = new StringBuffer(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } in.close(); //print result System.out.println(response.toString()); } } </pre> </div> <div> <h4>.NET</h4> <pre class="brush: java;"> public static void Main(string[] args) { var request = (HttpWebRequest)WebRequest.Create("https://api.iban.com/clients/api/v4/iban/"); var postData = "api_key=[YOUR_API_KEY]"; postData += "&format=json"; postData += "&iban=DE02100500000024290661"; var data = Encoding.ASCII.GetBytes(postData); request.Method = "POST"; request.ContentType = "application/x-www-form-urlencoded"; request.ContentLength = data.Length; using (var stream = request.GetRequestStream()) { stream.Write(data, 0, data.Length); } var response = (HttpWebResponse)request.GetResponse(); var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd(); Console.WriteLine(responseString); Console.Write("Lai turpinātu, nospiediet jebkuru taustiņu . . . "); Console.ReadKey(true); } </pre> </div> <div> <h4>NODE</h4> <pre class="brush: java;"> var request = require('request'); var headers = { 'User-Agent': 'IBAN API Client/0.0.1', 'Content-Type': 'application/x-www-form-urlencoded' } var options = { url: 'https://api.iban.com/clients/api/v4/iban/', method: 'POST', headers: headers, form: {'api_key': '[YOUR_API_KEY]', 'format': 'json', 'iban': 'GB04BARC20474473160944'} } request(options, function (error, response, body) { if (!error && response.statusCode == 200) { var data = JSON.parse(body); console.log(data.errors); console.log("Bankas nosaukums: " + data.bank_data.bank); console.log("Bankas BIC: " + data.bank_data.bic); console.log("Bankas pilsēta: " + data.bank_data.city); console.log("Bankas adrese: " + data.bank_data.address); console.log("Bankas pasta indekss: " + data.bank_data.zip); console.log("Bankas tālrunis: " + data.bank_data.phone); console.log("Bankas fakss: " + data.bank_data.fax); console.log("Bankas www: " + data.bank_data.www); console.log("Bankas e-pasts: " + data.bank_data.email); console.log("Bankas valsts nosaukums: " + data.bank_data.country); console.log("Bankas valsts kods: " + data.bank_data.country_iso); console.log("Iekšzemes konta numurs: " + data.bank_data.account); } }) </pre> </div> </div> </div> <br> IBAN validācijas API lietojuma piemērs ar GET pieprasījumu apskatāms zemāk:<br><br> <a class="green" href="https://api.iban.com/clients/api/v4/iban/?api_key=key&format=xml&iban=IBAN" target="_new">https://api.iban.com/clients/api/v4/iban/?api_key=key&format=xml&iban=IBAN</a><br><br> kur:<br> <ul class="flat-list style1"> <li>"key" ir jūsu API atslēga;</li> <li>"IBAN", kas nosūtīts validācijai;</li> <li>"xml" ir atbildes formāts; iespējams lietot arī atslēgvārdu "json", lai saņemtu atbildi json formātā.</li> </ul><br> Tiklīdz tiek veikts HTTP GET vai POST pieprasījums ar pareizo API atslēgu, sistēma atgriež rezultātus norādītajā formātā. Atbildes paraugs apskatāms nākamajā sadaļā "API atbildes struktūra". <br><hr> <a name="response"></a> <h4>4. API V4 atbilde</h4> Zemāk atrodama API atbildes XSD shēma:<br> <pre class="brush: xml;"> <?xml version="1.0" encoding="UTF-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> <xs:element name="result"> <xs:complexType> <xs:sequence> <xs:element name="bank_data"> <xs:complexType> <xs:sequence> <xs:element name="bic" type="xs:string"></xs:element> <xs:element name="branch"></xs:element> <xs:element name="bank" type="xs:string"></xs:element> <xs:element name="address"></xs:element> <xs:element name="city" type="xs:string"></xs:element> <xs:element name="state"></xs:element> <xs:element name="zip" type="xs:int"></xs:element> <xs:element name="phone"></xs:element> <xs:element name="fax"></xs:element> <xs:element name="www"></xs:element> <xs:element name="email"></xs:element> <xs:element name="country" type="xs:string"></xs:element> <xs:element name="country_iso" type="xs:string"></xs:element> <xs:element name="account" type="xs:int"></xs:element> <xs:element name="bank_code" type="xs:int"></xs:element> <xs:element name="branch_code"></xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="sepa_data"> <xs:complexType> <xs:sequence> <xs:element name="SCT" type="xs:string"></xs:element> <xs:element name="SDD" type="xs:string"></xs:element> <xs:element name="COR1" type="xs:string"></xs:element> <xs:element name="B2B" type="xs:string"></xs:element> <xs:element name="SCC" type="xs:string"></xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="validations"> <xs:complexType> <xs:sequence> <xs:element name="chars"> <xs:complexType> <xs:sequence> <xs:element name="code" type="xs:int"></xs:element> <xs:element name="message" type="xs:string"></xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="iban"> <xs:complexType> <xs:sequence> <xs:element name="code" type="xs:int"></xs:element> <xs:element name="message" type="xs:string"></xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="account"> <xs:complexType> <xs:sequence> <xs:element name="code" type="xs:int"></xs:element> <xs:element name="message" type="xs:string"></xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="structure"> <xs:complexType> <xs:sequence> <xs:element name="code" type="xs:int"></xs:element> <xs:element name="message" type="xs:string"></xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="length"> <xs:complexType> <xs:sequence> <xs:element name="code" type="xs:int"></xs:element> <xs:element name="message" type="xs:string"></xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="country_support"> <xs:complexType> <xs:sequence> <xs:element name="code" type="xs:int"></xs:element> <xs:element name="message" type="xs:string"></xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="errors"></xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema> </pre> Zemāk redzamajā tabulā dots detalizēts saņemto <i>bank_data</i> objekta lauku apraksts:<br><br> <table class="table table-bordered examples"> <thead> <tr> <th>Lauka nosaukums</th> <th>Garums</th> <th>Veids</th> <th>Apraksts</th> </tr> </thead> <tbody> <tr> <td>BIC</td> <td>Maks. 11</td> <td>Virkne</td> <td>Izdevējbankas/izdevējfiliāles vai izdevējiestādes BIC kods.</td> </tr> <tr> <td>BANK</td> <td>Maks. 256</td> <td>Virkne</td> <td>IBAN izdevējbankas/izdevējiestādes nosaukums.</td> </tr> <tr> <td>BRANCH</td> <td>Maks. 256</td> <td>Virkne</td> <td>Konkrētās bankas filiāles nosaukums, ja tāds ir pieejams.</td> </tr> <tr> <td>COUNTRY</td> <td>Maks. 32</td> <td>Virkne</td> <td>Pilns izcelsmes valsts nosaukums, piemēram, “United States”</td> </tr> <tr> <td>COUNTRY_ISO</td> <td>2</td> <td>Virkne</td> <td>Divu burtu valsts koda saīsinājums, piem., LV, US, UK, FR… utt.</td> </tr> <tr> <td>CITY</td> <td>Maks. 128</td> <td>Virkne</td> <td>Izdevējbankas pilsētas nosaukums.</td> </tr> <tr> <td>STATE</td> <td>Maks. 128</td> <td>Virkne</td> <td>Štata nosaukums, kurā atrodas banka/filiāle.</td> </tr> <tr> <td>ZIP</td> <td>Maks. 11</td> <td>Virkne</td> <td>Pilsētas pasta indekss.</td> </tr> <tr> <td>ADDRESS</td> <td>Maks. 128</td> <td>Virkne</td> <td>Izdevējbankas adrese.</td> </tr> <tr> <td>ACCOUNT</td> <td>Maks. 128</td> <td>Virkne</td> <td>No IBAN iegūtais vietējais bankas konta numurs.</td> </tr> </tbody> </table> Zemāk redzamajā tabulā dots detalizēts saņemto <i>sepa_data</i> objekta lauku apraksts:<br><br> <table class="table table-bordered examples"> <thead> <tr> <th>Lauka nosaukums</th> <th>Garums</th> <th>Tips</th> <th>Apraksts</th> </tr> </thead> <tbody> <tr> <td>SCT</td> <td>Maks. 3</td> <td>Virkne</td> <td>Vai dotā banka atbalsta SEPA kredīta pārvedumu.</td> </tr> <tr> <td>SDD</td> <td>Maks. 3</td> <td>Virkne</td> <td>Vai dotā banka atbalsta SEPA tiešo debetu.</td> </tr> <tr> <td>COR1</td> <td>Maks. 3</td> <td>Virkne</td> <td>Vai dotā banka atbalsta SEPA COR1.</td> </tr> <tr> <td>B2B</td> <td>Maks. 3</td> <td>Virkne</td> <td>Vai dotā banka atbalsta SEPA "Business to Business".</td> </tr> <tr> <td>SCC</td> <td>Maks. 3</td> <td>Virkne</td> <td>Vai dotā banka atbalsta SEPA karšu klīringu.</td> </tr> </tbody> </table> <br> <br> Zemāk dots piemērs XML atbildei no API uz IBAN validācijas vaicājumu:<br> <pre class="brush: xml;"> <result> <bank_data> <bic>BARCGB22</bic> <branch>INTERNATIONAL BANKING 2</branch> <bank>BARCLAYS BANK UK PLC</bank> <address>PO Box 69999 1 Churchill Place Canary Wharf </address> <city>London</city> <state/> <zip>E14 1QE</zip> <phone>020 71147000</phone> <fax/> <www/> <email/> <country/> <country_iso>GB</country_iso> <account>73160944</account> </bank_data> <sepa_data> <SCT>YES</SCT> <SDD>YES</SDD> <COR1>YES</COR1> <B2B>YES</B2B> <SCC>NO</SCC> </sepa_data> <validations> <chars> <code>006</code> <message>IBAN nesatur neatļautus simbolus</message> </chars> <iban> <code>001</code> <message>IBAN kontrolcipari ir pareizi</message> </iban> <account> <code>002</code> <message>Konta numura kontrolcipari ir pareizi</message> </account> <structure> <code>005</code> <message>IBAN struktūra ir pareiza</message> </structure> <length> <code>003</code> <message>IBAN garums ir pareizs</message> </length> <country_support> <code>007</code> <message>Valsts atbalsta IBAN standartu</message> </country_support> </validations> <errors/> </result> </pre> <hr> <a name="errors"></a> <h4>5. API V4 statusa kodi</h4> <p><strong>Matemātisko kontrolciparu un formāta validācijas tiek atgrieztas "validations" objektā<br> API versijā V4 mēs katrai no validācijām esam iedalījuši atsevišķu objektu, lai jūsu kodā atvieglotu piekļuvi katrai konkrētai validācijai.<br> Tas būtībā nozīmē, ka tā vietā, lai cikliski izmantotu objektu "validations", jūs varat vienkārši atsaukties uz konkrēto validācijas objektu, norādot tā nosaukumu, piemēram, $validations->structure; </strong><br> </p> <table class="table table-bordered downloads"> <thead> <tr> <th>Statusa kods</th> <th>Veids</th> <th>Apraksts</th> </tr> </thead> <tbody> <tr style="background-color: #fefae2;"> <td>301</td> <td>Konta kļūda</td> <td>API atslēga nav derīga</td> </tr> <tr style="background-color: #fefae2;"> <td>302</td> <td>Konta kļūda</td> <td>Beidzies abonements</td> </tr> <tr style="background-color: #fefae2;"> <td>303</td> <td>Konta kļūda</td> <td>Vaicājumi nav pieejami</td> </tr> <tr style="background-color: #fefae2;"> <td>304</td> <td>Konta kļūda</td> <td>Jums nav piekļuves šai API</td> </tr> <tr style="background-color: #fefae2;"> <td>305</td> <td>Konta kļūda</td> <td>IP adrese nav atļauta</td> </tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"> <td>201</td> <td>Validācija neizdevās</td> <td>Konta numura kontrolcipari nav pareizi</td> </tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"> <td>202</td> <td>Validācija neizdevās</td> <td>IBAN kontrolcipari nav pareizi</td> </tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"> <td>203</td> <td>Validācija neizdevās</td> <td>IBAN garums nav pareizs</td> </tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"> <td>205</td> <td>Validācija neizdevās</td> <td>IBAN struktūra nav pareiza</td> </tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"> <td>206</td> <td>Validācija neizdevās</td> <td>IBAN satur neatļautus simbolus</td> </tr> <tr style="background-color: rgba(241, 215, 208, 0.55);"> <td>207</td> <td>Validācija neizdevās</td> <td>Valsts neatbalsta IBAN standartu</td> </tr> <tr style="background-color: rgba(208, 241, 230, 0.55);"> <td>001</td> <td>Validācija veiksmīga</td> <td>IBAN kontrolcipari ir pareizi</td> </tr> <tr style="background-color: rgba(208, 241, 230, 0.55);"> <td>002</td> <td>Validācija veiksmīga</td> <td>Konta numura kontrolcipari ir pareizi</td> </tr> <tr style="background-color: rgba(208, 241, 230, 0.55);"> <td>003</td> <td>Validācija veiksmīga</td> <td>IBAN garums ir pareizs</td> </tr> <tr style="background-color: rgba(208, 241, 230, 0.55);"> <td>004</td> <td>Validācija veiksmīga</td> <td>Šai bankai vai filiālei netiek veikta konta numuru kontrolciparu pārbaude</td> </tr> <tr style="background-color: rgba(208, 241, 230, 0.55);"> <td>005</td> <td>Validācija veiksmīga</td> <td>IBAN struktūra ir pareiza</td> </tr> <tr style="background-color: rgba(208, 241, 230, 0.55);"> <td>006</td> <td>Validācija veiksmīga</td> <td>IBAN nesatur neatļautas rakstzīmes</td> </tr> <tr style="background-color: rgba(208, 241, 230, 0.55);"> <td>007</td> <td>Validācija veiksmīga</td> <td>Valsts atbalsta IBAN standartu</td> </tr> </tbody> </table> <br> </div></div> </div> </div> </div> <footer class="footer" > <div class="footer-widgets"> <div class="container"> <div class="row"> <div class="col-md-3 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle">Tīmekļa rīki</div> <ul class="ft-menu"> <li><a href="/iban-checker">IBAN pārbaudītājs</a></li> <li><a href="/calculate-iban">IBAN kalkulators</a></li> <li><a href="/search-bic">Meklēt BIC</a></li> <!-- <li><a href="/currency-converter">Currency Convert</a></li> <li><a href="/exchange-rates">Currency Exchange rates</a></li> --> </ul> </div> </div> </div> <div class="col-md-3 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle"><a href="/developers">Produkti</a></div> <ul class="ft-menu"> <li><a href="/iban-suite">IBAN komplekts: validācija un aprēķināšana</a></li> <li><a href="/bic-validation-service">BIC validācijas pakalpojums</a></li> <li><a href="/register">Pieprasīt izmēģinājuma piekļuvi</a></li> </ul> </div> </div> </div> <div class="col-md-3 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle"><a href="/developers">Izstrādātājiem</a></div> <ul class="ft-menu"> <li><a href="/validation-api">IBAN validācijas API</a></li> <li><a href="/calculation-api">IBAN aprēķināšanas API</a></li> <li><a href="/bic-validation-api">BIC validācijas API</a></li> </ul> </div> </div> </div> <div class="col-md-3 col-sm-6 col-xs-6"> <div class="widget widget_nav_menu"> <div class="menu-footer-menu-container"> <div class="footermenutitle"><a href="/about">Par mums</a></div> <ul class="ft-menu"> <li><a href="/why-iban">Kādēļ IBAN</a></li> <li><a href="/customers">Klienti</a></li> <li><a href="/our-data">Mūsu dati</a></li> </ul> <!-- <div class="footermenutitle">Language</div> --> <!-- <select id="foo"> <option value="">Pick a Language</option> <option value="http://www.google.com">x</option> <option value="http://www.yahoo.com">y</option> <option value="http://www.google.com"><img src="/images/icon/blank.png" class="flag flag-de" width="16" height="11" alt="de"> Deutsch</option> </select> <script> document.getElementById("foo").onchange = function() { if (this.selectedIndex!==0) { window.location.href = this.value; } }; </script> --> </div> </div> </div> </div> </div> </div> <div class="content-bottom-widgets"> <div class="container"> <div class="row"> <div class="ft-wrapper"> <div class="col-md-12 text-center footermenutitle">Partneri</div></div> </div> </div> </div> <div class="content-bottom-widgets"> <div class="container"> <div class="row"> <div class="flat-wrapper"> <div class="ft-wrapper"> <div class="col-md-4 text-left"> <span style="clear:both;">BIC datu izmantošana ar "S.W.I.F.T. SCRL" atļauju. Datubāzes tiesības aizsargātas, 2025. <br> IBAN.com ir autorizēts "VocaLink™" izplatītājs</span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/swiftref.png" alt="S.W.I.F.T. SCRL"> </span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/deutsche_bundesbank.png" alt="Deutsche Bundesbank"> </span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/banque_de_france.png" alt="La Banque de France Eurosisteme"></span> </div> <div class="col-md-2 col-sm-6 text-center"> <span><img src="/images/logos/vocalink_mastercard.png" alt="Vocalink LTD (Mastercard)"> </span> </div> </div> </div> </div> </div> </div> <div class="footer-content"> <div class="container"> <div class="row"> <div class="copyright"> <div class="copyright-content"> <div class="col-md-4 col-sm-12"> © 2025<a href="https://www.iban.com/">IBAN</a> </div> <div class="col-md-8 col-sm-12"> <a href="https://www.iban.com/privacy">Privātums</a> <a href="https://www.iban.com/terms">Noteikumi</a> <a href="https://www.iban.com/dpa">Datu apstrāde</a> <a href="https://www.iban.com/security" class="hidden-xs">Drošība</a> <a href="/contact">Kontakti</a> <a href="/sitemap" class="hidden-xs" >Lapas karte</a> </div> </div> </div> </div> </div> </div> </footer> <a class="go-top"> <i class="fa fa-chevron-up"></i> </a> <script type="text/javascript" src="/javascript/jquery-2.2.4.min.js" ></script> <script type="text/javascript" src="javascript/zozo.tabs.min.js"></script><link rel="stylesheet" type="text/css" href="stylesheets/zozo.tabs.min.css"><script> jQuery(document).ready(function ($) { /* jQuery activation and setting options for first tabs, enabling multiline*/ $("#tabbed-nav").zozoTabs({ position: "top-compact", multiline: true, theme: "white", shadows: true, orientation: "horizontal", size: "medium", animation: { easing: "easeInOutExpo", duration: 500, effects: "slideH" } }); /* jQuery activation and setting options for second tabs, enabling multiline*/ }); </script> <!-- NID BROWSER CODE SWITCHING JS INCLUDE --> <!-- END NID BROWSER SWITCHING JS INCLUDE --> <script type="text/javascript" src="/javascript/ibanlibs.js"></script> <script type="text/javascript" src="/javascript/main.js"></script> <script type="text/javascript"> $(document).ready(function() { $.DivasCookies({ bannerText : "Lai uzlabotu jūsu apmeklējuma kvalitāti, šajā vietnē tiek izmantotas sīkdatnes.", // text for the Divas Cookies banner cookiePolicyLink : "/privacy", // link to the extended cookie policy cookiePolicyLinkText : "Privātuma politika", // text for the link to the extended cookie policy thirdPartyPolicyWidget : "", // if set to "iubenda" tries to use the Iubenda widget acceptButtonText : "Piekrītu", // text for the close button acceptButtonSrc : "", // source for the close button image openEffect : "", // opening effect for Divas Cookies banner ["fade", "slideUp", "slideDown", "slideLeft", "slideRight"] openEffectDuration : 600, // duration of the opening effect (msec) openEffectEasing : "", // easing for the opening effect closeEffect : "", // closing effect for Divas Cookies banner ["fade", "slideUp", "slideDown", "slideLeft", "slideRight"] closeEffectDuration : 600, // duration of the closing effect (msec) closeEffectEasing : "", // easing for the closing effect debugMode : false, // if true, the options are checked and warnings are shown saveUserPreferences : true, // if true, sets a cookie after the Divas Cookies is closed the first time and never shows it again cookieDuration : 30, // number of days after which the Divas Cookie technical cookie will expire (default 365 days) blockScripts : false, // set this to true if you blocked scripts by wrapping them with if($.DivasCookies.optedIn()){**script to be blocked**} (default false) pageReload : false, // if true reloads the actual page after opt-in to show the previuosly blocked scripts (default false) acceptOnScroll : false, // if true sets the Divas Cookie technical cookie on page scroll for cookies agreement (default false) acceptOnClick : true, // if true sets the Divas Cookie technical cookie on click on any <a> in the page except that on Divas Cookies banner for cookies agreement (default false) excludePolicyPage : true // if true excludes the cookie policy page from acceptOnScroll and acceptOnClick (default false) }); }); </script> <!--[if lt IE 10]> <script src="https://cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv.min.js"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/respond.js/1.4.2/respond.min.js"></script> <![endif]--> <!--[if IE 9]> <script src="javascript/matchMedia.js"></script> <script type="text/javascript" src="javascript/jquery.placeholder.js"></script> <script> // To test the @id toggling on password inputs in browsers that don’t support changing an input’s @type dynamically (e.g. Firefox 3.6 or IE), uncomment this: // $.fn.hide = function() { return this; } // Then uncomment the last rule in the <style> element (in the <head>). $(function() { // Invoke the plugin $('input, textarea').placeholder({customClass:'my-placeholder'}); // That’s it, really. var html; }); </script> <![endif]--> <script type="text/javascript" src="https://www.iban.com/javascript/tw-app.js"></script> </body> </html> <!-- Global site tag (gtag.js) - Google Analytics --> <script async src='https://www.googletagmanager.com/gtag/js?id=UA-70849995-18'></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-70849995-18'); </script>