# Rideshare Receipt Ocr

> Rideshare Receipt Ocr

- Skill: `qq5855144/rideshare-receipt-ocr` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add qq5855144/rideshare-receipt-ocr`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qq5855144/rideshare-receipt-ocr/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: qq5855144 (https://skillmd.com/u/qq5855144)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qq5855144/rideshare-receipt-ocr

---


## 能力概述

对各大主要服务商（滴滴企业版等）的网约车行程单进行结构化 OCR 识别，支持识别 16 个关键字段，包括服务商名称、行程起止时间、总金额、行程明细数组等。

- **Endpoint**: `POST https://app-bo4w33bsdqm9-api-zYkZz8qoKp1L-gateway.appmiaoda.com/rest/2.0/ocr/v1/online_taxi_itinerary`
- **Content-Type**: `application/x-www-form-urlencoded`
- **认证模式**: `platform_managed`（密钥由平台注入，客户端无需关心）
- Auth Header 为 `X-Gateway-Authorization: Bearer ${INTEGRATIONS_API_KEY}`（注意不是标准的 `Authorization`）。
- **支持平台**: Web、MiniProgram
- **响应格式**: JSON（结构化字段，无媒体 URL）

**输入模式优先级**（四选一）：

| 优先级 | 参数 | 说明 |
|--------|------|------|
| 1 | `image` | 图片 base64 编码（最大 4 MB），支持 jpg/jpeg/png/bmp |
| 2 | `url` | 图片完整 HTTP/HTTPS URL |
| 3 | `pdf_file` | PDF 文件 base64 编码，配合 `pdf_file_num` 指定页码 |
| 4 | `ofd_file` | OFD 文件 base64 编码，配合 `ofd_file_num` 指定页码 |

**响应示例（成功）：**

```json
{
  "log_id": "1385196013945356288",
  "words_result_num": 7,
  "words_result": {
    "ServiceProvider": "滴滴企业版",
    "StartTime": "2020-07-01 16:00",
    "EndTime": "2020-07-30 19:00",
    "Phone": "13000000000",
    "TotalFare": "2316",
    "ItemNum": "3",
    "items": [
      {
        "ItemId": "1",
        "PickupDate": "20-07-01",
        "PickupTime": "16:00",
        "StartPlace": "鱼化寨地铁-D口",
        "DestinationPlace": "创新港",
        "CarType": "快车",
        "Distance": "9.7",
        "City": "西安市",
        "Fare": "20.86"
      }
    ]
  }
}
```

详细参数表与字段说明见 [references/online-taxi-itinerary-ocr-api.md](references/online-taxi-itinerary-ocr-api.md)。

---

## 生成期用法（Agent 直接调用）

在生成期（脚本/Agent 工具调用）中，直接请求上游 API，密钥从平台环境变量读取。

完整的 TypeScript 调用代码见 [references/online-taxi-itinerary-ocr-api.md](references/online-taxi-itinerary-ocr-api.md) — **生成期代码** 章节。

---

## 生成后用法（应用内通过 Edge Function 调用）

在应用内（Web / MiniProgram），前端不可直接持有 `INTEGRATIONS_API_KEY`，须通过 Supabase Edge Function 中转。

- Web 和 MiniProgram 响应均为 JSON，**两个平台共用同一个 Edge Function**，前端调用方式相同。
- Edge Function 从 Deno 环境变量读取密钥，前端只发送 base64 图片或 URL 等参数即可。

完整的 Edge Function 代码与前端调用代码见
[references/online-taxi-itinerary-ocr-api.md](references/online-taxi-itinerary-ocr-api.md) — **Edge Function** 章节。