freearch/batch_get
目录 |
1.接口说明
1.1接口描述
批量获取自由项信息
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
基础数据同步或前端展示
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/freearch/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | string | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| page_index | 否 | string | 页号 |
| rows_per_page | 否 | string | 每页行数 |
| field_name | 否 | string | 自由项标识，比如：“cFree2”表示自由项2 |
| alias | 否 | string | 编码，比如：“blue” |
| item | 否 | string | 自由项组关键字，比如：“自由项9” |
| value | 否 | string | 值，比如：“蓝” |
3.3请求示例
GET https://api.yonyouup.com/api/freearch/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&page_index=1&rows_per_page=20&ds_sequence=1
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| page_index | string | 页号 | |
| rows_per_page | string | 每页行数 | |
| row_count | string | 总行数 | |
| page_count | string | 页数 | |
| item | string | 自由项名 | |
| item_name | string | 定义的自由项名 | |
| field_name | string | 字段名 | |
| value | string | 自定义项或自由项值 | |
| alias | string | 代码 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"page_index":"1",
"rows_per_page":"10",
"row_count":"9",
"errmsg":"",
"errcode":"0",
"page_count":"1",
"freearch":[
{
"field_name":"cFree7",
"alias":"S",
"item_name":"尺码",
"item":"自由项7",
"value":"S"
},
{
"field_name":"cFree7",
"alias":"M",
"item_name":"尺码",
"item":"自由项7",
"value":"M"
},
{
"field_name":"cFree9",
"alias":"01",
"item_name":"颜色",
"item":"自由项9",
"value":"白色"
},
{
"field_name":"cFree9",
"alias":"02",
"item_name":"颜色",
"item":"自由项9",
"value":"黑色"
}
]
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}