Tạo nhiều tài khoản

Tạo nhiều tài khoản

Tạo nhiều tài khoản

POST https://abc.hoola.vn/manage/api/users/create-multi-user

Để 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)

200 Truy vấn thành công. Dữ liệu trả về là mảng users bao gồm các thông tin về trạng thái tạo tài khoản của từng tài khoản cần tạo. Tài khoản tạo thành công sẽ có thông tin về trường userId và trạng thái success là true

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": "[e-mail]",
            "password": "1234567890",
            "userId": null,
            "success": false,
            "status": "Email already in use"
        },
        {
            "name": "Lê Việt B",
            "username": "levietb",
            "email": "[e-mail]",
            "password": "1234567890",
            "userId": "msnJmaPa7KmtEzz3q",
            "success": true,
            "status": "Success created"
        },
        {
            "name": "Nguyễn Văn C",
            "username": "nguyenvanc",
            "email": "[e-mail]",
            "password": "1234567890",
            "userId": "urs2vByNw9ETg9XYZ",
            "success": true,
            "status": "Success created"
        },
        {
            "name": "Trần Xuân D",
            "username": "tranxuand",
            "email": "[e-mail]",
            "password": "1234567890",
            "userId": "MPC5B5dsdYD9Ak283",
            "success": true,
            "status": "Success created"
        },
        {
            "name": "Phạm Văn E",
            "username": "phamvane",
            "email": "[e-mail]",
            "password": "1234567890",
            "userId": "cc95fXX5PTX5qDR9R",
            "success": true,
            "status": "Success created"
        },
        {
            "username": "nguyenxuanq",
            "email": "[e-mail]",
            "password": "1234567890",
            "userId": null,
            "success": false,
            "status": "Not enough required infomation to create new user"
        },
        {
            "username": "lexuank",
            "email": "[e-mail]",
            "userId": null,
            "success": false,
            "status": "Not enough required infomation to create new user"
        }
    ],
    "msg": "4 success, 3 error"
}

400 Thiếu tham số yêu hoặc tất cả user đã tồn tại

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: "[e-mail]",
            password: "1234567890",
            userId: null,
            success: false,
            status: "Email already in use"
        },
        {
            name: "Trần Văn A",
            username: "nguyenvaa",
            email: "[e-mail]",
            password: "1234567890",
            userId: null,
            success: false,
            status: "Username already in use"
        },
        {
            name: "Phạm Văn C",
            email: "[e-mail]",
            userId: null,
            success: false,
            status: "Not enough required infomation to create new user"
        },
        {
            email: "[e-mail]",
            password: "1234567890",
            userId: null,
            success: false,
            status: "Not enough required infomation to create new user"
        },
        {
            name: "Hoàng Văn F",
            username: "hoangvanf",
            email: "[e-mail]",
            password: "1234567890",
            userId: null,
            success: false,
            status: "Server error in create new use"
        },      
    ],
    "msg": "0 success, 4 error"
}

401 Xác thực tài khoản của bạn không thành công

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"
}

403 Tài khoản của bạn không được phân quyền để thực hiện truy vấn này hoặc số lượng tài khoản còn lại không đủ so với số lượng tài khoản cần tạo

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"
}

405 Phương thức truy vấn không hợp lệ

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"
}

500 Lỗi server

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=sdhg23797sdbv9186jdvk58

body: {
    users: [
        {
            name: "Nguyễn Văn A",
            username: "nguyenvana",
            email: "[e-mail]",
            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: "[e-mail]",
            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: "[e-mail]",
            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: "[e-mail]",
            password: "1234567890"
        },
        {
            name: "Phạm Văn E",
            username: "phamvane",
            email: "[e-mail]",
            password: "1234567890"
        }
    ]
}