TeamViewer Remote Control 数据 API

TeamViewer Remote Control 是 TeamViewer 远程访问平台的安卓客户端：工程师、服务台与托管服务商用它从手机连接无人值守的计算机、协助最终用户并处理自己的 Computers & Contacts 列表。它服务于美国、巴西、印度、墨西哥与阿联酋的远程支持与 IT 管理市场，是分布式 IT 团队的标准工具。

作为数据源，应用暴露的正是这些界面背后的对象：带 emailAddress 与 companyName 的账户记录、numberOfChannels 等许可证权益、携带 teamViewerId、onlineStatus 与 isWakeOnLanPossible 的设备目录，以及含 sessioncode 与 joinSessionUrlForRecipient 的支持工单。集成构建者基于这一数据面实现 ITAM 资产盘点、服务台会话交接与许可证席位对账。

TeamViewer Remote Control 是 TeamViewer 的安卓应用，可从手机发起远程支持与无人值守访问会话，是 IT 团队、服务台与托管服务商所用平台的移动端入口，在美国、巴西、印度、墨西哥与阿联酋上架。应用界面背后是一套带许可证权益的登录账户资料、含在线状态与 Wake-on-LAN 标记的 Computers & Contacts 设备目录，以及带加入链接的支持工单记录。这些数据可驱动 CMDB 资产清单同步、服务台工单交接与许可证席位对账。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

签发登录令牌
POST /v1/session/token opendata
铸造登录令牌，令牌登录调用及之后所有 Bearer 请求都依靠它保持控制端的已登录状态。
认证方式：需要已登录的 TeamViewer 账户会话。返回的令牌在之后的账户、联系人、设备与远程控制调用中以 Authorization: Bearer 发送。
- token
- tokenId
- accountId
- ssoVerificationToken
```
POST /v1/session/token HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session
Accept: application/json
```
```
{
  "token": "tv-login-7f3c9a21e8b04d11",
  "tokenId": 88421,
  "accountId": 12345678,
  "ssoVerificationToken": null
}
```
- 依据应用的登录流程重构。
- 响应字段与登录后应用保存的会话状态一致。
使用登录令牌登录
POST /v1/session/token-login opendata
完成令牌登录，使 Computers & Contacts 与远程控制界面接受该 Bearer 会话。
认证方式：交换本身无需认证。请求体携带来自 POST /v1/session/token 的 token、tokenId 与 accountId；后续调用附加 Authorization: Bearer。
- token
- tokenId
- accountId
- ssoVerificationToken
- keepMeSignedIn
```
POST /v1/session/token-login HTTP/1.1
Content-Type: application/json

{
  "token": "tv-login-7f3c9a21e8b04d11",
  "tokenId": 88421,
  "accountId": 12345678,
  "ssoVerificationToken": null,
  "keepMeSignedIn": true
}
```
```
{
  "ok": true
}
```
- 依据应用的老用户登录流程重构。

读取已登录账户

GET /v1/account osint

加载账户界面使用的已登录身份：显示名、邮箱、公司成员信息与生效的许可证功能。

认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。

accountId
profile
displayName
emailAddress
pictureUrl
state
accountCompanyInfo
accountJoinCompanyState
isInCompany
companyId
companyName
effectiveLicenseFeatures
loginType
isTenantManager
accountType

GET /v1/account HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json

{
  "accountId": 12345678,
  "profile": {
    "displayName": {"value": "Alex Rivera"},
    "emailAddress": {"value": "[email protected]"},
    "pictureUrl": {"value": "https://cdn.example.com/avatar/12345678.png"}
  },
  "state": "Online",
  "accountCompanyInfo": {
    "accountJoinCompanyState": "Joined",
    "isInCompany": true,
    "companyId": 44012,
    "companyName": "Acme IT Services"
  },
  "effectiveLicenseFeatures": [1, 4, 9],
  "loginType": "Regular",
  "isTenantManager": false,
  "accountType": "Regular"
}

依据应用的账户界面重构。
字段分组与该界面展示的资料、公司与许可证面板一一对应。

列出账户许可证

GET /v1/account/licenses opendata

返回账户的远程控制、IoT、协助、备份、MDM、监控与端点防护席位，这些席位决定会话通道的上限。

