# 发票与小票结构化识别 > 来源页面: 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