README

接入指南

PHP version >= 5.4 & curl extension support
通过composer安装SDK
创建Config配置类，填入key，secret和sandbox参数
使用sdk提供的接口进行开发调试
上线前将Config中$sandbox值设为false以及填入正式环境的key和secret

安装

安装命令(20220605 变更)

    composer require eleme-openapi-php-sdk/eleme-openapi-php-sdk

旧安装命令(不建议使用)

    composer require eleme-openapi/eleme-openapi-sdk

基本用法

    use ElemeOpenApi\Config\Config;
    use ElemeOpenApi\Api\ShopService;
    
    //实例化一个配置类
    $config = new Config($app_key, $app_secret, false);
    
    //使用config和token对象，实例化一个服务对象
    $shop_service = new ShopService($token, $config);
    
    //调用服务方法，获取资源
    $shop = shop_service->get_shop(12345);

Token获取

企业应用与个人应用的token获取方法略有不同。

实际使用过程中，在token获取成功后，该token可以使用较长一段时间，需要缓存起来，请勿每次请求都重新获取token。

企业应用

    use ElemeOpenApi\Config\Config;
    use ElemeOpenApi\OAuth\OAuthClient;
    
    //实例化一个配置类
    $config = new Config($app_key, $app_secret, false);
    
    //使用config对象，实例化一个授权类
    $client = new OAuthClient($config);
    
    //根据OAuth2.0中的对应state，scope和callback_url，获取授权URL
    $auth_url = $client->get_auth_url($state, $scope, $callback_url);

商家打开授权URL，同意授权后，跳转到您的回调页面，并返回code

    //通过授权得到的code，以及正确的callback_url，获取token
    $token = $client->get_token_by_code($code, $callback_url);

个人应用

    use ElemeOpenApi\Config\Config;
    use ElemeOpenApi\OAuth\OAuthClient;
    
    //实例化一个配置类
    $config = new Config($app_key, $app_secret, false);
    
    //使用config对象，实例化一个授权类
    $client = new OAuthClient($config);
    
    //使用授权类获取token
    $token = $client->get_token_in_client_credentials();

Demo使用方法

该demo主要用来演示企业应用的授权流程和展示应用信息

在开发者中心创建企业应用，记下沙箱环境店铺的账号和密码，并在沙箱环境中填入回调地址（该地址需要https）
找到demo文件夹将资源拷贝到您的项目目录
```
 vendor/eleme-openapi/eleme-openapi-sdk/demo/
```
在init.php中修改沙箱环境的app_key，app_secret，callback_url，以及项目目录的相对路径

    define("ROOT_DIR", dirname(__FILE__) . "your project path");
    
    $app_key = "your app key";
    $app_secret = "your app secret";
    $sandbox = true;

    $scope = "all";
    $callback_url = "your callback url";

将demo部署到服务器上
打开SDK生成的授权URL，使用沙箱店铺的账号和密码进行授权，成功后调转回调接口，输出页面，展示店铺信息
使用沙箱店铺的账号密码在napos客户端登陆，会发现刚刚授权的应用已安装，并能够打开应用跳转回调页，展示店铺信息

CHANGELOG:

[1.86.0]

Release Date : 2024-04-03

[Feature] 更新了活动服务
[Feature] 新增了渠道管理服务
[Feature] 新增了生活钉接口
[Feature] 更新了金融服务
[Feature] 更新了消息服务
[Feature] 更新了订单服务
[Feature] 更新了商品服务
[Feature] 更新了店铺服务
[Feature] 更新了订单评论服务
[Feature] 更新了商户服务

[1.85.0]

Release Date : 2024-03-01

[Feature] 新增了斗金服务

[1.84.0]

Release Date : 2023-12-07

[Feature] 更新了活动服务
[Feature] 新增了生意参谋服务
[Feature] 更新了消息服务
[Feature] 更新了订单服务

[1.83.0]

Release Date : 2023-11-03

[Feature] 更新了金融服务
[Feature] 更新了商品服务

[1.82.0]

Release Date : 2023-09-26

[Feature] 更新了活动服务
[Feature] 新增了开放平台用户信息查询服务
[Feature] 新增了订单服务
[Feature] 更新了消息服务
[Feature] 更新了开店服务

[1.81.0]

Release Date : 2023-09-07

[Feature] 更新了活动服务
[Feature] 更新了消息服务
[Feature] 更新了新消息服务
[Feature] 更新了商品服务

