# api-example

**Repository Path**: tracenet/api-example

## Basic Information

- **Project Name**: api-example
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-06-05
- **Last Updated**: 2025-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 简介

物流行业信息化系统常用的API接口。<br />

### 支持的服务

| 服务名称    | 类型                                                                                                                                                                                                                                  | Client（内含接口清单）                                                                                 |
|:--------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| 信息核验服务  | 驾驶员从业资格证核验<br/>车辆道路运输证核验<br/>企业基础信息核验                                                                                                                                                                                               | [CgssClient.java](src/main/java/com/cxso/example/client/CgssClient.java)                       |
| 身份验证服务  | 四要素认证<br/>三要素验证<br/>人像核验                                                                                                                                                                                                            | [CheckClient.java](src%2Fmain%2Fjava%2Fcom%2Fcxso%2Fexample%2Fclient%2FCheckClient.java)       |
| 保险服务    | 物流保险下单                                                                                                                                                                                                                              | [InsureClient.java](src%2Fmain%2Fjava%2Fcom%2Fcxso%2Fexample%2Fclient%2FInsureClient.java)     |
| 车辆定位服务  | 实时定位<br/>历史轨迹<br/>车辆入网查询                                                                                                                                                                                                            | [LocationClient.java](src%2Fmain%2Fjava%2Fcom%2Fcxso%2Fexample%2Fclient%2FLocationClient.java) |
| 图像识别服务  | 身份证识别<br/>营业执照识别<br/>银行卡识别<br/>驾驶证正面识别<br/>行驶证识别<br/>银行回单识别<br/>道路运输从业资格证识别<br/>道路运输证识别<br/>通用文字识别                                                                                                                                  | [OcrClient.java](src%2Fmain%2Fjava%2Fcom%2Fcxso%2Fexample%2Fclient%2FOcrClient.java)           |
| 船舶定位服务  | 历史轨迹<br/>实时位置                                                                                                                                                                                                                       | [ShipClient.java](src%2Fmain%2Fjava%2Fcom%2Fcxso%2Fexample%2Fclient%2FShipClient.java)         |
| 电子签章    | 合同下载<br/>添加模板<br/>申请CA证书<br/>合同签署                                                                                                                                                                                                   | [SignClient.java](src%2Fmain%2Fjava%2Fcom%2Fcxso%2Fexample%2Fclient%2FSignClient.java)         |
| 短信服务    | 文字短信<br/>语音短信                                                                                                                                                                                                                       | [SmsClient.java](src%2Fmain%2Fjava%2Fcom%2Fcxso%2Fexample%2Fclient%2FSmsClient.java)           |
| ETC服务   | 运单开始接口<br/>运单结束<br/>查询发票                                                                                                                                                                                                            | [EtcClient.java](src/main/java/com/cxso/example/client/EtcClient.java)                         |
| 人脸识别服务  | 获取H5人脸识别地址<br/>人脸识别结果                                                                                                                                                                                                               | [FaceClient.java](src/main/java/com/cxso/example/client/FaceClient.java)                       |
| 聚合上报服务  | 上报运单<br/>上报车辆<br/>上报司机<br/>上报轨迹<br/>上报合同<br/>上报流水<br/>上报发票<br/>上报ETC发票<br/>上报货主                                                                                                                                                     | [ReportClient.java](src%2Fmain%2Fjava%2Fcom%2Fcxso%2Fexample%2Fclient%2FReportClient.java)     |
| 聚合代理商服务 | 新增货主<br/>新增司机<br/>新增车辆<br/>新增车队长<br/>新增收款信息                                                                                                                                                                                         | [MergeAgentWlptClient.java](src/main/java/com/cxso/example/client/MergeAgentWlptClient.java)   |
| 聚合货主服务  | 运单轨迹<br/>撤销支付<br/>新增运单<br/>支付信息查询<br/>确认支付<br/>申请开票<br/>货主信息查询<br/>货源接单<br/>申请支付<br/>编辑运单<br/>运单信息查询<br/>取消货源<br/>新增合同<br/>运单提货<br/>新增货源<br/>钱包信息查询<br/>运单取消<br/>支付结果查询<br/>新增收款信息<br/>运单签收<br/>运单运抵<br/>撤销开票<br/>发票信息查询<br/>运单轨迹查询 | [MergeOwnerWlptClient.java](src/main/java/com/cxso/example/client/MergeOwnerWlptClient.java)   |

### 开放平台示例代码

[OpenExample.java](src%2Fmain%2Fjava%2Fcom%2Fcxso%2Fexample%2FOpenExample.java)

### 聚合上报示例代码

[ReportExample.java](src%2Fmain%2Fjava%2Fcom%2Fcxso%2Fexample%2FReportExample.java)

### 聚合网货服务示例代码

[MergeExample.java](src/main/java/com/cxso/example/MergeExample.java)

#### 示例说明

```java
  public static void main(String[]args){
//步骤一: 初始化客户端链接, 初始化一次即可
public static final ClientManager clientManager=SdkClient.builder("服务域名地址","clientId","clientSecret");
        //步骤二: 选择服务
        OcrClient ocrClient=clientManager.use(OcrClient.class);
        //步骤三: 调用服务，银行卡识别
        Result<OcrBankCardResponse> result=ocrClient.ocrBankCard(new OcrBankCardRequest(){{
        setUrl("https://img1.baidu.com/it/u=4133249545,341559632&fm=253&fmt=auto&app=138&f=JPEG?w=674&h=500");
        }});
        //步骤四: 拿到结果
        if(result.isSuccess()){
        OcrBankCardResponse data=result.getData();
        System.out.println(JSONObject.toJSONString(data,JSONWriter.Feature.PrettyFormat));
        }else{
        System.out.println(result.getMsg());
        }
        }
```