Shop information — API Pancake POS

get /shops

GET/shopsGọi qua 360: GET https://partner.quantri360.com/v1/pancake_pos/shops

Sắp mở. API này đã chạy thật qua 360 và đang được chốt giá — bạn có thể đọc tài liệu và chuẩn bị tích hợp trước.

Mô tả API

Danh sách cửa hàng Pancake POS mà API key đã nối thấy được: mã cửa hàng (SHOP_ID), tên, tiền tệ, các trang Facebook gộp trong cửa hàng. Dùng để lấy SHOP_ID đúng trước khi gọi các API /shops/{SHOP_ID}/….

Không có tham số. Một API key có thể thấy nhiều cửa hàng, nhưng qua 360 chỉ gọi được các đường dẫn /shops/{SHOP_ID}/… của ĐÚNG cửa hàng đã nối (cửa hàng khác → 404).

Request

Địa chỉ

GET https://partner.quantri360.com/v1/pancake_pos/shops

Xác thực & gian hàng

Tên	Vị trí	Kiểu	Mẫu	Mô tả
Authorization	header	header	Bearer q360_live_ab12cd34_…	Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_id	query	string	1234567	SHOP_ID đã nối — có thể bỏ khi đường dẫn có /shops/{SHOP_ID}.

Tham số request

Không có tham số riêng (ngoài tham số chung).

Ví dụ request

curl -s "https://partner.quantri360.com/v1/pancake_pos/shops" \
  -H "Authorization: Bearer $KEY"

Python

import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/pancake_pos/shops",
    params={},
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())

Node.js

const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/pancake_pos/shops');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());

PHP

<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/pancake_pos/shops' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Tham số phản hồi (nguyên của Pancake POS)

Tên	Kiểu	Mẫu	Mô tả
success	bool	true
shops	object[]		Cửa hàng.
id	int	1234567	SHOP_ID — dùng trong mọi đường dẫn /shops/{SHOP_ID}/….
name	string	Cửa hàng Online	Tên cửa hàng.
currency	string	VND	Tiền tệ của cửa hàng — mọi số tiền ở các API khác theo đơn vị này (VND: đồng, không có phần lẻ).
pages	object[]		Trang mạng xã hội gộp vào cửa hàng: id, name, username, platform (`facebook`…), settings.auto_create_order.
avatar_url	string		Ảnh đại diện.
preferred_shop	int		Thứ tự ưu tiên của người dùng (nhỏ = ưu tiên).
link_post_marketer	object[]	[]	Liên kết bài viết / nguồn đơn / TKQC với marketer.

Mẫu phản hồi

{
  "success": true,
  "shops": [
    {
      "id": 1234567,
      "name": "Cửa hàng Online",
      "currency": "VND",
      "pages": [
        {
          "id": "871110146500000",
          "name": "Cửa hàng Online",
          "username": "cuahang.official",
          "platform": "facebook",
          "shop_id": 1234567,
          "settings": {
            "auto_create_order": false
          }
        }
      ],
      "preferred_shop": null,
      "avatar_url": null,
      "link_post_marketer": []
    }
  ]
}

Bắt đầu dùng

Đăng ký tài khoản Partner
Mở loại dữ liệu thuộc nhóm Khác ở trang nền tảng
Tạo API key (tick kênh Pancake POS)
Gọi theo ví dụ ở trên