GET /v1/members

会员列表（游标分页）

Scope members:read 商户自身

keyset 游标，按 (created_at, id) 严格递减。不用 OFFSET ——

会员表是头部持续插入的列表，翻页途中来了新记录会让你重复看到同一行。

kyc_level 批量取（两条 SQL，不是 N+1），可以放心翻大页。

查询参数

字段	类型	必填	说明
`limit`	integer	可选	每页条数，缺省 20、上限 100。非法值静默回落到 20，不报错
`cursor`	string	可选	上一页的 `next_cursor`。不透明串，不要自己拼 —— 解不开的游标按「从头开始」处理而不是报错。

响应

200OK

{
  "data": [
    {
      "id": "mem_9f1c0c8e-6f2a-4c1d-9d0b-2a7e5b3f8c41",
      "external_member_id": "u-10086",
      "uid": "80031427",
      "email": "alice@example.com",
      "nickname": "Alice",
      "status": "normal",
      "kyc_level": 2,
      "created_at": "2026-08-12T09:30:00.000Z"
    }
  ],
  "next_cursor": "MjAyNi0wOC0xMlQwOTozMDowMC4wMDBafDlmMWMwYzhl",
  "has_more": true
}

403insufficient_scope 缺 members:read

调用样例

curl -X GET 'https://api.zise.com/v1/members' \
  -H 'authorization: Bearer $TOKEN' \
  -H 'x-zise-merchant: $MERCHANT_ID'

const res = await fetch(
  "https://api.zise.com/v1/members",
  {
    method: "GET",
    headers: {
      "authorization": "Bearer $TOKEN",
      "x-zise-merchant": "MERCHANT_ID"
    },
  },
);
// 金额一律按字符串读，不要 JSON.parse 成 number
const data = await res.json();

import requests

res = requests.get(
    "https://api.zise.com/v1/members",
    headers={
        "authorization": "Bearer $TOKEN",
        "x-zise-merchant": "$MERCHANT_ID"
    },
)
# 金额用 Decimal(str(...))，不要 float
data = res.json()