CATCH LOC Developers

등록된 위치오브젝트 정보 조회 API

Description

각 파트너사의 등록된 위치오브젝트들의 정보와 최종위치정보 조회하는 API.

API

http://cms.catchloc.com/api.get.member.info.all.php

Parameters

api_key : 파트너 API_KEY
timestamp : 현재시간 Unix timestamp
cert_key : API 인증용 hash key
page : 목록의 페이지 번호(Default 1)
page_size : 목록의 페이지 크기(Default 100)

Response

protocol : JSON Array
member_key : CatchLoc location object member key
member_id : CatchLoc member id
member_name : CatchLoc member name
member_status : Object 상태값(Code)
member_status_str : Object 상태값(Text)
pincode : 패미 PIN 번호
last_location_date : 최종위치등록시간(Unix timestamp)
last_location_speed : 최종위치속도(km/h)
last_latitude : 위도
last_longitude : 경도
odometer : 총 누적이동거리(m)

Example


            ===== Request =====

            http://cms.catchloc.com/api.get.member.info.all.php?
            api_key=abcdefghijklmnopqrstuvwxyz1234567890&
            timestamp=1446624149000&
            cert_key=abcdefghijklmnopqrstuvwxyz1234567890



            ===== Response =====

            - 성공 시            
            [
                {
                    "member_key":"abcdefghijklmnopqrstuvwxyz1234567890",
                    "member_id":"MEMBER_ID",
                    "member_name":"MEMBER_NAME",
                    "member_status":"0",
                    "member_status_str":"OBJECT_STATUS_0",
                    "pincode":"601559943",
                    "last_location_date":0,
                    "last_location_speed":1.2,
                    "last_latitude":0,
                    "last_longitude":0,
                    "odometer":12345
                },......
            ]

            - 실패 시
            {
                "result":"FAIL",
                "message":"에러 사유"
            }


            ===== Request =====

            String page = "100개 단위의 정보 페이지 번호, 2인 경우 101~200번째의 데이터 목록 호출";

            CatchLoc catchloc = new CatchLoc();

            catchloc.setApiKey("API키");
            catchloc.setServerKey("서버키");

            JSONObject result = catchloc.getObjectsData(page);



            ===== Response (JSONObject) =====

            {
                "result"  : "ok",
                "type"    : "jsonarray"
                "message" : API Response Body
            }


            ===== Request =====

            import CatchLocSDKForAPI (공통)

            CatchLocAPI.shared.setApiKey(API_KEY)
            CatchLocAPI.shared.setserverKey(SERVER_KEY)

            - page : 목록의 페이지 번호(Default 1)

            CatchLocAPI.shared.getObjectsData(page: page)

            혹은

            CatchLocAPI.shared.getObjectsData()
            { result in
                
                let jsonData = result.response

                혹은

                let jsonString = result.description()
                
            }

            ===== Response =====

            {
                "response" : API Response Body
            }


            ===== Request =====
            
            $page = '100개 단위의 정보 페이지 번호, 2인 경우 101~200번째의 데이터 목록 호출';

            $catchloc = new CatchLoc();

            $catchloc->setApiKey("API키");
            $catchloc->setServerKey("서버키")

            $result = $catchloc->getObjectsData($page);


            ===== Response (JSON 형태의 문자열) =====

            "{
                "result"  : "ok",
                "type"    : "array"
                "message" : API Response Body
            }"


            ===== Request =====

            var callback = function(json)
            {
                api 응답값을 처리하는 콜백함수의 내용
                (예시 : 지도에 위치 출력 혹은 목록 출력)
            };

            var params =
            {
                page: '100개 단위의 정보 페이지 번호, 2인 경우 101~200번째의 데이터 목록 호출'
            };

            CatchLoc.setApiKey("API키");
            CatchLoc.setServerKey("서버키");

            CatchLoc.getObjectsData(params, callback);



            ===== Response (JSON, callback 함수의 매개변수 내용) =====

            {
                "result"  : "ok",
                "type"    : "array"
                "message" : API Response Body
            }