동적 주소로 조회

이벤트 발생일을 기준으로 특정일을 조회한다던가 특정 검색어를 동적으로 변경하여 조회할 때 사용됩니다.

  • 동적으로 조회하고자 하는 API의 End Point를 확인해주시고 사용할 API 에 대한 미리보기 버튼을 클릭합니다.

  • API 의 요청 변수 값을 확인합니다.

  • 데이터플로우에서 단계별로 커넥터를 설정합니다.

  1. 공공데이터포털에서 확인한 API End Point 주소를 입력해 주세요.

  2. API 의 요청변수 값을 JSON 형태로 입력해 주세요. JSON 형태는 중괄호({}) 안에서 항목과 값을 한 쌍으로 묶어주는 데이터 형태입니다. JSON 형태 데이터 안에서의 값은 큰따옴표("") 로 묶어주셔야 합니다.

  3. 동적으로 데이터바인딩이 필요할 경우 두개의 중괄호 묶음({{}}) 으로 처리해 주셔야 합니다.

  4. API 호출 후 처리할 데이터 경로를 지정합니다.

데이터 경로를 지정하는 이유는 무엇인가요?

각 공공데이터포털에서 제공되는 API는 목적 또는 개발한 기관에 따라 제공하는 데이터 형태가 다르기 때문에 조회된 데이터를 참고하여 직접 데이터 경로를 지정해 주어야 합니다.

조회할 데이터는 배열 형태의 데이터여야 합니다. 배열은 연관된 데이터를 모아서 관리하기 위해서 사용되는 데이터 형태입니다.

  • XML 형태의 데이터인 경우 (예시)

PublicToiletsBefore2017 하단에 row 항목이 반복되는 형태의 데이터를 배열로 해석합니다. 즉 데이터 경로는 PublicToiletsBefore2017.row 입니다.

  • JSON 형태의 데이터인 경우(예시)

대괄호([ ])로 감싸져 있는 부분을 배열이라 부르며 예시에서는 MetalService 객체 안에 item 이란 객체로 반환됩니다. 데이터 경로는 MetalService.item 입니다.

API가 조회되지 않는다면 다음을 확인해 주세요.

  1. 올바른 API Key를 입력했는지 확인해 주세요 (일부 API 는 별도의 API Key 를 발급하여 사용하셔야 합니다.)

  2. 하루 호출 가능한 API 회수를 초과했는지 확인해 주세요 (최대 가능 회수는 일당 10,000회이며 기관마다 API 호출 정책이 변경될 수 있습니다.)

  3. 일시적인 API 연결 상태 이상으로 호출이 실패되었을 수 있습니다. 어느정도의 시간을 두고 다시 호출해 주세요.

  4. 조회하고자 하는 데이터가 배열 형식인지 확인해 주세요.

  5. 표준을 지키지 않은 API 의 경우는 보안 및 시스템 안정성을 위해 지원하지 않습니다.

Last updated