java顺丰接口调用

### Java 调用顺丰 API 示例

为了在Java应用程序中调用顺丰API，通常会涉及到创建HTTP请求来发送订单信息并接收响应。基于已有的项目实例[^1]，下面提供了一个简单的例子用于说明如何通过Java代码发起对顺丰API的调用。

#### 准备工作

首先需要准备好API访问所需的凭证，比如AppKey和Sign（签名），这些可以从顺丰开放平台获得。另外还需要引入必要的依赖项以便于处理JSON数据以及构建HTTPS请求。

对于Maven项目来说，在`pom.xml`文件里加入如下依赖：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.78</version>
</dependency>

<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.5.13</version>
</dependency>

#### 发起POST请求示例

这里给出一段基本的Java代码片段展示怎样向顺丰服务器提交一个新的运单请求:

import org.apache.http.HttpResponse;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class SFExpressClient {

    private static final String APP_KEY = "your_app_key"; // 替换成自己的app key
    private static final String SIGNATURE = "your_signature"; // 替换成计算后的sign
    
    public void createOrder() throws Exception {
        CloseableHttpClient httpClient = HttpClients.createDefault();
        
        try {
            HttpPost post = new HttpPost("https://open.sf-express.com/std/service/v1/waybill/create");
            
            JSONObject jsonParam = new JSONObject();
            jsonParam.put("shipper", "");
            jsonParam.put("receiver", "");
            jsonParam.put("cargo", "");

            StringEntity entity = new StringEntity(jsonParam.toJSONString(), Charset.forName("UTF-8"));
            entity.setContentType("application/json");

            post.setEntity(entity);
            post.setHeader("Content-Type", "application/json;charset=UTF-8");
            post.setHeader("AppKey", APP_KEY);
            post.setHeader("Nonce", UUID.randomUUID().toString());
            post.setHeader("Signature", SIGNATURE);

            HttpResponse response = httpClient.execute(post);
            System.out.println(EntityUtils.toString(response.getEntity()));
        } finally {
            httpClient.close();
        }
    }
}

这段代码展示了如何设置请求头中的认证参数，并且构造了包含寄件人、收件人及货物详情在内的JSON格式主体内容。需要注意的是实际应用时应该按照官方指南填写具体的字段值[^2]。