POST검증
문자열을 쓰기 전에 Base64인지 확인하세요. 답에는 알파벳, 패딩, 디코딩 크기가 담기고, 유효하지 않으면 그 이유가 담깁니다.
POST
https://api.base64hub.com/v1/validate요청
입력은 디코딩과 같습니다. input을 담은 JSON이나, text/plain 본문으로 보낸 Base64입니다.
curl -s https://api.base64hub.com/v1/validate \
-H 'Content-Type: text/plain' \
-d '-_-_'
const res = await fetch("https://api.base64hub.com/v1/validate", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ input: "-_-_" }),
});
const v = await res.json();
console.log(v.valid, v.variant, v.bytes); // true url 3
import json
import urllib.request
req = urllib.request.Request(
"https://api.base64hub.com/v1/validate",
data=json.dumps({"input": "-_-_"}).encode(),
headers={"Content-Type": "application/json"},
)
with urllib.request.urlopen(req) as res:
v = json.load(res)
print(v["valid"], v["variant"], v["bytes"]) # True url 3
b64 --validate -- -_-_
# valid (url, 3 bytes)
본문 매개변수
| 이름 | 타입 | 설명 |
|---|---|---|
input 필수 | string | 검사할 텍스트. |
응답
validate는 형식이 올바른 요청에는 항상 200으로 답합니다. 유효한 입력:
200 OK · application/json
{
"valid": true,
"variant": "url",
"padded": true,
"bytes": 3
}
유효하지 않은 입력(여기서는 Zm9vY):
200 OK · application/json
{
"valid": false,
"error": {
"code": "invalid_base64",
"message": "invalid length: 5 characters leave a single character in the last group"
}
}
| 필드 | 타입 | 설명 |
|---|---|---|
valid | boolean | 디코딩이 성공할 때 정확히 true. |
variant | string | +나 /가 있으면 standard, -나 _가 있으면 url, 둘 다 있으면 mixed, 둘 다 없으면 either. |
padded | boolean | =를 포함한 정리된 입력의 길이가 4의 배수인지. |
bytes | integer | 디코딩한 데이터의 크기. |
error | object | valid가 false일 때만 있음. code는 invalid_base64, message는 문제와 그 위치를 설명. |
either는 흔합니다. SGVsbG8sIGh1YiE=에는 네 가지 특수 문자가 하나도 없으므로 두 알파벳 모두에서 유효합니다. padded: false라고 해서 입력이 유효하지 않은 것은 아닙니다. SGVsbG8sIGh1YiE는 padded: false, 11바이트로 유효합니다.
오류
상태가 200이 아닌 오류는 Base64가 아니라 요청 자체에 관한 것입니다.
| 상태 | 코드 | 원인 |
|---|---|---|
| 400 | invalid_body | 유효하지 않은 JSON, input이 없거나 문자열이 아님, 알 수 없는 필드, 쿼리 매개변수, UTF-8이 아닌 본문. |
| 413 | too_large | 본문이 1 MB를 넘음. |
| 415 | unsupported_media_type | Content-Type이 application/json이나 text/plain이 아님. |
| 429 | 없음 | 요청 한도 도달. 제한 참고. |
업데이트 2026. 11. 22.