接入指南

## 接入流程

对于初次接入的企业，需要按照如下流程操作
<img src="/media/202303/2023-03-28_204115_2154210.436170551296456.png " style="width:1000px, height:200px "   />

### 1. 申请AK/SK 
- 请联系项目经理在超8运营平台创建,并授予接口权限。

### 2. 获取AccessToken
参见文档: [获取AccessToken](https://developers.yesno.com.cn/doc/57/)

### 3. 集成测试
- 按照下方的接入环境进行集成测试

### 4. 正式上线

## 基本信息

###  环境信息
HOST+接口文档的Path 部分 等于接口的全路径

| 环境 | HOST地址 |
|--- | --- |
| FAT - 项目测试 | https://open-fat.yesno.com.cn |
| PROD - 生产环境 | https://sapi.supercarrier8.com |

>  以上环境为超8-SaaS版，如果是客户自建，以自建分配的域名为主.

### 通用返回结构

| 参数名称  | 参数类型 | 参数说明 |
| --- | --- | --- |
| code      | Integer | 200 代表处理成功，其它的为失败。其它错误代码,请参考业务定义|
| message   | String | 描述信息 |
| timestamp | Long | 时间戳 |
| traceId   | String | 链路追踪ID,需要协助排查接口问题时，请提供此traceID |
| data      | Object | 业务数据|
| exception     | String | 异常信息，一般用于开发调试，通常为null | 
| meta     | Object   | 元数据信息，接口错误码翻译的占位符数据信息 | 
| ext     | Object     | 扩展信息，自定义响应的扩展数据，通常为null |