[1.80.0]

Release Date : 2023-08-02

[Feature] 更新了商品服务
[Feature] 新增了店铺分服务
[Feature] 更新了商户服务

[1.79.0]

Release Date : 2023-06-30

[Feature] 更新了金融服务
[Feature] 更新了商品服务

[1.78.0]

Release Date : 2023-06-02

[Feature] 更新了自然人商户入驻服务
[Feature] 更新了开店服务

[1.77.0]

Release Date : 2023-05-10

[Feature] 更新了活动服务
[Feature] 新增了自然人商户入驻服务
[Feature] 更新了消息服务
[Feature] 新增了开店服务
[Feature] 更新了商品服务

[1.76.0]

Release Date : 2023-03-10

[Feature] 更新了活动服务
[Feature] 更新了金融服务
[Feature] 更新了服务市场服务
[Feature] 更新了消息服务
[Feature] 更新了新消息服务
[Feature] 更新了商品服务
[Feature] 新增了小票服务

[1.75.0]

Release Date : 2023-01-04

[Feature] 更新了活动服务
[Feature] 新增了发票服务
[Feature] 更新了消息服务
[Feature] 新增了新消息服务
[Feature] 新增了抖音服务
[Feature] 新增了开放服务
[Feature] 新增了抖音商品信息补全服务
[Feature] 新增了提供给dy的查询服务，包括：服务数据，仲裁信息，赔付信息等
[Feature] 新增了抖音风险同步服务
[Feature] 更新了商品服务

[1.74.0]

Release Date : 2022-11-07

[Feature] 新增了卡券服务

[1.72.0]

Release Date : 2022-10-10

[Feature] 更新了金融服务
[Feature] 更新了消息服务
[Feature] 更新了商品服务
[Feature] 更新了店铺服务

[1.71.0]

Release Date : 2022-09-09

[Feature] 更新了消息服务
[Feature] 更新了订单服务
[Feature] 更新了店铺服务

[1.70.0]

Release Date : 2022-06-05

[Feature] 更新了消息服务
[Feature] 更新了订单服务

[1.69.0]

Release Date : 2022-05-08

[Feature] 更新了金融服务
[Feature] 更新了消息服务
[Feature] 更新了订单服务
[Feature] 更新了商品服务

[1.68.0]

Release Date : 2022-01-14

[Feature] 更新了订单服务

[1.67.0]

Release Date : 2021-12-03

[Feature] 更新了门店装修服务
[Feature] 更新了金融服务
[Feature] 更新了消息服务
[Feature] 更新了商品服务

[1.66.0]

Release Date : 2021-10-29

[Feature] 更新了金融服务
[Feature] 更新了消息服务
[Feature] 更新了订单服务
[Feature] 更新了商户信用分服务
[Feature] 更新了订单评论服务

[1.65.0]

Release Date : 2021-09-18

[Feature] 更新了金融服务
[Feature] 更新了订单服务
[Feature] 更新了商品服务

[1.64.0]

Release Date : 2021-07-08

[Feature] 更新了商户数据服务
[Feature] 更新了经营体检
[Feature] 更新了金融服务
[Feature] 更新了服务市场服务
[Feature] 更新了消息服务
[Feature] 新增了商家服务中台服务
[Feature] 更新了订单服务
[Feature] 更新了商品服务
[Feature] 更新了招聘市场服务
[Feature] 更新了店铺服务
[Feature] 更新了订单评论服务

[1.63.0]

Release Date : 2021-01-12

[Feature] 更新了活动服务
[Feature] 更新了视频服务
[Feature] 更新了服务市场服务
[Feature] 更新了消息服务
[Feature] 更新了订单服务
[Feature] 更新了商品服务

[1.62.0]

Release Date : 2020-11-03

[Feature] 更新了企业订餐商户服务
[Feature] 更新了金融服务
[Feature] 更新了订单服务

[1.61.0]

Release Date : 2020-04-24

[Feature] 新增招聘市场服务、企业订单服务；订单服务更新接口

[1.60.0]

Release Date : 2020-03-30

[Feature] 更新了商品服务

[1.59.0]

Release Date : 2019-12-27

[Feature] 更新了金融服务

[1.58.0]

Release Date : 2019-12-23

[Feature] 更新了店铺服务

[1.57.0]

Release Date : 2019-11-18

[Feature] 更新了订单服务
[Feature] 新增了商户信用分服务

[1.56.0]

