Search postal code
Japan Post ZIP
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 honest and 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. Keyless public upstream; no credentials required.
Provider-first APIFuse endpoint
curl -X POST \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
"https://api.apifuse.com/v1/japan-post-zip/search_postal_code" \
-d '{
"postal_code": "7830060"
}'모든 Gateway 호출에는 APIFuse API key가 필요합니다. Connection badge가 표시된 operation은 추가로 X-ApiFuse-Connection-Id 헤더를 전달하세요.
인증 규칙 반영
provider catalog의 auth mode를 기반으로 필요한 인증 방식이 상세 페이지와 OpenAPI에 함께 반영됩니다.
Gateway 경로 자동 연결
provider/operation 조합이 그대로 APIFuse Gateway 경로와 Platform 문서 링크에 반영됩니다.
스키마 기반 문서화
요청 예시와 응답 스키마가 provider 정의에서 자동으로 내려와 항상 최신 상태를 유지합니다.