Countries:GET - Revision history

Mike.robski: 1 revision

2013-02-20T17:59:19Z

1 revision

Mike.robski at 17:58, 20 February 2013

2013-02-20T17:58:17Z

Mike.robski: 1 revision

2013-02-19T17:58:54Z

1 revision

Mike.robski at 17:52, 19 February 2013

2013-02-19T17:52:24Z

New page

= GET /countries =
Retrieves a list of all supported countries.
__TOC__

== Request ==
<code>GET /countries</code>

==== Request Parameters ====
None.

=== URI Parameters ===
None.

== Response ==
Returns a dictionary containing list of countries with ISO 3166-1 alpha-2[http://www.iso.org/iso/iso-3166-1_decoding_table.html] country codes and a link to obtain the provinces of each country.

=== Status Code ===
;200 OK
: Success

=== Response Body ===
<nowiki>
{
"list": [
{
"isoName": "US",
"name": "United States of America",
"provinces": "</nowiki>{{APIBaseURL}}<nowiki>/countries/US/provinces/"
},
{
"isoName": "BG",
"name": "Bulgaria",
"provinces": "</nowiki>{{APIBaseURL}}<nowiki>/countries/BG/provinces/"
}
],
"links": [
{"rel": "self", "href": "</nowiki>{{APIBaseURL}}<nowiki>/countries"}
]
}
</nowiki>

; list - ''list''
: List of countries with ISO 3166-1 alpha-2[http://www.iso.org/iso/iso-3166-1_decoding_table.html] code and link to corresponding province list. Each element of the list has the following attributes:

:; isoName - ''string''
:: The ISO 3166-1 alpha-2[http://www.iso.org/iso/iso-3166-1_decoding_table.html] code of the country.

:; name - ''string''
:: A descriptive name (in English) for the country.

:; provinces - ''URI''
:: A URI to the list of provinces for the given country.

; links - ''list''
: [[Hypermedia]] for this resource. Link to self will preserve filtering, sorting and pagination set by the request. Links to the first, last, previous and next pages will also be included if applicable.

== See also ==
* [[Miscellaneous|Miscellaneous APIs]]
* [[Common Features]]

{{disqus}}
[[Category:Hostway API]]
[[Category:Miscellaneous APIs]]

@@ Line 13: / Line 13: @@
 == Response ==
-Returns a dictionary containing list of countries with ISO 3166-1 alpha-2[http://www.iso.org/iso/iso-3166-1_decoding_table.html] country codes and a link to obtain the provinces of each country.
+Returns a dictionary containing list of countries with [http://www.iso.org/iso/iso-3166-1_decoding_table.html|ISO 3166-1 alpha-2] country codes and a link to obtain the provinces for each country.
 === Status Code ===
@@ Line 24: / Line 24: @@
    "list": [
+     {
-       "isoName": "US",
+       "code": "US",
        "name": "United States of America",
-       "provinces": "</nowiki>{{APIBaseURL}}<nowiki>/countries/US/provinces/"
+       "provinces": "</nowiki>{{APIBaseURL}}<nowiki>/countries/US/provinces"
      },
+     {
-       "isoName": "BG",
+       "code": "BG",
        "name": "Bulgaria",
-       "provinces": "</nowiki>{{APIBaseURL}}<nowiki>/countries/BG/provinces/"
+       "provinces": "</nowiki>{{APIBaseURL}}<nowiki>/countries/BG/provinces"
+     }
    ],
@@ Line 40: / Line 40: @@
    </nowiki>
 ; list - ''list''
-: List of countries with ISO 3166-1 alpha-2[http://www.iso.org/iso/iso-3166-1_decoding_table.html] code and link to corresponding province list. Each element of the list has the following attributes:
+: List of countries with [http://www.iso.org/iso/iso-3166-1_decoding_table.html|ISO 3166-1 alpha-2] code and link to corresponding provinces list. Each element of the list has the following attributes:
-:; isoName - ''string''
+:; code - ''string''
-:: The ISO 3166-1 alpha-2[http://www.iso.org/iso/iso-3166-1_decoding_table.html] code of the country.
+:: The [http://www.iso.org/iso/iso-3166-1_decoding_table.html|ISO 3166-1 alpha-2] code of the country.
 :; name - ''string''