하이픈(HYPHEN)- 펌뱅킹, API마켓, 간편결제 전문 기업

관리자

2024.12.05 18:00:18

[하이픈코퍼레이션] 12월 API 업데이트에 따른 응답부 변경 예정의 건(중요공지)

12월 하이픈코퍼레이션 업데이트 대상 API 목록.xlsx

안녕하세요 하이픈 데이터마켓입니다.

당사 API 업데이트에 따른 응답부 변경에 대하여 안내드립니다.

당사 내부 API 연동 시스템 업데이트에 의하여 현재 수신받고 계신 API의 응답부가 일부 변경될 예정입니다.

해당되는 API를 사용하고 계시는 경우 해당 응답값 변경에 맞추어 업데이트를 요청드립니다.

자세한 사안은 각 개발가이드 업데이트 후 개별 API 응답부 확인 부탁드립니다.

전체 일정	24. 12. 11(수) / 24. 12. 12(목) / 24. 12. 19(목)
응답부 업데이트(1차)	24. 12. 11(수) 06:00 ~ 07:00 / 테스트배드 24. 12. 04(수) 오픈
응답부 업데이트(2차)	24. 12. 12(목) 06:00 ~ 07:00 / 테스트배드 24. 12. 09(월) 오픈
응답부 업데이트(3차)	24. 12. 19(목) 06:00 ~ 07:00 / 테스트배드 24. 12. 16(월) 오픈
테스트배드	https://market-api.hyphen.im/swagger-ui/index.html
대 상 API	총 137개 API(첨부 엑셀파일 참조)
업데이트 사유	일부 API 응답부 중복값 제거

※ 고객사 서버 or 테스트배드에서 테스트하시는 경우 hyphen-gestation 필드를 Y로 설정하시어 테스트 하시면

테스트 거래로 취급되어 과금되지 않으며 hyphen-gestation 필드를 공란으로 설정하거나 제거 하시는 경우

실제 거래로 인식하여 요금이 과금됩니다.

■변경 예정사항(예시)

변경 전

변경 후

{
  "common": {
    "userTrNo": "",
    "hyphenTrNo": "10202410170000038141",
    "errYn": "N",
    "errMsg": ""
  },
  "data": {
    "taxTypeNm": "부가가치세 일반과세자",
    "changeDt": "",
    "bizNo": "4988102543",
    "taxTypeCd": "01",
    "taxMsg": "부가가치세 일반과세자 입니다.",
    "errMsg": "",
    "reqCd": "crc-24575d6d-fc0a-419c-b32e-e03d902b1d96",
    "taxSt": "00",
    "errYn": "N",
    "searchDt": "20241017"
  },
"resCd": "0000",
  "resMsg": "정상",
  "out": {
    "taxTypeNm": "부가가치세 일반과세자",
    "changeDt": "",
    "bizNo": "4988102543",
    "taxTypeCd": "01",
    "taxMsg": "부가가치세 일반과세자 입니다.",
    "errMsg": "",
    "reqCd": "crc-24575d6d-fc0a-419c-b32e-e03d902b1d96",
    "taxSt": "00",
    "errYn": "N",
    "searchDt": "20241017"
  },
  "reqTm": "2024-10-17 17:30:06",
  "reqTmSs": "2024-10-17 17:30:06.992",
  "resTm": "2024-10-17 17:30:07",
  "resTmSs": "2024-10-17 17:30:07.551",
  "reqCd": "crc-24575d6d-fc0a-419c-b32e-e03d902b1d96"

  "common": {
    "userTrNo": "",
    "hyphenTrNo": "10202410170000038304",

"errCd": "",
    "errYn": "N",
    "errMsg": ""
  },
  "data": {
    "taxTypeNm": "부가가치세 일반과세자",
    "changeDt": "",
    "bizNo": "498-81-02543",
    "taxTypeCd": "01",
    "taxMsg": "부가가치세 일반과세자 입니다.",
    "errMsg": "",
    "reqCd": "crc-3d3a6e41-e3ea-4a98-8e1e-b5d2183bb9b7",
    "taxSt": "00",
    "errYn": "N",
    "searchDt": "20241017"
  }
}

※ 당사 패치 이전 시기에 변경사항 적용시키시는 경우에도 정상적인 사용이 가능합니다.

■변경 상세(코드별)

필드명	필드상세	대체코드
resCd	하이픈 ↔ 당사 스크래핑 서버간의 응답코드	삭제
resMsg	하이픈 ↔ 당사 스크래핑 서버간의 응답값	삭제
taxTypeNm	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
changeDt	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
bizBNo	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
taxTypeCd	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
taxMsg	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
errMsg	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
reqCd	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
taxSt	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
errYn	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
searchDt	개별부(data) 데이터와 중복된 데이터	개별부 동일 필드값
regTm	하이픈 ↔ 당사 스크래핑 서버간의 응답시간	삭제
reqTmSs	하이픈 ↔ 당사 스크래핑 서버간의 응답시간	삭제
resTm	하이픈 ↔ 당사 스크래핑 서버간의 응답시간	삭제
resTmSs	하이픈 ↔ 당사 스크래핑 서버간의 응답시간	삭제
reqCd	하이픈 ↔ 당사 스크래핑 서버간의 응답코드	삭제

※ 개발가이드에 정의된 데이터 이외에 더미성 데이터가 전달될 수 있으나 실 데이터와 무방한 데이터 입니다.

관련 문의는 하이픈 고객센터(1600-4173 또는 help@hyphen.im)를 이용해 주세요.

더욱 편리한 서비스를 제공할 수 있도록 최선을 다하겠습니다.

감사합니다.