# MINIGAME API

> MINIGAME(https://minigame.kr)은 AI로 만든 웹 미니게임을 소개하는 한국어 포털이에요. API v1으로 공개 게임 정보를 키 없이 읽고, 제작자는 API 키로 자기 게임의 정보·패치노트·통계·리뷰와 제보를 다뤄요.

- 기준 주소는 https://minigame.kr/api/v1 하나예요. www 같은 다른 주소나 http:// 로 보내면 리다이렉트되면서 키가 빠지니, 리다이렉트를 따라가지 마세요.
- 제작자 API는 `Authorization: Bearer $MINIGAME_API_KEY` 헤더로 불러요. 키는 환경 변수 MINIGAME_API_KEY 에만 두고 출력하지 마세요.
- 쓰기(POST·PATCH·PUT) 전에는 사람의 확인을 받으세요.

## 문서

- [전체 문서 (Markdown)](https://minigame.kr/developers.md): 엔드포인트·데이터 모양·오류·요청 한도
- [OpenAPI 3.1](https://minigame.kr/openapi.json): 요청·응답 형식
- [AI에게 맡기기](https://minigame.kr/developers.md#ai): 터미널 AI 도구에 붙여 넣는 작업 지침

## 공개 API

- [GET /](https://minigame.kr/developers.md#get-index): API 안내
- [GET /games](https://minigame.kr/developers.md#get-games): 게임 목록
- [GET /games/{slug}](https://minigame.kr/developers.md#get-game): 게임 정보
- [GET /games/{slug}/patch-notes](https://minigame.kr/developers.md#get-game-patch-notes): 패치노트 목록
- [GET /creators/{handle}](https://minigame.kr/developers.md#get-creator): 제작자 정보
- [GET /creators/{handle}/games](https://minigame.kr/developers.md#get-creator-games): 제작자의 게임
- [GET /enums](https://minigame.kr/developers.md#get-enums): 값 목록

## 제작자 API

- [GET /me](https://minigame.kr/developers.md#get-me): 내 키와 계정
- [GET /me/games](https://minigame.kr/developers.md#get-my-games): 내 게임 목록
- [POST /me/games](https://minigame.kr/developers.md#post-my-games): 게임 등록
- [GET /me/games/{id}](https://minigame.kr/developers.md#get-my-game): 내 게임 정보
- [PATCH /me/games/{id}](https://minigame.kr/developers.md#patch-my-game): 게임 정보 수정
- [PUT /me/games/{id}/visibility](https://minigame.kr/developers.md#put-visibility): 공개 상태 바꾸기
- [POST /me/images](https://minigame.kr/developers.md#post-images): 이미지 올리기
- [GET /me/games/{id}/patch-notes](https://minigame.kr/developers.md#get-my-patch-notes): 내 패치노트 목록
- [POST /me/games/{id}/patch-notes](https://minigame.kr/developers.md#post-patch-note): 패치노트 게시
- [GET /me/games/{id}/stats](https://minigame.kr/developers.md#get-stats): 통계
- [GET /me/games/{id}/reviews](https://minigame.kr/developers.md#get-reviews): 받은 리뷰
- [PUT /me/games/{id}/reviews/{reviewId}/reply](https://minigame.kr/developers.md#put-review-reply): 리뷰 답글
- [GET /me/games/{id}/bugs](https://minigame.kr/developers.md#get-bugs): 버그 제보
- [PUT /me/games/{id}/bugs/{bugId}/memo](https://minigame.kr/developers.md#put-bug-memo): 제보 처리 메모
- [PUT /me/games/{id}/bugs/{bugId}/status](https://minigame.kr/developers.md#put-bug-status): 제보 처리 상태

## Optional

- [이용약관 'API 이용'](https://minigame.kr/terms#api): API 이용 조건
- [개인정보처리방침](https://minigame.kr/privacy): API 키 정보와 API 기록을 다루는 방법