常见问题
为什么车辆配置了车队遥测报告错误
诸如“TLS 握手错误来自...:远程错误:tls:证书错误”之类的错误可能是由无效/错误的车队遥测服务器证书引起的。为了缓解这种故障模式,请确保服务器证书由普遍信任的证书颁发机构签名。
为什么有些调用返回了 429 错误?
这意味着账户已达到端点的请求速率限制。请检查 'RateLimit--Remaining' 或 'RateLimit--Reset' 请求头,以确定何时可以进行下一次请求。更多信息请参考响应代码。
为什么对车辆的一些调用返回了 408 错误?
这通常意味着设备处于离线状态。请确保设备是否有互联网连接?如果有连接,设备是否处于休眠状态(节省能量)?如果是,可能需要唤醒它。
当我收到 'Unauthorized missing scopes' 403 错误时是什么意思?
提供的令牌缺少当前资源所需的范围。查看端点的范围要求,并确保令牌具有这些范围。如果令牌未创建具有所需范围,则意味着所有者需要在授权流程中显式授予所需的范围。
为什么我的新用户 API 请求返回 unknown user?
在可以代表账户进行请求之前,账户的所有者必须至少登录一次移动应用程序。
为什么授权请求失败?
请重新阅读认证部分,并严格按照示例中的说明操作。
我的授权请求返回"We don't recognize this client_id and client_secret combination"。
应用程序如何确定用户已授予哪些范围?
解码 access_token (标准 JWT),并检查 scp
声明。
确保您按照认证部分中给出的示例操作。
为什么我的请求中没有 refresh_token?
根据授权范围部分,必须请求 offline_access
范围才能获取刷新令牌。
为什么我的刷新令牌突然无效?
刷新令牌的有效期为 3 个月。最近使用的刷新令牌的有效期最长为 24 小时。使用刷新令牌执行令牌交换时,请确保保存新的刷新令牌以供下次交换使用。
企业如何自动将车队钥匙与车辆配对?
无需签名命令的车辆在调用合作伙伴帐户注册端点后将自动配对车队密钥。自动车队密钥配对适用于管理自己的合作伙伴帐户或第三方企业帐户授权的企业。
为什么注册后产品端点返回空响应?
使用错误的令牌类型时会发生这种情况。查看 令牌类型,根据应用程序的用例确定要使用的正确令牌类型。最常见的问题是使用合作伙伴帐户令牌,而实际上需要的是第三方令牌。
Fleet API 有暂存环境吗?
不,没有可用的模拟器或暂存环境。
作为特斯拉能源产品(如 Powerwall)的安装者,为什么我们不能通过 API 访问客户产品?
Fleet API 不支持访问客户产品。通过 API 实现此目的的唯一方法是让产品所有者完成授权流程,授予您访问其产品的权限。
为什么某些与气候相关的命令会失败?
车辆必须处于允许执行与气候相关的命令的状态。例如,错误 汽车无法执行命令:未启用车舱舒适度远程设置 表示必须打开预处理或气候保持器