파일 업로드
  1. base64hub
  2. 문서
  3. HTTP API

HTTP API 개요

https://api.base64hub.com/v1에 있는 작은 Base64 JSON API입니다. 키도 계정도 필요 없고 CORS를 지원합니다. 이 페이지에서는 모든 엔드포인트에 공통인 내용을 다룹니다.

기본 URL과 엔드포인트

https://api.base64hub.com/v1
메서드경로용도
POST/v1/encode텍스트나 원시 바이트를 Base64로
POST/v1/decodeBase64를 텍스트, 16진수, 원시 바이트로
POST/v1/validateBase64를 검사하고 특성을 알려 줌
GET/v1/health상태와 버전
GET/v1/openapi.jsonAPI의 OpenAPI 3.1 명세

GET https://api.base64hub.com/은 이 페이지로 리디렉션(302)됩니다. 요청에 인증은 필요 없습니다.

요청 형식

엔드포인트마다 받는 콘텐츠 타입이 정해져 있으며, 그 밖의 타입에는 415 unsupported_media_type으로 답합니다.

엔드포인트Content-Type본문
encodeapplication/json{"input": "<text>", "variant", "padding", "wrap"}
encodeapplication/octet-stream원시 바이트. 옵션은 쿼리 문자열로
decode, validateapplication/json{"input": "<base64>"}
decode, validatetext/plainBase64 자체

본문은 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"}}
상태코드발생 조건
400invalid_body형식이 잘못된 JSON, 잘못된 필드 타입, input 누락, 알 수 없는 필드나 쿼리 매개변수, UTF-8이 아닌 본문
400invalid_base64decode 입력이 Base64가 아님. 메시지에 문제와 그 위치가 나옴
404not_found알 수 없는 경로
405method_not_allowed경로에 맞지 않는 메서드. Allow 헤더에 올바른 메서드가 나옴
413too_large1 MB를 넘는 본문
415unsupported_media_type엔드포인트가 받지 않는 Content-Type
429없음요청 한도 도달. 응답은 JSON이 아니라 Cloudflare가 보냄
500internal_errorAPI의 예기치 않은 오류

validate는 잘못된 Base64도 상태 200으로 보고합니다. “유효하지 않음"이 바로 질문에 대한 답이기 때문입니다. 검증을 참고하세요.

OpenAPI

기계가 읽을 수 있는 명세는 https://api.base64hub.com/v1/openapi.json에 있습니다. API 클라이언트나 코드 생성기로 가져오면 모든 엔드포인트의 요청을 바로 만들 수 있습니다.

업데이트 2026. 11. 22.