InspireMe

API Key 발급

Public API를 사용하려면 먼저 API Key를 발급받아야 합니다.

📌 API Key 발급은 관리자만 가능합니다. 일반 사용자 계정에는 설정 페이지에 "API Key 관리" 섹션이 표시되지 않습니다. Key가 필요하면 관리자에게 요청하세요.

발급 절차 (관리자)

  1. InspireMe에 관리자 계정으로 로그인합니다.
  2. 상단 프로필 메뉴에서 **"내 명언"**을 클릭합니다.
  3. 좌측 메뉴에서 **"설정"**을 클릭합니다.
  4. "API Key 관리" 섹션에서 [API Key 생성] 버튼을 클릭합니다.
  5. Key 이름을 입력하고 생성합니다.

⚠️ 주의: 생성된 API Key는 생성 시 한 번만 표시됩니다. 반드시 안전한 곳에 복사해 두세요. 분실 시 삭제 후 다시 생성해야 합니다.

제한 사항

  • 계정당 최대 1개의 API Key를 생성할 수 있습니다.
  • API Key는 설정 페이지에서 비활성화하거나 삭제할 수 있습니다.

API Key 형식

발급된 API Key는 다음 형식입니다:

im_live_<랜덤 문자열>

예시: im_live_abc12345def67890...

  • im_live_ prefix로 시작하여 InspireMe API Key임을 식별할 수 있습니다.
  • 전체 길이는 약 40자입니다.

보안 권장사항

  • API Key는 환경 변수로 관리하세요. 소스 코드에 직접 포함하지 마세요.
  • 프론트엔드(브라우저) 코드에 API Key를 노출하지 마세요. 반드시 서버 사이드에서 호출하세요.
  • 키가 유출된 경우, 즉시 설정 페이지에서 삭제 후 재발급하세요.
  • 사용하지 않는 키는 비활성화하여 불필요한 접근을 차단하세요.

만료 정책

API Key 생성 시 만료 기간을 선택할 수 있습니다.

옵션 설명
만료 없음 수동 삭제 전까지 유효 (기본값)
30일 생성일로부터 30일 후 만료
90일 생성일로부터 90일 후 만료
180일 생성일로부터 180일 후 만료
1년 생성일로부터 365일 후 만료

만료된 API Key로 요청 시 다음 에러가 반환됩니다:

{
  "error": {
    "code": "API_KEY_EXPIRED",
    "message": "API key has expired. Please generate a new key."
  }
}