신미대접락차방 정비 인터페이스 문서

1. 설명
이 문서는 신미 대측 접합 차량국 정비 프로젝트에만 적용됩니다
2. 유효기간
2017-03-30 까지
3. 인터페이스 설명
3.1 인터페이스 주소 설명
주소 접두어: 프로덕션:https://m.lechebang.com/gateway/partner_json/{method}/1618 테스트:https://m.lechebang.cn/gateway/partner_json/{method}/1618 그중method는 인터페이스 이름입니다
3.2 인터페이스 목록
인터페이스 이름
설명
멱성
cancelOrder
주문 취소(결제 전)
Y
paymentNotify
동시 지불 결과
Y
applyRefund
환불 신청
Y
refundNotify
동시 환불 결과
Y
notifyReview
동기 주문 평가
Y
3.3 보안 인증
러차팡 측은 요청(JSON 형식)에 대한 서명 검증을 통해 인터페이스의 안전성을 확보한다. 구체적인 서명 알고리즘은 다음과 같다.

요청 매개 변수 목록에서sign 필드를 제외하고 다른 (뿌리 결점)에서 사용해야 하는 매개 변수는 모두 서명할 매개 변수입니다.

JSON 뿌리 결점의 모든 속성에 대해 속성명에 따라 0~9, a~z의 순서로 정렬하고 같은 알파벳을 만나면 두 번째 알파벳을 보고 이런 식으로 유추한다.

정렬이 끝난 후에 모든 속성 이름과 값을 "="로 키 값을 구성하여 "&"문자로 연결합니다.이 문자열은 서명할 문자열입니다.예를 들어 아래의 요청 매개 변수 {appCode:100,timestamp:1338686946,sign:"6e8ccf3e7fb18ead4bfd9f41078fd52b",cityId:10101010101}서명 대기 문자열: appCode=100&cityId=1010101 ×tamp=1338886946

서명 대기 문자열의 끝에 서명용 시크릿 값을 더하면 키 시크릿은 러차방이 제공한다(테스트 사용 참조 부록).예: 시크릿 값은'vWdg5jw9BTmLk6S0wsYL'이고 서명할 문자열은 appCode=100&cityId=10101 ×tamp;1338886946 추가 시크릿 후 획득: appCode=100&cityId=101010 ×tamp;1338686946vWdg5jw9BTmLk6S0wsYL

md5 연산을 진행하고 연산 결과는 uppercase 대문자화 작업을 하여 최종적으로 서명을 받았습니다.인터페이스 측은 서명 도구를 다운로드하여 서명을 계산하고 측정할 수 있으며, 연결 테스트 과정에서도 사용할 수 있다.

3.4 요청 및 반환
3.4.1 요청 형식
러차방 인터페이스 요청은 appCode, 시간 스탬프, 서명, 기타 업무 매개 변수 네 부분으로 구성됩니다.

{
    "appCode":1618,
    "timestamp":1488524179,
    "sign":"3EBAAA2CB74D32DFB422C32829C11813",
    //    
}

신미대 앱코드는 1618 timestamp(타임 스탬프)이 서버에 요청한 시간으로 오차가 5분 정도 걸립니다.
3.4.2 반환 형식

{
    "costTime":15,
    "msg":"ok",
    "result":{},
    "resultCode":"200",
    "statusCode":"200",
    "validationErrors":null
}

여기에서:
필드
설명
statusCode
상태 코드, 부록 오류 코드 참조
msg
오류 메시지
result
업무 데이터가 되돌아올 때,result 필드에 데이터를 넣습니다
4. 인터페이스 설계
4.1 주문 취소(결제 전) cancelOrder
비즈니스 요청 매개 변수
매개변수 이름
매개변수 유형
필수
설명
orderId
String
Y
러차방 주문 ID
호출 예
Request:

{
    "appCode":1618,
    "orderId":"XXX1000",
    "timestamp":1488449177,
    "sign":"BEBB7C326A040AD1CE9327D720699453"
}

Response:

{
    "costTime":1380,
    "msg":"ok",
    "result": {},
    "resultCode":"200",
    "statusCode":"200",
    "validationErrors":null
}

4.2 동시 결제 결과paymentNotify
비즈니스 요청 매개 변수
매개변수 이름
매개변수 유형
필수
설명
orderId
String
Y
러차방 주문 ID
payResult
int
Y
지불 결과,1:성공,2:실패
payPrice
String
N
사용자 실제 지불 금액
dpPromoPrice
String
N
평가된 우대 가격
호출 예
Request:

{
    "appCode":1618,
    "orderId":"XXXX1000",
    "payResult":1,
    "payPrice":200,
    "dpPromoPrice":6,
    "timestamp":1488506049,
    "sign":"AAB48C53E09D1D4911ACB886094099AC"
}

Response:

{
    "costTime":14,
    "msg":"ok",
    "result": {},
    "resultCode":"200",
    "statusCode":"200",
    "validationErrors":null
}

4.3 환불 신청 applyRefund
비즈니스 요청 매개 변수
매개변수 이름
매개변수 유형
필수
설명
orderId
String
Y
러차방 주문 ID
호출 예
Request:

{
    "appCode":1618,
    "orderId":"XXX0001",
    "timestamp":1488508664,
    "sign":"5E398CA68254B0B14CDC1594109EA213"
}

Response:

{
    "costTime":13,
    "msg":"ok",
    "result": {},
    "resultCode":"200",
    "statusCode":"200",
    "validationErrors":null
}

4.4 동시 환불 결과 refundNotify
비즈니스 요청 매개 변수
매개변수 이름
매개변수 유형
필수
설명
orderId
String
Y
러차방 주문 ID
refundResult
int
Y
환불 결과,1:환불 성공,2:환불 실패
호출 예
Request:

{
    "appCode":1618,
    "orderId":"XXX0001",
    "refundResult":1,
    "timestamp":1488508881,
    "sign":"942A939E7D3EAE3FFBF59AFF66FF1FB4"
}

Response:

{
    "costTime":11,
    "msg":"ok",
    "result": {},
    "resultCode":"200",
    "statusCode":"200",
    "validationErrors":null
}

4.5 동시 주문 평가 notify Review
비즈니스 요청 매개 변수
매개변수 이름
매개변수 유형
필수
설명
orderId
String
Y
러차방 주문 ID
star
int
Y
성급 평가, 구간 [1~5]:1~5레벨
reviewBody
String
Y
내용을 평론하다.
호출 예
Request:

{
    "appCode":1618,
    "orderId":"XXX001",
    "star":4,
    "reviewBody":"a good shop!",
    "timestamp":1488509130,
    "sign":"1A7DC6B1BCDB9B8D94A320918704CD8E"
}

Response:

{
    "costTime":17,
    "msg":"ok",
    "result": {},
    "resultCode":"200",
    "statusCode":"200",
    "validationErrors":null
}

5. 부록
5.1 statusCode 반환 상태 코드
상태 코드
설명
200
성취
501
잘못된 매개 변수 또는 논리 검사 실패
주의: 기타 상태 코드는 보충해야 합니다
5.2 신미 대키
테스트: 러차방 개발 획득 생산: 러차방 개발 획득