Service
일본 e-Gov 데이터 포털의 공식 읽기 전용 CKAN API로 데이터셋을 검색하고 데이터셋·리소스 메타데이터를 조회하며 기관·카테고리 선택자와 최근 수정 데이터셋을 확인합니다.
98.12%30일 가동률평균 응답442ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/japan-open-data/categories | Lists all e-Gov data categories (CKAN groups) with optional dataset counts so their category_id tokens can be passed to search-datasets. Use when the user wants to filter datasets by topic category or browse categories. Do NOT use to list publishing organizations — use japan-open-data:organizations instead. The complete category list is returned in one response without pagination. Returns items (category_id, title, description, dataset_count) and summary. | |
| POST | /v1/japan-open-data/dataset | Gets one dataset and a bounded page of its publisher resource metadata (name, format, MIME type, URL, timestamps) using a dataset_id returned by search-datasets or recent-datasets. Use when the user has already selected a dataset and needs its resources or publisher download URLs. Do NOT use to find datasets — use japan-open-data:search-datasets instead. The resource page is controlled by resource_limit (1-50) and resource_offset; resource files are not downloaded by APIFuse. Timestamps are explicit UTC instants. Returns items (one dataset detail with resources, resources_returned_count, resources_has_more, and next_resource_offset) and summary. | |
| POST | /v1/japan-open-data/organizations | Lists e-Gov publishing organizations with optional dataset counts so their organization_id tokens can be passed to search-datasets. Use when the user wants to filter datasets by publisher or browse publishers. Do NOT use to list data categories (CKAN groups) — use japan-open-data:categories instead; do NOT use to search datasets themselves — use japan-open-data:search-datasets instead. Pages with a cursor: pass summary.cursor from the previous response back as cursor, unchanged; limit is 1-100 per page and the whole registry is well under one page. Returns items (organization_id, title, description, dataset_count) and summary. | |
| POST | /v1/japan-open-data/recent-datasets | Lists recently modified e-Gov datasets in the portal's newest-modified-first order with resource counts and UTC ISO 8601 timestamps. Use when the user asks what datasets were added or updated recently without a specific keyword. Do NOT use for keyword or filtered search — use japan-open-data:search-datasets instead; do NOT use to get a dataset's resources — use japan-open-data:dataset instead. Pages with a cursor: pass summary.cursor from the previous response back as cursor, unchanged; limit is 1-50 per page. Returns items (dataset summaries with dataset_id and resource_count) and summary. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
| POST | /v1/japan-open-data/search-datasets | Searches e-Gov Data Portal datasets by a required full-text query with optional organization_id, category_id, and resource-format (formats) filters. Use when the user names a topic or keyword to look for. Do NOT use to browse what changed recently — use japan-open-data:recent-datasets instead; do NOT use to discover organization or category tokens — use japan-open-data:organizations or japan-open-data:categories instead. Pages with a cursor: pass summary.cursor from the previous response back as cursor, unchanged, along with the identical query and filters; limit is 1-50 per page; dataset timestamps are explicit UTC instants. Returns items (dataset summaries with dataset_id, organization, categories, tags, and resource_count) and summary (returned_count, total_count for the whole result set, has_more, cursor). |
