接口说明
接口英文名称：alipay.open.mini.category.require.query
请求url：https://openapi.alipay.com/v3/alipay/open/mini/category/require/query
请求方式：post
path指该参数为路径参数
query指该参数需在请求url传参
body指该参数需在请求json传参
通用场景
查询类目所需资质信息
公共请求参数
业务请求参数
body参数
category_code_list｜类目列表必选array[1,5]
【描述】类目列表，不超过五个
【示例值】[ "xs1001_xs2002_xs3008","xs1022_xs2182"]
常见请求示例
默认示例
curl -x post \
"https://openapi.alipay.com/v3/alipay/open/mini/category/require/query" \
-h "authorization: alipay-sha256withrsa app_id=${appid},timestamp=${now},nonce=${uuid},expired_seconds=600,sign=${sign}" \
-h "alipay-request-id: ${requestid}" \
-h "content-type: application/json" \
-d '{
"category_code_list":[
"xs1001_xs2002_xs3008",
"xs1022_xs2182"
]
}'
说明：本示例仅供参考。
公共响应参数
业务响应参数
category_require_info_list｜类目查询结果对象可选categoryrequireinfo[]
【描述】类目对应资质列表
category_code｜类目code必选string(32)
【描述】类目code（各级类目code下划线"_"拼接）。类目信息参考alipay.open.mini.category.query
【示例值】xs1001_xs2002_xs3008
category_name｜类目名称必选string(64)
【描述】类目名称（各级类目名称下划线"_"拼接）
【示例值】教育培训_培训机构_课外辅导
business_licence_required｜营业执照页面是否必填必选boolean(10)
【描述】营业执照页面是否必填
【示例值】true
door_photo_required｜门头照页面是否必填必选boolean(5)
【描述】门头照页面是否必填
【示例值】true
special_licence_required｜特殊资质页面是否必填必选boolean(5)
【描述】特殊资质页面是否必填
【示例值】true
category_requirements｜类目要求原始描述信息必选string(1024)
【描述】类目要求原始描述信息
【示例值】1、需提供区、县级教育部门颁发的《民办学校办学许可证》，或事业单位法人证书、民办非企业单位登记证书； ( 其中：民办学校办学许可证 就是 办学许可证)
响应示例
正常示例
异常示例
{
"category_require_info_list":[
{
"category_code":"xs1001_xs2002_xs3008",
"category_name":"教育培训_培训机构_课外辅导",
"business_licence_required":true,
"door_photo_required":true,
"special_licence_required":true,
"category_requirements":"1、需提供区、县级教育部门颁发的《民办学校办学许可证》，或事业单位法人证书、民办非企业单位登记证书； ( 其中：民办学校办学许可证 就是 办学许可证)"
}
]
}说明：本示例仅供参考。
公共错误码
前往查看业务错误码
| 状态码 | 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|---|
| 400 | system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | category_error | 类目编码数量异常 | 输入的类目编码数量不要大于五个 |
| 400 | category_is_blank | 类目为空 | 请传入类目信息 |
| 400 | invalid_params | 参数错误 | 确认参数后重新提交 |
| 400 | parameter_error | 类目编码错误 | 请传入正确的类目编码 |