全语言翻译数据 API

HyperSoft AI - Apps Lab · 效率工具

全语言翻译将功能拆分在登录后的练习通话服务与公共翻译源之间。身份从 POST /v1/auth/session/verify 与 GET /v1/account/profile 开始；匹配使用 POST /v1/matchmaking/partner，返回 RTC 房间 token 与搭档的 english_level。辅导评分在 GET /v1/sessions/{callId}/review。文本功能调用公共翻译（GET /v1/translate/text）、AI 辅导聊天（POST /v1/tutor/chat）、词典词条与货币汇率源。

全语言翻译 App（版本 1.2.5.7）是 HyperSoft AI 的安卓客户端，提供文本/语音翻译与登录后的英语练习语音通话层。翻译界面调用公共后端：Google 翻译客户端源、OpenAI 聊天辅导（gpt-3.5-turbo）、公共英语词典与 CDN 托管的货币汇率源。练习层以 Firebase ID token（Authorization: Bearer）加 X-Device-FID 设备头认证，覆盖身份、带 RTC 房间令牌的搭档匹配、通话历史、AI 流利度/语法报告、好友、在线状态与收件箱。

应用截图

API 端点一览

校验 Firebase ID token

POST /v1/auth/session/verify osint

用 Firebase ID token 换取已登录的语音通话资料（email、firebase_uid、每周分钟数、所在地、性别、最近一次通话搭档）。

认证方式： JSON 请求体中以 idToken 携带 Firebase ID token。后续请求发送 Authorization: Bearer <firebase-id-token> 以及 X-Device-FID 设备安装头部。

idToken
message
user
id
firebase_uid
email
name
english_level
location_city
location_country
location_country_code
is_user_premium
weekly_total_minutes
weekly_used_minutes
weekly_remaining_minutes
gender
avatar_id
unread_count

依据应用界面重构的示意示例，并非实时抓包。

POST /v1/auth/session/verify HTTP/1.1
Content-Type: application/json
X-Device-FID: <device-installation-id>

{
  "idToken": "<firebase-id-token>"
}

