Báo cáo Xếp hạng (Rating) của người dùng

HTTP Request:

POST /v2/business-pages/{id}/social/ratings/stats

Example Request

{
  "reviewObjectType": 1,
  "reviewObjectIds": [
    1029762
  ]
}

Header:

Tham số	Kiểu	Bắt buộc	Mô tả
Authorization	String		Authorization: Bearer {{token}} Với token lấy từ Xác thực và uỷ quyền truy cập tài nguyên BP

Query Path:

Tham số	Kiểu	Bắt buộc	Mô tả
id	Number		Business Page ID

Request Body:

Tham số	Kiểu	Bắt buộc	Mô tả
reviewObjectType	Number		Default: 1
reviewObjectIds	List Number		Danh sách Business Page ID cần lấy số xếp hạng mà Doanh nghiệp đang quản lý

Example response:

{
  "cmdId": "8a5c47ad-fa88-4a26-8551-fcd48de0516e",
  "success": true,
  "data": {
    "reviewObjectType": 1,
    "reviewObjectIds": [
      1029762
    ],
    "extendDataList": [
      {
        "reviewObjectId": 1029762,
        "reviewCount": 715,
        "oneStarCount": 0,
        "twoStarCount": 3,
        "threeStarCount": 0,
        "fourStarCount": 22,
        "fiveStarCount": 690,
        "avgStar": 5.0
      }
    ],
    "avgStar": 5.0
  }
}

Cấu trúc Response:

Tham số	Kiểu	Mô tả
cmdId	String	ID để tracking đối soát giữa Doanh nghiệp và MoMo
success	Boolean	Thành công hay thất bại
data	Object Json	Data trả về

Thuộc tính data trong Response:

Tham số	Kiểu	Mô tả
reviewObjectType	Number	Default: 1
reviewObjectIds	List Number	Danh sách Business Page ID cần lấy số xếp hạng mà Doanh nghiệp đang quản lý theo request ban đầu để đối chiếu thêm dữ liệu trả về.
avgStar	Number	Xếp hạng trung bình của tất cả các Business Page ID truyền vào

Thuộc tính extendDataList trong data:

Tham số	Kiểu	Mô tả
reviewObjectId	Number	Business Page ID
reviewCount	List Number	Số lượng người dùng để lại Đánh giá
oneStarCount	Number	Số lượng người dùng đánh giá xếp hạng 1 sao
twoStarCount	Number	Số lượng người dùng đánh giá xếp hạng 2 sao
threeStarCount	Number	Số lượng người dùng đánh giá xếp hạng 3 sao
fourStarCount	Number	Số lượng người dùng đánh giá xếp hạng 4 sao
fiveStarCount	Number	Số lượng người dùng đánh giá xếp hạng 5 sao
avgStar	Number	Xếp hạng trung bình của từng Business Page ID