CATCH LOC Developers

Login

설치 및 시작하기

라이브러리 추가 (CatchLoc-SDK.min.js/CatchLoc-SDK.min.mjs 다운로드)


            다운로드 받은 CatchLoc-SDK.min.js 파일을 원하시는 경로에 저장 후 html문서에 추가해주세요.
            <script src="path/to/CatchLoc-SDK.min.js"></script>
            

            모듈 형식으로 구현하시려면, CatchLoc-SDK.min.mjs 파일을 다운로드 해주세요.
            구현하시려는 자바스크립트 파일에 import 로 클래스를 가져오시면 됩니다.

            import {CatchLoc} from 'path/to/CatchLoc-SDK.min.mjs';
            

인스턴스 생성 및 초기화


            API키와 서버키를 SDK에 주입하여, SDK인스턴스를 초기화 합니다.

            CatchLoc.setApiKey('api키');
            CatchLoc.setServerKey('서버키');

            모듈을 임포트 하셨다면,
            let catchloc = new CatchLoc() 으로 객체생성 후, 해당 객체변수에서 함수를 호출하실 수 있습니다.


            초기화 이후 API를 호출하는 SDK의 함수를 실행하실 수 있습니다.
            

결과 처리하기 (예시)


            비동기(ajax)로 실행하기 때문에, 콜백함수를 이용하여 결과를 처리합니다.

            SDK를 초기화 후, 함수를 호출할 때 두 가지의 매개변수를 입력합니다.

            CatchLoc.getLastData(params, callback);


            - params (json 객체)
            let params =
            {
                API Request Body 를 json 형태로 설정합니다
            };

            - callback
            function callback(json)
            {
                1. json에서 result값 ok 확인
                2. json에서 type값 확인
                3. type값에 따라 message 처리

                - type이 array인 경우
                let items = json.message;

                for (var i in items)
                {
                    let item = items[i];

                    item 내용 처리
                }

                - type이 json인 경우, API Response를 참고하여 꼭 루프를 돌지 않고 처리하셔도 됩니다.
            }