{
  "message": "ok",
  "user": {
    "id": "usr_8f3c1d2e",
    "firebase_uid": "firebaseUid-01",
    "email": "[email protected]",
    "name": "Ada Khan",
    "about": "Practicing business English",
    "profession": "Software Engineer",
    "goal": "Fluency",
    "interest": ["travel", "tech"],
    "english_level": "B2",
    "partner_preference": "any",
    "location_city": "Karachi",
    "location_country": "Pakistan",
    "location_country_code": "PK",
    "notifications": true,
    "notify_me_available": true,
    "user_online_status": true,
    "is_user_premium": false,
    "created_at": "2026-01-12T08:14:00Z",
    "updated_at": "2026-09-26T11:02:00Z",
    "account_status": "active",
    "account_violation_reasons": [],
    "weekly_total_minutes": 120,
    "weekly_used_minutes": 18,
    "weekly_remaining_minutes": 102,
    "week_start_time": "2026-09-22T00:00:00Z",
    "gender": "FEMALE",
    "avatar_id": "12",
    "unread_count": 2,
    "last_call_id": "call_91ab",
    "last_call_partner_id": "usr_partner",
    "last_call_partner_name": "Jordan Lee",
    "last_call_partner_gender": "MALE",
    "last_call_partner_avatar_id": "4",
    "last_call_duration_seconds": 312,
    "last_call_ended_at": 1758873600000,
    "account_cool_down_remaining_ms": 0,
    "account_cool_down_total_ms": 0,
    "account_cool_down_start_ms": 0
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据应用的登录与会话初始化流程重构。
响应字段与练习面板上的账户卡片相对应。

获取已登录用户资料

GET /v1/account/profile osint

读取当前练习通话资料，包括 weekly_remaining_minutes（当该值不大于 0 时客户端会阻止搭档搜索）。

认证方式： Authorization: Bearer <firebase-id-token>；X-Device-FID 设备安装头部。

message
user
id
firebase_uid
email
name
profession
english_level
location_city
location_country_code
user_online_status
is_user_premium
weekly_remaining_minutes
gender
avatar_id
unread_count

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/account/profile HTTP/1.1
Authorization: Bearer <firebase-id-token>
X-Device-FID: <device-installation-id>

{
  "message": "ok",
  "user": {
    "id": "usr_8f3c1d2e",
    "firebase_uid": "firebaseUid-01",
    "email": "[email protected]",
    "name": "Ada Khan",
    "profession": "Software Engineer",
    "english_level": "B2",
    "location_city": "Karachi",
    "location_country": "Pakistan",
    "location_country_code": "PK",
    "user_online_status": true,
    "is_user_premium": false,
    "account_status": "active",
    "weekly_total_minutes": 120,
    "weekly_used_minutes": 18,
    "weekly_remaining_minutes": 102,
    "gender": "FEMALE",
    "avatar_id": "12",
    "unread_count": 2
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据资料界面及其对搭档搜索的每周配额限制重构。

更新用户资料

PUT /v1/account/profile osint

写入练习通话资料中可编辑的身份字段（name、about、profession、english_level、location、gender、avatar_id）。

认证方式： Authorization: Bearer <firebase-id-token>；X-Device-FID 设备安装头部。

name
about
profession
goal
interest
english_level
partner_preference
location_city
location_country
location_country_code
notifications
notify_me_available
user_online_status
gender
avatar_id

依据应用界面重构的示意示例，并非实时抓包。

PUT /v1/account/profile HTTP/1.1
Authorization: Bearer <firebase-id-token>
X-Device-FID: <device-installation-id>
Content-Type: application/json

{
  "name": "Ada Khan",
  "about": "Practicing business English",
  "profession": "Software Engineer",
  "goal": "Fluency",
  "interest": ["travel", "tech"],
  "english_level": "B2",
  "partner_preference": "any",
  "location_city": "Karachi",
  "location_country": "Pakistan",
  "location_country_code": "PK",
  "notifications": true,
  "notify_me_available": true,
  "user_online_status": true,
  "gender": "FEMALE",
  "avatar_id": "12"
}

{
  "message": "updated",
  "user": {
    "id": "usr_8f3c1d2e",
    "name": "Ada Khan",
    "english_level": "B2",
    "location_city": "Karachi",
    "location_country_code": "PK",
    "gender": "FEMALE",
    "avatar_id": "12",
    "updated_at": "2026-09-26T11:20:00Z"
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据编辑资料表单及其保存的字段集合重构。

匹配练习搭档

POST /v1/matchmaking/partner osint

按 gender / english_level / profession 匹配实时英语练习搭档，并返回 RTC 房间凭证与搭档身份卡片。

认证方式： Authorization: Bearer <firebase-id-token>；X-Device-FID 设备安装头部。

gender
english_level
profession
callId
roomId
status
zegoAppId
zegoUserId
token
tokenExpireInSeconds
waitingForPartner
partner
id
name
avatar_id
rating_average
is_friend
country
interests

依据应用界面重构的示意示例，并非实时抓包。

POST /v1/matchmaking/partner HTTP/1.1
Authorization: Bearer <firebase-id-token>
X-Device-FID: <device-installation-id>
Content-Type: application/json

{
  "gender": "FEMALE",
  "english_level": "B2",
  "profession": "Software Engineer"
}

{
  "message": "matched",
  "callId": "call_91ab",
  "roomId": "room_44c1",
  "status": "matched",
  "zegoAppId": 1234567890,
  "zegoUserId": "usr_8f3c1d2e",
  "token": "<rtc-room-token>",
  "tokenExpireInSeconds": 3600,
  "waitingForPartner": false,
  "partner": {
    "id": "usr_partner",
    "name": "Jordan Lee",
    "gender": "MALE",
    "avatar_id": "4",
    "about": "IELTS practice",
    "rating_average": 4.6,
    "is_friend": false,
    "english_level": "B2",
    "country": "IN",
    "profession": "Student",
    "interests": ["movies"]
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据搭档搜索流程重构。
响应将匹配到的搭档卡片与 RTC 房间加入凭证配对返回。

获取通话历史

GET /v1/sessions/history osint

返回过往的练习通话，含搭档身份、durationSeconds、direction 与时间戳。

认证方式： Authorization: Bearer <firebase-id-token>；X-Device-FID 设备安装头部。

message
calls
callId
roomId
status
direction
durationSeconds
startedAt
endedAt
createdAt
partner
name
country
english_level

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/sessions/history HTTP/1.1
Authorization: Bearer <firebase-id-token>
X-Device-FID: <device-installation-id>

{
  "message": "ok",
  "calls": [
    {
      "callId": "call_91ab",
      "roomId": "room_44c1",
      "status": "ended",
      "direction": "outgoing",
      "durationSeconds": 312,
      "startedAt": "2026-09-26T10:00:00Z",
      "endedAt": "2026-09-26T10:05:12Z",
      "createdAt": "2026-09-26T10:00:00Z",
      "partner": {
        "id": "usr_partner",
        "name": "Jordan Lee",
        "gender": "MALE",
        "avatar_id": "4",
        "english_level": "B2",
        "country": "IN",
        "profession": "Student",
        "rating_average": 4.6,
        "is_friend": false
      }
    }
  ]
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据通话历史列表界面重构。

获取 AI 通话报告

GET /v1/sessions/{callId}/review opendata

返回通话后的 AI 辅导报告：fluency/grammar/vocabulary/overall 评分，以及来自通话文本的纠错句子。

认证方式： Authorization: Bearer <firebase-id-token>；X-Device-FID 设备安装头部。

call_id
duration_seconds
ended_at
has_transcript
can_regenerate
regenerated
result
scores
fluency
grammar
overall
vocabulary
summary
sentences
original
corrected
start_ms
mistakes

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/sessions/call_91ab/review HTTP/1.1
Authorization: Bearer <firebase-id-token>
X-Device-FID: <device-installation-id>

{
  "message": "ok",
  "call_id": "call_91ab",
  "duration_seconds": 312,
  "ended_at": "2026-09-26T10:05:12Z",
  "has_transcript": true,
  "can_regenerate": true,
  "regenerated": false,
  "result": {
    "scores": {
      "fluency": 7.4,
      "grammar": 6.8,
      "overall": 7.1,
      "vocabulary": 7.0
    },
    "summary": "Clear B2 conversation about travel plans.",
    "unclear": [],
    "sentences": [
      {
        "id": 1,
        "start_ms": 1200,
        "original": "I go to market yesterday",
        "corrected": "I went to the market yesterday",
        "mistakes": []
      }
    ],
    "strengths": [],
    "moderation": []
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据通话后辅导报告界面重构。
评分名称与 fluency、grammar、vocabulary、overall 图表一致。

获取好友列表
GET /v1/contacts osint
列出已接受的好友，含在线状态（user_online_status）、国家、职业与 avatar_id。
认证方式： Authorization: Bearer <firebase-id-token>；X-Device-FID 设备安装头部。
- message
- friends
- friendshipId
- id
- name
- avatar_id
- profession
- gender
- country
- user_online_status
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/contacts HTTP/1.1
Authorization: Bearer <firebase-id-token>
X-Device-FID: <device-installation-id>
```
```
{
  "message": "ok",
  "friends": [
    {
      "friendshipId": "fs_22",
      "id": "usr_partner",
      "name": "Jordan Lee",
      "avatar_id": "4",
      "profession": "Student",
      "gender": "MALE",
      "country": "IN",
      "user_online_status": true
    }
  ]
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据好友列表界面重构。

获取好友资料

GET /v1/contacts/{friendId}/profile osint

为好友详情页水合好友身份卡片，包括 email、城市/国家与 english_level。

认证方式： Authorization: Bearer <firebase-id-token>；X-Device-FID 设备安装头部。

message
friend
friendshipId
id
name
email
avatar_id
user_online_status
about
interest
profession
english_level
location_city
location_country
location_country_code
gender

依据应用界面重构的示意示例，并非实时抓包。

GET /v1/contacts/usr_partner/profile HTTP/1.1
Authorization: Bearer <firebase-id-token>
X-Device-FID: <device-installation-id>

{
  "message": "ok",
  "friend": {
    "friendshipId": "fs_22",
    "id": "usr_partner",
    "name": "Jordan Lee",
    "email": "[email protected]",
    "avatar_id": "4",
    "user_online_status": true,
    "about": "IELTS practice",
    "interest": ["movies"],
    "profession": "Student",
    "english_level": "B2",
    "location_city": "Bengaluru",
    "location_country": "India",
    "location_country_code": "IN",
    "gender": "MALE"
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据好友详情界面重构。

获取在线用户数
GET /v1/presence/online opendata
返回搭档搜索面板上显示的实时 onlineCount。
认证方式： Authorization: Bearer <firebase-id-token>；X-Device-FID 设备安装头部。
- message
- onlineCount
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/presence/online HTTP/1.1
Authorization: Bearer <firebase-id-token>
X-Device-FID: <device-installation-id>
```
```
{
  "message": "ok",
  "onlineCount": 1842
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据搭档搜索面板上的在线计数器重构。
获取通知列表
GET /v1/inbox osint
返回应用内收件箱（friend_request / fcm_message / user_message）以及 unread_count。
认证方式： Authorization: Bearer <firebase-id-token>；X-Device-FID 设备安装头部。
- message
- unread_count
- notifications
- id
- title
- body
- type
- created_at
- avatar_id
- gender
- friendship_id
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/inbox HTTP/1.1
Authorization: Bearer <firebase-id-token>
X-Device-FID: <device-installation-id>
```
```
{
  "message": "ok",
  "unread_count": 2,
  "notifications": [
    {
      "id": "ntf_01",
      "title": "Friend request",
      "body": "Jordan Lee sent you a friend request",
      "type": "friend_request",
      "created_at": "2026-09-26T09:40:00Z",
      "avatar_id": "4",
      "gender": "MALE",
      "friendship_id": "fs_22"
    }
  ]
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据通知收件箱及其未读角标重构。

呼叫好友

POST /v1/sessions/direct osint

向某个 friendId 发起直接语音通话，并返回 RTC 房间凭证与搭档卡片。

认证方式： Authorization: Bearer <firebase-id-token>；X-Device-FID 设备安装头部。

friendId
message
type
callId
roomId
role
status
zegoAppId
zegoUserId
token
tokenExpireInSeconds
partner

依据应用界面重构的示意示例，并非实时抓包。

POST /v1/sessions/direct HTTP/1.1
Authorization: Bearer <firebase-id-token>
X-Device-FID: <device-installation-id>
Content-Type: application/json

{
  "friendId": "usr_partner"
}

{
  "message": "ringing",
  "type": "outgoing",
  "callId": "call_a2c4",
  "roomId": "room_77e0",
  "role": "caller",
  "status": "ringing",
  "zegoAppId": 1234567890,
  "zegoUserId": "usr_8f3c1d2e",
  "token": "<rtc-room-token>",
  "tokenExpireInSeconds": 3600,
  "partner": {
    "id": "usr_partner",
    "name": "Jordan Lee",
    "gender": "MALE",
    "avatar_id": "4",
    "english_level": "B2",
    "country": "IN",
    "is_friend": true
  }
}

依据应用界面推导；端点细节为示意说明，并非实际抓包。

依据好友详情界面的直接呼叫操作重构。

翻译文本
GET /v1/translate/text opendata
在源语言与目标语言之间翻译自由文本；客户端把返回的分段拼接为显示的字符串。
认证方式：无。公共翻译查询，携带客户端标记、源/目标语言代码以及原始查询文本。
- sl
- tl
- q
- client
- dt
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/translate/text?client=app&dt=t&sl=en&tl=es&q=good%20morning HTTP/1.1
```
```
{
  "segments": [
    {
      "translated": "buenos días",
      "original": "good morning"
    }
  ],
  "detected_source": "en"
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据文本翻译界面重构。
- 查询携带客户端标记、源/目标语言代码以及原始短语。
OpenAI 聊天补全
POST /v1/tutor/chat opendata
驱动应用内 AI 辅导 / 洞察聊天（gpt-3.5-turbo，temperature 0.7，max_completion_tokens 500），并使用语言代码系统提示词。
认证方式：每次调用均携带 Authorization: Bearer <api-key> 与 Content-Type: application/json。
- model
- messages
- role
- content
- temperature
- max_completion_tokens
- id
- created
- choices
- index
- message
依据应用界面重构的示意示例，并非实时抓包。
```
POST /v1/tutor/chat HTTP/1.1
Authorization: Bearer <api-key>
Content-Type: application/json

{
  "model": "gpt-3.5-turbo",
  "messages": [
    {"role": "system", "content": "Reply all chats only in `es` language code"},
    {"role": "user", "content": "How do I say good morning?"}
  ],
  "temperature": 0.7,
  "max_completion_tokens": 500
}
```
```
{
  "id": "chatcmpl-8f3c",
  "created": 1758873600,
  "model": "gpt-3.5-turbo",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Buenos días."
      }
    }
  ]
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据 AI 辅导聊天流程重构。
- 系统提示词将回复固定为学习者所选的语言代码。
英语词典查询
GET /v1/dictionary/entries/{word} opendata
为应用内词典面板查询英语单词（phonetic、meanings、definitions、examples）。
认证方式：无。公共词典数据源。
- word
- phonetic
- meanings
- partOfSpeech
- definitions
- definition
- example
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/dictionary/entries/hello HTTP/1.1
```
```
[
  {
    "word": "hello",
    "phonetic": "/həˈloʊ/",
    "meanings": [
      {
        "partOfSpeech": "noun",
        "definitions": [
          {
            "definition": "A greeting.",
            "example": "She gave a cheerful hello."
          }
        ]
      }
    ]
  }
]
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据应用内词典面板重构。
货币汇率换算
GET /v1/fx/rates/{fromCurrency} opendata
获取 fromCurrency 的最新汇率表，供应用内换算器把金额换算为 toCurrency。
认证方式：无。公共货币汇率数据源。
- date
- fromCurrency
依据应用界面重构的示意示例，并非实时抓包。
```
GET /v1/fx/rates/usd HTTP/1.1
```
```
{
  "date": "2026-09-26",
  "usd": {
    "inr": 83.21,
    "idr": 15420.5,
    "brl": 5.42,
    "eur": 0.91
  }
}
```
依据应用界面推导；端点细节为示意说明，并非实际抓包。
- 依据货币换算器界面重构。

数据类别

资料
搭档匹配
通话历史
AI 评分
在线状态
通知
翻译
词典
汇率

数据使用场景与案例

练习搭档身份图谱
语言学习 CRM 可关联 /v1/account/profile、/v1/contacts 与 /v1/contacts/{friendId}/profile，构建含 email、城市、english_level 与在线状态的练习搭档图谱。
口语评分时间序列
辅导仪表盘可先轮询 /v1/sessions/history 再查 /v1/sessions/{callId}/review，按学习者每周绘制 fluency、grammar、vocabulary 与 overall 评分曲线。
实时匹配容量
运营看板可关注 /v1/presence/online 及匹配的 waitingForPartner 标记，查看排队与已匹配的学习者数量。
翻译加汇率叠加
旅行助手可调用 /v1/translate/text 查询、词典词条与 /v1/fx/rates/{fromCurrency} 汇率表，展示短语并叠加实时货币换算。

常见问题

全语言翻译如何认证语音通话 API？

客户端把 Firebase idToken 提交到 POST /v1/auth/session/verify，随后在 GET /v1/account/profile、POST /v1/matchmaking/partner 等调用中发送 Authorization: Bearer <firebase-id-token> 与 X-Device-FID 设备头。

哪些字段标识匹配到的练习搭档？

POST /v1/matchmaking/partner 返回 partner.id、name、gender、avatar_id、english_level、country、profession、interests、rating_average 与 is_friend，以及 callId、roomId、zegoAppId、zegoUserId 和 token。

流利度评分存储在哪里？

GET /v1/sessions/{callId}/review 返回 result.scores（fluency、grammar、overall、vocabulary），以及 sentences[].original / corrected 和 duration_seconds。

哪些公共源驱动翻译与汇率？

文本翻译用 GET /v1/translate/text（sl、tl、q）。AI 辅导提交到 POST /v1/tutor/chat。词典查询用 GET /v1/dictionary/entries/{word}。汇率用 GET /v1/fx/rates/{fromCurrency} 获取以基础货币为键的汇率表。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

全语言翻译数据 API

应用截图

API 端点一览

校验 Firebase ID token

获取已登录用户资料

更新用户资料

匹配练习搭档

获取通话历史

获取 AI 通话报告

获取好友列表

获取好友资料

获取在线用户数

获取通知列表

呼叫好友

翻译文本

OpenAI 聊天补全

英语词典查询

货币汇率换算

数据类别

数据使用场景与案例

练习搭档身份图谱

口语评分时间序列

实时匹配容量

翻译加汇率叠加

常见问题

更多效率工具类应用

Genius Scan - PDF Scanner

PDF Scanner app - TapScanner

Simple Scan - PDF Scanner App

Vault - Hide Pics, App Lock

相关主题

需要集成这个 App 的数据 API？

全语言翻译数据 API

应用截图

API 端点一览

校验 Firebase ID token

获取已登录用户资料

更新用户资料

匹配练习搭档

获取通话历史

获取 AI 通话报告

获取好友列表

获取好友资料

获取在线用户数

获取通知列表

呼叫好友

翻译文本

OpenAI 聊天补全

英语词典查询

货币汇率换算

数据类别

数据使用场景与案例

练习搭档身份图谱

口语评分时间序列

实时匹配容量

翻译加汇率叠加

常见问题

相关应用

更多效率工具类应用

Genius Scan - PDF Scanner

PDF Scanner app - TapScanner

Simple Scan - PDF Scanner App

Vault - Hide Pics, App Lock

相关主题

需要集成这个 App 的数据 API？