API 키는 어떻게 만드나요?

위치: 설정 → 고급 → 다른 앱 연결

해당 페이지 열기: admin.<your-site>/settings/integrations (<your-site> 부분을 운영 중인 사이트 주소로 변경하세요). 메뉴에 보이지 않는다면 설정 페이지에서 모든 설정 보기을 켜세요.

시작 전 확인사항

• 사이트 소유자만 키를 만들 수 있습니다.

진행 방법

1. 설정 → 고급 설정 → 다른 앱 연동 → API 키을 엽니다.
2. 키 만들기을 누릅니다.
3. 이름에 이름을 입력합니다(예: "파트너 웹사이트").
4. 어떤 작업을 할 수 있나요? 아래에서 필요한 항목을 체크합니다:
   • 기사 읽기: 유료 결제 글을 제외한 발행된 일반 글.
   • 유료 전용 본문 전체 읽기: 유료 결제 글의 전체 본문 포함.
   • 임시 저장 기사 보내기: 글을 초안으로 추가합니다. 관리자가 직접 확인하기 전에는 사이트에 공개되지 않습니다.
   • 사진 보내기: 웹 주소(URL)를 통해 미디어 라이브러리에 사진을 추가합니다.
   • 섹션 및 태그 읽기.
   • 트래픽 수치 읽기: 글 조회수 및 총 방문자 수.
   • 수익 보고서 읽기: 전체 통계 수치만 제공되며, 개별 독자 정보는 제외됩니다.
5. 선택 사항: 만료일, 다음 주소에서만 허용(한 줄에 하나씩, 최대 20개), 분당 요청 수(1~600), 일일 요청 수(1~1,000,000)을 설정합니다.
6. 키 만들기을 누릅니다.
7. 상자에 표시된 키를 복사합니다. 이 화면에서 벗어나면 키를 다시 확인할 수 없습니다. 저장했습니다을 누릅니다.
8. 연동할 앱에 키를 등록합니다. 해당 앱은 "Authorization: Bearer" 헤더에 이 키를 넣어 요청을 전송하게 됩니다.

참고 사항

• 목록에서 각 키의 이름, 권한, 최근 사용, 만료일, 상태(상태: 정상 작동 중, 만료됨 또는 중지됨)을 확인할 수 있습니다.
• 새 키를 발급할까요 기능은 기존 키를 새 키로 교체합니다. 이전 키의 유효 기간을 지정해 일정 시간 동안 유지하거나, 유출이 의심되는 경우 지금 중단을 선택하세요.
• 키 중지을 실행하면 해당 키를 사용한 모든 요청이 즉시 차단됩니다. 이는 되돌릴 수 없습니다. 해당 앱의 접근을 다시 허용하려면 새 키를 만들어야 합니다.
• 키 상세 정보에서는 최근 30일간의 사용 내역을 보여줍니다.
• 각 키마다 개별 호출 제한이 적용됩니다. 너무 자주 요청을 보내는 앱은 호출 속도가 제한됩니다.
• 유료 글 접근 권한이 있는 키가 유출되면 누구나 유료 콘텐츠를 읽을 수 있으므로 철저히 보관하세요.

자주 발생하는 문제

• "생성 가능한 최대 키 개수에 도달했습니다. 더 이상 사용하지 않는 키를 먼저 삭제하세요."
• "키 이름을 입력하세요."
• "키의 작업 권한을 하나 이상 선택하세요."
• "오늘 이후의 날짜를 선택하세요."

자주 묻는 질문

관련 도움말

• 다른 앱 연결하기
• 웹훅