Regenerate-secret Agency F10

1. Tổng quan

• Action URL: /api/vi/agencies
• Đặc tả chi tiết: Swagger Link (opens new window)
• Mô tả:
  • Tạo lại credentials cho agency F10.
  • Chỉ F1 agency mới có quyền tạo lại secret.

2. Hướng dẫn

• Bước 1: Thực hiện xây dựng request và POST tới API action URL.
• Bước 2: Nhận về response.

3. Parameters

Ví dụ Parameters

Thuộc tính	Bắt buộc	Kiểu dữ liệu	Mô tả
x-api-token	Có	String	Token API (F1)
x-api-password	Có	String	Mật khẩu API (F1)
x-api-account	Có	String	Tài khoản API (F1)

4. Request body

4.1 Ví dụ Request body

{
  "contactPhone": "String"
}

4.2 Bảng mô tả Request body

Thuộc tính	Bắt buộc	Kiểu dữ liệu	Mô tả
contactPhone	Có	String	Số điện thoại agency F10

5. Responses

5.1 Ví dụ Responses

{
  "StatusCode": 201,
  "Timestamp": "2:29:08 AM",
  "Path": "/api/v1/agencies",
  "Message": "Tạo mới agency F10 thành công",
  "Data": {
    "Agency": {
      "id": "094051d1-21bd-45c4-826f-0b5d0546bf84",
      "companyName": "Agency 001",
      "contactEmail": "agency01@gmail.com",
      "contactPhone": "+84987600001",
      "apiAccount": "encoded_api_account",
      "apiPassword": "encoded_api_password",
      "apiToken": "encoded_api_token",
      "address": "123 Đường ABC, Quận XYZ, TP.HCM",
      "notes": "Agency mới tạo",
      "agencyType": "F10",
      "firstName": "Nguyễn",
      "lastName": "Văn A",
      "isActive": true,
      "tier": "premium",
      "defaultLanguage": "VI",
      "defaultCurrency": "VND",
      "subscriptionId": null,
      "balenceAmount": "10000.00",
      "balenceLimit": "0.00",
      "industry": "Travel",
      "agencyCredit": "limit",
      "parentAgencyId": "ca5b18b8-fa5d-485f-a615-984ee0d4df89",
      "createdAt": "2025-10-16T02:29:08.320Z",
      "updatedAt": "2025-10-16T02:29:08.322Z"
    },
    "Credentials": {
      "apiAccount": "encoded_api_account",
      "apiPassword": "encoded_api_password",
      "apiToken": "encoded_api_token"
    }
  },
  "Errors": null,
  "RequestId": "req_1760581747622_uyg66pbvv",
  "TotalDuration": 1017
}

5.1 Bảng mô tả Responses

Thuộc tính	Kiểu dữ liệu	Mô tả	Ví dụ
StatusCode	String	Tình trạng request	200: Secret của agency được tạo lại thành công 400: Dữ liệu không hợp lệ 401: Không có quyền tạo lại secret 403: Chỉ F1 agency mới có quyền tạo secret 404: Không tìm thấy agency
Timestamp	String	Thời gian phản hồi	"2:29:08 AM"
Path	String	Đường dẫn API	"/api/v1/agencies"
Message	String	Tin nhắn thông báo	"Tạo mới agency F10 thành công"
Errors	String	Lỗi khi thực hiện request	null
RequestId	String	Mã định danh request	"req_1760581747622_uyg66pbvv"
TotalDuration	string	Thời gian xử lý request	1017
Agency.id	string	ID của agency	"094051d1-21bd-45c4-826f-0b5d0546bf84"
Agency.companyName	string	Tên công ty	"Agency 001"
Agency.contactEmail	string	Email liên hệ	"agency01@gmail.com"
Agency.contactPhone	string	Số điện thoại liên hệ	"+84987600001"
Agency.apiAccount	string	Tài khoản API (mã hóa)	"encoded_api_account"
Agency.apiPassword	string	Mật khẩu API (mã hóa)	"encoded_api_password"
Agency.apiToken	string	Token API (mã hóa)	"encoded_api_token"
Agency.address	string	Địa chỉ	"123 Đường ABC, Quận XYZ, TP.HCM"
Agency.notes	string	Ghi chú	"Agency mới tạo"
Agency.agencyType	string	Loại agency	"F10"
Agency.firstName	string	Họ	"Nguyễn"
Agency.lastName	string	Tên	"Văn A"
Agency.isActive	boolean	Trạng thái hoạt động	true
Agency.tier	string	Cấp độ agency	"premium"
Agency.defaultLanguage	string	Ngôn ngữ mặc định	"VI"
Agency.defaultCurrency	string	Tiền tệ mặc định	"VND"
Agency.subscriptionId	string	ID subscription đang sử dụng	null
Agency.balenceAmount	number	Số dư agency	10000
Agency.balenceLimit	number	Giới hạn số dư	0
Agency.industry	string	Ngành nghề	"Travel"
Agency.agencyCredit	string	Tín dụng agency	"limit"
Agency.parentAgencyId	string	ID agency cha	"ca5b18b8-fa5d-485f-a615-984ee0d4df89"
Agency.createdAt	string	Ngày tạo	"2025-10-16T02:29:08.320Z"
Agency.updatedAt	string	Ngày cập nhật	"2025-10-16T02:29:08.322Z"