GYAPP查询授权项目信息
使用场景：使用分配的GY_APPID查询已授权的项目信息数据
调用凭证： 应用签名
请求地址: https://test-oapi.gongyi.qq.com/api/opf_proj_qry/GetAppProjectInfos
请求方法: POST （ HTTPS ）
请求参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| project_nos7 | []string | 是 | 要查询的项目ID列表；如：["xxx","xxx2",] ;单次最多支持10个同时查询 |
| ver | 1 | 是 | 数据格式版本；= 1,2;不同参数返回字段有区别--具体见：返回字段列表 |
返回参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int | 返回码：0表示成功，其他值表示错误，请参考错误码说明 |
| msg | string | 错误信息 |
| data | object | 返回数据 |
data内容:
| 参数 | 类型 | 说明 |
|---|---|---|
| list1 | array | 多个项目信息列表 |
| list[].project_no | string | 项目ID |
| list[].donate | object6 | |
| list[].donate.target4 | string | 筹款目标(分) |
| list[].donate.current_donate_amount4 | string | 总的捐款金额(分) |
| list[].donate.current_donate_count4 | string | 总的捐款次数 |
| 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.image2 | string | 项目头图 |
| list[].info.state3 | 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_nos":["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",
"cate":"教育助学",
"sub_cate":"助学金",
"recipients":"人/困境儿童",
"is_monthly_donate":"0"
},
"donate":{
"target" : "300000",
"current_donate_amount" : "1333222",
"current_donate_count": "122223"
}
}]
}
}
1. 2024年7月30日 fix文档错误;字段名data->list↩
2. 2024/7/29新增字段 ↩
3. 2024/7/29新增字段 ↩
4. 2025年6月10日新增字段 ↩
5. 2025/7 新增字段 ↩
6. 需要单独申请ver=2的权限后才可以获取数据 ↩
7. 为便于理解及参数一致性，2025年7月8日参数名由pids调整为project_nos;原pids参数仍可用，不受影响；但不要同时设置pids和project_nos。 ↩