OPEN API GUIDE

공통 사항

API SECRET KEY

API 호출은 가급적 Backend 또는 Intranet용 Frontend에만 사용을 권장합니다.(SECRET KEY는 유출 주의)

API URL

https://cust.devy.kr/openapi/{FunctionName}/

REQUEST METHOD

GET | POST

REQUEST DATA
  • DATA TYPE : json 권장
  • 필수 공통 제출 데이터
    Name Type Required Description
    ServiceId Number * [fixed] 할당된 ServiceId
    Ex) 9000
    TimeStamp Number * Unix timestamp (현재시각)
    Ex) 1748787152
    TimeHash Text * SHA256 HMAC of TimeStamp (Hexa string)
    Ex) c934a6a3e6db3951894747dc8891c9559e1759c1e7a000a2a775290f912e133e
TimeHash?
  • TimeHash는 TimeStamp와 API_SECRET_KEY를 이용하여 SHA256 HMAC으로 계산한 값입니다.
  • 아래 HMAC 자료를 참고하여 API 요청시간(TimeStamp)에 해당하는 TimeHash 값을 계산해 주세요.
    HMAC Sample GIT
  • Format(Encoding) : Hexa encoded text, not base64 encoding.
RESPONSE DATA

json type

기타 주의사항
  • TimeStamp값이 서버시각 기준 5분이상 차이나는 경우 ERROR 응답됩니다.