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) 1757059571
    TimeHash Text * SHA256 HMAC of TimeStamp (Hexa string)
    Ex) 39373714b27137d1c7cbfc68b0a632860961ab1765fc603ba31dea50d96f7875
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 응답됩니다.