# 全国公职与国企招录岗位数据
> 来源页面: https://www.gugudata.com/api/details/recruitmentpositions
## 概览
- API 标识: `recruitmentpositions`
- 分类: 教育/高考
- 描述: 全国多类型公职与国企招录岗位查询
- 标签: 公职招录 / 国企招聘 / 岗位检索
- 短标签: 基础数据 / 招录岗位 / 就业数据
- 详情页: https://www.gugudata.com/api/details/recruitmentpositions
- LLM Markdown: https://www.gugudata.com/api/details/recruitmentpositions/llm.md
- 数据预览: https://www.gugudata.com/preview/recruitmentpositions
- 购买开通: https://www.gugudata.com/order/recruitmentpositions
- APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders
## 给大模型的接入指令
如果你正在帮助用户接入这个 API,请优先使用本文档中的接口地址、请求方式、请求参数、返回参数、状态码、cURL 示例和预览数据生成代码或排查问题。
- 接入目标: 调用 `全国公职与国企招录岗位数据`,不要臆造未在文档中出现的参数或返回字段。
- AppKey 获取: 用户登录咕咕数据开发者中心后,在 `APP KEY 管理` 页面复制对应产品的 AppKey。
- AppKey 替换: 示例中的 `YOUR_APPKEY`、`APPKEY`、`{{YOUR_APPKEY}}`、`{{appkey}}`、`{{appKey}}` 都应替换为用户自己的 AppKey。
- AppKey 传递: 推荐使用 `X-GUGUDATA-APPKEY` 或 `X-API-Key` 请求头;OpenAI 兼容客户端可使用 `Authorization: Bearer <AppKey>`;历史 query 参数 `appkey` 继续有效。
- 开通与续费: 未开通时引导用户访问购买开通页;已开通或需要续费时,引导用户进入开发者中心或订单与续费页。
- 错误处理: HTTP 状态码代表传输层结果,响应体内的业务状态码代表接口业务结果,代码中应分别处理。
- 生产建议: AppKey 应保存在服务端环境变量或密钥配置中,由服务端统一发起请求,不要写入网页、App 客户端或公开仓库。
关键链接:
- 接口详情页: https://www.gugudata.com/api/details/recruitmentpositions
- LLM Markdown: https://www.gugudata.com/api/details/recruitmentpositions/llm.md
- 数据预览: https://www.gugudata.com/preview/recruitmentpositions
- 购买开通页: https://www.gugudata.com/order/recruitmentpositions
- 开发者中心 APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders
## API 功能
- 汇集已结构化的国家公务员、部分省级公务员、事业单位、军队文职、三支一扶及国有单位公开招聘岗位;
- 统一岗位、招录人数、学历、学位、专业和资格条件等核心字段;
- 支持按招录类型、年度、地区、单位、岗位、学历和专业要求组合检索;
- 返回稳定岗位标识、公开来源链接及各招录类型对应的扩展信息;
- 适用于招考信息平台、职业规划、就业服务、岗位搜索与历史趋势研究;
- 各类型、年份和地区的覆盖及字段完整度以公开发布情况和接口实时返回为准;
- 百万级结构化数据,毫秒级响应性能。
- 默认最大 QPS:5,可在开发者中心自助升级,仅支持年付,订阅期内接口调用次数不限;
- [接口调用状态与状态监控。](https://www.gugudata.com/status)
## API 文档
- 接口地址: `https://api.gugudata.com/employment/recruitment-positions`
- 返回格式: `application/json; charset=utf-8`
- 请求方式: `GET`
- 请求协议: `HTTPS`
- 请求示例: `https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword=`
- 接口测试: https://api.gugudata.com/employment/recruitment-positions/demo
- Apifox: https://doc.gugudata.com/
- Postman: https://www.postman.com/gugudata/gugudata-official/collection/1163860-22cb92f5-771a-48fd-89c0-f20a0790a8ce/?action=share&creator=1163860&active-environment=1163860-a95b31ef-324f-43db-b2fc-faa41f45bd35
- OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
## 鉴权方式
接口支持以下 AppKey 传递方式,任选一种即可;已有请求示例、Postman 集合和历史代码仍可继续使用原来的 `appkey` 参数方式。
| 传输载体 | 参数 | 示例 | 说明 |
| --- | --- | --- | --- |
| HTTP Header | `X-GUGUDATA-APPKEY` | `X-GUGUDATA-APPKEY: YOUR_APPKEY` | 推荐方式,适合服务端接入和统一封装。 |
| HTTP Header | `X-API-Key` | `X-API-Key: YOUR_APPKEY` | 通用 API Key Header,便于和常见 API 客户端集成。 |
| HTTP Header | `Authorization` | `Authorization: Bearer YOUR_APPKEY` | 适合 OpenAI 兼容接口或 Bearer Token 风格客户端。 |
| Query 参数 | `appkey` | `?appkey=YOUR_APPKEY` | 兼容现有示例、Postman 集合、浏览器调试和历史代码。 |
> 部分历史 POST 接口仍兼容表单或 JSON body 中的 `appkey`;新接入建议优先使用 Header 或 Query 参数。
## 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
| --- | --- | --- | --- | --- |
| appkey | string | 是 | YOUR_APPKEY | 购买本接口后获取的 APPKEY,请仅在服务端安全保存。 |
| category | string | 否 | all | 招录类型。可选值:all(全部);civil_service(公务员);public_institution(事业单位);military_civilian(军队文职);three_support(三支一扶);state_owned_enterprise(国有单位)。 |
| year | integer | 否 | 0 | 招聘年度;不传或传 0 时不按年度筛选。 |
| province | string | 否 | | 省级地区名称精确筛选;传全国可查询现有国家级岗位。 |
| city | string | 否 | | 城市名称精确筛选,建议与 province 组合使用。 |
| district | string | 否 | | 区县名称精确筛选,建议与 province、city 组合使用。 |
| organizationCode | string | 否 | | 招录单位代码精确查询。 |
| positionCode | string | 否 | | 岗位代码精确查询。 |
| organizationKeyword | string | 否 | | 单位名称或部门名称模糊搜索,最长 100 个字符。 |
| positionKeyword | string | 否 | | 岗位名称或岗位描述模糊搜索,最长 100 个字符。 |
| majorKeyword | string | 否 | | 专业要求模糊搜索,最长 100 个字符。 |
| educationKeyword | string | 否 | | 学历要求模糊搜索,如本科、硕士研究生,最长 100 个字符。 |
| pageIndex | integer | 否 | 1 | 分页页码,从 1 开始。 |
| pageSize | integer | 否 | 20 | 每页记录数,取值范围 1~100。 |
## 返回参数
| 参数名 | 参数类型 | 备注 |
| --- | --- | --- |
| DataStatus.RequestParameter | string | 服务端识别的业务参数摘要,不包含 APPKEY。 |
| DataStatus.StatusCode | integer | 业务状态码。 |
| DataStatus.StatusDescription | string | 业务状态说明。 |
| DataStatus.ResponseDateTime | string | 响应时间。 |
| DataStatus.DataTotalCount | integer | 当前筛选条件下去重后的岗位总数。 |
| Data.PositionId | string | 岗位稳定唯一标识,可用于本地幂等更新。 |
| Data.Category | string | 标准招录类型代码。 |
| Data.CategoryName | string | 招录类型中文名称。 |
| Data.RecruitmentYear | integer | 招聘年度。 |
| Data.Province | string\|null | 省级地区,无公开数据时为 null。 |
| Data.City | string\|null | 城市,无公开数据时为 null。 |
| Data.District | string\|null | 区县,无公开数据时为 null。 |
| Data.OrganizationName | string\|null | 招录单位名称。 |
| Data.DepartmentName | string\|null | 部门或用人司局名称。 |
| Data.OrganizationCode | string\|null | 公开材料中的单位代码。 |
| Data.PositionCode | string\|null | 公开材料中的岗位代码。 |
| Data.PositionName | string\|null | 岗位名称。 |
| Data.PositionDescription | string\|null | 岗位职责或工作内容。 |
| Data.PositionCategory | string\|null | 岗位类别。 |
| Data.PlannedHires | integer | 计划招录人数;公开材料未提供时为 0。 |
| Data.EducationRequirement | string\|null | 学历要求。 |
| Data.DegreeRequirement | string\|null | 学位要求。 |
| Data.MajorRequirement | string\|null | 专业要求原始业务描述。 |
| Data.MajorRequirements | array | 结构化专业要求数组;无明细时返回空数组。 |
| Data.MajorRequirements[].MajorCode | string\|null | 专业代码。 |
| Data.MajorRequirements[].MajorName | string\|null | 专业名称。 |
| Data.MajorRequirements[].Requirement | string\|null | 该专业明细对应的要求说明。 |
| Data.PoliticalRequirement | string\|null | 政治面貌要求。 |
| Data.ExperienceRequirement | string\|null | 基层或相关工作经历要求。 |
| Data.GraduateRequirement | string\|null | 应届生或毕业时间要求。 |
| Data.AgeRequirement | string\|null | 年龄要求。 |
| Data.GenderRequirement | string\|null | 性别要求。 |
| Data.HouseholdRequirement | string\|null | 户籍或生源地要求。 |
| Data.QualificationRequirement | string\|null | 资格证书、职称或其他资质要求。 |
| Data.OtherRequirement | string\|null | 其他资格条件。 |
| Data.WorkLocation | string\|null | 工作地点。 |
| Data.SettlementLocation | string\|null | 落户地点。 |
| Data.ExamCategory | string\|null | 考试类别或笔试科目类别。 |
| Data.InterviewRatio | string\|null | 进入面试比例。 |
| Data.ApplicationDeadline | string\|null | 报名截止时间。 |
| Data.SourceUrl | string\|null | 公开信息来源链接。 |
| Data.PublishedAt | string\|null | 公开发布时间。 |
| Data.DataUpdatedAt | string\|null | 平台数据更新时间。 |
| Data.CategoryDetails | object\|null | 按 Category 返回该招录类型对应的扩展字段;无扩展数据时为 null。 |
| Data.CategoryDetails.InstitutionNature | string\|null | 公务员岗位的机构性质。 |
| Data.CategoryDetails.InstitutionLevel | string\|null | 公务员岗位的机构层级。 |
| Data.CategoryDetails.PositionDistribution | string\|null | 公务员岗位分布或职位属性。 |
| Data.CategoryDetails.ProfessionalTestRequired | string\|null | 公务员岗位是否组织专业能力测试。 |
| Data.CategoryDetails.DualDegreeAccepted | string\|null | 公务员岗位是否接受双学位。 |
| Data.CategoryDetails.PsychologicalAssessment | string\|null | 公务员岗位心理测评说明。 |
| Data.CategoryDetails.SupervisorCode | string\|null | 事业单位主管部门代码。 |
| Data.CategoryDetails.SupervisorName | string\|null | 事业单位主管部门名称。 |
| Data.CategoryDetails.PositionGrade | string\|null | 事业单位岗位等级。 |
| Data.CategoryDetails.WrittenExamRequired | string\|null | 事业单位岗位是否需要笔试。 |
| Data.CategoryDetails.InterviewRequired | string\|null | 事业单位岗位是否需要面试。 |
| Data.CategoryDetails.ExamCategoryMinor | string\|null | 事业单位考试细分类别。 |
| Data.CategoryDetails.EmployerSerial | string\|null | 军队文职用人单位序号。 |
| Data.CategoryDetails.SourceCategory | string\|null | 军队文职岗位来源类别。 |
| Data.CategoryDetails.ExamSubject | string\|null | 军队文职专业科目。 |
| Data.CategoryDetails.ContactPhone | string\|null | 军队文职公开咨询电话。 |
| Data.CategoryDetails.ServiceType | string\|null | 三支一扶服务类型,如支教、支农、支医或帮扶乡村振兴。 |
| Data.CategoryDetails.Township | string\|null | 三支一扶服务乡镇。 |
| Data.CategoryDetails.TeacherCertificateRequirement | string\|null | 三支一扶教师资格证要求。 |
| Data.CategoryDetails.PhysicianCertificateRequirement | string\|null | 三支一扶医师资格要求。 |
| Data.CategoryDetails.EnterpriseGroup | string\|null | 国有单位所属企业集团。 |
| Data.CategoryDetails.Subsidiary | string\|null | 国有单位所属子公司。 |
| Data.CategoryDetails.RecruitmentChannel | string\|null | 国有单位招聘渠道。 |
| Data.CategoryDetails.EmploymentType | string\|null | 国有单位招聘或用工类型。 |
| Data.CategoryDetails.Compensation | string\|null | 国有单位公开薪酬说明。 |
## 响应示例(真实数据节选)
```json
{
"DataStatus": {
"RequestParameter": "category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&city=&district=&organizationCode=&positionCode=&organizationKeyword=&positionKeyword=&majorKeyword=&educationKeyword=&pageIndex=1&pageSize=10",
"StatusCode": 100,
"StatusDescription": "请求成功。",
"ResponseDateTime": "2026-08-31 11:38:54.410",
"DataTotalCount": 9384
},
"Data": [
{
"PositionId": "31b3ceba3579c53f78241b99af07d64e3004d5293184a702ba4e0641c17c1d5f",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "黄埔海关技术中心",
"DepartmentName": "植物检疫实验室",
"OrganizationCode": "6210839",
"PositionCode": "2026005980056",
"PositionName": "植物检疫实验室",
"PositionDescription": "从事植物检疫工作。",
"PositionCategory": "专业技术岗位十一级至十三级",
"PlannedHires": 1,
"EducationRequirement": "硕士研究生",
"DegreeRequirement": "硕士",
"MajorRequirement": "植物学(A071001),植物病理学(A090401),农业昆虫与害虫防治(A090402)",
"MajorRequirements": [
{
"MajorCode": "A071001",
"MajorName": null,
"Requirement": "植物学(A071001),植物病理学(A090401),农业昆虫与害虫防治(A090402)"
},
{
"MajorCode": "A090401",
"MajorName": null,
"Requirement": "植物学(A071001),植物病理学(A090401),农业昆虫与害虫防治(A090402)"
},
{
"MajorCode": "A090402",
"MajorName": null,
"Requirement": "植物学(A071001),植物病理学(A090401),农业昆虫与害虫防治(A090402)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": null,
"GraduateRequirement": "应届毕业生",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": null,
"OtherRequirement": "1.大学英语六级考试合格(或425分)及以上; 2.色觉功能正常,不得为色盲或色弱。",
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"SourceUrl": "https://rsj.gz.gov.cn/attachment/7/7965/7965878/10667246.xlsx",
"PublishedAt": null,
"DataUpdatedAt": "2026-08-31 11:38:06.754",
"CategoryDetails": [
[
[
]
],
[
[
]
],
[
[
]
]
]
},
{
"PositionId": "3b312c165aa551461a2a080fb7d738338eeb74e7afcc0f3f85500dd0cf37790d",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "黄埔海关国际旅行卫生保健中心(黄埔海关口岸门诊部)",
"DepartmentName": "业务发展部",
"OrganizationCode": "6210839",
"PositionCode": "2026005980057",
"PositionName": "业务发展部",
"PositionDescription": "从事医学影像检查和诊断工作。",
"PositionCategory": "专业技术岗位十级及以上",
"PlannedHires": 1,
"EducationRequirement": "本科以上",
"DegreeRequirement": "学士以上",
"MajorRequirement": "临床医学(B100301),医学影像学(B100303);影像医学与核医学(A100207),影像医学与核医学硕士(专业硕士)(A100225),超声医学(专业硕士)(A100243)",
"MajorRequirements": [
{
"MajorCode": "A100207",
"MajorName": null,
"Requirement": "临床医学(B100301),医学影像学(B100303);影像医学与核医学(A100207),影像医学与核医学硕士(专业硕士)(A100225),超声医学(专业硕士)(A100243)"
},
{
"MajorCode": "A100225",
"MajorName": null,
"Requirement": "临床医学(B100301),医学影像学(B100303);影像医学与核医学(A100207),影像医学与核医学硕士(专业硕士)(A100225),超声医学(专业硕士)(A100243)"
},
{
"MajorCode": "A100243",
"MajorName": null,
"Requirement": "临床医学(B100301),医学影像学(B100303);影像医学与核医学(A100207),影像医学与核医学硕士(专业硕士)(A100225),超声医学(专业硕士)(A100243)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": "2年以上相关工作经历",
"GraduateRequirement": "不限",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": "中级以上;卫生技术人员;医师",
"OtherRequirement": "1.具有超声波医学专业技术资格,医师执业范围为医学影像和放射治疗; 2.具有2年二级及以上医院超声工作经历; 3.大学英语四级考试合格(或425分)及以上。",
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"SourceUrl": "https://rsj.gz.gov.cn/attachment/7/7965/7965878/10667246.xlsx",
"PublishedAt": null,
"DataUpdatedAt": "2026-08-31 11:38:06.754",
"CategoryDetails": [
[
[
]
],
[
[
]
],
[
[
]
]
]
},
{
"PositionId": "58c1ca355cf6c772c9f4fb253b54e3c47a4a81b8d3fffd1b5d460ba28fe2d617",
"Category": "public_institution",
"CategoryName": "事业单位",
"RecruitmentYear": 2026,
"Province": "广东",
"City": "中央驻粤",
"District": null,
"OrganizationName": "黄埔海关技术中心",
"DepartmentName": "食品化妆品实验室",
"OrganizationCode": "6210839",
"PositionCode": "2026005980055",
"PositionName": "食品化妆品实验室",
"PositionDescription": "从事检验检测、标准研究和科研等工作。",
"PositionCategory": "专业技术岗位十一级至十三级",
"PlannedHires": 2,
"EducationRequirement": "硕士研究生",
"DegreeRequirement": "硕士",
"MajorRequirement": "无机化学(A070301),分析化学(A070302),有机化学(A070303),生物化学与分子生物学(A071010),应用化学(A081704)",
"MajorRequirements": [
{
"MajorCode": "A070301",
"MajorName": null,
"Requirement": "无机化学(A070301),分析化学(A070302),有机化学(A070303),生物化学与分子生物学(A071010),应用化学(A081704)"
},
{
"MajorCode": "A070302",
"MajorName": null,
"Requirement": "无机化学(A070301),分析化学(A070302),有机化学(A070303),生物化学与分子生物学(A071010),应用化学(A081704)"
},
{
"MajorCode": "A070303",
"MajorName": null,
"Requirement": "无机化学(A070301),分析化学(A070302),有机化学(A070303),生物化学与分子生物学(A071010),应用化学(A081704)"
}
],
"PoliticalRequirement": null,
"ExperienceRequirement": null,
"GraduateRequirement": "应届毕业生",
"AgeRequirement": "18-38周岁",
"GenderRequirement": null,
"HouseholdRequirement": null,
"QualificationRequirement": null,
"OtherRequirement": "1.大学英语六级考试合格(或425分)及以上; 2.色觉功能正常,不得为色盲或色弱。",
"WorkLocation": "中央驻粤",
"SettlementLocation": null,
"ExamCategory": null,
"InterviewRatio": null,
"ApplicationDeadline": null,
"SourceUrl": "https://rsj.gz.gov.cn/attachment/7/7965/7965878/10667246.xlsx",
"PublishedAt": null,
"DataUpdatedAt": "2026-08-31 11:38:06.754",
"CategoryDetails": [
[
[
]
],
[
[
]
],
[
[
]
]
]
}
]
}
```
## 接口常见 HTTP 响应状态码
> 以下为接口调用中常见的 HTTP 传输层状态码,不等同于响应体内的业务状态码;完整状态码注册表以 IANA HTTP Status Code Registry 为准。
| 状态码 | 状态码解释 | 备注 |
| --- | --- | --- |
| 200 | 请求成功 | HTTP 请求已成功处理;业务状态请结合响应体中的自定义业务码判断。 |
| 201 | 资源已创建 | 创建类接口请求成功,并已生成对应资源。 |
| 202 | 请求已接受 | 请求已被接受处理,结果可能异步完成。 |
| 204 | 无响应内容 | 请求成功但响应体为空,适用于无需返回数据的操作。 |
| 400 | 请求参数错误 | 请求参数缺失、格式错误或参数组合不合法。 |
| 401 | 认证失败 | 缺少、无效或未通过认证的访问凭证(如 AppKey)。 |
| 403 | 无权限访问 | 订单到期、权限不足或接口额度不可用。 |
| 404 | 资源不存在 | 请求路径不存在。 |
| 405 | 请求方法不允许 | 当前路径不支持该 HTTP 方法。 |
| 408 | 请求超时 | 客户端请求在服务端等待时间内未完成,可稍后重试。 |
| 409 | 请求冲突 | 请求与当前资源状态冲突,调整参数或业务状态后重试。 |
| 413 | 请求内容过大 | 上传文件或请求体超过接口限制。 |
| 414 | 请求地址过长 | 请求 URL 超过服务端可处理长度,建议减少查询参数或改用 POST。 |
| 415 | 请求内容类型不支持 | 上传或请求体的内容类型不符合接口要求。 |
| 422 | 请求语义错误 | 请求格式正确,但参数取值、语义或业务约束无法处理。 |
| 429 | 请求频率受限 | 默认按来源 IP 限速,单 IP 最多 5 QPS,可满足常规业务调用。超出限制时接口会返回 429 请求频率受限;已购买接口订单可加购 10 QPS 扩展。 |
| 431 | 请求头过大 | 请求头字段过大或过多,建议精简 Header 后重试。 |
| 500 | 服务器内部错误 | 服务端处理异常,请稍后重试。 |
| 502 | 服务暂时不可用 | 请稍后重试。 |
| 503 | 服务暂时不可用 | 请稍后重试。 |
| 504 | 请求超时 | 请稍后重试。 |
## 接口自定义业务状态码
| 业务状态码 | 业务状态码解释 | 备注 |
| --- | --- | --- |
| 100 | 正常返回 | 无匹配岗位时 Data 返回空数组。 |
| 501 | 参数错误 | 请检查分类、年份、关键词和分页参数。 |
| 502 | 请求频率受限 | 默认 5 QPS,请按套餐频率调用。 |
| 503 | 订单已到期 | 请检查订单有效期。 |
| 504 | APPKEY 错误 | 请检查 APPKEY 及本接口购买状态。 |
| 505 | 请求次数超限 | 请检查套餐剩余调用次数。 |
| 900 | 接口内部响应错误 | 请稍后重试。 |
| 901 | 数据服务暂时不可用 | 请稍后重试。 |
## cURL 请求示例
```bash
curl --location --request GET 'https://api.gugudata.com/employment/recruitment-positions?appkey=YOUR_APPKEY&category=public_institution&year=2026&province=%e5%b9%bf%e4%b8%9c&organizationKeyword=%e6%95%99%e8%82%b2&educationKeyword=%e6%9c%ac%e7%a7%91&pageIndex=1&pageSize=20&city=&district=&organizationCode=&positionCode=&positionKeyword=&majorKeyword='
```
## 更多请求示例与预览数据
- [事业单位岗位查询](https://www.gugudata.com/preview/6a94ea3f1973dbbcdf49da64)
## 常见问题 Q&A
### Q: 数据多久更新?
A: 不同接口按各自的数据周期更新,具体以接口详情中的更新频率和字段说明为准。
### Q: 如何保证请求时 AppKey 的安全性?
A: 用户可以登录咕咕数据开发者中心,在 `APP KEY 管理` 页面复制对应产品的 AppKey;未开通接口时先进入当前接口的购买开通页,已开通或到期续费时进入开发者中心或订单与续费页。建议将 AppKey 保存在服务端环境中,由后端统一调用 API,再向前端或业务系统返回必要结果。不要把 AppKey 写入网页、App 客户端或公开仓库;生产环境建议按系统或业务线拆分 AppKey,并保留调用日志,便于权限控制、审计与问题排查。
### Q: 接口可以用于哪些开发语言?
A: Java、Python、Node.js、PHP、Go、C#、Swift、Kotlin 等常用语言均可接入。
### Q: 接口性能可以保证吗?
A: 实际响应时间会受接口类型、请求参数和网络环境影响。生产接入前建议完成联调与压测,高并发场景可提前评估 QPS 和专属容量。
## 服务协议以及服务免责声明
- [服务协议](https://www.gugudata.com/license)
- [服务免责声明](https://www.gugudata.com/disclaimer)
## 技术支持
- 技术支持邮箱: support@gugudata.com
- 微信客服: https://work.weixin.qq.com/kfid/kfcf9a60a6afe3337b7