这才叫 API 接口设计！【通过token获取淘宝物流订单详情】

最新推荐文章于 2024-04-29 18:28:22 发布

Tinalee-电商API接口呀

最新推荐文章于 2024-04-29 18:28:22 发布

阅读量330

点赞数

文章标签： github java spring json php c++

本文链接：https://blog.csdn.net/2301_79478575/article/details/132559864

版权

本文详细介绍了淘宝API接口的设计，包括`taobao.buyer_token`和Token设计，强调了API接口设计的原则，如协议规范、接口路径、版本管理、调用门槛、返回规范和安全规范。此外，还讨论了数据防止被看到、篡改的措施，如时间戳、随机数和黑名单机制。同时，提出了接口幂等性和最佳实践，并提到了API接口管理的重要性。

摘要由CSDN通过智能技术生成

API 接口设计

taobao.buyer_token

公共参数

请求地址: 申请调用KEY地址

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

Token 设计

Token 是服务端生成的一串字符串，以作客户端进行请求的一个令牌，当第一次登录后，服务器生成一个 Token 便将此 Token 返回给客户端，以后客户端只需带上这个 Token 前来请求数据即可，无需再次带上用户名和密码。

Token 的值一般用 UUID（算法比较著名的有雪花算法），当服务端接收到客户端请求后会生成 Token（一串字符，如 etye0fgkgk4ca2ttdsl0ae9a5dd77471fgf），然后将 Token 作为 key 将一些和 Token 关联的信息作为 value 保存到如 Redis 缓存数据库中，同步把该 Token 返回给客户端；后续该客户端的请求都需要带上这个 Token，服务器收到请求后就会去缓存服务器中匹配这个 Token 是否存在，存在则调用接口，不存在返回接口错误。