饿了么开放平台服务商应用／平台工具授权流程

A、客户端拼接授权需要访问的URL，示例及参数说明如下：

示例：

https://open-api-sandbox.shop.ele.me/authorize?response_type=code&client_id=9OKWbmUrKr&redirect_uri=[redirect_uri

参数说明：

参数名参数类型是否必选参数值参数释义

client_idString必选9OKWbmUrKr应用的key，创建应用时获得

response_typeString必选code授权类型，固定为code，表示授权码模式

redirect_uriString必选应用的授权回调地址redirect_uri指的是应用发起请求时，所传的回调地址参数，在用户授权后页面会跳转至redirect_uri。要求与应用注册时填写的授权回调地址一致或域名一致，并且必须支持https访问。需要进行Url Encode编码

scopeString必选all商户授权的权限范围，固定为all，表示所有权限

stateString必选String开发者自定义的应用状态，可以指定任意值，认证服务器会原样返回这个值，开发者需要确认当前授权的传入值与返回值是一致的，确保不会产生csrf漏洞。

B、引导商户到授权页，商户可以选择点击【同意授权】或者【取消授权】

C、获取授权码

如果商户点击【同意授权】，开放平台认证服务器会回应客户端的授权回调URI（redirection URI）返回以下参数：

响应示例如下：

HTTP/1.1 302 Found Location: [redirect_uri]?code=f5d9280fce5cedc761f1f19ef484e7e0&state=xyz

D、如果商户点击【取消授权】, 开放平台认证服务器会回应客户端授权回调URI，并且返回以下参数：

如果商户拒绝授权，则开放平台认证服务器会回应客户端的授权回调URI，并且返回以下参数：

HTTP/1.1 302 Found Location: [redirect_uri]?error=unauthorized_client&error_description=denied

参数说明:

E、使用授权码换取访问令牌，客户端向认证服务器发起访问令牌的请求。

示例及参数说明如下：

HTTP header中需要携带Authorization请求头，Basic值的算法如下(+号表示字符串连接)：

base64_encode(key + ":" + secret)

请求示例：

POST /token HTTP/1.1 Host: open-api-sandbox.shop.ele.me Authorization: Basic OU9LV2JtVXJLcjoyZGRiZTc2NTkzOWZhZjI5ZDEwNTU3MDg3MzVjOGViNw== Content-Type: application/x-www-form-urlencoded grant_type=authorization_code&code=f5d9280fce5cedc761f1f19ef484e7e0 &redirect_uri=[redirect_uri]&client_id=9OKWbmUrKr

CURL示例如下：

curl -i -XPOST -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic OU9LV2JtVXJLcjoyZGRiZTc2NTkzOWZhZjI5ZDEwNTU3MDg3MzVjOGViNw==" -d "grant_type=authorization_code&code=f5d9280fce5cedc761f1f19ef484e7e0&redirect_uri=[redirect_uri]&client_id=9OKWbmUrKr" https://open-api-sandbox.shop.ele.me/token

参数说明：

F、认证成功，认证服务器返回Token

示例如下：

HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Cache-Control: no-store Pragma: no-cache { "access_token":"2YotnFZFEjr1zCsicMWpAA", "trace_id": "fe.sopush_service^^5D77063E0EAC493A89780BBC3AEDB332|1703038197150", "token_type":"bear", "expires_in":3600, "refresh_token":"tGzv3JOkF0XG5Qx2TlKWIA", "scope":"all" }

参数说明:

G、刷新Token

令牌即将到期，或者开发者出于安全性考虑想要更换访问令牌，可以使用refresh_token直接换取新的access_token
A示例如下：

POST /token HTTP/1.1 Host: open-api-sandbox.shop.ele.me Authorization: Basic OU9LV2JtVXJLcjoyZGRiZTc2NTkzOWZhZjI5ZDEwNTU3MDg3MzVjOGViNw== Content-Type: application/x-www-form-urlencoded grant_type=refresh_token&refresh_token=tGzv3JOkF0XG5Qx2TlKWIA

CURL示例如下：

curl -i -XPOST -H "Content-Type: application/x-www-form-urlencoded" -H "Authorization: Basic OU9LV2JtVXJLcjoyZGRiZTc2NTkzOWZhZjI5ZDEwNTU3MDg3MzVjOGViNw==" -d "grant_type=refresh_token&refresh_token=21a5b98083e13676c5fc3948df4f0852" https://open-api-sandbox.shop.ele.me/token

参数说明: