API 사용법
Pixabox에서 제공하는 API 엔드포인트에 대한 문서입니다.
GET/api/search
미디어를 검색합니다. Pixabay API와 호환되는 응답 형식을 제공합니다.
Parameters
| Name | Type | Description |
|---|---|---|
| q | string | 검색할 키워드 (URL 인코딩 필요) |
| page | number | 페이지 번호 (기본값: 1) |
| per_page | number | 페이지당 항목 수 (기본값: 20, 최대: 200) |
| type | string | image, video, animation |
Example Request
GET /api/search?q=cat&type=image
GET/api/media/[id]
특정 미디어의 메타데이터를 조회합니다.
{
"id": 123,
"filename": "uuid.mp4",
"originalName": "video.mp4",
"type": "video",
"tags": "tag1, tag2",
...
}API/api/tags/manage
태그를 관리합니다 (이름 변경, 병합, 삭제).
PUT (Rename)
{ "oldName": "cat", "newName": "kitten" }POST (Merge)
{ "sourceName": "dog", "targetName": "animal" }DELETE (Remove)
{ "tagName": "bad_tag" }