States

GET States

Obtiene los estados dependiendo de un pais.

Resource URL

GET https://api.next-cloud.mx/v1/catalogs/country/(string: country_id)/states.(format)

Parámetros:

format – json o xml.
country_id – Clave del pais

Encabezados de solicitud:

Authorization – Token del usuario

Objeto JSON de respuesta:

clave_stado (string) – Clave del estado.
clave_pais (string) – Clave del pais.
estado (string) – Nombre del estado.
id (int) – Identificador del estado.

Códigos de Status:

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>