API 数据接入
通过 API 接口实时获取第三方平台数据，自动同步到 Zleap
核心概念
API 是不同系统之间的「数据快递通道」
API (Application Programming Interface，应用程序编程接口)，你可以把 API 理解成不同系统之间的「数据快递通道」。从其他平台获取数据到智跃 Zleap 里，API 就是双方提前约定好的 "快递路线"：
- API 请求地址 = 快递要送达的目的地
- 参数 = 快递面单上的 "备注信息"（告诉对方你要什么类型、什么范围的数据）
- 请求方式（如 GET） = 快递的 "取件规则"（比如是 "上门取件" 还是 "网点自提"）
填写好上面的信息，数据就能自动从对方系统 "快递" 到智跃 Zleap 里。
用 API 采集信息的优势
实时新鲜
配置好请求地址后，系统会直接从对方系统拉取最新数据，实时抓取动态数据。
自动省力
只要配置好参数和超时时间，系统会定期自动同步数据，不用每天重复手动操作，把人力从 "搬运数据" 里解放出来。
准确少错
系统直接对接传输数据，避免了人工录入时的抄错、漏填问题，数据准确率更高。
灵活可控
可以根据需求调整参数（如时间范围、数据类型），精准获取想要的信息，避免冗余数据干扰。
如何使用 API 接入数据？
以「接入高德天气 API，获取广州实时天气」为例，演示如何通过 API 将第三方数据接入智跃 Zleap。
步骤一：获取 API
1. 找到 API 提供方
确定数据来源平台（如高德开放平台、企业内部系统等）。
2. 申请 API 密钥
以高德天气 API 为例：
- 打开高德开放平台官网，注册 / 登录开发者账号
- 进入「控制台」→「应用管理」→「创建应用」（命名如 "智跃天气同步"）
- 应用创建后，点击「添加 Key」，选择「Web 服务 API」类型，提交申请
关键提醒：拿到 API 后，一定要问清 3 件事：是否需要密钥（token/AppID）？（安全相关，必填）；调用频率限制（比如每分钟最多调用 100 次，避免被拉黑）；数据返回格式（一般是 JSON，确保智跃 Zleap 支持）。
步骤二：API 配置
1. 进入配置页面
打开智跃 Zleap「信息管理」模块 → 选择「API 接入」→ 进入配置页面。
2. 填写 API 信息
填写基础配置：「API 名称」、「API 请求地址」，设置请求方式和超时时间。
请求方式说明：
| 请求方式 | 用途 | 常见场景 |
|---|---|---|
| GET | 获取数据 | 查询天气、获取新闻列表、读取用户信息 |
| POST | 提交数据 | 提交表单、上传文件、创建订单 |
| PUT | 更新数据 | 修改用户资料、更新商品信息 |
| DELETE | 删除数据 | 删除文章、取消订单 |
提示：获取信息的话一般就用 GET！
3. 添加请求参数
点击「添加参数」，填写 key 等必填与可选的参数。
4. 调试 + 保存
- 点击配置页「调试」按钮，系统会发送请求
- 若返回「测试成功」，说明配置成功
- 调试通过后，点击「保存」，广州天气信息源创建完成
常见问题
调试失败怎么办？
1. 检查 API 地址是否正确
- 确认 URL 是否完整（包含 http:// 或 https://）
- 检查是否有拼写错误
- 确认 API 地址是否可访问（可在浏览器中直接访问测试）
2. 检查参数配置
- 必填参数是否都已填写
- 参数值格式是否正确（如日期格式、数字格式等）
- 密钥（key/token）是否有效且未过期
3. 检查请求方式
- 确认选择的请求方式（GET/POST/PUT/DELETE）与 API 文档要求一致
- 大部分查询类 API 使用 GET 方式
4. 检查网络连接
- 确认网络连接正常
- 检查是否有防火墙或代理限制
- 确认 API 服务器是否正常运行
如何设置合适的超时时间？
超时时间是指系统等待 API 响应的最长时间，超过这个时间就会认为请求失败。
建议设置：
- 轻量级查询（如天气、汇率）：10-20 秒
- 中等数据量（如新闻列表、商品信息）：20-30 秒
- 大数据量或复杂查询：30-60 秒
提示：如果是数据量大、处理复杂的请求（如报表生成、大文件下载），可适当调长超时时间（如 60 秒）；如果是实时性要求高的请求（如支付、订单接口），建议调短超时时间（如 10-15 秒），避免用户等待过久。
对 API 数据接入有疑问或建议？欢迎提交反馈！