엔드포인트
| 메서드 | 경로 | 하는 일 |
|---|---|---|
POST | /v1/encode | 텍스트나 원시 바이트를 Base64로. 표준 또는 URL-safe, 패딩, 줄 바꿈 |
POST | /v1/decode | Base64를 텍스트로, 바이너리는 16진수로, 또는 원시 바이트로 |
POST | /v1/validate | Base64인지, 어떤 알파벳인지, 패딩이 있는지, 몇 바이트인지 |
GET | /v1/health | 상태와 버전 |
GET | /v1/openapi.json | OpenAPI 3.1 명세 |
요청과 응답은 JSON입니다. encode는 application/octet-stream으로 원시 바이트도 받으며, decode는 Accept: application/octet-stream으로 요청하면 원시 바이트를 돌려줍니다.
요청과 응답 예
문자열을 패딩 없는 URL-safe Base64로 인코딩합니다.
curl -s https://api.base64hub.com/v1/encode \
-H 'Content-Type: application/json' \
-d '{"input": "Привет", "variant": "url", "padding": false}'
{"output":"0J_RgNC40LLQtdGC","variant":"url","padding":false,"bytes_in":12,"bytes_out":16}
decode도 같은 방식으로 동작하며, 바이트가 텍스트가 아니면 그렇다고 알려 줍니다.
curl -s https://api.base64hub.com/v1/decode \
-H 'Content-Type: text/plain' -d '+/+/'
{"output":null,"utf8":false,"hex":"fbffbf","bytes_out":3}
디코더는 일부러 너그럽게 만들었습니다. 공백과 줄 바꿈, data:...;base64, 접두사, 빠진 패딩, 두 알파벳 모두 받아들입니다. 진짜 오류는 잘못된 문자와 그 위치를 담은 400 invalid_base64로 돌아옵니다. 예를 들면 invalid character '!' at position 4입니다.
제한과 동작
- 인증: 없음. 키나 토큰이 필요하지 않습니다.
- 요청 한도: IP 주소당 10초에 20개 요청. 한도를 넘으면 Cloudflare가 상태 429를 반환합니다.
- 본문 크기: 최대 1 MB. 더 큰 본문은
413 too_large를 받습니다. - 엄격한 입력: 알 수 없는 JSON 필드와 쿼리 매개변수는
400 invalid_body로 거부하므로 옵션 이름의 오타를 놓치지 않습니다. - CORS: 모든 응답에
Access-Control-Allow-Origin: *가 붙고 preflight에도 응답합니다. - 캐싱: 모든 응답이
Cache-Control: no-store입니다.
전체 오류 표와 콘텐츠 타입별 규칙은 API 개요에 있습니다.
Base64에 API를 쓰면 좋은 경우
Base64는 계산 비용이 적고 모든 언어에 내장되어 있습니다. 브라우저에는 btoa, Node.js에는 Buffer, Python에는 base64 모듈이 있습니다. 그래도 다음과 같은 경우에는 웹 서비스를 호출하는 편이 낫습니다.
- HTTP 요청은 보낼 수 있지만 코드는 실행할 수 없는 노코드 도구, 스프레드시트, 웹훅 빌더를 쓸 때
- 이식 작업 없이 모든 언어에서 같은 너그러운 디코딩과 검증을 쓰고 싶을 때
- 테스트나 교육용으로 비교할 기준 답이 필요할 때
토큰이나 개인 키처럼 민감한 데이터에는 로컬 도구를 쓰세요. 이 사이트의 브라우저 도구, CLI, npm 패키지와 Python 패키지는 데이터를 컴퓨터 밖으로 내보내지 않고 똑같은 결과를 냅니다.
자주 묻는 질문
base64hub API는 정말 무료인가요?
네. 키도 계정도 없습니다. 모두가 쓸 수 있도록 IP 주소당 10초에 20개 요청으로 요청 한도를 두고 있습니다.
API가 제가 보낸 내용을 저장하나요?
아니요. 저장소가 없는 Cloudflare Worker로 실행되며 요청 본문을 로그에 남기지 않습니다. 그래도 로컬 도구로 충분하다면 어떤 웹 서비스에도 비밀 값을 보내지 마세요. b64 CLI는 오프라인에서 같은 결과를 냅니다.
브라우저의 JavaScript에서 Base64 API를 호출할 수 있나요?
네. 모든 응답에 Access-Control-Allow-Origin: *가 붙고 preflight 요청에도 응답하므로 어느 출처(origin)에서나 fetch()가 동작합니다.
API로 얼마나 큰 파일을 인코딩할 수 있나요?
요청 본문은 1 MB로 제한됩니다. 더 큰 파일에는 스트리밍하는 CLI나 브라우저의 파일 → Base64 도구를 쓰세요.