文件处理 / 图片处理，将 PPT 文件转换为图片序列。

1. 产品功能

• 支持将 PPT 文件转换为高质量图片序列；
• 支持 .ppt 和 .pptx 格式；
• 保持原始 PPT 的布局和样式；
• 转换后的图片支持永久访问；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/ppt-to-images

接口地址: https://api.gugudata.com/imagerecognition/ppt-to-images?appkey=YOUR_APPKEY

返回格式: application/json; charset=utf-8

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/imagerecognition/ppt-to-images?appkey=YOUR_APPKEY

数据预览: https://www.gugudata.com/preview/ppt-to-images

接口测试: https://api.gugudata.com/imagerecognition/ppt-to-images/demo

3. 请求参数

4. 返回参数

网站工具 将任意网页 URL 转换为 Markdown 格式文本 网页内容提取 / 网页解析 网站工具 / markdown

1. 产品功能

• 支持任意网页 URL 转换为 Markdown 格式（注意：无法处理具有反爬机制或不合规的网页）；
• 智能提取网页主要内容，过滤无关元素；
• 保持原有文本结构和格式；
• 支持图片、链接等元素的 Markdown 转换；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/url2markdown

接口地址: https://api.gugudata.com/websitetools/url2markdown

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/websitetools/url2markdown?appkey=YOUR_APPKEY&url=https://www.example.com

数据预览: https://www.gugudata.com/preview/url2markdown

接口测试: https://api.gugudata.com/websitetools/url2markdown/demo

3. 请求参数

4. 返回参数

图像/转换 将 PPT 文件转换为 PDF 文档 文件转换 / 超高精度与还原度 文件转换 / PDF 。

1. 产品功能

• 超高精度与还原度的 PDF 文件转换；
• 支持将 PPT 文件转换为 PDF 文档；
• 支持 .ppt 和 .pptx 格式；
• 保持原始 PPT 的布局、字体和样式；
• 转换后的 PDF 文件支持永久访问；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/ppt-to-pdf

接口地址: https://api.gugudata.com/imagerecognition/ppt-to-pdf?appkey={{YOUR_APPKEY}}

返回格式: application/json; charset=utf-8

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/imagerecognition/ppt-to-pdf?appkey={{YOUR_APPKEY}}

数据预览: https://www.gugudata.com/preview/ppt-to-pdf

接口测试: https://api.gugudata.com/imagerecognition/ppt-to-pdf/demo

3. 请求参数

4. 返回参数

目前好用的邮箱服务，带短信通知的有哪些？收费和付费都可以。目前查到 139 邮箱可以，但是限制移动号码。

1. 产品功能

• 提供全球 QS 世界大学排名数据；
• 每个季度定时更新数据；
• 支持按学校名称模糊搜索；
• 包含详细的排名指标和得分信息；
• 支持分页查询；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/global-university-ranking

接口地址: https://api.gugudata.com/metadata/global-university-ranking

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/metadata/global-university-ranking?appkey=YOUR_APPKEY&name=&pageIndex=1&pageSize=10

数据预览: https://www.gugudata.com/preview/global-university-ranking

接口测试: https://api.gugudata.com/metadata/global-university-ranking/demo

3. 请求参数

4. 返回参数

AI / 八字命理 基于八字命理分析 命理分析 / 八字运势。

1. 产品功能

• 基于八字命理以及盲派八字理论解析个人运势；
• 提供详细的大运分析，覆盖学业、婚姻、财运、健康等领域；
• 分析个人运势，包括学业、婚姻、财运、健康等方面的解读；
• 智能解读人生关键节点，帮助用户更好地规划未来；
• 高效计算，实时返回分析结果；
• 数据仅供娱乐和参考；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/bazi-fortune-teller

接口地址: https://api.gugudata.com/ai/bazi-fortune-teller?appkey={{appkey}}

返回格式: application/json; charset=utf-8

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/ai/bazi-fortune-teller?appkey={{appkey}}

数据预览: https://www.gugudata.com/preview/bazi-fortune-teller

接口测试: https://api.gugudata.com/ai/bazi-fortune-teller/demo

3. 请求参数

4. 返回参数

网站工具 / 截图 高效生成网页截图 生成网页截图 / 图片输出。

1. 产品功能

• 支持全页截图和视窗截图；
• 支持自定义截图尺寸；
• 兼容移动设备截图；
• 支持暗黑模式截图；
• 固定参数请求，可以得到最新的站点截图；
• 快速高效的截图生成；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/url2image

接口地址: https://api.gugudata.com/websitetools/url2image

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/websitetools/url2image?appkey=YOUR_APPKEY&url=YOUR_VALUE&width=250&height=250&viewportWidth=1080&viewportHeight=1080&forceReload=false&isMobile=false&isFullPage=false&isDarkMode=false

数据预览: https://www.gugudata.com/preview/url2image

接口测试: https://api.gugudata.com/websitetools/url2image/demo

3. 请求参数

4. 返回参数

网站工具 / HTML 高效转换 URL 到静态 HTML 生成静态 HTML 站点 / 永久存储。

1. 产品功能

支持非 SPA 网站内容转换； 超高的还原度与转换性能； 站点资源压缩到一个单一的文件； 输出 HTML 文件永久 CDN 存储地址； 输出可直接访问的 HTML 站点文件；

• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/url2html

接口地址: https://api.gugudata.com/websitetools/url2html

返回格式: application/json; charset=utf-8

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/websitetools/url2html

数据预览: https://www.gugudata.com/preview/url2html

接口测试: https://api.gugudata.com/websitetools/url2html/demo

3. 请求参数

4. 返回参数

文件处理 / PDF 高效 PDF 转 HTML 工具 生成 HTML 站点 / 可永久存储。

1. 产品功能

• 高效处理大文件；
• 支持多语言字符识别；
• 支持 formdata 格式 PDF 文件流传参；
• 输出文件永久 CDN 存储；
• 输出可直接访问的 HTML 站点；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/pdf2html

接口地址: https://api.gugudata.com/imagerecognition/pdf2html?appkey={{appkey}}

返回格式: application/json; charset=utf-8

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/imagerecognition/pdf2html?appkey={{appkey}}

数据预览: https://www.gugudata.com/preview/pdf2html

接口测试: https://api.gugudata.com/imagerecognition/pdf2html/demo

3. 请求参数

4. 返回参数

比如输入 {"https://ooo.0x0.ooo/2024/10/28/OD3TzB.png", "发布按钮"}

