States¶
GET States¶
Obtiene los estados dependiendo de un pais.
Resource URL¶
-
GET
http://api.next-cloud.mx/v1/catalogs/country/
(string: country_id)/states.
(format)¶ Parameters: - format – json o xml.
- country_id – Clave del pais
Request Headers: - Authorization – Token del usuario
Response JSON Object: - clave_stado (string) – Clave del estado.
- clave_pais (string) – Clave del pais.
- estado (string) – Nombre del estado.
- id (int) – Identificador del estado.
Status Codes: - 200 OK – Ningún error.
- 401 Unauthorized – Token no válido o no enviado.
- 404 Not Found – No existe el pais / No existen estados.
Example Request¶
GET v1/catalogs/country/mex/states.json HTTP/1.1
Host: api.next-cloud.mx
Accept: application/json
Authorization: Token ( token del usuario )
Example Response¶
HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json
Allow: GET, OPTIONS
[
{
"clave_estado": "AS",
"clave_pais": "MEX",
"estado": "Aguascalientes",
"id": 1
}, {
"clave_estado": "BC",
"clave_pais": "MEX",
"estado": "Baja california",
"id": 2
}, {
"clave_estado": "BS",
"clave_pais": "MEX",
"estado": "Baja california sur",
"id": 3
}
]
Example XML¶
Example request¶
GET v1/catalogs/country/mex/states.xml HTTP/1.1
Host: api.next-cloud.mx
Accept: application/xml
Authorization: Token ( token del usuario )
Example Response¶
HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/xml; charset=utf-8
Allow: GET, OPTIONS
<?xml version="1.0" encoding="utf-8"?>
<root>
<list-item>
<clave_estado>AS</clave_estado>
<clave_pais>MEX</clave_pais>
<estado>Aguascalientes</estado>
<id>1</id>
</list-item>
<list-item>
<clave_estado>BC</clave_estado>
<clave_pais>MEX</clave_pais>
<estado>Baja california</estado>
<id>2</id>
</list-item>
<list-item>
<clave_estado>BS</clave_estado>
<clave_pais>MEX</clave_pais>
<estado>Baja california sur</estado>
<id>3</id>
</list-item>
</root>