Branchs API
API trả về danh sách chi nhánh của nhà hàng
Các thông tin cấu hình cần thiết:
| Tên |
Mô tả |
| CompanyCode |
Mã nhà hàng lấy |
| AccessToken |
Chuỗi token xác thực |
Để lấy các thông tin trên xem bài viết account/login
About
| URL |
Phiên bản |
| graphapi.cukcuk.vn |
1.0 |
Schemes
Endpoints
api/v1/branchs/all
POST
Lấy danh sách chi nhánh của nhà hàng
Expected Response Types
| HttpCode |
ServiceResult.ErrorType |
Mô tả |
| 401 |
|
Chuỗi AccessToken hết hạn hoặc không hợp lệ cần phải gọi cấp phát lại |
| 200 |
0 |
Không có lỗi |
| 200 |
1 |
Tham số không hợp lệ null or empty |
| 200 |
2 |
Mã nhà hàng không tồn tại |
| 200 |
7 |
Thiết lập kết nối CUKCUK đang ở trạng thái ngắt, không thể lấy dữ liệu |
| 200 |
100 |
Lỗi nội bộ API Graph |
| 200 |
102 |
Request bị từ chối, do có request cùng loại đang xử lý. Vui lòng chờ xử lý xong hoặc chờ request đang xử lý timeout thì gọi lại. |
Parameters
| Name |
In |
Description |
Required? |
Type |
| includeInactive |
uri |
true - lấy toàn bộ bao gồm cả chi nhánh đã ngừng theo dõi |
false |
bool |
| Name |
In |
Description |
Required? |
Type |
| Authorization |
header |
Header key cấu hình AccessToken (dạng Bearer AccessToken) |
true |
string |
| CompanyCode |
header |
Header key cấu hình mã nhà hàng CompanyCode |
true |
string |
Ví dụ:
CompanyCode: demoquanviet
Authorization: Bearer 06S1YMPgDJl65xE5tYzAJlNmVALHVHlLZg9euMUaUTO9C0Jm8TL3L4isto97ApKdQbVVX2rUJUTfXbBBipo1B5UvAgl3hwDYh8bNGVVUNp6B99Ht3KZQkwVh2SNblX-vulGSNatV-NF1KOfNJImOUsVXimxVEX3n2lnRV0A_mbJ_XP0sliGqbMzwa9YtY-jts4Iu06TaFOqBpBhndS-mofDlZlKkVqYklwy6cDzBktas7Xfi5MOsCujCDYO_0WFauBQCPDVnSj6ew_3Nm5ollwynkmErSmVf2E4cShM4700
Content Types Produced
| Produces |
| application/json |
Content Types Consumed
| Consumes |
| application/json |
Response
Trả về đối tượng ServiceResult với ServiceResult.Data là Array<Branch>
Example
Ví dụ gọi GET tới
https://graphapi.cukcuk.vn/api/v1/categories/list?includeInactive=true
Hệ thống sẽ trả về ServiceResult với Data là Array<Branch>
JSON response
{
"Code": 200,
"Data": [
{
"Id": "994c6fe5-da83-441b-a0e8-57a6fed98fb2",
"Code": "demoquanviet",
"Name": "demoquanviet",
"IsBaseDepot": false,
"Inactive": false
}
],
"Total": 0,
"Success": true
}
Definitions
Branch Definition
| Property |
Type |
Format |
Mô tả |
| Id |
string |
guid |
Id chi nhánh |
| Code |
string |
|
Mã chi nhánh |
| Name |
string |
|
Tên chi nhánh |
| IsBaseDepot |
bool |
|
True - là kho tổng |
| IsChainBranch |
bool |
|
True - là chuỗi nhà hàng |
ServiceResult Definition
| Property |
Type |
Format |
Mô tả |
| Code |
int |
|
Mã lỗi HttpCode (200, 500...) |
| ErrorType |
int |
|
Loại lỗi |
| ErrorMessage |
string |
|
Thông tin lỗi |
| Success |
bool |
|
True - không có lỗi logic xảy ra |
| Data |
string |
object |
Dữ liệu trả về client |
| Total |
int |
|
Tổng số bản ghi khi lấy dữ liệu phân trang |
ErrorType Definition
| HttpCode |
ServiceResult.ErrorType |
Mô tả |
| 401 |
|
Chuỗi AccessToken hết hạn hoặc không hợp lệ cần phải gọi cấp phát lại |
| 200 |
0 |
Không có lỗi |
| 200 |
1 |
Tham số không hợp lệ null or empty |
| 200 |
2 |
Mã nhà hàng không tồn tại |
| 200 |
3 |
Mã Appid không tồn tại trên hệ thống |
| 200 |
4 |
Chuỗi thông tin chữ ký đăng nhập không hợp lệ, timeout |
| 200 |
5 |
Tham số lấy phân trang vượt quá số lượng cấu hình cho phép (max 100) |
| 200 |
6 |
Tham số ngày giờ không hợp lệ (01/01/1753 - 31/12/9999) |
| 200 |
7 |
Thiết lập kết nối CUKCUK đang ở trạng thái ngắt, không thể lấy dữ liệu |
| HttpCode |
ServiceResult.ErrorType |
Mô tả |
| 200 |
100 |
Lỗi nội bộ API Graph |
| 200 |
102 |
Request bị từ chối, do có request cùng loại đang xử lý. Vui lòng chờ xử lý xong hoặc chờ request đang xử lý timeout thì gọi lại.
Ví dụ: Khi đang gọi api login mà api chưa trả về dữ liệu lại tiếp tục gọi request login này sẽ trả về lỗi này. |