API Command Center

Blokore 통합 사령부 기술 명세서

[01] 개요

본 문서는 thankun.kro.kr에서 제공하는 마인크래프트 유저 수색 및 데이터 수집 API의 사용법을 정의합니다. 모든 요청은 HTTPS를 통해 이루는게 정신에 이로우며, 결과는 JSON 형식으로 반환됩니다.

[02] 엔드포인트: 유저 수색

GET /api/mojang

닉네임을 입력받아 해당 유저의 UUID와 스킨 데이터를 확보합니다.

ParameterTypeRequiredDescription
nameStringYes수색할 마인크래프트 닉네임

응답 예시 (Success)

{
  "name": "thankun",
  "uuid": "...",
  "full_uuid": "...",
  "skin_url": "https://textures.minecraft.net/..."
}

[03] 엔드포인트: 유니코드 변환

GET /api/unicode

문자열과 유니코드(U+XXXX) 간의 상호 정밀 변환을 수행합니다.

ParameterTypeRequiredDescription
modeStringYestoUnicode 또는 toText
textStringYes변환할 원본 데이터 (URL 인코딩 권장)

응답 예시 (Success)

{
  "result": "U+C548 U+B155"
}

* 팁: toText 모드 사용 시 \uXXXX 형식도 자동으로 감지하여 처리합니다.

[04] 엔드포인트: N진수 통합 변환

GET /api/base

임의의 진수 데이터를 다른 진수 체계로 정밀 변환합니다. (2~36진수 지원)

ParameterDefaultDescription
value(Required)변환할 숫자 데이터
from10입력 데이터의 진수 (Base)
to16출력 데이터의 진수 (Base)

사용 예시

/api/base?value=1010&from=2&to=10{"input":"1010","from":"2","to":"10","result":"10"}

[05] 엔드포인트: 정밀 시간 분석

GET /api/timestamp

밀리초(ms) 단위의 유닉스 타임스탬프를 사람이 읽을 수 있는 KST(한국 표준시)로 복원합니다.

ParameterTypeRequiredDescription
tsNumber/StringYes분석할 13자리 타임스탬프 (ms 단위)

응답 예시 (Success)

{
  "success": true,
  "result": "2026. 04. 30. 16:24:29.968",
  "raw": "1777566269968"
}

* 참고: 본 API는 BigInt 연산을 통해 거대 정수 처리 시 발생할 수 있는 데이터 유실을 방지합니다.

[06] 엔드포인트: 13일의 금요일 추적

GET /api/friday13

특정 연도에 존재하는 모든 '13일의 금요일' 날짜를 정밀 수색하여 리스트로 반환합니다.

ParameterTypeDefaultDescription
yearNumberCurrent Year수색할 연도 (4자리 정수)

응답 예시 (Success)

{
  "success": true,
  "year": 2026,
  "count": 3,
  "dates": [
    { "year": 2026, "month": 2, "day": 13, "formatted": "2026-02-13" },
    { "year": 2026, "month": 3, "day": 13, "formatted": "2026-03-13" },
    { "year": 2026, "month": 11, "day": 13, "formatted": "2026-11-13" }
  ]
}

* 팁: 이 글은 사실 팁이 아니라 Never gonna give you up 입ㄴ디ㅏ

사령부 운영 지침

본 API는 유저분의 관대함으로 운영됩니다.
서버가 터지지 않을 정도로만 자유롭게 활용해 주세요. 별도의 문의는 받지 않으며, 모든 수색 결과는 실시간 데이터에 의존합니다.