빙하 시스템 택배 루트 정보 조회 API. md

빙하 시스템 택배 경로 정보 조회 API 는 제3자 가 API 를 통 해 택배 경로 정 보 를 조회 하 는 데 사용 된다.
API 권한 부여 빙하 시스템 권한 부여 접근 절 차 를 참고 하 십시오.
빙하 시스템 은 http 기본 인증 (http basic auth) 방식 으로 인증 하고 ip 를 연결 합 니 다.매번 API 호출 은 http 요청 헤더 에 accessToken (검 은 개가 제공) 이라는 머리 정 보 를 포함 해 야 합 니 다. 해당 하 는 값 은 검 은 개가 제공 합 니 다. 자바 에 서 는 유사 합 니 다. header("accessToken", " ") accssToken 은 이전 userValue 와 일치 합 니 다.
테스트 전에 검 은 개 관계자 에 게 연락 하여 권한 수여 코드, 연락처:http://www.jianshu.com/p/da0afb071d8a
택배 경로 정보 조회 API
방법 명: /express/api/v1/trackExpress.do 테스트 주 소 는: http://test.higo-express.cn/express/api/v1/trackExpress.do 정식 주 소 는: http://oms.higo-express.cn/express/api/v1/trackExpress.do요청 인자 (POST 요청)

  "waybillID": "4000005415"

참조 코드
jar 패키지 의존

 
            org.springframework
            spring-test
            3.2.14.RELEASE
        

코드 예제

 package com.higo.action.api;

import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.print;

import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.MediaType;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import org.springframework.test.context.web.WebAppConfiguration;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
import org.springframework.web.context.WebApplicationContext;

import com.higo.query.express.ExpressQuery;
import com.higo.utils.HigoLogUtils;
import com.higo.utils.JacksonUtils;

/**
* yulongs 2015 11 3    5:39:08 
*
**/
@RunWith(SpringJUnit4ClassRunner.class)
@WebAppConfiguration
@ContextConfiguration(locations = {"file:src/main/webapp/WEB-INF/spring/appServlet/servlet-context.xml","file:src/main/webapp/WEB-INF/spring/root-context.xml"})
public class ExpressTrackingAPIActionTest {

  
  @Autowired
  private WebApplicationContext wac;

  private MockMvc mockMvc;

  @Before
  public void setup() {
      this.mockMvc = MockMvcBuilders.webAppContextSetup(this.wac).build();
  }

  @Test
  public void testTrackExpress() throws Exception {
      ExpressQuery expressQuery = new ExpressQuery();
      expressQuery.setWaybillID("4000328507");
      String accsstoken = "3f4873cab8eb5c24c1901fa3302a4043";
      HigoLogUtils.debug(JacksonUtils.writeValue(expressQuery));
     this.mockMvc.perform(post("http://test.higo-express.cn/express/api/v1/trackExpress.do").param("waybillID", expressQuery.getWaybillID())
         .header("Content-Type",MediaType.APPLICATION_FORM_URLENCODED_VALUE +";charset=utf-8").
         header("accessToken", accsstoken)).andDo(print());
  }
}

요청 매개 변수 설명
매개 변수 이름
묘사 하 다.
유형
길이
필수 여부
예시
waybillID
블랙 독 택배 번호
string
32
예.
4000005415
예제 복귀

{
  "requestValid": 1,
  "message": null,
  "callStatus": "success",
  "data": [
    {
      "timestamp": "2015/12/16 16:36:06",
      "trackingDetail": "      【  RDC】    ",
      "expressStatus": 0
    }
  ]
}

반환 매개 변수 설명
매개 변수 이름
묘사 하 다.
유형
길이
필수 여부
예시
callStatus
호출 성공 실패
string
32
예.
fail/success
message
실패 알림 정보
string
32
아니.
인증 실패
data
경로 정보
배열
예.
예.
data.timestamp
경로 정보 발생 시간
string
예.
예.
data.trackingDetail
경로 정보
string
예.
당신 의 택 배 는 이미 【 대 흥 RDC 】 사이트 에서 수령 하 였 습 니 다.
data.expressStatus
이미 서명 수령 여부 0: 미 서명 수령 1: 서명 수령
int
예.
0/1