InspireMe

API 사용법

인증

모든 Public API 요청에는 API Key가 필요합니다. Authorization 헤더에 Bearer 토큰으로 포함하세요.

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

요청 규격

  • HTTP 메서드: 모든 Public API는 GET만 지원합니다.
  • Content-Type: 응답은 항상 application/json입니다.
  • 인코딩: UTF-8

Base URL

https://inspireme.advenoh.pe.kr/api/v1

응답 형식

모든 응답은 JSON 형식입니다.

성공 응답

{
  "data": { ... }
}

에러 응답

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "language must be 'ko' or 'en'"
  }
}

에러 코드

HTTP 상태 코드 설명
400 INVALID_PARAMETER 잘못된 요청 파라미터
401 API_KEY_REQUIRED API Key 누락
401 INVALID_API_KEY 유효하지 않은 API Key
429 RATE_LIMIT_EXCEEDED 호출 제한 초과
500 INTERNAL_ERROR 서버 내부 오류

SDK 예시

JavaScript (fetch)

const API_KEY = process.env.INSPIREME_API_KEY;

const response = await fetch(
  "https://inspireme.advenoh.pe.kr/api/v1/quotes/random?language=ko",
  {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
  }
);

const { data } = await response.json();
console.log(`${data.content} — ${data.author}`);

Python (requests)

import os
import requests

API_KEY = os.environ["INSPIREME_API_KEY"]

response = requests.get(
    "https://inspireme.advenoh.pe.kr/api/v1/quotes/random",
    headers={"Authorization": f"Bearer {API_KEY}"},
    params={"language": "ko"},
)

data = response.json()["data"]
print(f"{data['content']} — {data['author']}")