TeamViewer Remote Control 图标

TeamViewer Remote Control 数据 API

TeamViewer · 企业办公

TeamViewer Remote Control 是总部位于德国格平根的远程连接厂商 TeamViewer 推出的安卓控制端应用,用手机即可接管电脑或另一台移动设备。在“连接”界面输入数字 TeamViewer ID 即可发起远程控制会话,“最近连接”栏可快速回连上次的伙伴,Computers & Contacts 标签页按共享设备组列出每台电脑的在线状态,并把个人联系人按分组整理。技术人员可以创建带会话码和加入链接的一次性支持会话发给终端用户,通过会话内聊天面板与对方沟通,并在连接前用网络唤醒(Wake-on-LAN)或移动唤醒推送唤起离线主机。登录支持经身份提供商的企业单点登录、双因素认证以及用于生物识别解锁的受信任设备;账户页显示所属公司、许可证包含的远程控制通道数,以及 IoT、Pilot(现名 Assist AR)、备份、移动设备管理、监控与端点防护等附加许可。它是 IT 部门、服务台和托管服务商开展远程支持与无人值守访问所用平台的移动端,与 AnyDesk、Splashtop、Chrome 远程桌面等产品竞争,在美国、巴西、印度、墨西哥和阿联酋上架。

数字 teamViewerId 是串起整套记录的主键。Computers & Contacts 分组里的每台电脑都带有 displayName、onlineStatus、deviceType、managedState 以及 isWakeOnLanPossible 与 isMobileWakeActivated 唤醒标志,受管主机还会补充 operatingSystemType、tvVersion、lastSeenTimestamp 和 managers。设备组带有 shareStatus、shareRight 与 owner;个人联系人带有 name、email、status 与 groupName;“最近连接”则记录每个伙伴的 connectId 与 lastConnectionDate。

支持工单构成会话层:每个工单都有 sessioncode、joinSessionUrlForRecipient、validUntil、recipientStatus 与 supportSessionType,会话内聊天以带 authorDisplayName、text、writtenAt 和 readAt 的消息保存。账户侧包括账户资料(emailAddress、companyName、isTenantManager、effectiveLicenseFeatures)、从 numberOfChannels 到 mobileDeviceManagementLicenses、endpointProtectionLicenses 的许可证权益、remoteSessionsCount 用量计数器、双因素认证状态,以及标有 trustOrigin 与 isCurrentDevice 的受信任设备。

这些记录直接支撑具体集成:CMDB/ITAM 任务分页拉取设备组与电脑,为每台主机写入 teamViewerId、operatingSystemType 与 tvVersion;工单机器人创建支持工单,把会话码和加入链接存到工单上,技术人员无需在聊天里传密码即可加入;FinOps 将合同通道数及 MDM、备份席位与 remoteSessionsCount 对照;身份同步任务读取联系人和受信任设备,维护一份可无人值守联系对象的内部通讯录。openData Studio 将这套设备目录、支持会话与许可证记录变成可供这些集成直接调用的开放数据。

应用截图

  • TeamViewer Remote Control 应用截图 1
  • TeamViewer Remote Control 应用截图 2
  • TeamViewer Remote Control 应用截图 3
  • TeamViewer Remote Control 应用截图 4
  • TeamViewer Remote Control 应用截图 5
  • TeamViewer Remote Control 应用截图 6
  • TeamViewer Remote Control 应用截图 7
  • TeamViewer Remote Control 应用截图 8

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"
    }
  • 获取单个个人联系人

    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
    }
  • 创建支持会话

    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 集成。

相关主题

  • TeamViewer API
  • TeamViewer 远程控制端点
  • Computers & Contacts API
  • TeamViewer 设备
  • TeamViewer 支持会话
  • TeamViewer 账户许可证
  • TeamViewer 聊天消息
  • TeamViewer 受信任设备

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

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

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

获取报价