# jd-sdk-php

**Repository Path**: eddielau/jd-sdk-php

## Basic Information

- **Project Name**: jd-sdk-php
- **Description**: JD SDK for php
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-07-21
- **Last Updated**: 2021-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JD SDK

## Install


## Usage

+ 获取API实例

    ```php
    <?php
    include '{PROJECT_DIR}/src/JdApi.php';

    $appkey = 'YOUR_APP_KEY';
    $secret = 'YOUR_APP_SECRET';
    $api = JdApi::getInstance($appkey, $secret);

    ```

+ 授权相关

    ```php
    <?php
    /* 获取授权码 */
    $redirectTo = '回调地址'; //必须与开发者控制里的URL保持一致
    $state = '回调的状态'; //用于保持请求和回调的状态，授权请求后原样带回给第三方。该参数可用于防止csrf攻击（跨站请求伪造攻击），建议第三方带上该参数，可设置为简单的随机数加session进行校验
    $api->getLoginUrl($redirectTo, $state);

    /* 获取access_token */
    $code = 'XXXXX'; //调用“获取授权码”方法，用户登录授权后返回
    $ret = $api->getAccessToken($code);

    ```

+ 应用

    ```php
    <?php
    /* 根据登录pin查询商家基本信息 */
    $result = $api->queryByPin();

    /* 店铺信息查询 */
    $result = $api->queryShop();

    /* 获取商家所有的店内分类 */
    $result = $api->findShopCategories();

    /* 根据pin查询用户信息 */
    $pin = 'jd_test1'; //京东商家pin
    $result = $api->findUser($pin);

    // others...

    ```

+ 方法列表

    | 方法名称 | 描述 |
    |:--|:--|
    |findUser|根据pin查询用户信息|
    |getSellerInfo|查询商家基本信息|
    |queryShop|店铺信息查询|
    |queryReturnAddress|查询退货地址列表|
    |queryShipAddress|查询发货地址列表|
    |getShopCategoryByCid|获取指定的店内分类|
    |deleteShopCategoryByCid|删除指定店内分类|
    |findShopCategories|获取商家所有的店内分类|
    |findSubShopCategoriesByParentCid|获取指定分类的子分类列表|
    |queryByPin|根据登录pin查询商家基本信息|
    |getBasicVenderInfoByVenderId|根据商家编号获取商家基本信息|
    |getCategory|获取商家可用的经营分类列表|
    |getShopCategories|根据商家编号获取店内分类|
    |addIsvActivity|添加ISV活动|
    |getLoginUrl|生成“获取授权码”地址|
    |getAccessToken|通过code获取access_token|
    |refreshToken|刷新授权有效期|

## Refer

+ [API文档 > 用户API](https://open.jd.com/home/home#/doc/api?apiCateId=106&apiId=1045&apiName=jingdong.getUserLevel.query)
+ [常用文档 > 开发文档 > 授权获取accesstoken](https://open.jd.com/home/home#/doc/common?listId=880)