HTTP API 개요
https://api.base64hub.com/v1에 있는 작은 Base64 JSON API입니다. 키도 계정도 필요 없고 CORS를 지원합니다. 이 페이지에서는 모든 엔드포인트에 공통인 내용을 다룹니다.
기본 URL과 엔드포인트
https://api.base64hub.com/v1
| 메서드 | 경로 | 용도 |
|---|---|---|
POST | /v1/encode | 텍스트나 원시 바이트를 Base64로 |
POST | /v1/decode | Base64를 텍스트, 16진수, 원시 바이트로 |
POST | /v1/validate | Base64를 검사하고 특성을 알려 줌 |
GET | /v1/health | 상태와 버전 |
GET | /v1/openapi.json | API의 OpenAPI 3.1 명세 |
GET https://api.base64hub.com/은 이 페이지로 리디렉션(302)됩니다. 요청에 인증은 필요 없습니다.
요청 형식
엔드포인트마다 받는 콘텐츠 타입이 정해져 있으며, 그 밖의 타입에는 415 unsupported_media_type으로 답합니다.
| 엔드포인트 | Content-Type | 본문 |
|---|---|---|
| encode | application/json | {"input": "<text>", "variant", "padding", "wrap"} |
| encode | application/octet-stream | 원시 바이트. 옵션은 쿼리 문자열로 |
| decode, validate | application/json | {"input": "<base64>"} |
| decode, validate | text/plain | Base64 자체 |
본문은 UTF-8이어야 합니다(encode에 보내는 원시 바이트는 예외). 알 수 없는 JSON 필드와 쿼리 매개변수는 무시하지 않고 400 invalid_body로 거부하므로, 옵션 이름을 잘못 써도 조용히 실패하는 일이 없습니다. 쿼리 옵션은 application/octet-stream 본문과 함께 보낼 때만 읽습니다.
응답은 JSON(application/json; charset=utf-8)입니다. 단, Accept: application/octet-stream을 붙인 decode는 원시 바이트를 반환합니다.
CORS와 헤더
모든 응답에는 다음 헤더가 붙습니다.
Access-Control-Allow-Origin: *
Cache-Control: no-store
X-Content-Type-Options: nosniff
preflight OPTIONS 요청에는 허용 메서드와 Content-Type, Accept 요청 헤더를 담은 204로 답하므로 어느 웹 페이지에서나 fetch()로 API를 호출할 수 있습니다.
제한
- 본문 크기: 1 MB(1048576바이트). 더 큰 본문은
413 too_large를 받습니다. - 요청 한도:
/v1/아래 경로에서 IP 주소당 10초에 20개 요청. 한도는 API 앞단의 Cloudflare가 적용합니다. 한도를 넘으면 Cloudflare 자체 응답과 함께 상태429를 받는데, 이 응답은 JSON이 아니고 CORS 헤더도 없어서 브라우저 스크립트에는 읽을 수 있는 본문 대신 네트워크 오류로 보입니다. - 줄 바꿈(wrap): 0~1000자.
API는 상태를 저장하지 않으며 요청 본문을 로그에 남기지 않습니다. 큰 파일이나 비밀 값에는 b64 CLI 같은 로컬 도구를 쓰세요.
오류
API 자체에서 나는 오류는 변하지 않는 code와 사람이 읽을 수 있는 message를 담은 JSON입니다.
{"error":{"code":"invalid_base64","message":"invalid character '!' at position 4"}}
| 상태 | 코드 | 발생 조건 |
|---|---|---|
| 400 | invalid_body | 형식이 잘못된 JSON, 잘못된 필드 타입, input 누락, 알 수 없는 필드나 쿼리 매개변수, UTF-8이 아닌 본문 |
| 400 | invalid_base64 | decode 입력이 Base64가 아님. 메시지에 문제와 그 위치가 나옴 |
| 404 | not_found | 알 수 없는 경로 |
| 405 | method_not_allowed | 경로에 맞지 않는 메서드. Allow 헤더에 올바른 메서드가 나옴 |
| 413 | too_large | 1 MB를 넘는 본문 |
| 415 | unsupported_media_type | 엔드포인트가 받지 않는 Content-Type |
| 429 | 없음 | 요청 한도 도달. 응답은 JSON이 아니라 Cloudflare가 보냄 |
| 500 | internal_error | API의 예기치 않은 오류 |
validate는 잘못된 Base64도 상태 200으로 보고합니다. “유효하지 않음"이 바로 질문에 대한 답이기 때문입니다. 검증을 참고하세요.
OpenAPI
기계가 읽을 수 있는 명세는 https://api.base64hub.com/v1/openapi.json에 있습니다. API 클라이언트나 코드 생성기로 가져오면 모든 엔드포인트의 요청을 바로 만들 수 있습니다.
업데이트 2026. 11. 22.