Connect Your Coding (API) Skill with Your Tesla Model 3/S/X – How to Access Your Car in Your Computer

对于一个IT从业人员来说,能够通过自己的电脑来操控自己的车辆,是一件让人兴奋的事情。从此,车打破了100多年来机械产品的古板印象,摇身一变成为了充满活力的电子产品。也许这正是Tesla这类新型电动车最让人着迷的地方 – Software Define Anything,软件定义一切。 虽然特斯拉官方的API接口的说明文档,但是在Github上已经有人通过反向工程,整理并发布了一整套非官方API文档。注意只是文档是非官方的,其中描述的所有API都是特斯拉自己在iOS平台和安卓平台的官方App中使用的接口,因此这一整套API的安全性,稳定性都是可以信任的。实际上目前市面上可以看到的其它非官方用以操控Tesla车辆的应用程序,应该使用的都是这套API。 首先看一下特斯拉官方的App,在这个App里面我们可以做到如下各种操作: 获取车辆各种信息:包括剩余电量在内的各种车辆状态以及当前停车位置 唤醒车辆 启动车辆 打开和关闭车内空调 打开和关闭坐骑加热 打开前后行李厢 打开和关闭车门 打开和关闭车窗 让车辆鸣笛 让车辆闪烁车灯 打开和关闭哨兵模式 这些在官方App里面可以实现的功能,通过API也都可以通过自己写代码来实现,既然支持写代码,那么就进一步更可以做到各种智能场景,比如在iPhone手机里通过“捷径”功能,编写定时程序,让车辆在每天出门上班前的10分钟自动将车内空调打开。有了API就拥有了无穷的想象空间。 那么如何使用API来操控你的Tesla车辆,本文做简单介绍。我的车辆是Tesla Model 3,然而这套API也同样适用于Model S/X/Y,或者是Roadster,甚至是还未发售的Cybertruck。 准备条件 仔细阅读API文档,文档链接在这里。 为了测试API,要从头开始写代码有些麻烦,因此我使用了Setapp订阅里包含的软件Paw,可以直接调用和测试API。同样功能的软件还有Postman。 第一步:生成Token 整套API使用的是OAuth 2.0的鉴权协议,因此在第一步我们需要先生成可以用于之后调用API接口的Token,为了生成这个Token,需要提供在Tesla官网上注册的用户邮箱和密码,每个Tesla车主在购车前一定是需要在官方注册的,因此生成的Token也是每位车主独有的。注意,这个Token不要告诉任何其他人,否则别人就可以远程操控你的车辆了。当然,生成的Token是有失效期的,也可以手动失效。因此也无需担心安全性问题。 我们在Paw中创建一个Request,调用类型选择“POST”,调用的API地址是:https://owner-api.teslamotors.com/oauth/token?grant_type=password 当在Paw的地址栏中输入带?的URL时,Paw会自动将问号后的内容转换成URL Params部分的键值对。 在调用的Headers部分要填入:Content-Type: application/json,其中Content-Type是Header Name,而application/json是Header Value,如果不填入,在调用的时候会报错,而无法获得正确Token。 在调用的Body部分要填入API需要的入参,在文档中都有明确描述,分别是: grant_type,这是一个固定值,就是文本password; client_id,这是API提供者提供的id,也是一个固定值,是81527cff06843c8634fdc09e8ac0abefb46ac849f38fe1e431c2ef2106796384; client_secret,这是API提供者提供的密钥,也是一个固定值,是c7257eb71a564034f9419ee651c7d0e5f7aa6bfbd18bafb5c5c033b093bb2fa3; email是上面说的Tesla官网的帐号邮箱; password是上面说的Tesla官网帐号的密码。 最终整个调用在Paw中的显示如下图: 可以看到这里已经成功执行了,在右侧的结果栏中已经返回了access_token,整个返回结果的JSON格式如下: { “access_token”: “abc123”, “token_type”: “bearer”, “expires_in”: 3888000, “refresh_token”: “cba321”, “created_at”: 1538359034…