InspireMe

랜덤 명언 API

엔드포인트

GET /api/v1/quotes/random

파라미터

파라미터 타입 기본값 설명
language string - 언어 필터 (ko, en)
count number 1 반환할 명언 수 (1~10)

예시: 단일 명언

curl -H "Authorization: Bearer im_live_xxxx..." \
  "https://inspireme.advenoh.pe.kr/api/v1/quotes/random?language=ko"

응답

{
  "data": {
    "id": "q-abc123",
    "content": "너 자신을 알라",
    "author": "소크라테스",
    "language": "ko",
    "tags": ["philosophy", "wisdom"]
  }
}

예시: 복수 명언

curl -H "Authorization: Bearer im_live_xxxx..." \
  "https://inspireme.advenoh.pe.kr/api/v1/quotes/random?language=en&count=3"

응답

{
  "data": [
    {
      "id": "q-abc123",
      "content": "Know thyself",
      "author": "Socrates",
      "language": "en",
      "tags": ["philosophy"]
    }
  ]
}

파라미터 상세

  • language — 미지정 시 전체 언어(ko, en)에서 랜덤 선택합니다. 요청한 언어의 번역이 없는 경우 원본 언어로 반환됩니다(language fallback).
  • count — 1~10 범위만 유효합니다. 10 초과 시 자동으로 10으로 제한됩니다. 복수 요청 시 중복 없이 반환됩니다.

응답 필드 설명

필드 타입 설명
id string 명언 고유 ID (UUID)
content string 요청 언어에 맞는 명언 본문
author string 저자 이름
language string 명언 원본 언어 (ko 또는 en)
tags string[] 태그 목록 (예: ["philosophy", "wisdom"])