외부 API·엔드포인트 개요 가이드

T2Editor는 모든 기능이 자체 완결형인 구조가 아닙니다. 특히 AI, 검색, ClipURL 같은 기능은 외부 서비스와 연결될 수 있으며, 이때 실제 운영 안정성은 UI보다 API 설계에 크게 좌우됩니다.

운영자 관점 핵심 이해

운영자가 꼭 알아야 할 점은 간단합니다. 어떤 기능이 외부 서버 없이는 동작하지 않는지, 장애가 나면 어떤 화면이 멈추는지, 대체할 수 있는지 세 가지입니다. 이 문서의 목적은 개발자가 아닌 운영자도 이 경계를 빠르게 이해하도록 돕는 데 있습니다.

개발자 관점 핵심 이해

AI와 검색, ClipURL은 각기 다른 플러그인처럼 보이지만 공통적으로 다음 문제를 안고 있습니다.

• 외부 엔드포인트 주소 관리
• 인증 또는 라이선스 정보 전달
• CORS 정책
• 요청 실패 시 UI 복구
• 사용량 제한과 로그 관리

따라서 교체 작업은 단순한 URL 치환이 아니라, 사실상 “플러그인-API 계약”을 다시 맞추는 작업이라고 보는 것이 정확합니다.

교체 시 체크리스트

• 응답 JSON 구조가 기존 플러그인 파서와 맞는가
• 인증 헤더가 필요한가
• 도메인 서명 또는 라이선스 검증이 필요한가
• 장애 시 사용자에게 어떤 메시지를 보여줄 것인가
• 요청량 제한이 있는가

참고 자료

• DSclub T2Editor 서비스 페이지: https://dsclub.kr/service/editor
• SIR T2Editor 8.1.2 소개 글: https://sir.kr/boards/g5_plugin/15016