Chúng tôi sẽ ngừng cung cấp API Tại chỗ. Hãy tham khảo tài liệu về việc Ngừng cung cấp API Tại chỗ để biết chi tiết, đồng thời tìm hiểu cách chuyển sang API Đám mây thế hệ tiếp theo của chúng tôi.

Cài đặt trang kinh doanh

/v1/settings/business/profile

Sử dụng điểm cuối /v1/settings/business/profile để đặt cấu hình các tùy chọn cài đặt trang kinh doanh sau đây: địa chỉ doanh nghiệp, nội dung mô tả về doanh nghiệp, email để liên hệ với doanh nghiệp, ngành kinh doanh và trang web của doanh nghiệp.

Trước khi bạn bắt đầu

  • Bạn phải sử dụng tài khoản admin để truy cập vào phần cài đặt trang kinh doanh.

Truy xuất

Thực hiện lệnh gọi API GET để truy xuất các tùy chọn cài đặt trang kinh doanh.

Ví dụ

GET /v1/settings/business/profile

Nếu thành công, hệ thống sẽ trả về đối tượng profile chứa dữ liệu trang kinh doanh. Để biết thêm thông tin mô tả về dữ liệu, hãy xem danh sách Thông số ở bên dưới.

{
   "settings": {
     "business": {
        "profile": {
          "address": "new-business-address",
          "description": "business-description",
          "email": "new-business-email",
          "vertical": "business-industry",
          "websites": [ "website-1", "website-2" ]
        }
      }
}

Nếu bạn gặp bất kỳ lỗi nào, hãy xem bài viết Thông báo trạng thái và thông báo lỗi.

Cập nhật cài đặt trang kinh doanh

Thực hiện lệnh gọi API POST để cập nhật các tùy chọn cài đặt trang kinh doanh.

Ví dụ

POST /v1/settings/business/profile
{
    "address": "your-business-address",
    "description": "your-business-description",
    "email": "your-business-email",
    "vertical": "your-business-industry",
    "websites": [ "your-website-1", "your-website-2" ]
}

Thông số

TênMô tả

address

loại: Chuỗi

Địa chỉ của doanh nghiệp. Tối đa 256 ký tự.

description

loại: Chuỗi

Nội dung mô tả về doanh nghiệp. Tối đa 512 ký tự.

email

loại: Chuỗi

Địa chỉ email (ở định dạng email hợp lệ) để liên hệ với doanh nghiệp. Tối đa 128 ký tự.

vertical

loại: Chuỗi

Ngành kinh doanh. Phải là một trong những giá trị được chấp nhận sau đây:

  • Automotive
  • Beauty, Spa and Salon
  • Clothing and Apparel
  • Education
  • Entertainment
  • Event Planning and Service
  • Finance and Banking
  • Food and Grocery
  • Public Service
  • Hotel and Lodging
  • Medical and Health
  • Non-profit
  • Professional Services
  • Shopping and Retail
  • Travel and Transportation
  • Restaurant
  • Other

Sau khi tạo ngành dọc của doanh nghiệp, bạn không thể đặt thông số này về giá trị trống.

websites

loại: Mảng chuỗi

URL (bao gồm cả http:// hoặc https://) được liên kết với doanh nghiệp (ví dụ: trang web, Trang Facebook, Instagram). Tối đa 2 trang web, mỗi trang có tối đa 256 ký tự.

Cập nhật một phần

Nếu chỉ cần cập nhật thông tin mới cho một số trường, bạn có thể gửi yêu cầu để chỉ thay đổi những trường cần thiết:

  POST /v1/settings/business/profile
{
    "address": "new-business-address",
    "email": "new-business-email"
}

Nếu thành công, hệ thống sẽ trả về Mã trạng thái HTTP 200 OKnull hoặc {}. Nếu bạn gặp bất kỳ lỗi nào, hãy xem bài viết Thông báo trạng thái và thông báo lỗi.