Danh mục

Danh sách cố định cho các tùy chọn trong form: quốc gia, tiền tệ và ngôn ngữ. Ít khi thay đổi và có thể lưu vào bộ nhớ đệm trong một ngày.

Quốc gia#

POST/external/counties

Xác thực: Authorization: Bearer

Trả về tất cả quốc gia. Không cần nội dung yêu cầu. id được dùng làm countryID ở bước thanh toán.

Phản hồi

200 Thành công.

Yêu cầu
curl -X POST "https://test.hms.gen.tr/external/counties" \
  -H "Authorization: Bearer $HMS_TOKEN"
Phản hồi · 200
{
    "success": true,
    "count": 249,
    "items": [
        {
            "id": 1,
            "name": "Türkiye",
            "nameIng": "Turkey",
            "code": "TR",
            "plate": "TR"
        },
        {
            "id": 2,
            "name": "Almanya",
            "nameIng": "Germany",
            "code": "DE",
            "plate": "D"
        }
    ]
}

Tiền tệ#

GET/external/currencies

Xác thực: Authorization: Bearer

Tham số truy vấn

limitintegermặc định: 20
Số bản ghi mỗi trang.
pageintegermặc định: 1
Số trang.
orderstring
id hoặc -id.

Phản hồi

200 Thành công.

Yêu cầu
curl "https://test.hms.gen.tr/external/currencies?limit=10&page=1" \
  -H "Authorization: Bearer $HMS_TOKEN"
Phản hồi · 200
{
    "success": true,
    "count": 4,
    "items": [
        {
            "id": 1,
            "titleCode": "TRY",
            "symbol": "₺",
            "price": 1
        },
        {
            "id": 2,
            "titleCode": "EUR",
            "symbol": "€",
            "price": 47.85000000000000142108547152020037174224853515625
        },
        {
            "id": 3,
            "titleCode": "USD",
            "symbol": "$",
            "price": 41.2000000000000028421709430404007434844970703125
        }
    ]
}

Ngôn ngữ#

GET/external/languages

Xác thực: Authorization: Bearer

Tham số truy vấn

limitintegermặc định: 20
Số bản ghi mỗi trang.
pageintegermặc định: 1
Số trang.
orderstring
id hoặc -id.

Phản hồi

200 Thành công.

Yêu cầu
curl "https://test.hms.gen.tr/external/languages?limit=10&page=1" \
  -H "Authorization: Bearer $HMS_TOKEN"
Phản hồi · 200
{
    "success": true,
    "count": 3,
    "items": [
        {
            "id": 1,
            "title": "Türkçe",
            "code": "tr",
            "image": "https://test.hms.gen.tr/images/1000/dil/t-tr.png"
        },
        {
            "id": 2,
            "title": "English",
            "code": "en",
            "image": "https://test.hms.gen.tr/images/1000/dil/t-en.png"
        },
        {
            "id": 3,
            "title": "Deutsch",
            "code": "de",
            "image": "https://test.hms.gen.tr/images/1000/dil/t-de.png"
        }
    ]
}
Cập nhật lần cuối: 21 tháng 9, 2026Phát hiện lỗi? Hãy cho chúng tôi biết