Release Date : 2019-10-18

[Feature] 修复requestId可能不和规范的问题

[1.55.0]

Release Date : 2019-09-26

[Feature] 更新了活动服务

[1.54.0]

Release Date : 2019-09-01

[Feature] 新增了经营体检

[1.53.0]

Release Date : 2019-07-19

[Feature] 更新了服务市场服务

[1.52.0]

Release Date : 2019-07-09

[Feature] 更新了消息服务

[1.51.0]

Release Date : 2019-06-28

[Feature] 更新了视频服务

[1.50.0]

Release Date : 2019-05-17

[Feature] 更新了店铺服务

[1.49.0]

Release Date : 2019-05-10

[Feature] 更新了活动服务

[1.48.0]

Release Date : 2019-04-15

[Feature] 更新了活动服务

[1.47.0]

Release Date : 2019-04-12

[Feature] 更新了商户会员卡服务

[1.46.0]

Release Date : 2019-03-05

[Feature] 更新了商品服务

[1.45.0]

Release Date : 2019-02-22

[Feature] 餐厅入口流量服务下线接口

[1.44.0]

Release Date : 2019-01-03

[Feature] 更新了商品服务

[1.43.0]

Release Date : 2018-12-28

[Feature] 更新了服务市场服务
[Feature] 更新了商品服务

[1.42.0]

Release Date : 2018-12-21

[Feature] 更新了门店装修服务
[Feature] 更新了订单评论服务

[1.41.0]

Release Date : 2018-12-07

[Feature] 更新了订单服务

[1.40.0]

Release Date : 2018-11-30

[Feature] 更新了店铺服务
[Feature] requestId新增时间戳后缀

[1.39.0]

Release Date : 2018-11-15

[Feature] 更新了活动服务
[Feature] 更新了店铺服务

[1.38.0]

Release Date : 2018-10-17

[Feature] 更新了活动服务
[Feature] 更新了订单服务
[Feature] 更新了订单评论服务

[1.37.0]

Release Date : 2018-09-29

[Feature] 新增了商户数据服务
[Feature] 更新了店铺服务

[1.36.0]

Release Date : 2018-09-21

[Feature] 更新了商户会员卡服务
[Feature] 更新了门店装修服务
[Feature] 新增了短信服务

[1.35.0]

Release Date : 2018-09-14

[Feature] 更新了订单服务

[1.34.0]

Release Date : 2018-09-07

[Feature] 更新了活动服务
[Feature] 更新了商品服务
[Feature] 更新了店铺服务

[1.33.0]

Release Date : 2018-08-17

[Feature] 更新了活动服务
[Feature] 更新了商户会员卡服务

[1.32.0]

Release Date : 2018-08-03

[Feature] 新增了商户会员卡服务
[Feature] 新增了CPC竞价服务
[Feature] 更新了订单服务

[1.31.0]

Release Date : 2018-07-27

[Feature] 更新了订单服务
[Feature] 更新了商品服务
[Feature] 更新了店铺服务

[1.30.0]

Release Date : 2018-07-13

[Feature] 更新了订单评论服务

[1.29.0]

Release Date : 2018-07-06

[Feature] 更新了视频服务
[Feature] 更新了商品服务
[Feature] 上传视频接口封装

[1.28.0]

Release Date : 2018-06-28

[Feature] 新增了视频服务
[Feature] 新增了门店装修服务
[Feature] 更新了订单服务
[Feature] 更新了商品服务
[Feature] 更新了店铺服务

[1.27.0]

Release Date : 2018-06-22

[Feature] 更新了店铺服务

[1.26.0]

Release Date : 2018-06-08

[1.25.0]

Release Date : 2018-06-08

[Feature] 更新了活动服务
[Feature] 更新了订单服务

[1.24.0]

Release Date : 2018-05-18

[Feature] 更新了活动服务
[Feature] 更新了商品服务
[Feature] 新增授权码换取OpenId接口

[1.23.0]

Release Date : 2018-03-23

[Feature] 更新了活动服务
[Feature] 新增了餐厅入口流量服务
[Feature] 更新了订单服务
[Feature] 更新了店铺服务

[1.22.0]

Release Date : 2018-02-02

[Feature] 更新了活动服务

[1.21.0]

Release Date : 2018-01-18

[Feature] 新增了服务市场服务
[Feature] 更新了订单评论服务

[1.20.0]

Release Date : 2018-01-05

[Feature] 更新了商品服务
[Feature] 更新了店铺服务

