获取营期导入模板
按营期 ID 获取批量导入所需的表单字段定义(input_key / input_title)。导入前请先调本接口,再按返回字段组装 批量导入营期营员 的 excel_data。
POST/api/getInputJson
请求参数
| 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| token | String | 身份校验令牌 | 必填 | - | 由 获取访问令牌 获得 |
| period_id | Number | 营期 ID | 必填 | - | 不同营期的字段可能不同 |
CURL
curl --location --request POST 'https://open.xinduobang.cn/api/getInputJson' \
--header 'Content-Type: application/json' \
--data-raw '{
"token": "YOUR_TOKEN",
"period_id": 5300
}'
成功响应
{
"code": 0,
"data": [
{
"input_key": "input_data_0",
"input_title": "营员姓名(必填)"
},
{
"input_key": "input_data_1",
"input_title": "营员手机(非必填)"
},
{
"input_key": "input_data_2",
"input_title": "营员证件号(必填)"
},
{
"input_key": "input_data_7",
"input_title": "会员手机(必填)"
},
{
"input_key": "input_data_8",
"input_title": "商品plu【526370688219】(必填)"
},
{
"input_key": "input_data_9",
"input_title": "购买数量(必填)"
}
]
}
实际字段数量因营期而异,示例仅展示部分。
| 字段 | 类型 | 说明 |
|---|---|---|
| input_key | String | 导入时使用的字段键名 |
| input_title | String | 字段说明(含是否必填、可选值等) |
失败响应
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 非 0 | 业务错误 | 请检查 period_id 与 token |
相关接口
- 获取营期 PLU:
获取营期 PLU 编号 - 批量导入营期营员:
批量导入营期营员