Naše JSON-RPC rozhraní myšlenkově vychází z XML-RPC, ale řeší některé jeho nedostatky pro jednodušší používání.
Název volané metody je cesta v URL, takže například volání metody items se zapíše jako /items.
Tento JSON-RPC server umožňuje volání metod několika způsoby:
_, _callback, nebo callback. Jakmile volání obsahu jeden z těchto parametrů, automaticky se odpovídá pomocí JSONP. Více o JSONP na Wikipedii.Content-Type: application/x-www-form-urlencoded.application/json, text/json, nebo text/plain pro JSON a application/bson pro BSON.Rozhraní odpovídá buďto JSONem, jebo BSONem a to podle HTTP hlavičky Accept. Výchozí formát odpovědi je JSON.
Odpověď vždy obsahuje objekt s klíči status a status_message. Status je číselný stav vyřízení volání podobný stavovým kódům HTTP, ale může se lišit tam, kde neexistuje odpovídající HTTP status. Status_message pak obsahuje textový popis výsledku volání. V případě úspěšného volání je odpověď {“status”:200, “status_message”: “OK”}.
Pokud volání vrací nějaká data, kořenový objekt obsahuje ještě klíč s názvem volané metody.
GET /system_list_methods HTTP/1.0
User-Agent: curl/7.37.1
Host: dummy.grandit.cz:1200
Accept: */*
HTTP/1.1 200 OK
Content-Type: application/json
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: Reply-OK-Only
Connection: Close
Content-Length: __
{
"status_message": "OK",
"system_list_methods": [
"system_alive",
"system_list_methods",
"system_method_help",
"system_method_info",
"system_method_sig",
"system_multicall",
"system_status",
],
"status": 200
}
Pokud do vstupního pole, zadáte adresu našeho RPC rozhraní, můžete klikem na tlačítko načíst jeho konfiguraci. S konfigurací rozhraní se načítají jak signatury metod, tak nápověda. Pomocí tohoto rozhraní je také možné jednotlivé metody provolat a zovnou se podívat na návratové hodnoty.
API slouží k identifikaci skutečného mobilního operátora na základě telefonního čísla.
| Označení | Země | Operátor |
|---|---|---|
| o2_cz | Česká Republika | O2 |
| tm_cz | Česká Republika | T-Mobile |
| vf_cz | Česká Republika | Vodafone |
| nt_cz | Česká Republika | Nordic Telecom |
| fix_cz | Česká Republika | Pevná síť |
| tm_sk | Slovenská Republika | T-Mobile |
| or_sk | Slovenská Republika | Orange |
| o2_sk | Slovenská Republika | O2 |
| sw_sk | Slovenská Republika | 4ka |
| Označení | Název |
|---|---|
| af | Afghanistan |
| al | Albania |
| dz | Algeria |
| as | American Samoa |
| ad | Andorra |
| ao | Angola |
| ai | Anguilla |
| aq | Antarctica |
| ag | Antigua and Barbuda |
| ar | Argentina |
| am | Armenia |
| aw | Aruba |
| au | Australia |
| at | Austria |
| az | Azerbaijan |
| bs | Bahamas (the) |
| bh | Bahrain |
| bd | Bangladesh |
| bb | Barbados |
| by | Belarus |
| be | Belgium |
| bz | Belize |
| bj | Benin |
| bm | Bermuda |
| bt | Bhutan |
| bo | Bolivia (Plurinational State of) |
| bq | Bonaire, Sint Eustatius and Saba |
| ba | Bosnia and Herzegovina |
| bw | Botswana |
| bv | Bouvet Island |
| br | Brazil |
| io | British Indian Ocean Territory (the) |
| bn | Brunei Darussalam |
| bg | Bulgaria |
| bf | Burkina Faso |
| bi | Burundi |
| cv | Cabo Verde |
| kh | Cambodia |
| cm | Cameroon |
| ca | Canada |
| ky | Cayman Islands (the) |
| cf | Central African Republic (the) |
| td | Chad |
| cl | Chile |
| cn | China |
| cx | Christmas Island |
| cc | Cocos (Keeling) Islands (the) |
| co | Colombia |
| km | Comoros (the) |
| cd | Congo (the Democratic Republic of the) |
| cg | Congo (the) |
| ck | Cook Islands (the) |
| cr | Costa Rica |
| hr | Croatia |
| cu | Cuba |
| cw | Curaçao |
| cy | Cyprus |
| cz | Czechia |
| ci | Côte d'Ivoire |
| dk | Denmark |
| dj | Djibouti |
| dm | Dominica |
| do | Dominican Republic (the) |
| ec | Ecuador |
| eg | Egypt |
| sv | El Salvador |
| gq | Equatorial Guinea |
| er | Eritrea |
| ee | Estonia |
| sz | Eswatini |
| et | Ethiopia |
| fk | Falkland Islands (the) [Malvinas] |
| fo | Faroe Islands (the) |
| fj | Fiji |
| fi | Finland |
| fr | France |
| gf | French Guiana |
| pf | French Polynesia |
| tf | French Southern Territories (the) |
| ga | Gabon |
| gm | Gambia (the) |
| ge | Georgia |
| de | Germany |
| gh | Ghana |
| gi | Gibraltar |
| gr | Greece |
| gl | Greenland |
| gd | Grenada |
| gp | Guadeloupe |
| gu | Guam |
| gt | Guatemala |
| gg | Guernsey |
| gn | Guinea |
| gw | Guinea-Bissau |
| gy | Guyana |
| ht | Haiti |
| hm | Heard Island and McDonald Islands |
| va | Holy See (the) |
| hn | Honduras |
| hk | Hong Kong |
| hu | Hungary |
| is | Iceland |
| in | India |
| id | Indonesia |
| ir | Iran (Islamic Republic of) |
| iq | Iraq |
| ie | Ireland |
| im | Isle of Man |
| il | Israel |
| it | Italy |
| jm | Jamaica |
| jp | Japan |
| je | Jersey |
| jo | Jordan |
| kz | Kazakhstan |
| ke | Kenya |
| ki | Kiribati |
| kp | Korea (the Democratic People's Republic of) |
| kr | Korea (the Republic of) |
| kw | Kuwait |
| kg | Kyrgyzstan |
| la | Lao People's Democratic Republic (the) |
| lv | Latvia |
| lb | Lebanon |
| ls | Lesotho |
| lr | Liberia |
| ly | Libya |
| li | Liechtenstein |
| lt | Lithuania |
| lu | Luxembourg |
| mo | Macao |
| mg | Madagascar |
| mw | Malawi |
| my | Malaysia |
| mv | Maldives |
| ml | Mali |
| mt | Malta |
| mh | Marshall Islands (the) |
| mq | Martinique |
| mr | Mauritania |
| mu | Mauritius |
| yt | Mayotte |
| mx | Mexico |
| fm | Micronesia (Federated States of) |
| md | Moldova (the Republic of) |
| mc | Monaco |
| mn | Mongolia |
| me | Montenegro |
| ms | Montserrat |
| ma | Morocco |
| mz | Mozambique |
| mm | Myanmar |
| na | Namibia |
| nr | Nauru |
| np | Nepal |
| nl | Netherlands (the) |
| nc | New Caledonia |
| nz | New Zealand |
| ni | Nicaragua |
| ne | Niger (the) |
| ng | Nigeria |
| nu | Niue |
| nf | Norfolk Island |
| mp | Northern Mariana Islands (the) |
| no | Norway |
| om | Oman |
| pk | Pakistan |
| pw | Palau |
| ps | Palestine, State of |
| pa | Panama |
| pg | Papua New Guinea |
| py | Paraguay |
| pe | Peru |
| ph | Philippines (the) |
| pn | Pitcairn |
| pl | Poland |
| pt | Portugal |
| pr | Puerto Rico |
| qa | Qatar |
| mk | Republic of North Macedonia |
| ro | Romania |
| ru | Russian Federation (the) |
| rw | Rwanda |
| re | Réunion |
| bl | Saint Barthélemy |
| sh | Saint Helena, Ascension and Tristan da Cunha |
| kn | Saint Kitts and Nevis |
| lc | Saint Lucia |
| mf | Saint Martin (French part) |
| pm | Saint Pierre and Miquelon |
| vc | Saint Vincent and the Grenadines |
| ws | Samoa |
| sm | San Marino |
| st | Sao Tome and Principe |
| sa | Saudi Arabia |
| sn | Senegal |
| rs | Serbia |
| sc | Seychelles |
| sl | Sierra Leone |
| sg | Singapore |
| sx | Sint Maarten (Dutch part) |
| sk | Slovakia |
| si | Slovenia |
| sb | Solomon Islands |
| so | Somalia |
| za | South Africa |
| gs | South Georgia and the South Sandwich Islands |
| ss | South Sudan |
| es | Spain |
| lk | Sri Lanka |
| sd | Sudan (the) |
| sr | Suriname |
| sj | Svalbard and Jan Mayen |
| se | Sweden |
| ch | Switzerland |
| sy | Syrian Arab Republic |
| tw | Taiwan (Province of China) |
| tj | Tajikistan |
| tz | Tanzania, United Republic of |
| th | Thailand |
| tl | Timor-Leste |
| tg | Togo |
| tk | Tokelau |
| to | Tonga |
| tt | Trinidad and Tobago |
| tn | Tunisia |
| tr | Turkey |
| tm | Turkmenistan |
| tc | Turks and Caicos Islands (the) |
| tv | Tuvalu |
| ug | Uganda |
| ua | Ukraine |
| ae | United Arab Emirates (the) |
| gb | United Kingdom of Great Britain and Northern Ireland (the) |
| um | United States Minor Outlying Islands (the) |
| us | United States of America (the) |
| uy | Uruguay |
| uz | Uzbekistan |
| vu | Vanuatu |
| ve | Venezuela (Bolivarian Republic of) |
| vn | Viet Nam |
| vg | Virgin Islands (British) |
| vi | Virgin Islands (U.S.) |
| wf | Wallis and Futuna |
| eh | Western Sahara |
| ye | Yemen |
| zm | Zambia |
| zw | Zimbabwe |
| ax | Åland Islands |