[1.19.0]

Release Date : 2017-12-24

[Feature] 更新了订单服务
[Feature] 更新了订单评论服务

[1.18.0]

Release Date : 2017-12-01

[Feature] 更新了金融服务
[Feature] 更新了订单服务

[1.17.0]

Release Date : 2017-10-27

[Feature] 更新了活动服务

[1.16.0]

Release Date : 2017-10-22

[Feature] 更新了活动服务
[Feature] 更新了商品服务
[Feature] 更新了订单评论服务

[1.15.0]

Release Date : 2017-09-01

[1.14.0]

Release Date : 2017-09-01

[Feature] 新增了活动服务
[Feature] 更新了订单评论服务

[1.13.0]

Release Date : 2017-08-18

[Feature] 更新了订单服务

[1.12.0]

Release Date : 2017-08-03

[Feature] 更新了金融服务

[1.11.0]

Release Date : 2017-07-07

[Feature] 更新了商品服务

[1.10.0]

Release Date : 2017-07-04

[Feature] 新增了金融服务
[Feature] 更新了订单服务
[Feature] 更新了商品服务
[Feature] 更新了店铺服务

[1.9.0]

Release Date : 2017-05-26

[Feature] 更新了订单服务

[1.8.0]

Release Date : 2017-05-24

[Feature] 更新了商户服务

[1.7.0]

Release Date : 2017-05-18

[Feature] 更新了订单服务
[Feature] 更新了商品服务

[1.6.1]

Release Date : 2017-05-12

[Feature] 更新了订单服务
[Feature] 更新了商品服务
[Feature] 修复了demo的Util里，convert_to_message的json_decode有可能精度丢失的问题

[v1.5.0]

Release Date : 2017-5-8

[Feature] 订单服务新增接口。
[Feature] 商品服务新增接口。

[v1.4.0]

Release Date : 2017-5-5

[Feature] 店铺服务新增接口。
[Feature] 商品服务新增接口。
[Feature] 新增签约服务。

[v1.3.0]

Release Date : 2017-4-25

[Feature] 店铺服务新增接口。

[v1.2.0]

Release Date : 2017-4-21

[Feature] 订单服务新增接口。
[Feature] 商品服务新增接口。
[Feature] 新增订单评论服务。

[v1.1.10]

Release Date : 2017-4-21

[Feature] 修复了含有数组入参时，有可能造成的签名无效的问题。

[v1.1.9]

Release Date : 2017-4-14

[Feature] 对部分字符集的入参进行了UTF8转换，修复了中文字符的签名有可能无法计算成功的问题。

[v1.1.8]

Release Date : 2017-4-11

[BugFix] 修复了demo的HTML文件中，图片链接失效的问题

[v1.1.7]

Release Date : 2017-4-7

[Feature] SDK完整实现

eleme-openapi-php-sdk / eleme-openapi-php-sdk

Maintainers

Details

README

接入指南

安装

安装命令(20220605 变更)

旧安装命令(不建议使用)

基本用法

Token获取

企业应用

个人应用

Demo使用方法

CHANGELOG:

[1.86.0]

[1.85.0]

[1.84.0]

[1.83.0]

[1.82.0]

[1.81.0]

[1.80.0]

[1.79.0]

[1.78.0]

[1.77.0]

[1.76.0]

[1.75.0]

[1.74.0]

[1.72.0]

[1.71.0]

[1.70.0]

[1.69.0]

[1.68.0]

[1.67.0]

[1.66.0]

[1.65.0]

[1.64.0]

[1.63.0]

[1.62.0]

[1.61.0]

[1.60.0]

[1.59.0]

[1.58.0]

[1.57.0]

[1.56.0]

[1.55.0]

[1.54.0]

[1.53.0]

[1.52.0]

[1.51.0]

[1.50.0]

[1.49.0]

[1.48.0]

[1.47.0]

[1.46.0]

[1.45.0]

[1.44.0]

[1.43.0]

[1.42.0]

[1.41.0]

[1.40.0]

[1.39.0]

[1.38.0]

[1.37.0]

[1.36.0]

[1.35.0]

[1.34.0]

[1.33.0]

[1.32.0]

[1.31.0]

[1.30.0]

[1.29.0]

[1.28.0]

[1.27.0]

[1.26.0]

[1.25.0]

[1.24.0]

[1.23.0]

[1.22.0]

[1.21.0]

[1.20.0]