{"swagger":"2.0","info":{"title":"123 XE API","description":"Tài liệu mô tả 123 xe api - http://dev.api.123xe.vn/uodapi","version":"1.0.0","contact":{"email":"hieubq@vng.com.vn"},"license":{"name":"Apache 2.0"}},"tags":[{"name":"session","description":"Các chức năng đăng ký, đăng nhập, thay đổi mật khẩu, reset mật khẩu & xác thực tài khoản quan điện thoại."},{"name":"device","description":"Các chức năng đăng ký và hủy đăng ký nhận thông báo về thiết bị."},{"name":"passenger","description":"Các chức năng xem thông tin cá nhân, cập nhật thông tin cá nhân, đăng ký & xóa thiết bị khỏi danh sách nhận thông báo từ hệ thống, tạo yêu cầu đặt xe, xem danh sách các yêu cầu đã gửi."},{"name":"driver","description":"Các chức năng xem thông tin cá nhân, cập nhật thông tin cá nhân, đăng ký & xóa thiết bị khỏi danh sách nhận thông báo từ hệ thống, đặt lịch chạy xe, xem danh sách các chuyến đi sắp tới."},{"name":"booking","description":"Các chức năng xem thông tin chi tiết của một booking, cập nhật booking."},{"name":"trip","description":"Các chức năng xem thông tin chi tiết của một chuyến đi (trip), cập nhật trạng thái của chuyến đi."},{"name":"admin","description":"các chức năng quản lý hệ thống, quản lý nhân viên, sắp xếp chuyến của admin"}],"produces":["application/json"],"paths":{"/admin/{admin_id}":{"get":{"tags":["admin"],"summary":"Lấy thông tin Admin","description":"Lấy thông tin cá nhân của tài khoản Admin.","operationId":"getAdminInfo","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"admin_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của admin."}],"responses":{"200":{"description":"Lấy thông tin tài khoản Admin.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"admin_info":{"$ref":"#/definitions/Admin"}}}}}}}},"put":{"tags":["admin"],"summary":"Cập nhật thông tin Admin","description":"Cập nhật thông tin cá nhân của tài khoản Admin.","operationId":"updateAdminInfo","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"admin_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của admin."},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Admin"}}],"responses":{"200":{"description":"Cập nhật thông tin tài khoản Admin.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"admin_info":{"$ref":"#/definitions/Admin"}}}}}}}}},"/admin/operator/{operator_id}":{"put":{"tags":["admin"],"summary":"Cập nhật thông tin Group (Operator)","description":"Cập nhật thông tin cá của Group.","operationId":"updateOperatorInfo","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"operator_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của admin."},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Operator"}}],"responses":{"200":{"description":"Cập nhật thông tin Group.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"operator_info":{"$ref":"#/definitions/Operator"}}}}}}}}},"/employees/admin":{"post":{"tags":["admin"],"summary":"Thêm tài khoản nhân viên (admin)","description":"Admin tạo thêm tài khoản admin cho nhân viên quản lý.","operationId":"createAdmin","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Admin"}}],"responses":{"200":{"description":"Thêm tài khoản admin.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"admin_info":{"$ref":"#/definitions/Admin"}}}}}}}}},"/employees/admin/{admin_id}":{"get":{"tags":["admin"],"summary":"get thông tin chi tiết tài khoản admin.","description":"get thông tin chi tiết admin.","operationId":"getAdminDetail","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"admin_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của tài khoản admin"}],"responses":{"200":{"description":"lấy thông tin tài khoản admin.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"admin_info":{"$ref":"#/definitions/Admin"}}}}}}}},"put":{"tags":["admin"],"summary":"update thông tin chi tiết tài khoản admin.","description":"update thông tin chi tiết tài khoản admin.","operationId":"updateAdmin","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"admin_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của tài khoản admin"},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Admin"}}],"responses":{"200":{"description":"update tài khoản admin.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"admin_info":{"$ref":"#/definitions/Admin"}}}}}}}},"delete":{"tags":["admin"],"summary":"xóa tài khoản admin.","description":"xóa tài khoản admin.","operationId":"deleteAdmin","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"admin_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của tài khoản admin"}],"responses":{"200":{"description":"xóa tài khoản admin.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object"}}}}}}},"/employees/driver":{"post":{"tags":["admin"],"summary":"Thêm tài khoản nhân viên (driver)","description":"Admin tạo thêm tài khoản driver cho nhân viên.","operationId":"createDriver","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Driver"}}],"responses":{"200":{"description":"thêm tài khoản driver.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"driver_info":{"$ref":"#/definitions/Driver"}}}}}}}}},"/employees/driver/{driver_id}":{"get":{"tags":["admin"],"summary":"get thông tin chi tiết driver.","description":"get thông tin chi tiết driver.","operationId":"getDriverDetail","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"driver_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của tài khoản admin"}],"responses":{"200":{"description":"lấy thông tin tài khoản driver.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"driver_info":{"$ref":"#/definitions/Driver"}}}}}}}},"put":{"tags":["admin"],"summary":"update thông tin chi tiết driver.","description":"update thông tin chi tiết driver.","operationId":"updateDriver","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"driver_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của tài khoản admin"},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Driver"}}],"responses":{"200":{"description":"update tài khoản driver.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"driver_info":{"$ref":"#/definitions/Driver"}}}}}}}},"delete":{"tags":["admin"],"summary":"xóa tài khoản driver.","description":"xóa tài khoản driver.","operationId":"deleteDriver","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"driver_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của tài khoản driver"}],"responses":{"200":{"description":"xóa tài khoản driver.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object"}}}}}}},"/employees":{"get":{"tags":["admin"],"summary":"get danh sách nhân viên.","description":"get danh sách nhân viên gồm admins & drivers.","operationId":"getEmployees","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"}],"responses":{"200":{"description":"xóa tài khoản driver.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"admins":{"type":"array","items":{"$ref":"#/definitions/Employee"}},"drivers":{"type":"array","items":{"$ref":"#/definitions/Employee"}}}}}}}}}},"/session/register":{"post":{"tags":["session"],"summary":"Đăng ký tài khoản mới.","description":"Đăng ký tài khoản mới bằng số điện thoại & mật khẩu cá nhân. Mỗi số điện thoại chỉ được đăng ký 1 lần.","operationId":"register","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["phone","password"],"properties":{"phone":{"type":"string","pattern":"^(84|0)[0-9]","maxLength":12,"minLength":9},"password":{"type":"string","description":"Mật khẩu ��ã hash MD5 / SHA2."},"clientid":{"type":"integer","format":"int32","default":0,"description":"Xác định là client nào. 0 = passenger client | 1 = driver client | 2 = GroupAdmin client | 100 = supper admin client."}}}}],"responses":{"200":{"description":"Đăng ký.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"user_info":{"$ref":"#/definitions/User"}}}}}}}}},"/session/login":{"post":{"tags":["session"],"summary":"Đăng nhập vào hệ thống.","description":"Đăng nhập vào hệ thống bằng số điện thoại & mật khẩu.","operationId":"login","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API."},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["phone","password"],"properties":{"phone":{"type":"string","pattern":"^(84|0)[0-9]","maxLength":12,"minLength":9},"password":{"type":"string","description":"Mật khẩu đã hash MD5 / SHA2."},"clientid":{"type":"integer","format":"int32","default":0,"description":"Xác định là client nào. 0 = passenger client | 1 = driver client | 2 = GroupAdmin client | 100 = supper admin client."}}}}],"responses":{"200":{"description":"Đăng nhập.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"user_info":{"$ref":"#/definitions/User"}}}}}}}}},"/session/otp/{phone}":{"get":{"tags":["session"],"summary":"lấy OTP.","description":"Lấy mã xác thực OTP.","operationId":"getOTP","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API."},{"name":"phone","in":"path","required":true,"type":"string","pattern":"^(84|0)[0-9]","maxLength":12,"minLength":9}],"responses":{"200":{"schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object"}}},"description":"Gửi yêu cầu lấy mã otp."}}},"post":{"tags":["session"],"summary":"Xác thực bằng mã OTP gửi về số điện thoại","description":"Xác thực tài khoản bằng mã OTP được gửi về điện thoại qua sms.","operationId":"verifyAccount","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API."},{"name":"phone","in":"path","required":true,"type":"string","pattern":"^(84|0)[0-9]","maxLength":12,"minLength":9},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["otp_code"],"properties":{"otp_code":{"type":"integer","format":"int32","description":"Mã xác nhận otp được gửi qua sms."}}}}],"responses":{"200":{"schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object"}}},"description":"Xác thực tài khoản."}}}},"/session/changepass":{"put":{"tags":["session"],"summary":"Đổi mật khẩu.","description":"Xác nhận thay đổi mật khẩu.","operationId":"changePass","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API."},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["phone","old_password","new_password"],"properties":{"phone":{"type":"string","pattern":"^(84|0)[0-9]","maxLength":12,"minLength":9},"old_password":{"type":"string","description":"Mật khẩu cũ đã hash MD5 / SHA2."},"new_password":{"type":"string","description":"Mật khẩu mới đã hash MD5 / SHA2."}}}}],"responses":{"200":{"schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object"}}},"description":"Đổi mật khẩu."}}}},"/session/resetpass":{"post":{"tags":["session"],"summary":"Quên mật khẩu.","description":"Xác nhận tạo lại mật khẩu mới.","operationId":"resetPass","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API."},{"name":"body","in":"body","required":true,"schema":{"type":"object","required":["phone","new_password","otp_code"],"properties":{"phone":{"type":"string","pattern":"^(84|0)[0-9]","maxLength":12,"minLength":9},"new_password":{"type":"string","description":"Mật khẩu mới đã hash MD5 / SHA2."},"otp_code":{"type":"integer","format":"int32","description":"Mã xác nhận otp được gửi qua sms."}}}}],"responses":{"200":{"description":"Reset mật khẩu.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"user_info":{"$ref":"#/definitions/User"}}}}}}}}},"/devices":{"post":{"tags":["device"],"summary":"Đăng ký thiết bị.","description":"Đăng ký thiết bị với hệ thống để nhận thông báo từ hệ thống.","operationId":"registerDevice","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Device"}}],"responses":{"200":{"description":"Đăng ký thiết bị.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"device":{"$ref":"#/definitions/Device"}}}}}}}},"delete":{"tags":["device"],"summary":"Xóa thiết bị.","description":"Xóa thiết bị khỏi danh sách được nhận thông báo từ hệ thống.","operationId":"removeDevice","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Device"}}],"responses":{"200":{"schema":{"$ref":"#/definitions/Error"},"description":"Xóa thiết bị."}}}},"/passengers/{passenger_id}":{"get":{"tags":["passenger"],"summary":"Lấy thông tin cá nhân.","description":"Lấy thông tin cá nhân của tài khoản hành khách.","operationId":"getPassengerInfo","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"passenger_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của passenger."}],"responses":{"200":{"description":"Lấy thông tin hành khách.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"passenger_info":{"$ref":"#/definitions/Passenger"}}}}}}}},"put":{"tags":["passenger"],"summary":"Cập nhật thông tin cá nhân.","description":"Cập nhật thông tin cá nhân của tài khoản hành khách.","operationId":"updatePassengerInfo","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"passenger_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của passenger."},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Passenger"}}],"responses":{"200":{"description":"Cập nhật thông tin hành khách.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"passenger_info":{"$ref":"#/definitions/Passenger"}}}}}}}}},"/passengers/{passenger_id}/bookings":{"post":{"tags":["passenger"],"summary":"Đặt xe.","description":"Gửi yêu cầu đặt xe của hành khách.","operationId":"createBooking","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"passenger_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của passenger."},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Booking"}}],"responses":{"200":{"description":"Gửi yêu cầu đặt xe.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"booking":{"$ref":"#/definitions/Booking"}}}}}}}},"get":{"tags":["passenger"],"summary":"Lấy danh sách các yêu cầu đặt xe.","description":"Lấy danh sách các yêu cầu đặt xe của hành khách theo trang & index.","operationId":"getPageBookings","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"passenger_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của passenger."},{"name":"Lastid","in":"header","type":"integer","format":"int64","description":"last booking id / last date."},{"name":"Minsize","in":"header","type":"integer","format":"int32","description":"số lượng tối thiểu cần lấy."},{"name":"Ordertype","in":"header","type":"integer","format":"int32","description":"0 = order theo creation time (id) | 1 = order theo thời gian đi"}],"responses":{"200":{"description":"Lấy danh sách yêu cầu đặt xe.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"meta":{"$ref":"#/definitions/Meta"},"bookings":{"type":"array","items":{"$ref":"#/definitions/Booking"}}}}}}}}}},"/passengers/{passenger_id}/bookings/histories":{"get":{"tags":["passenger"],"summary":"Lấy danh sách các yêu cầu đặt xe.","description":"Lấy danh sách các yêu cầu đặt xe của hành khách theo trang & index.","operationId":"getPageBookingsHistories","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"passenger_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của passenger."},{"name":"Lastid","in":"header","type":"integer","format":"int64","description":"last booking id / last date."},{"name":"Minsize","in":"header","type":"integer","format":"int32","description":"số lượng tối thiểu cần lấy."},{"name":"Ordertype","in":"header","type":"integer","format":"int32","description":"0 = order theo creation time (id) | 1 = order theo thời gian đi"}],"responses":{"200":{"description":"Lấy danh sách yêu cầu đặt xe.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"meta":{"$ref":"#/definitions/Meta"},"bookings":{"type":"array","items":{"$ref":"#/definitions/Booking"}}}}}}}}}},"/passengers/{passenger_id}/bookings/price/{distance}":{"get":{"tags":["passenger"],"description":"xem dự tính chi phí khi đặt vé.","operationId":"getPrice","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"passenger_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của passenger."},{"name":"distance","in":"path","required":true,"description":"id của booking muốn xem thông tin chi tiết.","type":"number","format":"double"}],"responses":{"200":{"description":"Xem chi tiết đặt xe.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"price":{"$ref":"#/definitions/Price"}}}}}}}}},"/bookings/{booking_id}":{"get":{"tags":["booking"],"summary":"Xem chi tiết booking.","description":"xem thông tin chi tiết của 1 booking.","operationId":"getBookingDetail","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"booking_id","in":"path","required":true,"description":"id của booking muốn xem thông tin chi tiết.","type":"integer","format":"int64"}],"responses":{"200":{"description":"Xem chi tiết đặt xe.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"booking_detail":{"$ref":"#/definitions/BookingDetail"}}}}}}}}},"/drivers/{driver_id}":{"get":{"tags":["driver"],"summary":"Lấy thông tin cá nhân.","description":"Lấy thông tin cá nhân của tài khoản tài xế.","operationId":"getDriverInfo","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"driver_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của driver."},{"name":"Sessionkey","in":"header","description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"}],"responses":{"200":{"description":"Lấy thông tin tài xế.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"driver_info":{"$ref":"#/definitions/Driver"}}}}}}}},"put":{"tags":["driver"],"summary":"Cập nhật thông tin cá nhân.","description":"Cập nhật thông tin cá nhân của tài khoản tài xế.","operationId":"updateDriverInfo","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"driver_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của driver."},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Driver"}}],"responses":{"200":{"description":"cập nhật thông tin tài xế.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"driver_info":{"$ref":"#/definitions/Driver"}}}}}}}}},"/drivers/{driver_id}/schedules":{"post":{"tags":["driver"],"summary":"thêm lịch trình.","description":"Cập nhật lịch trình của 1 ngày.","operationId":"setSchedules","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"driver_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của driver."},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Schedule"}}],"responses":{"200":{"description":"Thêm lịch.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"schedule":{"$ref":"#/definitions/Schedule"}}}}}}}}},"/drivers/{driver_id}/schedules/{timestamp}":{"get":{"tags":["driver"],"summary":"Lấy Lịch trình.","description":"Lấy Lịch trình của tài xế từ ngày truyền lên đến cuối tháng.","operationId":"getSchedules","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"driver_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của driver."},{"name":"timestamp","in":"path","required":true,"type":"integer","format":"int64","description":"thời gian tính bằng giây (epoch time)."}],"responses":{"200":{"description":"Lấy lịch trình.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"schedules":{"type":"array","items":{"$ref":"#/definitions/Schedule"}}}}}}}}},"put":{"tags":["driver"],"summary":"cập nhật lịch trình.","description":"Cập nhật lịch trình của 1 ngày.","operationId":"updateSchedules","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"driver_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của driver."},{"name":"timestamp","in":"path","required":true,"type":"integer","format":"int64","description":"thời gian tính bằng giây (epoch time)."},{"name":"body","in":"body","required":true,"schema":{"$ref":"#/definitions/Schedule"}}],"responses":{"200":{"description":"Sửa lịch.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"schedule":{"$ref":"#/definitions/Schedule"}}}}}}}}},"/drivers/{driver_id}/trips":{"get":{"tags":["driver"],"summary":"Danh sách chuyến đi gần nhất.","description":"Lấy danh sách các chuyến đi sắp tới gần nhất.","operationId":"getPageTrips","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"driver_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của passenger."},{"name":"Lastid","in":"header","type":"integer","format":"int64","description":"last booking id / last date."},{"name":"Minsize","in":"header","type":"integer","format":"int32","description":"số lượng tối thiểu cần lấy."},{"name":"Ordertype","in":"header","type":"integer","format":"int32","description":"0 = cũ -> mới | 1 = mới -> cũ"}],"responses":{"200":{"description":"Lấy danh sách chuyến.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"meta":{"$ref":"#/definitions/Meta"},"trips":{"type":"array","items":{"$ref":"#/definitions/Trip"}}}}}}}}}},"/drivers/{driver_id}/trips/histories":{"get":{"tags":["driver"],"summary":"Lịch sử các chuyến đi.","description":"Lấy danh sách các chuyến đi trong quá khứ.","operationId":"getPageTripsHistories","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"driver_id","in":"path","required":true,"type":"integer","format":"int64","description":"id của passenger."},{"name":"Lastid","in":"header","type":"integer","format":"int64","description":"last booking id / last date."},{"name":"Minsize","in":"header","type":"integer","format":"int32","description":"số lượng tối thiểu cần lấy."},{"name":"Ordertype","in":"header","type":"integer","format":"int32","description":"0 = cũ -> mới | 1 = mới -> cũ"}],"responses":{"200":{"description":"Lấy danh sách chuyến.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"meta":{"$ref":"#/definitions/Meta"},"trips":{"type":"array","items":{"$ref":"#/definitions/Trip"}}}}}}}}}},"/trips/{trip_id}":{"get":{"tags":["trip"],"summary":"Xem chi tiết trip.","description":"xem thông tin chi tiết của 1 chuyến đi, các điểm đón & trả khách.","operationId":"getTripDetail","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"Sessionkey","in":"header","required":true,"description":"sessionkey dùng authenticate với api.","type":"string"},{"name":"Apiver","in":"header","type":"string","default":"1.0.0","description":"version of API"},{"name":"trip_id","in":"path","required":true,"description":"id của trip muốn xem thông tin chi tiết.","type":"integer","format":"int64"}],"responses":{"200":{"description":"Xem chi tiết chuyến.","schema":{"type":"object","properties":{"error":{"$ref":"#/definitions/Error"},"data":{"type":"object","properties":{"booking_detail":{"$ref":"#/definitions/TripDetail"}}}}}}}}}},"definitions":{"Operator":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"desc":{"type":"string","description":"thông tin mô tả"},"location":{"$ref":"#/definitions/LocationPoint"},"address":{"type":"string"},"logo_url":{"type":"string"}}},"Admin":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"dplname":{"type":"string"},"phone":{"type":"string"},"avatar":{"type":"string","description":"Link hình ảnh avatar"},"permission":{"type":"string"},"operator":{"$ref":"#/definitions/Operator"}}},"Employee":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"role":{"type":"integer","format":"int32","description":"1 = DRIVER | 2 = ADMIN"},"dplname":{"type":"string"},"phone":{"type":"string"},"avatar":{"type":"string","description":"Link hình ảnh avatar"}}},"User":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"dplname":{"type":"string","description":"Display name"},"phone":{"type":"string","pattern":"^(84|0)[0-9]","maxLength":12,"minLength":9},"status":{"type":"integer","format":"int32","description":"Trạng thái tài khoản | 0 = not activated | 1 = activated | 2 = banned"},"sessionkey":{"type":"string","description":"Sessionkey dùng authenicate với hệ thống để xác nhận user & quyền tương tác với api"}}},"Passenger":{"type":"object","required":["dplname","phone"],"properties":{"id":{"type":"integer","format":"int64"},"dplname":{"type":"string","description":"Display name"},"avatar":{"type":"string","description":"Link hình ảnh avatar"},"phone":{"type":"string","pattern":"^(84|0)[0-9]","maxLength":12,"minLength":9},"status":{"type":"integer","format":"int32","description":"Trạng thái tài khoản | 0 = not activated | 1 = activated | 2 = banned."}}},"PassengerShort":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"dplname":{"type":"string","description":"Display name"},"phone":{"type":"string"},"avatar":{"type":"string","description":"Link hình ảnh avatar"}}},"Vehicle":{"type":"object","required":["vehicle_type","license_plate"],"properties":{"id":{"type":"integer","format":"int64","description":"id của xe"},"vehicle_type":{"type":"integer","format":"int32","description":"loại xe 4 chỗ, 7 chỗ, 16 chỗ"},"license_plate":{"type":"string","description":"biển số xe."}}},"Driver":{"type":"object","required":["dplname","phone","default_location"],"properties":{"id":{"type":"integer","format":"int64"},"dplname":{"type":"string","description":"Display name"},"avatar":{"type":"string","description":"Link hình ảnh avatar"},"phone":{"type":"string","pattern":"^(84|0)[0-9]","maxLength":12,"minLength":9},"status":{"type":"integer","format":"int32","description":"Trạng thái tài khoản | 0 = not activated | 1 = activated | 2 = banned."},"default_location":{"$ref":"#/definitions/LocationPoint"},"vehicle":{"$ref":"#/definitions/Vehicle"}}},"DriverShort":{"type":"object","required":["dplname","phone"],"properties":{"id":{"type":"integer","format":"int64"},"dplname":{"type":"string","description":"Display name"},"phone":{"type":"string"}}},"Device":{"type":"object","required":["os_type","device_token"],"properties":{"os_type":{"type":"integer","format":"int32","description":"Loại thiết bị | 0 = Android | 1 = IOS | 2 = Winphone."},"device_token":{"type":"string","description":"Device-token của thiết bị khi đăng ký nhận notify với GCM & APNS"}}},"Meta":{"type":"object","required":["last_id","min_size","order_type"],"properties":{"last_id":{"type":"integer","format":"int64","description":"id của item cuối cùng / ngày cuối cùng"},"min_size":{"type":"integer","format":"int32","description":"số lượng item tối thiểu cần lấy về"},"order_type":{"type":"integer","format":"int32","description":"0 = order theo creation time (id) | 1 = order theo thời gian đi new -> old | 2 = order theo thời gian đi old -> new"}}},"LocationPoint":{"type":"object","required":["lat","lng"],"properties":{"lat":{"type":"number","format":"double","description":"latitude"},"lng":{"type":"number","format":"double","description":"longitude"},"address":{"type":"string","description":"Địa chỉ bằng text"}}},"TimeRange":{"type":"object","required":["late_time"],"properties":{"early_time":{"type":"integer","format":"int64","description":"epoch time tính bằng giây"},"late_time":{"type":"integer","format":"int64","description":"epoch time tính bằng giây"}}},"Booking":{"type":"object","required":["from","to","pickup","dropoff","load","is_sharing"],"properties":{"booking_id":{"type":"integer","format":"int64","description":"id của booking"},"request_id":{"type":"integer","format":"int64","description":"id của request tương ứng với booking mà hành khách tạo"},"from":{"$ref":"#/definitions/LocationPoint"},"to":{"$ref":"#/definitions/LocationPoint"},"pickup":{"$ref":"#/definitions/TimeRange"},"dropoff":{"$ref":"#/definitions/TimeRange"},"load":{"type":"integer","format":"int32","description":"số hành khách"},"is_sharing":{"type":"boolean","description":"chấp nhận đi chung, chờ hệ thống sắp xếp"},"status":{"type":"integer","format":"int32","description":"Trạng thái của booking | 0 = PENDING | 1 = PREPROCESSED | 2 = PROCESSED | 10 = RUNNING | 15 = COMPLETED | 16 = CANCELED"},"distance":{"type":"number","format":"double"},"price":{"type":"integer","format":"int64"}}},"BookingDetail":{"type":"object","properties":{"driver":{"$ref":"#/definitions/DriverShort"},"booking":{"$ref":"#/definitions/Booking"}}},"Trip":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"id của chuyến"},"start_time":{"type":"integer","format":"int64","description":"thời gian khởi hành"},"from":{"$ref":"#/definitions/LocationPoint"},"to":{"$ref":"#/definitions/LocationPoint"},"number_passengers":{"type":"integer","format":"int32","description":"số lượng hành khách của chuyến đi"},"status":{"type":"integer","format":"int32","description":"Trạng thái của chuyến. 0=waiting, 10=running, 15=finished, 16=canceled"}}},"Stop":{"type":"object","properties":{"request_id":{"type":"integer","format":"int64","description":"id của request tương ứng yêu cầu xe tại stop này"},"location":{"$ref":"#/definitions/LocationPoint"},"time":{"$ref":"#/definitions/TimeRange"},"stop_type":{"type":"integer","format":"int32","description":"Loại stop | 1 = đón khách | 2 = trả khách"},"passengers":{"type":"array","items":{"$ref":"#/definitions/PassengerShort"}}}},"TripDetail":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"id của chuyến"},"stops":{"type":"array","items":{"$ref":"#/definitions/Stop"}}}},"TimeWindow":{"type":"object","properties":{"start_time":{"type":"integer","format":"int64"},"end_time":{"type":"integer","format":"int64"},"lat":{"type":"number","format":"double"},"lng":{"type":"number","format":"double"},"timewindow_type":{"type":"integer","format":"int32","description":"TimeWindow type | 0 = hằng ngày | 1 = Thời gian xác định"}}},"Schedule":{"type":"object","properties":{"day":{"type":"integer","format":"int64","description":"begin time of day | 0h:0m:0s"},"timewindows":{"type":"array","items":{"$ref":"#/definitions/TimeWindow"}}}},"CostRange":{"type":"object","properties":{"lower":{"type":"integer","format":"int64"},"higher":{"type":"integer","format":"int64"}}},"Price":{"type":"object","properties":{"distance":{"type":"number","format":"double"},"share_price":{"type":"integer","format":"int64"},"private_price":{"$ref":"#/definitions/CostRange"}}},"Error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer","format":"int32","description":"http response code"},"message":{"type":"string","description":"error message"}}}},"host":"virtserver.swaggerhub.com","basePath":"/trungthanhnt/123xe-API/1.0.0","schemes":["https","http"]}