Any service call has https://code.pedroruizhidalgo.es/api/v5 as API root. Let's call it in this manual [apiroot]

For every service call you need to provide your own [apikey]. This can be obtained in https://pedroruizhidalgo.es/createapiaccount.

The [apikey] consists in a string of 32 character length.

The general url format is [apiroot]/[service]/[renderway]/[apikey].

For example: To get your user data visit [apiroot]/user/json/[apikey]

There are three ways to render the results:

• json
• xml
• html

Ex: If you want to get your geolocation data in json format, call it like. [apiroot]/users/json/[apikey].

A successfull process will display this screen:

After create your account you will receive an email like :

Of course, activation service has the three render ways. Nevertheless, if you follow the email's link, shall render in html, unless you type manually the url. Like this:

[apiroot]/activation/[rendermode]/[apikey]

Access mode [apiroot]/checkiban/[rendermode]/[iban]/[apikey]

(This example was obtained when searching in google "example iban".)

{
    "account": "0532013000",
    "bank": "37040044",
    "bban": "370400440532013000",
    "branch": "",
    "checksum": "89",
    "country": "DE",
    "country_central": "Deutsche Bundesbank",
    "country_central_url": "http://www.bundesbank.de/",
    "human_format": "DE89 3704 0044 0532 0130 00",
    "nationalchecksum": ""
}
      

As you can see, we provide the iban decomposed format, human readable format, the sum of control and the national bank of this country, among others.

If iban is not valid we provide:

{
    "iban": "DE89370400440532013014",
    "validate": "false"
}      
      

The ISO 4217 code list is used in banking and business globally.

{
    "AED": "United Arab Emirates Dirham",
    "AFN": "Afghanistan Afghani",
    "ALL": "Albania Lek",
    "AMD": "Armenia Dram",
    "ANG": "Netherlands Antilles Guilder",
    "AOA": "Angola Kwanza",
    "ARS": "Argentina Peso",
    "AUD": "Australia Dollar",
    "AWG": "Aruba Guilder",
    "AZN": "Azerbaijan Manat",
    "BAM": "Bosnia and Herzegovina Convertible Marka",
    "BBD": "Barbados Dollar",
    "BDT": "Bangladesh Taka",
    "BGN": "Bulgaria Lev",
    "BHD": "Bahrain Dinar",
    "BIF": "Burundi Franc",
    "BMD": "Bermuda Dollar",
...
    "VEF": "Venezuela Bolívar",
    "VND": "Viet Nam Dong",
    "VUV": "Vanuatu Vatu",
    "WST": "Samoa Tala",
    "XAF": "Communauté Financière Africaine (BEAC) CFA Franc BEAC",
    "XCD": "East Caribbean Dollar",
    "XDR": "International Monetary Fund (IMF) Special Drawing Rights",
    "XOF": "Communauté Financière Africaine (BCEAO) Franc",
    "XPF": "Comptoirs Français du Pacifique (CFP) Franc",
    "YER": "Yemen Rial",
    "ZAR": "South Africa Rand",
    "ZMW": "Zambia Kwacha",
    "ZWD": "Zimbabwe Dollar"
}          
      

Access mode: [apiroot]/geolocation/[rendermode]/[apikey]/[optional IP address]

Call geolocation service whith out the optional IP address for get your own IP. In other words, if you do not provide an IP address, the service will proccess your current IP address.

{
    "area_code": "",
    "city": "",
    "continent": "North America",
    "continent_code": "NA",
    "country_code": "US",
    "country_name": "United States",
    "currency": "USD",
    "currency_simbol": "$",
    "currency_utf8": "$",
    "current_time": "2018-10-25 21:22:50",
    "in_eu": "no",
    "IP": "70.110.40.10",
    "latitude": "37.751",
    "longitude": "-97.822",
    "region": "",
    "region_code": "",
    "region_name": "",
    "tax_percent": false,
    "time_zone": "",
    "usdollar_to_usd": "1"
}    
  

An egyptian example.

{
    "area_code": "",
    "city": "Cairo",
    "continent": "Africa",
    "continent_code": "AF",
    "country_code": "EG",
    "country_name": "Egypt",
    "currency": "EGP",
    "currency_simbol": "£",
    "currency_utf8": "£",
    "current_time": "2018-10-25 21:24:34",
    "in_eu": "no",
    "IP": "45.100.28.10",
    "latitude": "30.0771",
    "longitude": "31.2859",
    "region": "Cairo Governorate",
    "region_code": "C",
    "region_name": "Cairo Governorate",
    "tax_percent": false,
    "time_zone": "Africa/Cairo",
    "usdollar_to_egp": "17.953"
}      
  

