GYAPP查询授权项目信息
使用场景：使用分配的GY_APPID查询已授权的项目信息数据
调用凭证： 应用签名
请求地址: https://oapi.gongyi.qq.com/api/opf_proj_qry/GetAppProjectInfos
请求方法: POST （ HTTPS ）
请求参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| project_nos7 | []string | 是 | 要查询的项目ID列表；如：["xxx","xxx2",] ;单次最多支持10个同时查询 |
| ver | 1 | 是 | 数据格式版本；当前仅支持1 - 固定传1 |
返回参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int | 返回码：0表示成功，其他值表示错误，请参考错误码说明 |
| msg | string | 错误信息 |
| data | object | 返回数据 |
data内容:
| 参数 | 类型 | 说明 |
|---|---|---|
| list1 | array | 多个项目信息列表 |
| list[].project_no | string | 项目ID |
| list[].donate | object或null | 开发中 - 当前返回null |
| list[].info | object或undefined | 项目数据信息 - 如果app没有项目的权限或项目数据不存在，则返回空{}或null |
| list[].info.org_no | string | 项目发起机构id |
| list[].info.org_name | string | 项目发起机构名称 |
| list[].info.funder_org_no | string | 项目公募机构ID |
| list[].info.funder_org_name | string | 项目公募机构名称 |
| list[].info.name | string | 项目名称 |
| list[].info.intro | string | 项目简介 |
| list[].info.image 2 | string | 项目头图 |
| list[].info.state 3 | string | 项目状态 3 -筹款中;5 - 结束筹款;1、2、4、6、7等:其他都是非筹款状态 |
| list[].info.is_monthly_donate5 | string | 是否月捐项目 "1" - 月捐项目；其他任何值 - 非月捐项目 |
| list[].info.recipients5 | string | 受助对象; 格式："大类/子类"; 如果特殊情况只有大类或子类；则直接返回大类/子类。 |
| list[].info.cate5 | string | 项目一级分类 |
| list[].info.sub_cate5 | string | 项目二级分类 |
请求示例:
{
"project_no":"3004499"
}
返回示例:
{
"code": 0,
"msg": "Success",
"op_time": 1650812345,
"trace_id": "1a2b3c4d5e6f7g8h1a2b3c4d5e6f7g8h",
"data": {
"list": [{
"project_no":"18968",
"info":{
"intro": "项目描述",
"name": "项目名称",
"org_no": "100042",
"org_name": "中国红十字基金会",
"funder_org_no": "100042",
"funder_org_name": "中国红十字基金会",
"image":"https://orgcdn.gongyi.qq.com/orgv2/imgcdn2/40008b9a5380fcacce3976bf7c08af5b_20220818/gongyi_40008b9a5380fcacce3976bf7c08af5b_1660806316_sdqcu.jpg/0",
"state":"3",
"is_monthly_donate":"0",
"recipients":"人/困难家庭",
"cate":"医疗救助",
"sub_cate":"白血病"
}
}]
}
}
1: 2024年7月30日 fix文档错误;字段名data -> list
2: 2024-07-29 新增字段
3: 2024-07-29 新增字段
5: 2025-07-16 新增字段
7: 2025-07-16 为便于理解及参数一致性，参数名由pids调整为project_nos; 原pids参数仍可用，不受影响；但不要同时设置pids和project_nos。