API 문서 - Plakker

Plakker API 문서

Plakker의 REST API를 사용하여 이모티콘 팩 데이터에 프로그래밍 방식으로 접근할 수 있습니다.

기본 정보

Base URL: https://plakker.bloupla.net

Content-Type: application/json (GET 요청), multipart/form-data (POST 요청)

Rate Limit: Cloudflare Workers 기본 제한 적용

CORS: 모든 도메인에서 접근 가능 (크롬 확장 프로그램 포함)

엔드포인트

GET /api/packs

이모티콘 팩 목록을 페이지네이션으로 조회합니다. 제목이나 제작자 이름으로 검색할 수 있습니다.

Query Parameters

Parameter	Type	Required	Description
`page`	integer	No	페이지 번호 (기본값: 1, 페이지당 20개)
`search`	string	No	검색어 (제목이나 제작자 이름으로 검색, 대소문자 구분 안함)

사용 예시

GET /api/packs - 전체 팩 목록 조회 (1페이지)
GET /api/packs?page=2 - 2페이지 조회
GET /api/packs?search=고양이 - "고양이" 검색
GET /api/packs?search=고양이&page=2 - "고양이" 검색 결과의 2페이지

Response Example

{
  "packs": [
    {
      "id": "pack_1704067200000_abc123",
      "title": "예시 팩 1",
      "creator": "예시 제작자 1",
      "thumbnail": "https://plakker.bloupla.net/r2/thumbnails/pack_1704067200000_abc123_thumbnail",
      "createdAt": "2024-01-01T00:00:00.000Z"
    }
  ],
  "currentPage": 1,
  "totalPages": 3,
  "totalPacks": 25,
  "hasNext": true
}

GET /api/pack/{pack_id}

특정 이모티콘 팩의 상세 정보와 모든 이모티콘 URL을 조회합니다.

Path Parameters

Parameter	Type	Required	Description
`pack_id`	string	Yes	이모티콘 팩의 고유 ID

Response Example

{
  "id": "pack_1704067200000_abc123",
  "title": "예시 팩 1",
  "creator": "예시 제작자 1",
  "creatorLink": "https://example.com/creator1",
  "thumbnail": "https://plakker.bloupla.net/r2/thumbnails/pack_1704067200000_abc123_thumbnail",
  "emoticons": [
    "https://plakker.bloupla.net/r2/emoticons/pack_1704067200000_abc123_0",
    "https://plakker.bloupla.net/r2/emoticons/pack_1704067200000_abc123_1",
    "https://plakker.bloupla.net/r2/emoticons/pack_1704067200000_abc123_2"
  ],
  "createdAt": "2024-01-01T00:00:00.000Z"
}

제한사항 및 특징

개별 파일 크기: 최대 25MB (Cloudflare Workers 제한)
요청 CPU 시간: 최대 50ms (무료 플랜 기준)
KV 읽기/쓰기: 일일 한도 적용
이모티콘 최소 개수: 3개
지원 이미지 형식: PNG, JPEG, GIF, WebP
이미지 자동 리사이즈: 이모티콘 150x150, 썸네일 200x200
검색 기능: 부분 문자열 매칭, 대소문자 구분 안함, 제목과 제작자 이름에서 동시 검색
검색 성능: 모든 팩을 메모리에 로드 후 필터링 (소규모 데이터셋에 최적화)