Another european example:

{
    "area_code": "",
    "city": "",
    "continent": "Europe",
    "continent_code": "EU",
    "country_code": "IT",
    "country_name": "Italy",
    "currency": "EUR",
    "currency_simbol": "€",
    "currency_utf8": "€",
    "current_time": "2018-10-25 21:26:12",
    "in_eu": "yes",
    "IP": "94.80.188.102",
    "latitude": "43.1479",
    "longitude": "12.1097",
    "region": "",
    "region_code": "",
    "region_name": "",
    "tax_percent": 22,
    "time_zone": "Europe/Rome",
    "usdollar_to_eur": "0.8765"
}
  

As you can observe, we convert the currency from us dollar to local.

{
  "abbreviation": "SA, SAL, SAU, SAE",
  "check_sum": 0,
  "checksum_type": "Number",
  "province": "Castellón",
  "province_code": "12",
  "raw_number": "34567",
  "raw_type": "A",
  "type": "Sociedad Anónima",
  "validate": "false"
}
   

If we correct the checsum... [apiroot]/spanishcif/A12345670/json/[apikey]

{
  "abbreviation": "SA, SAL, SAU, SAE",
  "check_sum": 0,
  "checksum_type": "Number",
  "province": "Castellón",
  "province_code": "12",
  "raw_number": "34567",
  "raw_type": "A",
  "type": "Sociedad Anónima",
  "validate": "true"
}
  

You dig it?...

{
    "count": 9,
    "user": "freeuser"
}
   

If you are not a free user will obtain that:

{
  "count": "Your plan is not countable",
  "user": "nonfreeuser"
}
   

[header]
image,assets/img/logo.png,65,13,15,15
SetFont,Arial,B,13
cell,30
cell,120,10,API SERVICES V5,0,0,C
ln,5
setfont,arial,,8
cell,30
cell,120,8,@pedroruizhidalg,0,1,C
cell,30
SetFont,times,i,10
settextcolor,180,180,180
cell,120,3,"Coding the world since 1983!",0,1,C
ln,10
SetFont,Arial,B,8
settextcolor,0,0,0

[armor]
cell,10,4.5,Num,1,0,C
cell,50,4.5,Name,1,0,C
cell,50,4.5,Address,1,0,C
cell,20,4.5,Phone,1,0,C
cell,50,4.5,Email,1,1,C
SetFont,Arial,,8

[loop]
1,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
2,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
3,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
4,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
5,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
6,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
7,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
8,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
9,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
10,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com

...

95,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
96,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
97,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
98,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
99,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com
100,Lorem ipsum dolor sit amet,Praesent varius tellus id urna ida,Integer ut,quam@pellentesque.com

[afterloop]
ln,10
setx,30
cell,30,4.5,This text goes after loop.,0,1,L
setx,30
cell,30,4.5,Try it and enjoy!,0,1,L
[footer]
sety,-15
setfont,arial,i,8


[footer]
sety,-15
setfont,arial,i,8

[pagename]
Spanish accent Página

[filename]
prueba.pdf

[response]
download




   

See the sample generated by code above.

{
	"data" : "this is the data to codify",
	"apikey" : "yourverysecretapikey",
	"level" : "M",
	"size" : 3,
	"black" : "255,255,255",
	"quality" : true,
	"white" : "0,0,255"
}

To convert the API request to an image, you can do something like that: (For convenience, we expose the code in PHP, but you can do it with you preferred language)

$post = json_encode( array(
          "data" => "your text to code",
          "apikey" => "yourapikey",
          "level" => "M",
          "size" => 4,
          "black" => "255,255,255",
          "quality" => true,
          "white" => "30,30,255"
        )
      );
      $ch = curl_init('https://code.pedroruizhidalgo.es/api/v5/qrcodes');
      curl_setopt( $ch , CURLOPT_CUSTOMREQUEST , "POST");    
      curl_setopt( $ch , CURLOPT_POSTFIELDS , $post );
      curl_setopt( $ch , CURLOPT_RETURNTRANSFER , true );
      curl_setopt( $ch , CURLOPT_HTTPHEADER , array (                                                                          
        'Content-Type: application/json',                                                                                
        'Content-Length: ' . strlen($post))                                                                       
      );
      $result = curl_exec(  $ch );

      echo <img src="data:image/png;base64,' . base64_encode ( $result ) . '">';

Time zone: Europe/Madrid, Page rendered in 0.5103 seconds. CodeIgniter Version 3.1.9