# baoyi_open

**Repository Path**: windvix/baoyi_open

## Basic Information

- **Project Name**: baoyi_open
- **Description**: 保易科技公开API文档
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2017-02-14
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# 我是车主开放API文档
----------

[TOC]
## 接口概述

本文档中，所有调用我是车主服务端接口的请求都需要按此规则校验。

### Access Key校验

使用API接口，需向我是车主申请**Access Key**。在双方接口交互时，统一使用**Access Key**进行校验。

> **重要提醒：**本文档中提供的所有接口均面向开发者服务器端调用，开发者应妥善保管Access Key，可在应用的服务器端存储和使用，但不应存储或传递到客户端，也不应在网页等前端代码中嵌入。


### 接口说明
>- 所有接口都只支持POST请求；
>- 所有接口请求Content-Type类型为：application/x-www-form-urlencoded;charset=utf-8；
>- 所有接口返回类型为JSON，同时进行UTF-8编码。

----------
###接口示例
####请求数据示例
``` php
//post提交数据
function postData($url, $data) {
   $ch = curl_init();
   $postdata = '';
   foreach ($data as $key => $value) {
      $postdata.= ($key . '=' . $value . '&');
   }
   curl_setopt($ch, CURLOPT_URL, $url);
   curl_setopt($ch, CURLOPT_POST, TRUE);
   curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); 
   curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata);
   $result = curl_exec($ch);
   curl_close($ch);
   return $result;
}

//封装请求参数
$data = array();
$data['access_key'] = 'Test1234325';//分配的Access Key
$data['phone'] = '15222223333';//提交的手机号
//进行POST请求并打印返回的json数据
$json_str = postData($url, $data);
echo $json_str;
```

----------
####返回的数据示例
``` json
{
	"c": "0",                     //返回码
    "m": "",                      //与返回码对应的消息
    "d": {                        //返回的数据
		"order_id":"test132343",
		"order_title":"测试订单"
	}
}
```
返回码说明， 请见[码表](http://www.example.com) 


##漆保宝订单
###创建订单
创建漆保宝订单
####接口地址
>http://120.25.214.154:7777/car_app_server/index.php/api/channel/fragment/qibaobao_create


#### 请求参数
POST表单请求

| 参数名      |必填  |类型| 默认值  |   参数说明 |
| :-------------- | :--------| :------ |:------------ |:---------------- |
| access_key|是 |string | 无| 我是车主分配的**Access Key**|
| open_user_id|是 |string | 无|用户的唯一编号，由合作方提供|
| car_plate_no| 是 |string | 无|车牌号码|
| check_car_addr| 是 |string | 无|验车地址|
| phone| 是 |string | 无|已验证的手机号码|
| pay_price| 是 |double | 无|订单要支付的金额，单位元|
| city| 否 |string |广州市|服务城市，暂只开放**广州市**|


#### 返回字段
JSON格式返回

``` json
{
    "c": "1",
    "d": {
        "order_title": "漆保宝588.0元",
        "pay_price": 598,
        "create_time": 1487065927445,
        "car_plate_no": "粤A2988D",
        "city": "广州市",
        "user_name": "李小明",
        "order_price": 588,
        "insurance_start_time": 0,
        "insurance_month_count": 12,
        "order_status": 0,
        "update_time": 1487065927489,
        "check_car_addr": "广州市大街",
        "user_phone": "15622231933",
        "open_user_id": "wx_Rsoofwojjkkfeoikjsddflkjdslkjdd",
        "order_id": "Q2017021417520724657331",
        "max_use_time": "2",
        "insurance_end_time": 0
    },
    "m": "创建成功"
}
```
> 
**c** - 状态码，详细请见 - [状态码表](http://54.199.175.134/wonder_server/index.php/api/code)
**m** -  对应于状态码的消息提示
**d** -  返回的数据列表
 **all_count** - 总共有多少条记录
 **page_size** - 分页大小 
 **cur_page** - 当前是第几页
 **all_page** - 总共有多少页 
 **cur_idx** - 当前页首个是第几个
 **list** - 文集列表 
  **id** - 文集编号
  **create_time_str** - 文集创建时间字符串
  **title_01** - 文集大标题
  **title_02** - 文集中标题
  **title_03** - 文集小标题
  **rss_user_count** - 文集当前有多少用户订阅
  **like_count** - 点赞数
  **is_login_data** - 是否是登录后返回的数据，**1**-是，**0**-否
  **is_me_rss** - 我是否已经订阅了此文集，**1**-是，**0**-否,**-1**-非登录状态请求订阅情况未知
  **state** - 文集的状态，暂时用不到