MarketingMã giới thiệu
Thêm mã giới thiệu
Thêm mã giới thiệu mới
Endpoint
POST /v1/affiliatecodes
Request Payload
JSON Object Payload:
{
"company_id": 1,
"creator_id": 1,
"affiliate_id": 2,
"code": "aaacb2f2f",
"description": "Mã giới thiệu cho đối tác VIP",
"tag": "vip",
"status": 1
}| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty (phải trùng công ty của phiên đăng nhập) |
creator_id | int | Có | ID người tạo |
affiliate_id | int | ID đối tác affiliate sở hữu mã | |
code | string | Có | Mã giới thiệu |
description | string | Mô tả mã giới thiệu | |
tag | string | Tag phân loại | |
status | int | Trạng thái (1: Hoạt động, 0: Tạm dừng; mặc định 0) |
Response Schema
HTTP 201 - JSON Object
Xem AffiliateCode Object Schema
Error Codes
| HTTP | Code | Mô tả |
|---|---|---|
| 422 | error_code_required | Chưa nhập mã giới thiệu |
| 422 | error_company_id_required | Chưa truyền company_id |
| 422 | error_company_id_notfound | company_id không thuộc công ty của phiên đăng nhập |
| 422 | error_user1_id_required | Chưa truyền creator_id |
| 422 | error_user_id_notfound | creator_id không hợp lệ |
| 403 | error_forbidden | Người dùng không có quyền quản lý affiliate |
| 500 | error_add | Lỗi hệ thống khi lưu dữ liệu |
Lưu ý
API không kiểm tra trùng mã và không kiểm tra
affiliate_id có tồn tại hay không. Hãy tự đảm bảo mã là duy nhất trong cửa hàng.