返回 (517,880)

支持网页转 PDF 。

1. 产品功能

• 超高性能转换效率；
• 支持将传递的 HTML 转换为 PDF ，支持转换 HTML 中的 CSS 格式；
• 支持传递网站 URL ，直接转换页面成对应的 PDF 文件；
• 转换后的 PDF 提供永久存储文件地址；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡。

2. API 文档

API 详情地址: https://www.gugudata.com/api/details/html2pdf

接口请求地址: https://api.gugudata.com/imagerecognition/html2pdf

返回格式: application/json; charset=utf-8

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/imagerecognition/html2pdf

数据预览: https://www.gugudata.com/preview/html2pdf

接口测试: https://api.gugudata.com/imagerecognition/html2pdf/demo

3. 请求参数

4. 返回参数

基于 AI 的相似度评估，专有 AI 模型，包含评估详情 。

1. 产品功能

• 基于自有专业模型进行 AI 智能分析；
• 提供详细的相似度评分和结果描述；
• 高效的模型分析性能；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/exam-question-similarity

接口地址: https://api.gugudata.com/education/exam-question-similarity

返回格式: application/json; charset=utf-8

请求方式: POST

请求协议: HTTPS

请求示例: https://api.gugudata.com/education/exam-question-similarity

数据预览: https://www.gugudata.com/preview/exam-question-similarity

接口测试: https://api.gugudata.com/education/exam-question-similarity/demo

3. 请求参数

4. 返回参数

基础数据 / 高校招生，各高校历年招生计划数据，高校招生数据 / 历年计划。

1. 产品功能

• 支持历年高校招生计划数据查询；
• 包含各高校招生计划详细数据；
• 多维度查询条件支持；
• 毫秒级查询性能；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/collegeenrollmentplan

接口地址: https://api.gugudata.com/metadata/college-enrollment-plan

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/metadata/college-enrollment-plan?appkey={{YOUR_APPKEY}}&collegemajorname={{}}&year={{}}&pageIndex={{1}}&pageSize={{10}}&schoolname={{}}&provincename={{}}&classOne={{}}&classtwo={{}}&batchname={{}}&type={{}}

数据预览: https://www.gugudata.com/preview/collegeenrollmentplan

接口测试: https://api.gugudata.com/metadata/college-enrollment-plan/demo

3. 请求参数

4. 返回参数

但是 这时分发 jwt 的接口。怎么避免一直被搞？

想把异常请求直接拦截到外面，尽量不让异常请求落地到服务器上。

目前是套了腾讯云的 cdn 当反代用,不缓存每次都回源。cdn 上限制的单 ip qps （阿里云那边好像只能用 WAF 有点复杂..），还有别的办法不？

已登陆用户 的接口走了阿里云的函数计算，用的函数计算的 jwt 认证。 异常请求，直接在 redis 建了一个黑名单，再通知 jwt 分发接口禁止新发，等 jwt 失效就噶掉。

各位大佬们，要是有知道提供 API 网站的麻烦告知一下小弟，付费和免费的都行，谢谢大佬们了。。。

欢迎使用全国大学高校专业数据 API 接口！我们为您提供全面的大学专业基础数据，持续更新，覆盖各类专业属性。无论您是教育机构、学术研究者还是开发者，我们的 API 接口都能满足您的需求。

1. 产品功能

• 数据已更新至 2023 年，提供最新的全国高校专业基本信息；
• 数据库中拥有近 3000 条专业的精准基础数据，包含全国各大高校。您可以根据学历层次、学科门类、学科专业类等维度进行筛选；
• 每月一次数据更新校正，确保数据的准确性和时效性。我们与各高校保持密切合作，及时更新最新的专业信息；
• 提供专业开设课程列表，让您了解专业课程设置和难度。您可以查看每门课程的名称和难度等相关信息；
• 所有接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）协议，确保数据传输的安全性。您可以放心地进行数据请求和传输；
• 完全兼容 Apple ATS ，适配各类苹果设备和应用。无论您是在 iOS 、macOS 或其他苹果平台上使用，都能顺利访问和使用我们的 API ；
• 部署了全国多节点 CDN ，保证数据传输速度和稳定性。不论您身处何地，都能享受到快速、稳定的数据访问体验；
• API 接口采用多台服务器构建负载均衡，极速响应请求。我们通过负载均衡技术，实现高效的请求处理和快速的响应速度。

2. API 文档

API 详情地址

https://www.gugudata.com/api/details/ceemajor

接口请求地址

https://api.gugudata.com/metadata/ceemajor

返回格式

application/json; charset=utf-8

请求方式

GET

请求协议

HTTPS

请求示例

https://api.gugudata.com/metadata/ceemajor?appkey=YOUR_APPKEY&keywords=YOUR_VALUE&pagesize=10&pageindex=1

接口测试

https://www.gugudata.com/preview/ceemajor

3. 请求参数

以下是接口的请求参数及其说明：

4. 返回参数

以下是接口的返回参数及其说明：

前两天还和朋友说有道 API 真良心，送的钱都用不完。实际上我目前是 Alfred 自用。我不介意充值 100 ，虽然可能这辈子都用不完。但是文档没说明，客服一副拽死的态度，我是觉得略微懵逼。

有解决过这个问题的老哥么？告诉我得冲多少？

01 关于 Authing

Authing 是国内首款以开发者为中心的全场景身份云产品，集成了所有主流身份认证协议，为企业和开发者提供完善安全的用户认证和访问管理服务。以「 API First 」作为产品基石，把身份领域所有常用功能都进行了模块化的封装，通过全场景编程语言 SDK 将所有能力 API 化提供给开发者。同时，用户可以灵活的使用 Authing 开放的 RESTful APIs 进行功能拓展，满足不同企业不同业务场景下的身份和权限管理需求。

02 关于 APISIX

Apache APISIX 是一个动态、实时、高性能的 API 网关，提供负载均衡、动态上游、灰度发布、服务熔断、身份认证、可观测性等丰富的流量管理功能。Apache APISIX 不仅支持插件动态变更和热插拔，而且拥有众多实用的插件。Apache APISIX 的 OpenID Connect 插件支持 OpenID Connect 协议，用户可以使用该插件让 Apache APISIX 对接 Authing 服务，作为集中式认证网关部署于企业中。

03 业务目标

通过 Authing 权限管理 + APISIX 实现 API 的访问控制

