Authentication

All Public API requests require an API Key. Include it as a Bearer token in the Authorization header.

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

Request Specifications

• HTTP Method: All Public APIs only support GET.
• Content-Type: Responses are always application/json.
• Encoding: UTF-8

Base URL

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

Response Format

All responses are in JSON format.

Success Response

{
  "data": { ... }
}

Error Response

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

Error Codes

HTTP Status	Code	Description
400	INVALID_PARAMETER	Invalid request parameter
401	API_KEY_REQUIRED	API Key missing
401	INVALID_API_KEY	Invalid API Key
429	RATE_LIMIT_EXCEEDED	Rate limit exceeded
500	INTERNAL_ERROR	Internal server error

SDK Examples

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']}")