持卡人接口

---

获取持卡人列表

URL: GET /cardholder/list?page=1

Query:

字段	必填	说明
page	否	页码，从1开始
size	否	每页大小
search	否	搜索关键词
segment_id	否	卡段id

输出:

字段	类型	说明
id	string	持卡人id
email	string	邮箱
area_code	string	手机区号
mobile	string	手机号
first_name	string	名
last_name	string	姓
date_of_birth	string	出生日期, 格式1990-01-01
country	string	两位国家代码，如CN, US, AU
state	string	州/省，有些国家，如US，AU不填会报错
city	string	城市
address_line1	string	详细地址1
postcode	string	邮编
remark	string	备注
created_at	string	创建时间, 格式2025-04-26T06:46:20+0000, 需要格式化成本地时间

---

创建持卡人

URL: POST /cardholder/create

输入:

字段	类型	必填	说明
email	string	是	邮箱
area_code	string	是	手机区号
mobile	string	是	手机号
first_name	string	是	名
last_name	string	是	姓
date_of_birth	string	是	出生日期, 格式1990-01-01
country	string	是	两位国家代码，如CN, US, AU
state	string	否	州/省，有些国家，如US，AU不填会报错
city	string	是	城市
address_line1	string	是	详细地址1
postcode	string	是	邮编
remark	string	否	备注
segment_id	string	是	卡段id

输出:

字段	类型	说明
id	string	持卡人id

---

更新持卡人

注意: 邮箱和卡段id不能更新

URL: POST /cardholder/{id}/update

输入:

字段	类型	必填	说明
area_code	string	是	手机区号
mobile	string	是	手机号
first_name	string	是	名
last_name	string	是	姓
date_of_birth	string	是	出生日期, 格式1990-01-01
country	string	是	两位国家代码，如CN, US, AU
state	string	否	州/省，有些国家，如US，AU不填会报错
city	string	是	城市
address_line1	string	是	详细地址1
postcode	string	是	邮编
remark	string	否	备注

输出: 无