04 如何实现

本文所涉及到的代码已经上传到 Github

Python 插件： https://github.com/fehu-asia/authing-apisix-python-agent

Java Adapter: https://github.com/fehu-asia/authing-apisix-java-adapter

Java 插件： https://github.com/fehu-asia/authing-apisix-java-agent

4.1 业务架构

系统整体包含了三大部分：Authing 服务集群、Authing 插件适配服务以及 APISIX 网关，本方案建立需要配置和开发的部分有四个部分，Authing API 权限结构配置、APISIX 插件和路由配置、APISIX 插件开发部署以及业务适配服务开发，其中业务适配服务包含了认证和授权的主要逻辑(使用单独服务承载)，避免了插件的频繁更新和部署。

这里需要说明的是，之所以采用 Adapter 的方式来实现，是因为插件我们并不希望经常变动，但需求可能是无法避免的需要经常变动，所以我们将具体的鉴权逻辑放在 Adapter ，插件只实现请求转发和根据 Adapter 的返回结果决定是否放行，同时无状态的插件可以让我们实现更多的场景复用和能力扩展，例如进行鉴权结果的缓存实现，后续只需维护 Adapter 即可。

当然我们也可将具体的逻辑放在插件里。

注意，本教程只用于与 APISIX 和 Authing 进行集成，对于生产环境使用，您需要自行开发插件并保证其安全性及可用性等，本文档不承诺此插件可以用于生产环境。

• APISIX 基础环境搭建

git clone https://github.com/apache/apisix-docker.git cd apisix-docker/example docker-compose -p docker-apisix up -d 

到这里可以使用 docker ps 查看 apisix docker 进程启动状态， 随后访问 localhost:9000 可以进入 dashboard 界面进行路由和插件的配置。

4.2 在 Authing 对 API 进行管理

登录 Authing 官网：www.authing.com ，进行以下操作：

• 4.2.1 创建应用

配置 Token 签名算法为 RS256 及校验 AccessToken 的方式为 none 。

• 4.2.2 创建用户

进入 Authing 控制台-用户管理-用户列表-点击创建用户后，可以根据不同方式（用户名、手机号、邮箱）创建测试用户，如下图所示：

• 4.2.3 创建 API

进入 Authing 控制台-权限管理-创建资源，可以选择创建树数据类型的资源，如下图所示：

• 4.2.4 创建策略

进入权限管理-数据资源权限-数据策略标签，可以点击创建策略来新建数据访问策略，如下图所示。策略包含了对应的权限空间中定义的数据以及操作，创建后能够基于此策略对不同对象(用户、角色、用户组等)进行授权管理。

• 4.2.5 API 授权

4.3 APISIX 路由和 SOCK 配置

• 4.3.1 SOCK 配置

APISIX 使用 unix sock 与插件进程通信，因此需要配置对应的 sock 端口：

需要将宿主机上的 sock 文件挂载到容器里，插件启动的时候会在宿主机上创建这个 sock 文件，此处需要注意的是，若 APISIX 是先于插件启动的，当插件启动后，则需要重启下 APISIX 容器，确保插件先于 APISIX 启动。

文件位置： /apisix-docker/example/docker-compose.yml apisix 部分

 apisix: image: apache/apisix:latest restart: always volumes: - ./apisix_log:/usr/local/apisix/logs - ./apisix_conf/config.yaml:/usr/local/apisix/conf/config.yaml:ro - /tmp/runner.sock:/tmp/runner.sock 

• 4.3.2 路由配置

X-API-KEY： /apisix/apisix-docker/example/apisix_conf/config.yaml

curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d ' { "uri": "/*", "plugins": { "ext-plugin-pre-req": { "conf": [ { "name": "authing_agent", "value": "{\"url\": \"{适配服务的访问地址}\",\"user_pool_id\": \"{用户池 ID}\",\"user_pool_secret\": \"{用户池密钥}\"}" } ] } }, "upstream": { "type": "roundrobin", "nodes": { "httpbin.org:80": 1 } } }' 

ext-plugin-pre-req 是需要启用的插件类型, 在配置 conf 中需要确定两个变量：

"name": 插件名称
"value": "{"url": "适配服务的访问地址","user_pool_id": "用户池 ID","user_pool_secret": "用户池密钥"}"

其中，访问地址格式为 {{domain}}:{{port}}/{{path}}

例如： "{"url": "http://192.168.1.123:8080/isAllow","user_pool_id": "124u2353h2t24he2u349382u152","user_pool_secret": "6435462313i5412njburh2u34"}"

4.4 APISIX 插件开发和部署

• 4.4.1 建立插件工程目录

git clone https://github.com/apache/apisix-python-plugin-runner.git 进入目录 make setup 进入目录 make install 进入目录并修改 apisix/plugins/rewrite.py 文件，将请求参数传递到 Authing

• 4.4.2 编写 Agent (python) 插件代码

可使用其他语言实现例如 Java 、Go 、Lua

之所以采用 Python 的原因是因为环境初始化比较简单，可以让开发者快速了解 APISIX 的插件的开发机制。

https://apisix.apache.org/docs/apisix/external-plugin/

from typing import Any from apisix.runner.http.request import Request from apisix.runner.http.response import Response from apisix.runner.plugin.core import PluginBase import json import requests import json def isAllow(request,config): return requests.request("POST", config.get("url"), headers={ 'Content-Type': 'application/json' }, data=json.dumps({ "request": request, "pluginConfig": config })) class Rewrite(PluginBase): def name(self) -> str: return "authing_agent" def config(self, conf: Any) -> Any: return conf def filter(self, conf: Any, request: Request, response: Response): # 组装 Adapter 请求参数 authing_request = { "uri": request.get_uri(), "method": request.get_method(), "args":request.get_args(), "headers":request.get_headers(), "request_id":request.get_id(), "host":request.get_var("host"), "remote_addr": request.get_remote_addr(), "configs": request.get_configs() } # 接收 Adapter 响应判断是否放行 authing_respOnse= isAllow(authing_request,eval(conf)) if authing_response.text != "ok": response.set_status_code(authing_response.status_code) response.set_body(authing_response.text) 

• 4.4.3 运行 Agent 插件

nohup make dev & #后台运行 agent 程序 

4.5 适配器开发

• 4.5.1 通信接口设计

启动代理 Authing 服务（自行实现对应接口，以 springboot 为例，接口结构如下）

• 4.5.2 部分 JAVA 文件列出如下

