커넥트 API
AI Market 외부에서 운영하는 서비스가 구매자의 구독 상태를 실시간으로 확인하고 토큰·크레딧 사용량을 기록하는 API입니다.
테스트 키와 샌드박스를 통해 서비스 심사 완료 전에도 연동을 완료할 수 있습니다.
연동 절차
1
사용자를 승인 화면으로 리다이렉트합니다
서비스에서 사용자를 AI Market 승인 화면
(/connect/authorize)으로 리다이렉트합니다.
사용자가 로그인 후 연동을 승인하면
등록된 주소로 인가 코드가 전달됩니다.
2
인가 코드를 토큰으로 교환합니다
인가 코드와 클라이언트 시크릿을 이용하여
서버에서 접근 토큰과 갱신 토큰을 발급받습니다.
클라이언트 시크릿은 서버에서만 보관합니다.
3
구독 상태를 확인하고 사용량을 보고합니다
접근 토큰으로 구독 상태를 실시간으로 조회합니다.
월 제공량이 설정된 서비스는 사용량을 전송하고
잔여량을 응답으로 받습니다.
연동 문서 및 도구
연동 가이드
API 키 발급부터 승인 요청, 토큰 교환,
구독 확인, 사용량 보고, 운영 전환까지
연동 절차를 순서대로 안내합니다.
curl, Node.js, Python 예제를
함께 제공합니다.
API 레퍼런스
엔드포인트별 요청 파라미터, 응답 필드,
오류 코드 및 요청 한도를
표로 확인할 수 있습니다.
샌드박스
승인·토큰 발급·구독 확인·사용량 보고를
테스트 키로 브라우저에서 바로 실행하고
실제 요청과 응답을 확인합니다.
API 키 관리
운영 키와 테스트 키의 발급·재발급,
리다이렉트 URI, 연동 해제,
연동할 서비스 ID를 관리합니다.
커넥트 API 주요 기능
- 서비스에 접속한 사용자의 구독 여부를 실시간으로 판정합니다. 해지와 연체 상태도 즉시 반영됩니다.
- 구독형 서비스의 월 제공 토큰·크레딧 사용량을 보고하고, 남은 보유량을 조회합니다.
- 테스트 키로 서비스 심사 완료 전에 전체 연동 흐름을 검증합니다. 실제 구독과 결제에는 영향이 없습니다.
- 표준 OAuth 2.0 인가 코드 방식(PKCE 지원)을 사용하므로 언어와 프레임워크에 관계없이 연동할 수 있습니다.
연동 전 준비사항
- 크리에이터 계정과 크리에이터 모드
- 연동할 서비스(테스트 키는 임시저장 상태도 가능)
- 클라이언트 시크릿을 보관하고 토큰을 교환하는 서버
API 키와 샌드박스는 크리에이터 계정으로 로그인한 후 크리에이터 모드에서 이용할 수 있습니다. 가이드와 API 레퍼런스는 로그인 없이 확인할 수 있습니다.