Service
공개 zipcloud API 기반의 일본 우편번호(ZIP) → 주소 정규화 조회. 7자리 우편번호를 입력하면 도도부현/시구정촌/정역 매치를 반각 가타카나 읽기와 JIS X 0401 도도부현 코드와 함께 반환합니다.
99.93%30일 가동률평균 응답503ms
행을 선택하면 해당 API의 레퍼런스로 이동합니다.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/japan-post-zip/search-postal-code | Resolves a 7-digit Japanese postal code (ZIP) into normalized address matches via the public zipcloud lookup API. Use when the user provides a Japanese postal code such as 7830060 or 100-0001 (send digits only) and needs the prefecture, city, and town it belongs to, including half-width katakana readings and the JIS X 0401 prefecture code. Boundary codes can return multiple matches. Coverage is Japan Post KEN_ALL town-level data only: match_found:false with zero matches means the code has no KEN_ALL entry — either genuinely unassigned OR a real, assigned large-office individual code (大口事業所個別番号, e.g. 100-8111 for the Imperial Household Agency), which zipcloud does not carry. A no-match is a normal result, not an error, but it is NOT proof the postal code does not exist. Do NOT use for reverse lookup (address to postal code), non-Japanese postal codes, or partial/prefix search — the upstream only supports exact 7-digit lookup. No account or credentials required. Returns the echoed postal_code, match_found, a matches array (postal_code, prefecture, prefecture_code, prefecture_kana, city, city_kana, town, town_kana) and returned_count. |
sandbox key를 발급받고 첫 예약 생성까지 진행합니다.
파트너 credential은 APIFuse이 보관합니다. 발급받는 것은 하나의 managed key입니다.
예약 확정, 배달 상태 변경 같은 이벤트를 webhook으로 수신합니다.
서비스 장애와 게이트웨이 에러를 하나의 에러 모델로 정규화합니다.
