개발자 문서

API 사용 방법과 인증 정보를 안내합니다.

Introduction

Base URL

/api

Response Format

JSON

Error Format

{ "error": "메시지" }

Authorization

일부 API는 API 키가 필요합니다.

API Key 전달 방법

x-api-key: <키>
x-api-token: <키>
Authorization: Bearer <키>

Rate Limit / Quota

초과 시 429가 반환됩니다.

일일 제한

일반 사용자 100 / 편집자 1000 / 관리자 제한 없음

분당 제한

일반 사용자 60 / 편집자 600 / 관리자 제한 없음

Endpoint

GET/expressionsAPI 키 필요

등재된 표현 목록을 반환합니다.

Input

Query parameters

page (기본 1)
per_page (기본 20, 최대 100)
type (옵션)

GET /api/expressions?page=1&per_page=20&type=stereotype

Output

{
  "data": [
    {
      "id": 1,
      "term": "표현",
      "description": "설명",
      "type": "stereotype",
      "origin": null,
      "usage": null,
      "alternatives": null,
      "context_needed": false,
      "content_warning": [],
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-02T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 120,
    "total_pages": 6
  }
}

Example

curl -H "x-api-key: YOUR_API_KEY" \
  "/api/expressions?page=1&per_page=20&type=stereotype"

Type Description

Value	Type	Description
stereotype	편견/고정관념	특정 집단 전체를 부정적 속성으로 규정짓는 표현
dehumanization	비인격적 비유	사람을 동물·곤충 등에 빗대어 부르며 생명의 위계를 나누는 표현
mockery	조롱/희화	소수자의 특성을 웃음거리로 만드는 표현
patronizing	대상화	칭찬처럼 보이지만 상대를 동등하게 인정하지 않는 표현
fearmongering	공포감 조장	특정 집단이 위험을 초래한다며 공포심을 조장하는 표현
incitement	폭력/차별 선동	차별적 행동이나 폭력을 부추기는 표현