Open API cho developer

Open API cho developer
8k 2 tháng trước

Follow source code tại đây!!!

Follow document tại đây!!!

Hoà chung không khí sát nhập tỉnh, mình có start 1 dự án nhằm tổng hợp các API service tiện lợi cho developer.

  • Countries: Chứa thông tin data về các quốc gia, thành phố, tỉnh,… của nhiều quốc gia trên thế giới
  • Mình sẽ update thêm…
Category Badge Description Badge
Main Stats Stars Stars
Forks Forks
Contributors Contributors
Pull Requests Pull Requests
Last Commit Last Commit
Monthly Commits Commits
Code Stats Top Language Top Language
Languages Count Languages Count
Code Size Code Size

Hướng dẫn sử dụng Open API Countries

Tìm kiếm, get list countries

curl https://open-api.duonguyen.site/countries?name=Vietnam&page=0&limit=10
{
	"statusCode": 200,
	"data": [
		{
			"id": 246,
			"name": "Vietnam",
			"iso3": "VNM",
			"iso2": "VN",
			"numeric_code": "704",
			"phonecode": "84",
			"capital": "Hanoi",
			"currency": "VND",
			"currency_name": "Vietnamese đồng",
			"currency_symbol": "₫",
			"tld": ".vn",
			"native": "Việt Nam",
			"region": "Asia",
			"region_id": 3,
			"subregion": "South-Eastern Asia",
			"subregion_id": 13,
			"nationality": "Vietnamese",
			"latitude": "16.16666666",
			"longitude": "107.83333333",
			"emoji": "🇻🇳",
			"emojiU": "U+1F1FB U+1F1F3"
		}
	],
	"pagination": {
		"page": 0,
		"limit": 10,
		"total": 1,
		"totalPage": 1,
		"hasPreviousPage": false,
		"hasNextPage": true
	},
	"message": "Get data countries success."
}

Tìm kiếm, get list states

curl https://open-api.duonguyen.site/countries/states?countryId=246&page=0&limit=1
{
	"statusCode": 200,
	"data": [
		{
			"id": 5126,
			"name": "An Giang",
			"state_code": "44",
			"latitude": "10.52158360",
			"longitude": "105.12589550",
			"type": "province",
			"countryId": 246,
			"country": {
				"id": 246,
				"name": "Vietnam",
				"iso3": "VNM",
				"iso2": "VN"
			}
		}
	],
	"pagination": {
		"page": 0,
		"limit": 1,
		"total": 63,
		"totalPage": 63,
		"hasPreviousPage": false,
		"hasNextPage": true
	},
	"message": "Get data states success."
}

Tìm kiếm, get list cities

curl https://open-api.duonguyen.site/countries/cities?stateId=5149&page=0&limit=1
{
	"statusCode": 200,
	"data": [
		{
			"id": 149836,
			"name": "Bắc Từ Liêm",
			"latitude": "21.07148680",
			"longitude": "105.71992260",
			"stateId": 5149,
			"state": {
				"id": 5149,
				"name": "Hà Nội",
				"state_code": "HN",
				"country": {
					"id": 246,
					"name": "Vietnam",
					"iso3": "VNM",
					"iso2": "VN"
				}
			}
		}
	],
	"pagination": {
		"page": 0,
		"limit": 1,
		"total": 30,
		"totalPage": 30,
		"hasPreviousPage": false,
		"hasNextPage": true
	},
	"message": "Get data cities success."
}

Tìm kiếm, get detail một country

curl https://open-api.duonguyen.site/countries/246
{
	"statusCode": 200,
	"data": {
		"id": 246,
		"name": "Vietnam",
		"iso3": "VNM",
		"iso2": "VN",
		"numeric_code": "704",
		"phonecode": "84",
		"capital": "Hanoi",
		"currency": "VND",
		"currency_name": "Vietnamese đồng",
		"currency_symbol": "₫",
		"tld": ".vn",
		"native": "Việt Nam",
		"region": "Asia",
		"region_id": 3,
		"subregion": "South-Eastern Asia",
		"subregion_id": 13,
		"nationality": "Vietnamese",
		"latitude": "16.16666666",
		"longitude": "107.83333333",
		"emoji": "🇻🇳",
		"emojiU": "U+1F1FB U+1F1F3",
		"states": [
			{
				"id": 5149,
				"name": "Hà Nội",
				"state_code": "HN",
				"latitude": "21.02776440",
				"longitude": "105.83415980",
				"type": "municipality",
				"countryId": 246,
				"cities": [
					{
						"id": 149834,
						"name": "Ba Đình",
						"latitude": "21.03482330",
						"longitude": "105.80854700",
						"stateId": 5149
					}
				]
			}
		],
		"timezones": [
			{
				"id": 424,
				"zoneName": "Asia/Ho_Chi_Minh",
				"gmtOffset": 25200,
				"gmtOffsetName": "UTC+07:00",
				"abbreviation": "ICT",
				"tzName": "Indochina Time",
				"countryId": 246
			}
		],
		"translations": {
			"id": 246,
			"ko": "베트남",
			"ptBR": "Vietnã",
			"pt": "Vietname",
			"nl": "Vietnam",
			"hr": "Vijetnam",
			"fa": "ویتنام",
			"de": "Vietnam",
			"es": "Vietnam",
			"fr": "Viêt Nam",
			"ja": "ベトナム",
			"it": "Vietnam",
			"zhCN": "越南",
			"tr": "Vietnam",
			"ru": "Вьетнам",
			"uk": "В'єтнам",
			"pl": "Wietnam",
			"countryId": 246
		}
	},
	"pagination": null,
	"message": "Get data country success."
}
0%