몰루로그 API^베타

소개

API 문서

API 키

데이터 변경 이력

API로 변경한 데이터를 확인해요.

API 문서

코딩 에이전트로 연동하기

프롬프트 예시

https://api.mollulog.net/llms.txt 를 읽고, 블루 아카이브 데이터 관리 서비스인 몰루로그 API에 대해 파악해주세요. 개발중인 도구와 어떻게 연동할 수 있을지 검토 후 제안해주세요.

전체 안내: https://api.mollulog.net/llms-full.txt
목차: https://api.mollulog.net/llms.txt
OpenAPI: https://api.mollulog.net/v1/openapi.json

연결

Base URL: https://api.mollulog.net/v1
인증: Authorization: Bearer <API 키>

엔드포인트

학생 읽기 권한

GET/students?query=학생 찾기

파라미터	설명
`query`	학생 UID 또는 이름 검색어 (1–200자)
`limit`	기본 50 · 최대 100
`cursor`	이전 응답에서 받은 nextCursor

요청 예시

curl --request GET \
  --url 'https://api.mollulog.net/v1/students?query=아루' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Accept: application/json'

응답: students(UID·이름)와 nextCursor

GET/me/students모집 학생 목록

파라미터	설명
`limit`	기본 50 · 최대 100
`cursor`	이전 응답에서 받은 nextCursor

요청 예시

curl --request GET \
  --url 'https://api.mollulog.net/v1/me/students?limit=50&cursor=<CURSOR>' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Accept: application/json'

응답: 모집 학생의 현재 상태 목록

GET/me/students/:studentUid모집 학생 조회

파라미터	설명
`studentUid`	학생 찾기로 얻은 UID

요청 예시

curl --request GET \
  --url 'https://api.mollulog.net/v1/me/students/10000' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Accept: application/json'

응답 200

{"studentUid":"10000","tier":5,"weaponTier":0,"level":90,"skillEx":5,"skillNormal":10,"skillEnhanced":10,"skillSub":10,"equip1":10,"equip2":10,"equip3":10,"equip1Level":70,"equip2Level":70,"equip3Level":70,"equipSpecial":2,"weaponLevel":0,"abilityHp":0,"abilityAtk":0,"abilityHeal":0,"bond":20,"bondExp":1845}

등록하지 않은 학생이면 404 student_not_recruited

학생 쓰기 권한

POST/me/students모집 학생 등록

studentUid, tier, weaponTier는 꼭 보내야 해요.

요청 예시

curl --request POST \
  --url 'https://api.mollulog.net/v1/me/students' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"studentUid":"10000","tier":5,"weaponTier":0,"level":90}'

응답 201

{"studentUid":"10000"}

응답에 현재 상태 필드가 함께 와요 · 이미 등록한 학생이면 409 student_already_recruited

PATCH/me/students/:studentUid모집 학생 수정

파라미터	설명
`studentUid`	학생 찾기로 얻은 UID

요청 예시

curl --request PATCH \
  --url 'https://api.mollulog.net/v1/me/students/10000' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{"level":90,"bond":20}'

응답 200

{"studentUid":"10000"}

보낸 필드만 바뀌어요 · 등록하지 않은 학생이면 404 student_not_recruited

DELETE/me/students/:studentUid모집 학생 삭제

파라미터	설명
`studentUid`	학생 찾기로 얻은 UID

요청 예시

curl --request DELETE \
  --url 'https://api.mollulog.net/v1/me/students/10000' \
  --header 'Authorization: Bearer <API_KEY>'

응답 200

{"studentUid":"10000","deleted":true}

모집 등록, 현재 성장도, 인연·경험치를 지워요 · 육성 목표, 선물 계획, 플래너는 남아요

학생 상태 필드

필드	의미	범위	null로 비우기
`tier`	학생 성급등록할 때 필요	1–5	불가
`weaponTier`	고유무기 성급0은 고유무기 없음 · 1 이상은 학생 성급 5에서만 · 등록할 때 필요	0–4	불가
`level`	학생 Lv	1–90	가능
`skillEx`	EX 스킬	1–5	가능
`skillNormalskillEnhancedskillSub`	기본 · 강화 · 서브 스킬	1–10	가능
`equip1equip2equip3`	장비 1 · 2 · 3 티어	1–10	가능
`equip1Levelequip2Levelequip3Level`	장비 1 · 2 · 3 레벨	1–70	가능
`equipSpecial`	애용품	1–2	가능
`weaponLevel`	고유무기 Lv고유무기 성급에 따라 최대값이 달라요	0–60	가능
`abilityHpabilityAtkabilityHeal`	능력 해방 (HP · 공격력 · 치유력)1 이상은 고유무기가 있을 때만	0–25	가능
`bond`	인연 랭크	1–100	가능
`bondExp`	인연 누적 경험치인연 랭크와 맞지 않으면 비워져요	0–240,225	가능

결과 상태가 규칙에 맞지 않으면 요청 전체를 거부해요

오류

상태	코드 · 의미
`400`	`invalid_request`잘못된 요청 · 요청 내용을 확인해주세요 · 문제가 된 필드는 fields에 담겨요
`401`	`unauthorized`인증 실패 · API 키가 없거나, 올바르지 않거나, 만료·삭제됐어요
`403`	`forbidden`권한 없음 · 키에 필요한 권한이 없거나 계정이 활성 상태가 아니에요
`404`	`not_found`찾을 수 없음 · API 경로나 학생 UID를 확인해주세요
`404`	`student_not_recruited`등록하지 않은 학생 · 먼저 POST로 등록해주세요
`409`	`student_already_recruited`이미 등록한 학생 · 값을 바꾸려면 PATCH로 보내주세요
`429`	`rate_limited`요청 한도 초과 · Retry-After만큼 기다린 뒤 다시 보내주세요
`500`	`internal_error`서버 오류 · 요청이 처리됐는지 알 수 없어요 · GET으로 확인한 뒤 필요하면 다시 보내주세요
`503`	`unavailable`잠시 사용할 수 없음 · 요청을 처리하지 않았어요 · 잠시 후 다시 보내주세요

오류 응답 예시

{
  "error": {
    "code": "invalid_request",
    "message": "요청 내용을 확인해주세요.",
    "fields": [{ "field": "level", "message": "1부터 90 사이여야 해요." }],
    "docs": "https://mollulog.net/developers/docs#error-invalid_request"
  }
}

제한과 규칙

읽기 한도: 분당 60회 · 계정·지역별
쓰기 한도: 10분에 500회 · 모든 키 합산
요청 크기: 본문 최대 1MiB
학생 UID: 학생 찾기로 얻은 UID · 폼 체인지 학생은 다른 폼의 UID도 대표 UID로 처리돼요
키 유효 기간: 발급 후 1년
재시도: 같은 요청을 다시 보내면 다시 처리돼요

변경 이력

몰루로그

게임 <블루 아카이브>의 에셋 및 콘텐츠의 권리는 넥슨, 넥슨게임즈 및 Yostar에 있습니다.
몰루로그는 <블루 아카이브>의 비공식 팬 사이트이며 컨텐츠를 상업적으로 이용하지 않습니다.

서비스 이용 약관 개인정보처리방침 GitHub Twitter (X)