TILKO

API 사용 방법

틸코 API를 사용하기 위해 공통으로 적용되는 사항입니다.

Request

Header

POST / Api Url
Host: api.tilko.net
API-KEY: API KEY ( 내정보 -> API KEY )
ENC-KEY: API KEY 생성 시 제공받은 '공개키'로 RSA 암호화 시킨 AES Secret key 값
AES Secret key는 고객님이 생성한 값입니다.

API-KEY

API KEY 는 로그인 후 ‘ 내정보/API KEY ‘ 메뉴에서 확인 할 수 있으며, 없다면 생성 해야합니다.
API KEY 는 암호화 할 필요가 없고, 값 그대로 헤더에 실어주면 됩니다.
사용 여부를 반드시 체크해야하고, 사용 안함으로 선택되어 있을 시 사용 할 수 없습니다.

ENC-KEY

사용할 API의 변수에 [암호화] 라고 적혀있다면, AES-CBC-128 암호화 한 후 BASE 64 인코딩 해야합니다.
AES-CBC-128 암호화에 이용 된 SECRET-KEY를 공개키로 RSA 암호화 한 후 BASE 64 하여 헤더 ENC-KEY에 입력합니다.
AES에 사용되는 secret key는 클라이언트가 임의의 128비트의 값으로 생성합니다.

Parameter

Name	Type	Description
변수1	String	[암호화] AES로 암호화 된 Request 데이터
변수2	String	암호화 안된 일반 문자열 Request 데이터
변수3	int32,64	암호화 안된 일반 정수형 Request 데이터
변수4	String	암호화 안된 일반 문자열 Request 데이터(yyyy-MM-dd)

Tilko