DK-Agora AI 개발자 API를 사용하면 외부 애플리케이션에서 메모를 생성, 조회, 암호화/복호화할 수 있습니다. API 키를 생성하고 RESTful API를 통해 DK-Agora AI 기능을 프로그래밍 방식으로 활용할 수 있습니다.

1단계: 개발자 포털 접근

주소창에 /developer를 입력하거나, 상단 '자료' 메뉴에서 'API 문서'를 클릭하세요. 로그인이 필요합니다.

2단계: API 키 생성

개발자 포털에서 '새 API 키 생성' 버튼을 클릭합니다. 키 이름과 권한 범위를 설정하세요. 생성된 API 키는 한 번만 표시되므로 반드시 안전한 곳에 저장하세요.

3단계: API 사용

API 요청 시 Authorization 헤더에 Bearer 토큰으로 API 키를 포함합니다. 주요 엔드포인트: GET /api/v1/memos(목록), POST /api/v1/memos(생성), POST /api/v1/encrypt(암호화), POST /api/v1/decrypt(복호화).

4단계: 사용량 확인

개발자 포털에서 API 호출 횟수, 일별/월별 사용량 통계를 확인할 수 있습니다. 플랜별 API 호출 한도를 초과하면 429 오류가 반환됩니다.

5단계: API 문서 참고

/developer/docs 페이지에서 전체 API 레퍼런스를 확인할 수 있습니다. 각 엔드포인트의 요청/응답 형식, 에러 코드, 예제 코드가 제공됩니다.

개발자 API 팁

-API 키를 코드에 직접 포함하지 말고 환경변수로 관리하세요.
-사용하지 않는 API 키는 즉시 삭제하세요.
-에러 응답의 상태 코드와 메시지를 확인하여 디버깅하세요.
-레이트 리밋에 도달하면 잠시 후 재시도하거나, 플랜 업그레이드를 고려하세요.