# 发票与小票结构化识别
> 来源页面: https://www.gugudata.com/api/details/receipt-recognition
## 概览
- API 标识: `receipt-recognition`
- 分类: 图像/转换
- 描述: 识别发票与小票，提取票据字段
- 标签: 票据识别 / 增值税发票 / 餐饮小票 / 购物小票
- 短标签: 图片处理 / 票据识别
- 详情页: https://www.gugudata.com/api/details/receipt-recognition
- LLM Markdown: https://www.gugudata.com/api/details/receipt-recognition/llm.md
- 数据预览: https://www.gugudata.com/preview/receipt-recognition
- 购买开通: https://www.gugudata.com/order/receipt-recognition
- 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-AppKey: YOUR_APPKEY` 请求头，不接受查询参数或 JSON 请求体中的 AppKey。
- 开通与续费: 未开通时引导用户访问购买开通页；已开通或需要续费时，引导用户进入开发者中心或订单与续费页。
- 错误处理: HTTP 状态码代表传输层结果，响应体内的业务状态码代表接口业务结果，代码中应分别处理。
- 生产建议: AppKey 应保存在服务端环境变量或密钥配置中，由服务端统一发起请求，不要写入网页、App 客户端或公开仓库。
关键链接:
- 接口详情页: https://www.gugudata.com/api/details/receipt-recognition
- LLM Markdown: https://www.gugudata.com/api/details/receipt-recognition/llm.md
- 数据预览: https://www.gugudata.com/preview/receipt-recognition
- 购买开通页: https://www.gugudata.com/order/receipt-recognition
- 开发者中心 APP KEY 管理: https://www.gugudata.com/portal/
- 订单与续费: https://www.gugudata.com/portal/orders
## API 功能
- 识别增值税发票、餐饮小票与购物小票，返回逐张票据结果；
- 支持公开 HTTPS 图片地址，也可通过文件流上传 PNG 或 JPEG 图片；
- 单张票据可选择 single 模式，保留完整图片中的文字与字段证据；
- auto 模式支持深色背景上完整分离的浅色票据，最多 5 张；
- 返回票据边界与文字行坐标，便于对照原图核验；
- 按可识别证据抽取日期、金额、发票及购销方等字段，缺失字段不补造；
- 字段附带原始文字、置信度和对应文字行，便于业务复核；
- 对缺失、冲突与低置信度结果标记待复核，不替代人工审核或发票查验；
- 图片不超过 10 MiB、1,200 万像素，最长边不超过 6,000 像素；
- 服务繁忙时返回 429，请降低并发后重试，更高处理量需先联系确认。
## API 文档
- 接口地址: `https://api.gugudata.com/ai/receipt-recognition`
- 返回格式: `application/json; charset=utf-8`
- 请求方式: `POST`
- 请求内容类型: `application/json`；请求体只包含 `imageurl` 和 `mode`，其中 `mode` 为 `single` 或 `auto`。
- 请求协议: `HTTPS`
- 请求示例: `https://api.gugudata.com/ai/receipt-recognition`
- 接口测试: https://api.gugudata.com/ai/receipt-recognition/demo
- Apifox: https://doc.gugudata.com/
- Postman: https://www.postman.com/gugudata/gugudata-official
- OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
## 鉴权方式
本接口仅接受 `X-AppKey` 请求头。查询参数与 JSON 请求体不接受 AppKey。
| 传输载体 | 参数 | 示例 | 说明 |
| --- | --- | --- | --- |
| HTTP Header | `X-AppKey` | `X-AppKey: YOUR_APPKEY` | 必填，请使用当前产品的 AppKey。 |
## 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
| --- | --- | --- | --- | --- |
| X-AppKey | string | 是 | YOUR_APPKEY | HTTP 请求头；仅使用票据识别产品的 APPKEY，不支持 Query、Body 或 Bearer。 |
| imageurl | string | 是 | https://static.gugudata.com/demo/receipt-recognition/v1/input.ade755a263c27a1f2246.png | 公开 HTTPS PNG 或 JPEG 图片地址，不支持重定向或私网；JSON 模式必填。 |
| mode | string | 否 | auto | auto 或 single，服务默认 auto；演示样例使用 single。文件上传请使用 multipart/form-data 的 image 与 mode，不与 imageurl 混用。 |
## 返回参数
| 参数名 | 参数类型 | 备注 |
| --- | --- | --- |
| DataStatus.StatusCode | integer | 成功为 100；业务错误码与 HTTP 状态分别判断。 |
| DataStatus.RequestParameter | string | 正式请求仅返回 mode，不回显用户图片地址；固定 Demo 返回公开样例 imageurl 与 mode。 |
| DataStatus.StatusDescription | string | 请求处理说明。 |
| DataStatus.RequestId | string | 请求 UUID，与 Data.request_id 和 X-Request-ID 响应头一致。 |
| DataStatus.DataTotalCount | integer | 成功时为票据数量，失败时为 0。 |
| Data.request_id | string | 本次请求 UUID。 |
| Data.status | string | complete 或 needs_review；成功不表示字段已通过人工或税务核验。 |
| Data.image | object | 原始图片 width、height。 |
| Data.receipts | array | 逐张票据结果。 |
| Data.receipts[].receipt_index | integer | 当前图片内的票据序号，从 1 开始。 |
| Data.receipts[].receipt_type | string | vat_invoice、restaurant_receipt、shopping_receipt 或 unknown。 |
| Data.receipts[].polygon | array | 票据在原图中的多边形坐标。 |
| Data.receipts[].fields | object | 仅包含有证据且可解析的字段，不保证所有字段存在。 |
| Data.receipts[].fields.*.value | string | 标准化字段值；金额为十进制字符串。 |
| Data.receipts[].fields.*.raw_text | string | 提取字段的原始文字证据。 |
| Data.receipts[].fields.*.line_indices | array | 证据在本张票据 lines 中的零基索引。 |
| Data.receipts[].fields.*.confidence | number | OCR 证据置信度，不是字段正确率。 |
| Data.receipts[].lines | array | 文字行 text、confidence 与原图 polygon。 |
| Data.receipts[].needs_review | boolean | 是否需要人工复核。 |
| Data.receipts[].warnings | array | 本张票据的缺失、冲突或识别警告。 |
| Data.warnings | array | 图片级处理警告。 |
## 响应示例（真实数据节选）
```json
{
"DataStatus": {
"RequestParameter": "imageurl=https%3A%2F%2Fstatic.gugudata.com%2Fdemo%2Freceipt-recognition%2Fv1%2Finput.ade755a263c27a1f2246.png&mode=single",
"StatusCode": 100,
"StatusDescription": "固定示例识别结果，请核对原始图片。",
"ResponseDateTime": "2026-10-24 02:57:52.289",
"DataTotalCount": 1,
"RequestId": "f1bc1930-afec-4f98-bad3-186d817e2a56"
},
"Data": {
"status": "needs_review",
"receipts": [
{
"fields": {
"date": {
"confidence": 0.99983,
"line_indices": [
3
],
"raw_text": "开票日期：2016年01月06日",
"value": "2016-01-06"
},
"total_amount": {
"confidence": 0.9921,
"line_indices": [
37,
40
],
"raw_text": "价税合计(大写)\n(小写)¥1.00",
"value": "1.00"
}
},
"lines": [
{
"confidence": 0.9938,
"polygon": [
[
856.0,
16.0
],
[
942.0,
16.0
],
[
942.0,
43.0
],
[
856.0,
43.0
]
],
"text": "发票代码："
},
{
"confidence": 0.99093,
"polygon": [
[
388.0,
38.0
],
[
828.0,
38.0
],
[
828.0,
83.0
],
[
388.0,
83.0
]
],
"text": "广东增值税电子普通发票"
},
{
"confidence": 0.99091,
"polygon": [
[
856.0,
49.0
],
[
942.0,
49.0
],
[
942.0,
76.0
],
[
856.0,
76.0
]
],
"text": "发票号码："
},
{
"confidence": 0.99983,
"polygon": [
[
856.0,
86.0
],
[
1094.0,
85.0
],
[
1094.0,
109.0
],
[
856.0,
110.0
]
],
"text": "开票日期：2016年01月06日"
},
{
"confidence": 0.99897,
"polygon": [
[
543.0,
106.0
],
[
664.0,
104.0
],
[
665.0,
149.0
],
[
544.0,
152.0
]
],
"text": "国家税务局监制"
},
{
"confidence": 0.99408,
"polygon": [
[
51.0,
118.0
],
[
140.0,
120.0
],
[
139.0,
148.0
],
[
50.0,
145.0
]
],
"text": "机器编号："
},
{
"confidence": 0.97561,
"polygon": [
[
855.0,
120.0
],
[
942.0,
120.0
],
[
942.0,
146.0
],
[
855.0,
146.0
]
],
"text": "校验码："
},
{
"confidence": 1.0,
"polygon": [
[
87.0,
163.0
],
[
114.0,
163.0
],
[
114.0,
189.0
],
[
87.0,
189.0
]
],
"text": "名"
},
{
"confidence": 0.99601,
"polygon": [
[
175.0,
161.0
],
[
255.0,
161.0
],
[
255.0,
189.0
],
[
175.0,
189.0
]
],
"text": "称：个人"
},
{
"confidence": 0.99931,
"polygon": [
[
688.0,
165.0
],
[
721.0,
165.0
],
[
721.0,
238.0
],
[
688.0,
238.0
]
],
"text": "密码"
},
{
"confidence": 0.99999,
"polygon": [
[
45.0,
175.0
],
[
77.0,
175.0
],
[
77.0,
266.0
],
[
45.0,
266.0
]
],
"text": "购买方"
},
{
"confidence": 0.99866,
"polygon": [
[
88.0,
195.0
],
[
208.0,
195.0
],
[
208.0,
218.0
],
[
88.0,
218.0
]
],
"text": "纳税人识别号："
},
{
"confidence": 0.99925,
"polygon": [
[
86.0,
223.0
],
[
209.0,
223.0
],
[
209.0,
249.0
],
[
86.0,
249.0
]
],
"text": "地址、电话："
},
{
"confidence": 0.9964,
"polygon": [
[
691.0,
230.0
],
[
718.0,
230.0
],
[
718.0,
274.0
],
[
691.0,
274.0
]
],
"text": "区"
},
{
"confidence": 0.99773,
"polygon": [
[
88.0,
254.0
],
[
208.0,
254.0
],
[
208.0,
278.0
],
[
88.0,
278.0
]
],
"text": "开户行及账号："
},
{
"confidence": 0.99983,
"polygon": [
[
81.0,
286.0
],
[
301.0,
286.0
],
[
301.0,
309.0
],
[
81.0,
309.0
]
],
"text": "货物或应税劳务、服务名称"
},
{
"confidence": 0.99995,
"polygon": [
[
347.0,
284.0
],
[
431.0,
284.0
],
[
431.0,
311.0
],
[
347.0,
311.0
]
],
"text": "规格型号"
},
{
"confidence": 0.99996,
"polygon": [
[
439.0,
283.0
],
[
488.0,
283.0
],
[
488.0,
309.0
],
[
439.0,
309.0
]
],
"text": "单位"
},
{
"confidence": 1.0,
"polygon": [
[
537.0,
283.0
],
[
594.0,
283.0
],
[
594.0,
312.0
],
[
537.0,
312.0
]
],
"text": "数量"
},
{
"confidence": 0.99996,
"polygon": [
[
674.0,
283.0
],
[
732.0,
283.0
],
[
732.0,
313.0
],
[
674.0,
313.0
]
],
"text": "单价"
},
{
"confidence": 0.99981,
"polygon": [
[
833.0,
286.0
],
[
898.0,
286.0
],
[
898.0,
311.0
],
[
833.0,
311.0
]
],
"text": "金额"
},
{
"confidence": 0.99811,
"polygon": [
[
952.0,
284.0
],
[
999.0,
284.0
],
[
999.0,
311.0
],
[
952.0,
311.0
]
],
"text": "税率"
},
{
"confidence": 0.99808,
"polygon": [
[
1058.0,
286.0
],
[
1123.0,
286.0
],
[
1123.0,
311.0
],
[
1058.0,
311.0
]
],
"text": "税额"
},
{
"confidence": 0.99949,
"polygon": [
[
43.0,
311.0
],
[
304.0,
311.0
],
[
304.0,
333.0
],
[
43.0,
333.0
]
],
"text": "维达手帕纸Feel酷享别注装4层迷"
},
{
"confidence": 0.99999,
"polygon": [
[
732.0,
308.0
],
[
775.0,
308.0
],
[
775.0,
334.0
],
[
732.0,
334.0
]
],
"text": "3.85"
},
{
"confidence": 0.99999,
"polygon": [
[
907.0,
309.0
],
[
950.0,
309.0
],
[
950.0,
335.0
],
[
907.0,
335.0
]
],
"text": "3.85"
},
{
"confidence": 0.99981,
"polygon": [
[
954.0,
309.0
],
[
999.0,
309.0
],
[
999.0,
334.0
],
[
954.0,
334.0
]
],
"text": "17%"
},
{
"confidence": 0.99999,
"polygon": [
[
1132.0,
309.0
],
[
1174.0,
309.0
],
[
1174.0,
335.0
],
[
1132.0,
335.0
]
],
"text": "0.65"
},
{
"confidence": 0.99995,
"polygon": [
[
44.0,
334.0
],
[
136.0,
334.0
],
[
136.0,
358.0
],
[
44.0,
358.0
]
],
"text": "你纸巾*6包"
},
{
"confidence": 0.98768,
"polygon": [
[
42.0,
356.0
],
[
159.0,
356.0
],
[
159.0,
383.0
],
[
42.0,
383.0
]
],
"text": "折扣(77.778%)"
},
{
"confidence": 0.99991,
"polygon": [
[
903.0,
356.0
],
[
950.0,
356.0
],
[
950.0,
382.0
],
[
903.0,
382.0
]
],
"text": "-2.99"
},
{
"confidence": 0.99974,
"polygon": [
[
954.0,
356.0
],
[
997.0,
356.0
],
[
997.0,
382.0
],
[
954.0,
382.0
]
],
"text": "17%"
},
{
"confidence": 0.99992,
"polygon": [
[
1127.0,
356.0
],
[
1173.0,
356.0
],
[
1173.0,
382.0
],
[
1127.0,
382.0
]
],
"text": "-0.51"
},
{
"confidence": 0.99996,
"polygon": [
[
114.0,
505.0
],
[
142.0,
505.0
],
[
142.0,
530.0
],
[
114.0,
530.0
]
],
"text": "合"
},
{
"confidence": 0.99979,
"polygon": [
[
190.0,
503.0
],
[
223.0,
503.0
],
[
223.0,
531.0
],
[
190.0,
531.0
]
],
"text": "计"
},
{
"confidence": 0.99236,
"polygon": [
[
876.0,
500.0
],
[
954.0,
503.0
],
[
953.0,
532.0
],
[
875.0,
529.0
]
],
"text": "¥0.86"
},
{
"confidence": 0.99457,
"polygon": [
[
1098.0,
502.0
],
[
1174.0,
502.0
],
[
1174.0,
529.0
],
[
1098.0,
529.0
]
],
"text": "¥0.14"
},
{
"confidence": 0.99646,
"polygon": [
[
116.0,
542.0
],
[
243.0,
542.0
],
[
243.0,
565.0
],
[
116.0,
565.0
]
],
"text": "价税合计(大写)"
},
{
"confidence": 0.77409,
"polygon": [
[
351.0,
544.0
],
[
373.0,
544.0
],
[
373.0,
565.0
],
[
351.0,
565.0
]
],
"text": "X"
},
{
"confidence": 0.99969,
"polygon": [
[
373.0,
540.0
],
[
441.0,
540.0
],
[
441.0,
569.0
],
[
373.0,
569.0
]
],
"text": "壹圆整"
},
{
"confidence": 0.9921,
"polygon": [
[
889.0,
541.0
],
[
1013.0,
541.0
],
[
1013.0,
565.0
],
[
889.0,
565.0
]
],
"text": "(小写)¥1.00"
},
{
"confidence": 0.99983,
"polygon": [
[
48.0,
589.0
],
[
80.0,
591.0
],
[
76.0,
678.0
],
[
44.0,
677.0
]
],
"text": "销售方"
},
{
"confidence": 1.0,
"polygon": [
[
87.0,
579.0
],
[
112.0,
579.0
],
[
112.0,
606.0
],
[
87.0,
606.0
]
],
"text": "名"
},
{
"confidence": 0.99972,
"polygon": [
[
177.0,
580.0
],
[
375.0,
583.0
],
[
374.0,
607.0
],
[
177.0,
604.0
]
],
"text": "称：广州晶东贸易有限公司"
},
{
"confidence": 0.99994,
"polygon": [
[
691.0,
592.0
],
[
718.0,
592.0
],
[
718.0,
620.0
],
[
691.0,
620.0
]
],
"text": "备"
},
{
"confidence": 0.99978,
"polygon": [
[
719.0,
579.0
],
[
784.0,
579.0
],
[
784.0,
608.0
],
[
719.0,
608.0
]
],
"text": "订单号"
},
{
"confidence": 0.99904,
"polygon": [
[
87.0,
610.0
],
[
208.0,
610.0
],
[
208.0,
633.0
],
[
87.0,
633.0
]
],
"text": "纳税人识别号："
},
{
"confidence": 0.99718,
"polygon": [
[
87.0,
637.0
],
[
653.0,
637.0
],
[
653.0,
660.0
],
[
87.0,
660.0
]
],
"text": "地址、电话：广东东莞麻涌镇新基村东环路京东华南第二物流园028-65976800"
},
{
"confidence": 0.99626,
"polygon": [
[
690.0,
652.0
],
[
718.0,
652.0
],
[
718.0,
680.0
],
[
690.0,
680.0
]
],
"text": "注"
},
{
"confidence": 0.99542,
"polygon": [
[
88.0,
664.0
],
[
208.0,
664.0
],
[
208.0,
688.0
],
[
88.0,
688.0
]
],
"text": "开户行及账号："
},
{
"confidence": 0.99798,
"polygon": [
[
58.0,
702.0
],
[
171.0,
702.0
],
[
171.0,
728.0
],
[
58.0,
728.0
]
],
"text": "收款人：系统"
},
{
"confidence": 0.92185,
"polygon": [
[
375.0,
701.0
],
[
468.0,
701.0
],
[
468.0,
728.0
],
[
375.0,
728.0
]
],
"text": "复核:系统"
},
{
"confidence": 0.99482,
"polygon": [
[
617.0,
703.0
],
[
729.0,
699.0
],
[
730.0,
727.0
],
[
618.0,
731.0
]
],
"text": "开票人：系统"
},
{
"confidence": 0.99965,
"polygon": [
[
859.0,
701.0
],
[
918.0,
701.0
],
[
918.0,
729.0
],
[
859.0,
729.0
]
],
"text": "销售方"
}
],
"needs_review": true,
"polygon": [
[
0.0,
0.0
],
[
1195.0,
0.0
],
[
1195.0,
759.0
],
[
0.0,
759.0
]
],
"receipt_index": 1,
"receipt_type": "vat_invoice",
"warnings": [
"invalid_invoice_code",
"invalid_invoice_number",
"invalid_tax_amount",
"missing_invoice_number"
]
}
],
"warnings": [
],
"image": {
"height": 760,
"width": 1196
},
"request_id": "f1bc1930-afec-4f98-bad3-186d817e2a56"
}
}
```
## 接口常见 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 | 请求频率或处理容量受限 | 请降低并发并稍后重试；如需更高处理量，请先联系确认。 |
| 431 | 请求头过大 | 请求头字段过大或过多，建议精简 Header 后重试。 |
| 500 | 服务器内部错误 | 服务端处理异常，请稍后重试。 |
| 502 | 服务暂时不可用 | 请稍后重试。 |
| 503 | 服务暂时不可用 | 请稍后重试。 |
| 504 | 请求超时 | 请稍后重试。 |
## 接口自定义业务状态码
| 业务状态码 | 业务状态码解释 | 备注 |
| --- | --- | --- |
| 100 | 成功 | HTTP 200；仍需检查 needs_review 与 warnings。 |
| 501 | 参数或图片不可处理 | HTTP 400、408、413、422；根据错误说明修正。 |
| 502 | 请求频率或处理容量受限 | HTTP 429，按 Retry-After 降低并发重试。 |
| 503 | 订单已到期 | HTTP 403。 |
| 504 | 凭据无效或未开通票据识别权限 | HTTP 401；仅 X-AppKey 请求头。 |
| 505 | 调用额度耗尽 | HTTP 403。 |
| 901 | 服务不可用或处理超时 | HTTP 503、504。 |
## cURL 请求示例
```bash
curl --location --request POST 'https://api.gugudata.com/ai/receipt-recognition' \
--header 'X-AppKey: YOUR_APPKEY' \
--header 'Content-Type: application/json' \
--data '{"imageurl":"https://static.gugudata.com/demo/receipt-recognition/v1/input.ade755a263c27a1f2246.png","mode":"single"}'
```
## 常见问题 Q&A
### Q: 是否支持发票真伪查验？
A: 不支持。本接口提取图片文字与票据字段，不连接税务查验系统；入账、报销等关键内容须人工核验。
### Q: 如何使用多张票据？
A: auto 模式适用于深色背景上完整分离的浅色票据，最多 5 张。重叠、裁切、复杂背景或无法可靠分区时，请拆分为单张并使用 single 模式。
### Q: 为什么成功响应仍标记 needs_review？
A: 成功表示完成识别处理。字段缺失、金额冲突、低置信度或未知票种仍需复核，不应直接作为自动报销或入账依据。
### Q: 预览中的图片是什么？
A: 公开历史增值税发票样例，经标识遮盖后展示；图片来源及许可见预览页。固定演示结果由同一识别流程生成，不代表所有票据的识别效果。
### Q: 如何完成第一次 API 调用？
A: 先确认当前接口的请求方法、必填参数和成功状态，再使用对应产品的 AppKey 发起请求；以实际响应中的业务状态判断结果。 [查看接入指南](https://www.gugudata.com/developers/getting-started)
### Q: 如何保证请求时 AppKey 的安全性？
A: 在开发者中心的 APP KEY 管理页面复制对应产品的 AppKey，并保存在服务端环境变量或密钥管理服务中。不要写入网页、App 客户端、公开仓库或日志。
### Q: 接口可以用于哪些开发语言？
A: Java、Python、Node.js、PHP、Go、C#、Swift、Kotlin 等支持 HTTP 请求的语言均可接入；也可以通过 OpenAPI、Postman 或 Apifox 查看和调试接口。
### Q: 请求失败或超时后可以重试吗？
A: 先区分 HTTP 状态与业务错误。参数、鉴权和权限错误应修正后再请求；超时并不表示服务端未执行，重试前需确认接口是否会重复计费或产生副作用。 [查看接入指南](https://www.gugudata.com/developers/errors-and-retries)
### Q: 接口的性能可以保证吗？
A: 实际响应时间受接口类型、参数和网络环境影响。请按当前套餐的 QPS 控制并发，生产接入前完成联调与容量评估。
## 服务协议以及服务免责声明
- [服务协议](https://www.gugudata.com/license)
- [服务免责声明](https://www.gugudata.com/disclaimer)
## 技术支持
- 技术支持邮箱: support@gugudata.com
- 微信客服: https://work.weixin.qq.com/kfid/kfcf9a60a6afe3337b7