认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。

tvLicense
licenseType
displayname
numberOfChannels
licenseId
iotLicense
pilotLicense
backupLicenses
mobileDeviceManagementLicenses
monitoringLicenses
endpointProtectionLicenses
advancedAssetManagementLicenses
highestBusinessLicense

GET /v1/account/licenses HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json

{
  "tvLicense": {
    "licenseType": "Corporate",
    "displayname": "TeamViewer Corporate",
    "numberOfChannels": 15,
    "licenseId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "iotLicense": {"licenseType": "IoT"},
  "pilotLicense": {"licenseType": "Pilot", "displayname": "Frontline"},
  "backupLicenses": [],
  "mobileDeviceManagementLicenses": [],
  "monitoringLicenses": [],
  "endpointProtectionLicenses": [],
  "advancedAssetManagementLicenses": [],
  "highestBusinessLicense": 15
}

依据账户界面的许可证区块重构。

读取两步验证状态
GET /v1/account/security/two-factor opendata
报告已登录账户是否启用了两步验证。
认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。
- enabled
```
GET /v1/account/security/two-factor HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json
```
```
{
  "enabled": true
}
```
- 依据应用的安全设置界面重构。
列出受信任设备
GET /v1/account/trusted-devices osint
分页返回账户标记为受信任的设备，用于跳过两步验证与生物识别解锁流程。
认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。可选的续页令牌查询参数。
- trustedDevices
- teamviewerId
- trustOrigin
- displayName
- validOnce
- isCurrentDevice
- continuationToken
```
GET /v1/account/trusted-devices HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json
```
```
{
  "trustedDevices": [
    {
      "teamviewerId": 123456789,
      "trustOrigin": "Password",
      "displayName": "Alex's Pixel 8",
      "validOnce": false,
      "isCurrentDevice": true
    }
  ],
  "continuationToken": null
}
```
- 依据账户安全设置中的受信任设备列表重构。
读取远程会话指标
GET /v1/account/session-stats opendata
返回账户已运行的远程会话数量，用于账户界面的洞察条带。
认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。
- remoteSessionsCount
```
GET /v1/account/session-stats HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json
```
```
{
  "remoteSessionsCount": 42
}
```
- 依据账户界面的用量洞察条带重构。
读取 SSO 认证主机
GET /v1/account/sso opendata
返回账户通过身份提供商登录时使用的公司单点登录主机 URL。
认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。
- hostUrl
```
GET /v1/account/sso HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json
```
```
{
  "hostUrl": "https://login.example.com/acme"
}
```
- 依据企业登录流程重构。

列出个人联系人

GET /v1/contacts osint

分页返回 Computers & Contacts 合作伙伴列表，含在线状态、邮箱与分组归属。

认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。可选的分页令牌查询参数。

items
personalContactId
accountId
name
status
ownership
pictureUrl
groupId
groupName
email
description
nextPaginationToken

GET /v1/contacts HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json

{
  "items": [
    {
      "personalContactId": 90011,
      "accountId": 55667788,
      "name": "Jordan Lee",
      "status": "Online",
      "ownership": "Own",
      "pictureUrl": "https://cdn.example.com/avatar/90011.png",
      "groupId": 12,
      "groupName": "Helpdesk",
      "email": "[email protected]",
      "description": "Night shift"
    }
  ],
  "nextPaginationToken": "eyJwYWdlIjoyfQ"
}

依据 Computers & Contacts 标签页重构。
分页令牌与该列表的无限滚动行为一致。

获取单个个人联系人

GET /v1/contacts/{contactId} osint

加载单个 Computers & Contacts 合作伙伴的详情记录，含邮箱、备注与操作/视图设置。

认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。

personalContactId
accountId
name
status
ownership
pictureUrl
groupId
groupName
email
description
note
actionSettings
viewSettings

GET /v1/contacts/90011 HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json

{
  "personalContactId": 90011,
  "accountId": 55667788,
  "name": "Jordan Lee",
  "status": "Online",
  "ownership": "Own",
  "pictureUrl": "https://cdn.example.com/avatar/90011.png",
  "groupId": 12,
  "groupName": "Helpdesk",
  "email": "[email protected]",
  "description": "Night shift",
  "note": "On-call printer queue"
}

依据联系人详情面板重构。

列出计算机分组
GET /v1/device-groups opendata
分页返回 Computers & Contacts 分组及其共享权限与所有者，用作设备标签页的分组树。
认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。可选的分页令牌与页大小查询参数。
- items
- groupId
- name
- shareStatus
- shareRight
- owner
- accountId
- nextPaginationToken
```
GET /v1/device-groups HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json
```
```
{
  "items": [
    {
      "groupId": 12,
      "name": "Helpdesk",
      "shareStatus": "Shared",
      "shareRight": "FullAccess",
      "owner": {
        "accountId": 12345678,
        "name": "Alex Rivera"
      }
    }
  ],
  "nextPaginationToken": null
}
```
- 依据设备标签页的分组树重构。

列出分组内的计算机

GET /v1/device-groups/{groupId}/computers opendata

返回一个分组内的计算机，含数字设备 ID、在线状态与 Wake-on-LAN 标记。

认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。可选的分页令牌与页大小查询参数。

items
deviceId
teamViewerId
displayName
onlineStatus
groupId
isManagedDevice
deviceType
notes
managedState
isWakeOnLanPossible
isMobileWakeActivated
hasPermanentPassword
isKnownDevice
nextPaginationToken

GET /v1/device-groups/12/computers HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json

{
  "items": [
    {
      "deviceId": 4410,
      "teamViewerId": 123456789,
      "displayName": "NYC-FS01",
      "onlineStatus": "Online",
      "groupId": 12,
      "isManagedDevice": true,
      "deviceType": "Desktop",
      "notes": "File server",
      "managedState": "Managed",
      "isWakeOnLanPossible": true,
      "isMobileWakeActivated": false,
      "hasPermanentPassword": true,
      "isKnownDevice": true
    }
  ],
  "nextPaginationToken": null
}

依据分组的设备列表重构。

获取单个受管设备

GET /v2/devices/{deviceId} opendata

加载 Computers & Contacts 条目的受管设备详情（操作系统、客户端版本、最后在线时间、管理者）。

认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。

managementId
displayName
teamViewerId
onlineStatus
deviceType
operatingSystemType
tvVersion
lastSeenTimestamp
groupIds
hasPassword
moduleType
managers

GET /v2/devices/3fa85f64-5717-4562-b3fc-2c963f66afa6 HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json

{
  "managementId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "displayName": "NYC-FS01",
  "teamViewerId": 123456789,
  "onlineStatus": "Online",
  "deviceType": "Desktop",
  "operatingSystemType": "Windows",
  "tvVersion": "15.81.247",
  "lastSeenTimestamp": "2026-09-28T18:04:11Z",
  "groupIds": ["7c9e6679-7425-40de-944b-e07fc1f90ae7"],
  "hasPassword": true,
  "moduleType": "Host"
}

依据受管设备详情页重构。

列出最近连接
GET /v1/connections/recent opendata
返回“最近”条带：最近连接过的远程控制伙伴，含 connectId、lastConnectionDate 与在线状态。
认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。
- displayName
- itemType
- canBeAddedToPartnerList
- connectId
- isMyself
- lastConnectionDate
- onlineState
- pictureUrl
- buddyId
- ownership
```
GET /v1/connections/recent HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json
```
```
[
  {
    "displayName": "NYC-FS01",
    "itemType": "Device",
    "canBeAddedToPartnerList": true,
    "connectId": 123456789,
    "isMyself": false,
    "lastConnectionDate": "2026-09-28T17:51:02Z",
    "onlineState": "Online",
    "pictureUrl": null,
    "buddyId": 4410,
    "ownership": "Own"
  }
]
```
- 依据连接界面的“最近”条带重构。
按 TeamViewer ID 连接
POST /v1/remote-sessions/connect opendata
从连接界面向数字伙伴 ID 发起远程控制会话。
认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。
- teamviewerId
- connectionMode
- promptForConfirmation
- thirdPartyFeature
```
POST /v1/remote-sessions/connect HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Content-Type: application/json

{
  "teamviewerId": 123456789,
  "connectionMode": "RemoteControl",
  "promptForConfirmation": true,
  "thirdPartyFeature": null
}
```
```
{
  "ok": true
}
```
- 依据连接界面的伙伴 ID 表单重构。

创建支持会话

POST /v1/support-cases osint

创建一次性支持工单，含会话码、收件人邮箱与加入链接，并进入会话列表。

认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。

validityInMinutes
name
email
assignedAccountId
groupId
supportSessionType
sessioncode
createdAt
validUntil
joinSessionUrlForRecipient
recipientStatus
state
password
duration
customerClientId
supporterClientId

POST /v1/support-cases HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Content-Type: application/json

{
  "validityInMinutes": 60,
  "name": "Printer outage",
  "email": "[email protected]",
  "assignedAccountId": 12345678,
  "groupId": 12,
  "supportSessionType": "RemoteControl"
}

{
  "sessioncode": 881122334,
  "createdAt": "2026-09-29T07:10:00Z",
  "validUntil": "2026-09-29T08:10:00Z",
  "joinSessionUrlForRecipient": "https://join.example.com/s/881122334",
  "recipientStatus": "Pending",
  "assignedAccountId": 12345678,
  "groupId": 12,
  "name": "Printer outage",
  "email": "[email protected]",
  "supportSessionType": "RemoteControl",
  "state": "Open",
  "password": "7kQ2nP"
}

依据创建支持会话的表单重构。

列出聊天消息

GET /v1/conversations/{conversationId}/messages opendata

分页返回会话中的消息（作者、正文、writtenAt、readAt），供会话内聊天面板使用。

认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。

allMessagesLoaded
messages
authorId
authorDisplayName
messageId
conversationId
writtenAt
isEventMessage
text
clientMessageId
readAt

GET /v1/conversations/3fa85f64-5717-4562-b3fc-2c963f66afa6/messages HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Accept: application/json

{
  "allMessagesLoaded": false,
  "messages": [
    {
      "authorId": "12345678",
      "authorDisplayName": "Alex Rivera",
      "messageId": "9c8e6679-7425-40de-944b-e07fc1f90ae7",
      "conversationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "writtenAt": "2026-09-28T16:22:09Z",
      "isEventMessage": false,
      "text": "Can you share the error screenshot?",
      "clientMessageId": 41,
      "readAt": "2026-09-28T16:22:40Z"
    }
  ]
}

依据会话内聊天面板重构。

唤醒移动设备
POST /v1/devices/wake-mobile opendata
向以设备 ID 标识的移动主机发送唤醒推送，使远程控制尝试得以继续。
认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。
- teamviewerId
- result
```
POST /v1/devices/wake-mobile HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Content-Type: application/json

{
  "teamviewerId": 987654321
}
```
```
{
  "result": "WakeSent"
}
```
- 依据离线移动主机上显示的唤醒操作重构。
局域网唤醒计算机
POST /v1/devices/wake-on-lan opendata
向已设置 Wake-on-LAN 能力标记的主机发送 Wake-on-LAN 请求。
认证方式： Authorization: Bearer <token>，来自 POST /v1/session/token。
- teamviewerId
- result
```
POST /v1/devices/wake-on-lan HTTP/1.1
Authorization: Bearer tv-login-7f3c9a21e8b04d11
Content-Type: application/json

{
  "teamviewerId": 123456789
}
```
```
{
  "result": "WakeSent"
}
```
- 依据离线桌面上显示的唤醒操作重构。

数据类别

账户资料
许可证
受信任设备
联系人
设备分组
受管设备
最近连接
支持会话
聊天消息

数据使用场景与案例

基于 Computers & Contacts 的 ITAM 资产盘点
CMDB 任务分页拉取分组列表、各分组内的计算机与受管设备详情（GET /v1/device-groups、GET /v1/device-groups/{groupId}/computers、GET /v2/devices/{deviceId}），为组内每台主机更新 teamViewerId、displayName、onlineStatus、operatingSystemType 与 tvVersion。
服务台会话交接
工单机器人携带最终用户邮箱调用 POST /v1/support-cases 创建支持工单，再把 sessioncode、joinSessionUrlForRecipient 与 validUntil 记录到工单上，被指派的工程师无需在聊天中共享密码即可加入会话。
许可证席位对账
FinOps 拉取许可证权益（numberOfChannels 及 MDM、备份席位）与 remoteSessionsCount 用量计数器，将合同购买的通道数与实际远程控制量比对。
合作伙伴目录同步
身份数据源读取联系人列表（name、email、status、groupName）与受信任设备列表（teamviewerId、displayName、isCurrentDevice），维护一份可无人值守触达对象的内部通讯录。

常见问题

TeamViewer Remote Control 如何认证 API 调用？

会话调用（POST /v1/session/token）返回 token、tokenId 与 accountId，令牌登录调用完成登录。之后的每一次账户、联系人、设备与远程控制请求都以 Authorization: Bearer 头携带该令牌。

哪些调用列出 Computers & Contacts 背后的计算机？

GET /v1/device-groups 分页返回分组，GET /v1/device-groups/{groupId}/computers 返回每台机器的 teamViewerId、displayName、onlineStatus 与 Wake-on-LAN 标记。operatingSystemType 与 tvVersion 等受管设备详情来自 GET /v2/devices/{deviceId}。

可以读取支持会话的加入链接与收件人邮箱吗？

可以。在 POST /v1/support-cases 创建工单会返回 sessioncode、email、joinSessionUrlForRecipient、validUntil 与 state，工单系统把会话交给工程师所需的一切都包含在内。

账户邮箱与许可证席位数量在哪里？

GET /v1/account 返回带 displayName 与 emailAddress 的资料及公司成员信息，GET /v1/account/licenses 返回 numberOfChannels 以及备份、MDM、监控与端点防护席位。

与 TeamViewer Remote Control 相似的应用

AnyDesk — 一款远程桌面软件，采用自研 DeskRT 编解码器连接电脑和移动设备，实现低延迟会话，个人使用免费。
Splashtop — 远程访问与支持工具，覆盖 Windows、Mac、iOS、Android 和 Chrome OS，会话内置文件传输、聊天和远程打印功能。
Chrome Remote Desktop — 谷歌推出的免费远程访问服务，基于浏览器运行，各设备通过登录同一个 Google 账户进行关联。
RustDesk — 开源远程桌面软件，支持自托管部署，让组织自行掌控会话数据的中转位置。
Zoho Assist — Zoho 出品的云端远程支持与无人值守访问工具，可与工单系统及 Zoho 其他产品集成。
Microsoft Remote Desktop — 微软免费的远程桌面客户端，用于连接 Windows 电脑，仅支持运行 Windows 专业版或企业版的主机。
ConnectWise ScreenConnect — 面向 IT 支持团队的远程支持平台，提供自托管部署选项和 API 集成。

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

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

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

获取报价

TeamViewer Remote Control 数据 API

应用截图

API 端点一览

签发登录令牌

使用登录令牌登录

读取已登录账户

列出账户许可证

读取两步验证状态

列出受信任设备

读取远程会话指标

读取 SSO 认证主机

列出个人联系人

获取单个个人联系人

列出计算机分组

列出分组内的计算机

获取单个受管设备

列出最近连接

按 TeamViewer ID 连接

创建支持会话

列出聊天消息

唤醒移动设备

局域网唤醒计算机

数据类别

数据使用场景与案例

基于 Computers & Contacts 的 ITAM 资产盘点

服务台会话交接

许可证席位对账

合作伙伴目录同步

常见问题

与 TeamViewer Remote Control 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Google Ads

相关主题

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

TeamViewer Remote Control 数据 API

应用截图

API 端点一览

签发登录令牌

使用登录令牌登录

读取已登录账户

列出账户许可证

读取两步验证状态

列出受信任设备

读取远程会话指标

读取 SSO 认证主机

列出个人联系人

获取单个个人联系人

列出计算机分组

列出分组内的计算机

获取单个受管设备

列出最近连接

按 TeamViewer ID 连接

创建支持会话

列出聊天消息

唤醒移动设备

局域网唤醒计算机

数据类别

数据使用场景与案例

基于 Computers & Contacts 的 ITAM 资产盘点

服务台会话交接

许可证席位对账

合作伙伴目录同步

常见问题

相关应用

与 TeamViewer Remote Control 相似的应用

更多企业办公类应用

ADP Mobile Solutions

Box

CryptoRush: Crypto Simulator

Google Ads

相关主题

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