IsAllowController.java

package cn.authing.apisix.adapter.controller; import cn.authing.apisix.adapter.entity.APISIXRquestParams; import cn.authing.sdk.java.client.ManagementClient; import cn.authing.sdk.java.dto.CheckPermissionDto; import cn.authing.sdk.java.dto.CheckPermissionRespDto; import cn.authing.sdk.java.dto.CheckPermissionsRespDto; import cn.authing.sdk.java.model.ManagementClientOptions; import cn.hutool.http.HttpStatus; import cn.hutool.http.HttpUtil; import com.google.gson.Gson; import com.nimbusds.jose.JOSEException; import com.nimbusds.jose.JWSAlgorithm; import com.nimbusds.jose.JWSObject; import com.nimbusds.jose.jwk.source.JWKSource; import com.nimbusds.jose.jwk.source.RemoteJWKSet; import com.nimbusds.jose.proc.BadJOSEException; import com.nimbusds.jose.proc.JWSKeySelector; import com.nimbusds.jose.proc.JWSVerificationKeySelector; import com.nimbusds.jose.proc.SecurityContext; import com.nimbusds.jwt.JWTClaimsSet; import com.nimbusds.jwt.proc.ConfigurableJWTProcessor; import com.nimbusds.jwt.proc.DefaultJWTProcessor; import jakarta.servlet.http.HttpServletResponse; import lombok.extern.slf4j.Slf4j; import org.springframework.util.StopWatch; import org.springframework.util.StringUtils; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RestController; import java.net.MalformedURLException; import java.net.URL; import java.text.ParseException; import java.util.Arrays; import java.util.HashMap; import java.util.List; import java.util.Map; /** * @author Gao FeiHu * @version 1.0.0 * @date 2022.12.22 * @email gaofeihu@authing.cn */ @RestController @Slf4j public class IsAllowController { /** * 用户池 ID */ public static String ACCESS_KEY_ID = ""; /** * 用户池密钥 */ public static String ACCESS_KEY_SECRET = ""; /** * Authing SDK * See * https://docs.authing.cn/v3/reference/ */ ManagementClient managementClient; /** * 初始化 ManagementClient * * @param ak 用户池 ID * @param aks 用户池密钥 */ public void init(String ak, String aks) { log.info("init ManagementClient ......"); try { // 保存用户池 ID 和密钥 ACCESS_KEY_ID = ak; ACCESS_KEY_SECRET = aks; // 初始化 ManagementClientOptions optiOns= new ManagementClientOptions(); options.setAccessKeyId(ak); options.setAccessKeySecret(aks); managementClient = new ManagementClient(options); } catch (Exception e) { e.printStackTrace(); System.err.println("初始化 managementClient 失败，可能无法请求！"); } } /** * 是否放行 * * @param apisixRquestParams 请求 body ，包含了 APISIX 插件的配置以及请求上下文 * @param response HttpServletResponse * @return 200 OK 放行 * 403 forbidden 禁止访问 * 500 internal server error 请求错误 可根据实际需求放行或拒绝 */ @PostMapping("/isAllow") public Object isAllow(@RequestBody APISIXRquestParams apisixRquestParams, HttpServletResponse response) { // 请求计时器 StopWatch stopWatch = new StopWatch(); stopWatch.start(); // 请求 ID 与 APISIX 一致 String requestID = apisixRquestParams.getRequest().getRequest_id(); log.info("{} ==> 请求入参 : {} ", requestID, new Gson().toJson(apisixRquestParams)); try { // 0. 若插件为多实例用于实现不同业务逻辑，此处可对应修改为多实例模式 if (managementClient == null || !ACCESS_KEY_ID.equals(apisixRquestParams.getPluginConfig().get("user_pool_id"))) { init((String) apisixRquestParams.getPluginConfig().get("user_pool_id"), (String) apisixRquestParams.getPluginConfig().get("user_pool_secret")); } // 1. 拿到 accessToken String authorization = (String) apisixRquestParams.getRequest().getHeaders().get("authorization"); if (!StringUtils.hasLength(authorization)) { return result(response, stopWatch, requestID, HttpStatus.HTTP_UNAUTHORIZED, "HTTP_UNAUTHORIZED"); } String accessToken = authorization; if (authorization.startsWith("Bearer")) { accessToken = authorization.split(" ")[1].trim(); } log.info("{} ==> accessToken : {} ", requestID, accessToken); // 2. 解析 accessToken 拿到应用 ID 和用户 ID JWSObject parse = JWSObject.parse(accessToken); Map<String, Object> payload = parse.getPayload().toJSONObject(); String aud = (String) payload.get("aud"); String sub = (String) payload.get("sub"); // 3. 校验 accessToken // 在线校验 String result = onlineValidatorAccessToken(accessToken, aud); log.info("{} ==> accessToken 在线结果 : {} ", requestID, result); if (!result.contains("{\"active\":true")) { return result(response, stopWatch, requestID, HttpStatus.HTTP_UNAUTHORIZED, "HTTP_UNAUTHORIZED"); } // // 离线校验 // if (null == offlineValidatorAccessToken(accessToken, aud)) { // return result(response, stopWatch, requestID, HttpStatus.HTTP_UNAUTHORIZED, "HTTP_UNAUTHORIZED"); // } // 4. 获取到 APISIX 中的请求方法，对应 Authing 权限中的 action String action = apisixRquestParams.getRequest().getMethod(); // 5. 获取到 APISIX 中的请求路径 String resource = apisixRquestParams.getRequest().getUri(); // 6. 去 Authing 请求，判断是否有权限 // TODO 可在此添加 Redis 对校验结果进行缓存 CheckPermissionDto reqDto = new CheckPermissionDto(); reqDto.setUserId(sub); reqDto.setNamespaceCode(aud); reqDto.setResources(Arrays.asList(resource.substring(1, resource.length()))); reqDto.setAction(action); CheckPermissionRespDto checkPermissiOnRespDto= managementClient.checkPermission(reqDto); log.info(new Gson().toJson(checkPermissionRespDto)); // 7. 由于我们是单个 resource 校验，所以只需要判断第一个元素即可 List<CheckPermissionsRespDto> resultList = checkPermissionRespDto.getData().getCheckResultList(); if (resultList.isEmpty() || resultList.get(0).getEnabled() == false) { return result(response, stopWatch, requestID, HttpStatus.HTTP_FORBIDDEN, "HTTP_FORBIDDEN"); } return result(response, stopWatch, requestID, HttpStatus.HTTP_OK, "ok"); } catch (Exception e) { e.printStackTrace(); log.error("请求错误！", e); return result(response, stopWatch, requestID, HttpStatus.HTTP_INTERNAL_ERROR, e.getMessage()); } } public String result(HttpServletResponse response, StopWatch stopWatch, String requestID, int status, String msg) { stopWatch.stop(); log.info("{} ==> 请求耗时：{} , 请求出参 : http_status_code={},msg={} ", requestID, stopWatch.getTotalTimeMillis() + "ms", status, msg); response.setStatus(status); return msg; } public String onlineValidatorAccessToken(String accessToken, String aud) { HashMap<String, Object> paramMap = new HashMap<>(); paramMap.put("token", accessToken); paramMap.put("token_type_hint", "access_token"); paramMap.put("client_id", aud); return HttpUtil.post("https://api.authing.cn/" + aud + "/oidc/token/introspection", paramMap); } public JWTClaimsSet offlineValidatorAccessToken(String accessToken, String aud) { try { ConfigurableJWTProcessor<SecurityContext> jwtProcessor = new DefaultJWTProcessor<>(); JWKSource<SecurityContext> keySource = null; keySource = new RemoteJWKSet<>(new URL("https://api.authing.cn/" + aud + "/oidc/.well-known/jwks.json")); JWSAlgorithm expectedJWSAlg = JWSAlgorithm.RS256; JWSKeySelector<SecurityContext> keySelector = new JWSVerificationKeySelector<>(expectedJWSAlg, keySource); jwtProcessor.setJWSKeySelector(keySelector); return jwtProcessor.process(accessToken, null); } catch (MalformedURLException e) { e.printStackTrace(); } catch (ParseException e) { e.printStackTrace(); } catch (BadJOSEException e) { e.printStackTrace(); } catch (JOSEException e) { e.printStackTrace(); } finally { return null; } } } 

APISIXRquestParams.java

package cn.authing.apisix.adapter.entity; import lombok.Data; import lombok.ToString; import java.util.Map; /** * APISIX 请求实体类 */ @Data @ToString public class APISIXRquestParams { /** * APISIX 请求上下文 */ APISIXRequest request; /** * 插件配置 */ Map<String, Object> pluginConfig; } 

APISIXRequest.java

package cn.authing.apisix.adapter.entity; import lombok.Data; import lombok.ToString; import java.util.Map; @Data @ToString public class APISIXRequest { private String uri; private String method; private String request_id; private String host; private String remote_addr; private Map<String, Object> args; private Map<String, Object> headers; private Map<String, Object> configs; } 

4.6 访问测试

• 4.6.1 未认证

• 4.6.2 无权限

• 4.6.3 认证通过并成功访问

404 是因为上游服务没有这个接口，但认证和 API 鉴权已经通过

05 总结

如果您需要对 API 进行细颗粒度的管理可以通过本方案来实现，我们可以在 Adapter 实现更加细粒度的 API 访问控制以及更加场景化的权限方案。

01 关于 Authing

Authing 是国内首款以开发者为中心的全场景身份云产品，集成了所有主流身份认证协议，为企业和开发者提供完善安全的用户认证和访问管理服务。以「 API First 」作为产品基石，把身份领域所有常用功能都进行了模块化的封装，通过全场景编程语言 SDK 将所有能力 API 化提供给开发者。同时，用户可以灵活的使用 Authing 开放的 RESTful APIs 进行功能拓展，满足不同企业不同业务场景下的身份和权限管理需求。

02 关于 APISIX

Apache APISIX 是一个动态、实时、高性能的 API 网关，提供负载均衡、动态上游、灰度发布、服务熔断、身份认证、可观测性等丰富的流量管理功能。Apache APISIX 不仅支持插件动态变更和热插拔，而且拥有众多实用的插件。Apache APISIX 的 OpenID Connect 插件支持 OpenID Connect 协议，用户可以使用该插件让 Apache APISIX 对接 Authing 服务，作为集中式认证网关部署于企业中。

03 业务目标

通过 Authing 权限管理 + APISIX 实现 API 的访问控制。

案例：我们希望用户在 Authing 进行认证后访问到被授权的 API 。 ( https://console.authing.cn/api/v2/get_console_context ）

04 如何实现

注意，本教程只用于与 APISIX 和 Authing 进行集成测试。后续我们将发布《 Authing 结合 APISIX 实现统一可配置 API 权限网关（插件开发版）》。

4.1 业务架构

4.2 先决条件

需要自行提前安装，docker 和 docker-compose 。

4.3 APISIX & Authing Plugin 基础环境搭建

• 下载编排文件

wget https://raw.githubusercontent.com/fehu-asia/authing-apisix-docker-compose/main/apisix-authing.tgz --no-check-certificate 

• cd 到压缩包所在目录执行如下命令

tar -zxvf apisix-authing.tgz -C / && cd /apisix && docker-compose -p docker-apisix up -d 

到这里可以使用 docker ps 查看 apisix docker 进程启动状态， 随后访问 {your server IP}:9000 可以进入 dashboard 界面进行路由和插件的配置。

4.4 在 Authing 对 API 进行管理

Authing 官网：www.authing.com 。或点击文章底部阅读原文。

• 创建应用

配置 Token 签名算法为 RS256 及校验 AccessToken 的方式为 none 。

• 创建用户

进入 Authing 控制台-用户管理-用户列表-点击创建用户后，可以根据不同方式（用户名、手机号、邮箱）创建测试用户，如下图所示：

• 创建 API

进入 Authing 控制台-权限管理-创建资源，可以选择创建树数据类型的资源，如下图所示：

添加相关操作，这里我们的操作对应 HTTP 的请求方法：

• 创建策略

进入权限管理-数据资源权限-数据策略标签，可以点击创建策略来新建数据访问策略，如下图所示。策略包含了对应的权限空间中定义的数据以及操作，创建后能够基于此策略对不同对象(用户、角色、用户组等)进行授权管理。

• API 授权

4.5 添加路由

• 路由配置

在 APISIX 宿主机上执行。

注意，需要替换请求参数中的用户池 ID 以及密钥。

curl http://127.0.0.1:9180/apisix/admin/routes/1 -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d ' { "uri": "/*", "name": "authing_router", "plugins": { "ext-plugin-pre-req": { "allow_degradation": false, "conf": [ { "name": "authing_agent", "value": "{\"url\": \"http://authing-adapter:18080/isAllow\",\"user_pool_id\": \"{用户池 ID}\",\"user_pool_secret\": \"{用户池密钥}\"}" } ], "disable": false } }, "upstream": { "nodes": [ { "host": "console.authing.cn", "port": 443, "weight": 1 } ], "timeout": { "connect": 6, "send": 6, "read": 6 }, "type": "roundrobin", "scheme": "https", "pass_host": "node", "keepalive_pool": { "idle_timeout": 60, "requests": 1000, "size": 320 } }, "status": 1 }' 

upstream 我们在这里使用的是 httpbin.org ，httpbin.org 是一个简单的在线提供 HTTP 服务的网站，您可以将其用于测试，您也可以将其修改为自己的实际 API 服务地址。

X-API-KEY 所在位置：/apisix/apisix_conf/config.yaml

若您修改了此字段则需要在 curl 请求中进行修改：

4.6 访问测试

目标：当用户认证并携带有效的 AccessToken 且访问的 uri 是被授权的，方可正常调用 API 。

• 获取 accessToken

让我们先去 Authing 的应用进行认证，获取被授权用户的 accessToken 。

复制这个 access_token 接下来测试会用到。

• 未认证

curl --location --request GET 'http://{服务器 IP}:9080/xxxx' 

• 无权限

curl --location --request GET 'http://{服务器 IP}:9080/xxxx' \ --header 'Authorization: Bearer {accessToken}' 

• 认证通过并成功访问

curl --location --request GET 'http://{服务器 IP}:9080/api/v2/get_console_context' \ --header 'Authorization: Bearer {accessToken}' 

05 未来可期

在此方案基础上我们也可以实现统一的安全审计、用户行为轨迹分析、用户访问风险评估等，用以实现全链路 API 访问治理。

因为 ERP 这边有要求不要直接对接其他系统，中间件需要做一些接口的数据转换加工工作，求推荐点技术思路。。

最好是 Java 或者 Python 的

文档链接： https://api-ltc1.doc.coding.io/

有疑问或者问题可以发评论区

提供全国大学高校基础信息。

1. 产品功能

• 提供最新的全国学院基本信息以及招生数据；
• 总计近 3000 条全国高校精准数据；
• 每月一次更新校正数据；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

API 详情地址: https://www.gugudata.com/api/details/college

接口请求地址: https://api.gugudata.com/location/college

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/location/college?appkey=YOUR_APPKEY&keywords=YOUR_VALUE&pagesize=10&pageindex=1&keywordstrict=false&collegecategory=

接口测试: https://api.gugudata.com/location/college/demo

3. 请求参数

4. 返回参数

5. 接口 HTTP 响应标准状态码

6. 接口响应状态码

7. 开发语言请求示例代码

示例代码包含的开发语言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他语言进行对应的 RESTful API 请求实现即可。

8. 常见问题 Q&A

• Q: 数据请求有缓存吗？

  A: 所有的数据都是直接返回的，部分周期性数据在更新周期内数据是缓存的。

• Q: 如何保证请求时 key 的安全性？

  A: 一般建议将对我们 API 的请求放置在您应用的后端服务中发起，您应用的所有前端请求都应该指向您自己的后端服务，这样的架构也更加地纯粹且易维护。

• Q: 接口可以用于哪些开发语言？

  A: 可以使用于所有可以进行网络请求的开发语言，用于您项目快速地进行数据构建。

• Q: 接口的性能可以保证吗？

  A: 接口后台架构和我们给企业提供的商业项目架构一致，您可以通过访问测试接口查看接口相关返回性能与信息。

咕咕数据，专业的数据提供商，提供专业全面的数据接口、商业数据分析，让数据成为您的生产原料。

咕咕数据基于我们七年来为企业客户提供的千亿级数据存储与性能优化、相关海量基础数据支撑，将合规的部分通用数据、通用功能抽象成产品级数据 API ，大大满足了用户在产品开发过程中对基础数据的需求，同时降低了海量数据的存储与运维成本，以及复杂功能的技术门槛与人力开发成本。

除了我们已开放的分类数据与功能接口外，还有海量数据正在整理、清洗、整合、构建中，后期会开放更多的数据与云端功能接口 API 供用户使用。

目前已开放的数据接口 API

• [条码工具] 通用二维码生成
• [条码工具] Wi-Fi 无线网二维码生成
• [条码工具] 通用条形码生成
• [图像识别] 通用 OCR
• [图像识别] HTML 转 PDF
• [图像识别] HTML 转 Word
• [区域 /坐标] 全国大学高校基础信息
• [区域 /坐标] 地理坐标逆编码
• [区域 /坐标] IP 地址定位
• [区域 /坐标] 全国省市区街道区域信息
• [区域 /坐标] 地理坐标系转换
• [元数据 /字典] 历年高考省录取分数线
• [元数据 /字典] 历年高考高校录取分数线
• [元数据 /字典] 历年高考专业录取分数线
• [新闻 /资讯] 软件开发技术博文头条
• [新闻 /资讯] 获取任意链接文章正文
• [新闻 /资讯] 公众号头条文章
• [新闻 /资讯] 获取任意链接正文图片
• [新闻 /资讯] 获取公众号文章封面
• [新闻 /资讯] 幽默笑话大全
• [短信 /语音] 手机归属地查询
• [文字 /文本] 中文文本分词
• [文字 /文本] 中英文排版规范化
• [文字 /文本] 百万中国对联数据
• [文字 /文本] 国际标准书号 ISBN
• [文字 /文本] 简体繁体互转
• [文字 /文本] 唐诗宋词大全
• [文字 /文本] 关键字摘要智能提取
• [天气 /空气质量] 全国天气预报信息
• [天气 /空气质量] 全国实时空气质量指数
• [网站工具] 获取任意站点标题与图标
• [股票行情] 美股实时行情数据
• [股票行情] 美股历史行情数据
• [股票行情] 美股分时交易数据
• [股票行情] 美股历年基本财务数据
• [股票行情] 港股实时行情数据
• [股票行情] 港股历史行情数据
• [股票行情] 港股分时交易数据
• [股票行情] 港股上市公司公告
• [股票行情] 港股历年三大财务报表
• [股票行情] A 股实时行情数据
• [股票行情] A 股历史行情数据
• [股票行情] A 股分时交易数据
• [股票行情] A 股历年三大财务报表
• [股票行情] 中国股票指数数据
• [股票行情] A 股个股信息查询
• [股票行情] A 股历年财务指标
• [股票行情] 期权实时行情数据
• [股票行情] 科创板历史行情数据
• [股票行情] 美股粉单实时行情数据
• [股票行情] 分类美股实时行情数据
• [股票行情] 公募开放式基金实时数据
• [股票行情] 公募开放式基金历史数据
• [股票行情] 场内交易基金实时数据
• [股票行情] 场内交易基金历史数据
• [体育 /比赛] 历年奥运比赛数据

图书 ISBN 查询，图书基础信息，永久图书封面。

1. 产品功能

• 最全图书 ISBN 信息查询；
• 返回详细图书基础信息；
• 永久提供图书封面图片存储；
• 新数据秒级返回；
• 数据持续更新与维护；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡；
• 接口调用状态与状态监控

2. API 文档

接口详情: https://www.gugudata.com/api/details/isbn

接口地址: https://api.gugudata.com/text/isbn

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/text/isbn?appkey=YOUR_APPKEY&isbn=YOUR_VALUE

数据预览: https://www.gugudata.com/preview/isbn

接口测试: https://api.gugudata.com/text/isbn/demo

3. 请求参数

4. 返回参数

5. 接口响应状态码

6. 开发语言请求示例代码

示例代码包含的开发语言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他语言进行对应的 RESTful API 请求实现即可。

7. 常见问题 Q&A

• Q: 数据请求有缓存吗？

  A: 所有的数据都是直接返回的，部分周期性数据在更新周期内数据是缓存的。

• Q: 如何保证请求时 key 的安全性？

  A: 一般建议将对我们 API 的请求放置在您应用的后端服务中发起，您应用的所有前端请求都应该指向您自己的后端服务，这样的架构也更加地纯粹且易维护。

• Q: 接口可以用于哪些开发语言？

  A: 可以使用于所有可以进行网络请求的开发语言，用于您项目快速地进行数据构建。

• Q: 接口的性能可以保证吗？

  A: 接口后台架构和我们给企业提供的商业项目架构一致，您可以通过访问测试接口查看接口相关返回性能与信息。

咕咕数据，专业的数据提供商，提供专业全面的数据接口、商业数据分析，让数据成为您的生产原料。

咕咕数据基于我们七年来为企业客户提供的千亿级数据存储与性能优化、相关海量基础数据支撑，将合规的部分通用数据、通用功能抽象成产品级数据 API ，大大满足了用户在产品开发过程中对基础数据的需求，同时降低了海量数据的存储与运维成本，以及复杂功能的技术门槛与人力开发成本。

除了我们已开放的分类数据与功能接口外，还有海量数据正在整理、清洗、整合、构建中，后期会开放更多的数据与云端功能接口 API 供用户使用。

目前已开放的数据接口 API

• [条码工具] 通用二维码生成
• [条码工具] Wi-Fi 无线网二维码生成
• [条码工具] 通用条形码生成
• [图像识别] 通用 OCR
• [图像识别] HTML 转 PDF
• [图像识别] HTML 转 Word
• [区域 /坐标] 全国大学高校基础信息
• [区域 /坐标] 地理坐标逆编码
• [区域 /坐标] IP 地址定位
• [区域 /坐标] 全国省市区街道区域信息
• [区域 /坐标] 地理坐标系转换
• [元数据 /字典] 历年高考省录取分数线
• [元数据 /字典] 历年高考高校录取分数线
• [元数据 /字典] 历年高考专业录取分数线
• [新闻 /资讯] 软件开发技术博文头条
• [新闻 /资讯] 获取任意链接文章正文
• [新闻 /资讯] 公众号头条文章
• [新闻 /资讯] 获取任意链接正文图片
• [新闻 /资讯] 获取公众号文章封面
• [新闻 /资讯] 幽默笑话大全
• [短信 /语音] 手机归属地查询
• [文字 /文本] 中文文本分词
• [文字 /文本] 中英文排版规范化
• [文字 /文本] 百万中国对联数据
• [文字 /文本] 国际标准书号 ISBN
• [文字 /文本] 简体繁体互转
• [文字 /文本] 唐诗宋词大全
• [文字 /文本] 关键字摘要智能提取
• [天气 /空气质量] 全国天气预报信息
• [天气 /空气质量] 全国实时空气质量指数
• [网站工具] 获取任意站点标题与图标
• [股票行情] 美股实时行情数据
• [股票行情] 美股历史行情数据
• [股票行情] 美股分时交易数据
• [股票行情] 美股历年基本财务数据
• [股票行情] 港股实时行情数据
• [股票行情] 港股历史行情数据
• [股票行情] 港股分时交易数据
• [股票行情] 港股历年三大财务报表
• [股票行情] A 股实时行情数据
• [股票行情] A 股历史行情数据
• [股票行情] A 股分时交易数据
• [股票行情] A 股历年三大财务报表
• [股票行情] 中国股票指数数据
• [股票行情] A 股个股信息查询
• [股票行情] A 股历年财务指标
• [股票行情] 科创板历史行情数据
• [股票行情] 美股粉单实时行情数据
• [股票行情] 分类美股实时行情数据
• [股票行情] 公募开放式基金实时数据
• [股票行情] 公募开放式基金历史数据
• [体育 /比赛] 历年奥运比赛数据

全量 A 股分时交易数据，分钟级交易数据 / 多时间段区间。

1. 产品功能

• 支持所有 A 股分时交易数据查询；
• 支持 1 、5 、15 、30 、60 分钟交易区间；
• 毫秒级查询性能；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡。

2. API 文档

接口详情: https://www.gugudata.com/api/details/stockcnperminute

接口地址: https://api.gugudata.com/stock/cn/stockcnperminute

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/stock/cn/stockcnperminute?appkey=YOUR_APPKEY &symbol=YOUR_VALUE &period=5 &begindate=YOUR_VALUE &enddate=YOUR_VALUE &adjust=YOUR_VALUE

数据预览: https://www.gugudata.com/preview/stockcnperminute

接口测试: https://api.gugudata.com/stock/cn/stockcnperminute/demo

3. 请求参数（如果为 POST 请求，那么参数以 JSON 的格式传递）

4. 返回参数

5. 接口响应状态码

6. 开发语言请求示例代码

示例代码包含的开发语言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他语言进行对应的 RESTful API 请求实现即可。

咕咕数据，专业的数据提供商，提供专业全面的数据接口、商业数据分析，让数据成为您的生产原料。

咕咕数据基于我们五年来为企业客户提供的海量数据支撑，将部分通用数据、通用功能抽象成产品级 API ，大大满足了用户在产品开发过程中对基础数据的需求，同时降低了复杂功能的实现门槛与人力成本。

除了我们已开放的分类数据与接口外，还有海量数据正在整理、清洗、整合、构建中，后期会开放更多的数据与云端功能接口供用户使用。

目前已开放的数据接口 API

• [条码工具] 通用二维码生成
• [条码工具] Wi-Fi 无线网二维码生成
• [条码工具] 通用条形码生成
• [图像识别] 通用 OCR
• [图像识别] HTML 转 PDF
• [图像识别] HTML 转 Word
• [区域 /坐标] 全国大学高校基础信息
• [区域 /坐标] 地理坐标逆编码
• [区域 /坐标] IP 地址定位
• [区域 /坐标] 全国省市区街道区域信息
• [区域 /坐标] 地理坐标系转换
• [元数据 /字典] 历年高考省录取分数线
• [元数据 /字典] 历年高考高校录取分数线
• [元数据 /字典] 历年高考专业录取分数线
• [新闻 /资讯] 软件开发技术博文头条
• [新闻 /资讯] 获取任意链接文章正文
• [新闻 /资讯] 公众号头条文章
• [新闻 /资讯] 获取任意链接正文图片
• [新闻 /资讯] 获取公众号文章封面
• [新闻 /资讯] 幽默笑话大全
• [短信 /语音] 手机归属地查询
• [文字 /文本] 中文文本分词
• [文字 /文本] 中英文排版规范化
• [文字 /文本] 百万中国对联数据
• [文字 /文本] 简体繁体互转
• [文字 /文本] 唐诗宋词大全
• [文字 /文本] 关键字摘要智能提取
• [天气 /空气质量] 全国天气预报信息
• [网站工具] 获取任意站点标题与图标
• [股票行情] A 股历史行情数据
• [股票行情] 美股历史行情数据
• [股票行情] 港股历史行情数据
• [股票行情] 美股实时行情数据
• [股票行情] 港股实时行情数据
• [股票行情] A 股实时行情数据
• [体育 /比赛] 历年奥运比赛数据

历年所有财报数据，全量 A 股数据，最全三大财报数据。

1. 产品功能

• 支持所有 A 股全量三大财报数据查询；
• 分别包括资产负债表、利润表、现金流量表数据；
• 返回 70 多项财务指标；
• 多数据源清洗整合，百万级数据毫秒级返回；
• 全接口支持 HTTPS （ TLS v1.0 / v1.1 / v1.2 / v1.3 ）；
• 全面兼容 Apple ATS ；
• 全国多节点 CDN 部署；
• 接口极速响应，多台服务器构建 API 接口负载均衡。

2. API 文档

接口详情: https://www.gugudata.com/api/details/annualreport

接口地址: https://api.gugudata.com/stock/cn/annualreport

返回格式: application/json; charset=utf-8

请求方式: GET

请求协议: HTTPS

请求示例: https://api.gugudata.com/stock/cn/annualreport?appkey=YOUR_APPKEY&symbol=YOUR_VALUE&type=

数据预览: https://www.gugudata.com/preview/annualreport

接口测试: https://api.gugudata.com/stock/cn/annualreport/demo

3. 请求参数（如果为 POST 请求，那么参数以 JSON 的格式传递）

4. 返回参数

5. 接口响应状态码

6. 开发语言请求示例代码

示例代码包含的开发语言：C#, Go, Java, jQuery, Node.js, Objective-C, PHP, Python, Ruby, Swift 等，其他语言进行对应的 RESTful API 请求实现即可。

咕咕数据，专业的数据提供商，提供专业全面的数据接口、商业数据分析，让数据成为您的生产原料。

咕咕数据基于我们七年来为企业客户提供的海量数据支撑，将部分通用数据、通用功能抽象成产品级 API ，大大满足了用户在产品开发过程中对基础数据的需求，同时降低了复杂功能的实现门槛与人力成本。

除了我们已开放的分类数据与接口外，还有海量数据正在整理、清洗、整合、构建中，后期会开放更多的数据与云端功能接口供用户使用。

目前已开放的数据接口 API

• [条码工具] 通用二维码生成
• [条码工具] Wi-Fi 无线网二维码生成
• [条码工具] 通用条形码生成
• [图像识别] 通用 OCR
• [图像识别] HTML 转 PDF
• [图像识别] HTML 转 Word
• [区域 /坐标] 全国大学高校基础信息
• [区域 /坐标] 地理坐标逆编码
• [区域 /坐标] IP 地址定位
• [区域 /坐标] 全国省市区街道区域信息
• [区域 /坐标] 地理坐标系转换
• [元数据 /字典] 历年高考省录取分数线
• [元数据 /字典] 历年高考高校录取分数线
• [元数据 /字典] 历年高考专业录取分数线
• [新闻 /资讯] 软件开发技术博文头条
• [新闻 /资讯] 获取任意链接文章正文
• [新闻 /资讯] 公众号头条文章
• [新闻 /资讯] 获取任意链接正文图片
• [新闻 /资讯] 获取公众号文章封面
• [新闻 /资讯] 幽默笑话大全
• [短信 /语音] 手机归属地查询
• [文字 /文本] 中文文本分词
• [文字 /文本] 中英文排版规范化
• [文字 /文本] 百万中国对联数据
• [文字 /文本] 简体繁体互转
• [文字 /文本] 唐诗宋词大全
• [文字 /文本] 关键字摘要智能提取
• [天气 /空气质量] 全国天气预报信息
• [网站工具] 获取任意站点标题与图标
• [股票行情] A 股历史行情数据
• [股票行情] 美股历史行情数据
• [股票行情] 港股历史行情数据
• [股票行情] 美股实时行情数据
• [股票行情] 港股实时行情数据
• [股票行情] A 股实时行情数据
• [股票行情] A 股分时交易数据
• [股票行情] A 股历年三大财务报表
• [股票行情] 美股历史行情数据
• [股票行情] 美股分时交易数据
• [股票行情] 港股分时交易数据
• [股票行情] 公募开放式基金历史数据
• [股票行情] 科创板历史行情数据
• [[体育 /比赛] 历年奥运比赛数据