Để tránh trường hợp timeout request và dễ theo dõi kết quả, chỉ nên tạo tối đa 100 tài khoản trong một lần truy vấn.
Lưu ý, thông số của từng tài khoản trong mảng danh sách tài khoản phải đáp ứng yêu cầu sau:
- Họ và tên tài khoản phải là kiểu chuỗi (string), độ dài tối thiểu 3 ký tự;
- Username phải là kiểu chuỗi (string), không có khoảng trống, không có ký tự đặc biệt, chấp nhận các ký tự a-z, A-Z, 0-9, độ dài phải từ 3 đến 20 ký tự;
- Password phải có độ dài từ 6 đến 35 ký tự.
Cách trường thông tin tuỳ chọn của tài khoản:
- phone: Số điện thoại,
- city: Tỉnh, thành phố,
- district: Quận, huyện,
-street: Đường, phố,
- gender: Giới tính (Nam/Nữ),
- job: Nghề nghiệp
Khoảng cách thời gian giữa các lần truy vấn tạo nhiều tài khoản nên tối thiểu là 10 phút để tránh trường hợp truy vấn quá nhiều làm server quá tải.
Query Parameters
Name
Type
Description
token
string
Token xác thực tài khoản của bạn
sendEmail
Bolean
(true/false) Set bằng true để gửi email thông báo tài khoản được tạo thành công cho email.
Request Body
Name
Type
Description
users
array
Mảng danh sách thông tin các tài khoản cần tạo (bao gồm tên, username, email và password)
Mã phản hồi respCode "00". Data trả về gồm số lượng tài khoản tạo thành công và tạo không thành công {"respCode": "00","users": [ {"name":"Nguyễn Văn A","username":"nguyenvana","email":"nguyenvana@abc.com","password":"1234567890","userId":null,"success":false,"status":"Email already in use" }, {"name":"Lê Việt B","username":"levietb","email":"levietb@abc.com","password":"1234567890","userId":"msnJmaPa7KmtEzz3q","success":true,"status":"Success created" }, {"name":"Nguyễn Văn C","username":"nguyenvanc","email":"nguyenvan@abc.com","password":"1234567890","userId":"urs2vByNw9ETg9XYZ","success":true,"status":"Success created" }, {"name":"Trần Xuân D","username":"tranxuand","email":"tr@abc.com","password":"1234567890","userId":"MPC5B5dsdYD9Ak283","success":true,"status":"Success created" }, {"name":"Phạm Văn E","username":"phamvane","email":"phamvane@abc.com","password":"1234567890","userId":"cc95fXX5PTX5qDR9R","success":true,"status":"Success created" }, {"username":"nguyenxuanq","email":"nguyenxuanq@abc.com","password":"1234567890","userId":null,"success":false,"status":"Not enough required infomation to create new user" }, {"username":"lexuank","email":"lexuank@abc.com","userId":null,"success":false,"status":"Not enough required infomation to create new user" } ],"msg": "4 success, 3 error"}
Mã phản hồi respCode "02". Không tìm thấy body request. Data trả về {"respCode": "02","users": null,"msg": "No request body"}Mã phản hồi respCode "03". Không tìm thấy mảng users trong body request. Data trả về {"respCode": "03","users": null,"msg": "No users array in request body"}Mã phản hồi respCode "04". Tham số users trong body request không đúng định dạng là một mảng. Data trả về {"respCode": "04","users": null,"msg": "Users parammeter in body is not array format"}Mã phản hồi respCode "05". Tham số users trong body request là một mảng rỗng. Data trả về {"respCode": "05","users": null,"msg": "User parammeter is an empty array"}Mã phản hồi respCode "06". Không có tham số token xác thực tài khoản của bạn. Data trả về {"respCode": "06","users": null,"msg": "No token"}Mã phản hồi respCode "13". Tất cả danh sách users đều đã tồn tại hoặc thiếu thông tin yêu cầu hoặc server bị lỗi, không tạo được tài . Data trả về
{"respCode": "13","users": [ { name:"Nguyễn Văn A", username:"nguyenvaa", email:"nguyenvana@abc.com", password:"1234567890", userId:null, success:false, status:"Email already in use" }, { name:"Trần Văn A", username:"nguyenvaa", email:"tranvanb@abc.com", password:"1234567890", userId:null, success:false, status:"Username already in use" }, { name:"Phạm Văn C", email:"phamvanc@abc.com", userId:null, success:false, status:"Not enough required infomation to create new user" }, { email:"levand@abc.com", password:"1234567890", userId:null, success:false, status:"Not enough required infomation to create new user" }, { name:"Hoàng Văn F", username:"hoangvanf", email:"hoangvanf@abc.com", password:"1234567890", userId:null, success:false, status:"Server error in create new use" }, ],"msg": "0 success, 4 error"}
Mã phản hồi respCode "08". Token xác thực tài khoản của bạn không có hiệu lực hoặc đã hết hạn . Data trả về{"respCode": "08","users": null,"msg": "Invalid token || Token has expired"}
Mã phản hồi respCode "10". Tài khoản của bạn không được phân quyền thực hiện truy vấn này. Data trả về {"respCode": "10","users": null,"msg": "Your account does not have permission"}Mã phản hồi respCode "11". Đã sử dụng hết số lượng tài khoản cho phép. Data trả về {"respCode": "11","users": null,"msg": "The number of accounts has run out"}Mã phản hồi respCode "12". Số lượng tài khoản còn lại không đủ. Data trả về {"respCode": "12","users": null,"msg": "There are only 3 available accounts"}
Mã phản hồi respCode "01". Phương thức không hợp lệ . Data trả về {"respCode": "01","users": null,"msg": "Request method should be POST"}
Mã phản hồi respCode "07". Server không xác thực được tài khoản của bạn. Data trả về {"respCode": "07","users": null,"msg": "Server not able to authenticate your account"}Mã phản hồi respCode "10". Server không kiểm tra được số lượng tài khoản còn lại. Data trả về {"respCode": "10","users": null,"msg": "Server is not able to check your website resources"}
Ví dụ về tạo nhiều tài khoản:
POST:https://abc.hoola.vn/manage/api/users/create-multi-user?token=sdhg23797sdbv9186jdvk58body: { users: [ { name:"Nguyễn Văn A", username:"nguyenvana", email:"nguyenvana@abc.com", password:"1234567890", phone:"0987654321", city:"Hà Nội", district:"Quận Cầu Giấy", street:"40 Hoàng Đạo Thuý", gender:"Nam", job:"Giáo viên THCS" }, { name:"Lê Việt B", username:"levietb", email:"levietb@abc.com", password:"1234567890", phone:"0987654321", city:"Hà Nội", district:"Quận Ba Đình", street:"60 Điện Biên Phủ", gender:"Nam", job:"Lái xe" }, { name:"Nguyễn Lan Hương", username:"nguyenlanhuong", email:"nguyenalanhuong@abc.com", password:"1234567890", phone:"0987654321", city:"Hà Nội", district:"Quận Thanh Xuân", street:"130 Nguyễn Trãi", gender:"Nữ", job:"Chuyên viên văn " }, { name:"Trần Xuân D", username:"tranxuand", email:"tr@abc.com", password:"1234567890" }, { name:"Phạm Văn E", username:"phamvane", email:"phamvane@abc.com", password:"1234567890" } ]}