개발자 센터
로그인
홈 가이드 API 레퍼런스 샌드박스 API 키

커넥트 API

AI Market 외부에서 운영하는 서비스가 구매자의 구독 상태를 실시간으로 확인하고 토큰·크레딧 사용량을 기록하는 API입니다.
테스트 키와 샌드박스를 통해 서비스 심사 완료 전에도 연동을 완료할 수 있습니다.
같은 API로 서비스에 AI Market 계정 간편 가입·로그인 버튼을 붙일 수 있습니다.

연동 가이드 샌드박스 열기 API 키 관리

연동 절차

1

사용자를 승인 화면으로 리다이렉트합니다

서비스에서 사용자를 AI Market 승인 화면
(/connect/authorize)으로 리다이렉트합니다.
사용자가 로그인 후 연동을 승인하면
등록된 주소로 인가 코드가 전달됩니다.

2

인가 코드를 토큰으로 교환합니다

인가 코드와 클라이언트 시크릿을 이용하여
서버에서 접근 토큰과 갱신 토큰을 발급받습니다.
클라이언트 시크릿은 서버에서만 보관합니다.

3

구독 상태를 확인하고 사용량을 보고합니다

API 키와 사용자 ID로 해당 사용자의 구독 상태를
실시간으로 조회합니다. 월 제공량이 설정된 서비스는
사용자별 사용량을 전송하고 잔여량을 응답으로 받습니다.

연동 문서 및 도구

연동 가이드

API 키 발급부터 승인 요청, 토큰 교환,
구독 확인, 사용량 보고, 운영 전환까지
연동 절차를 순서대로 안내합니다.
curl, Node.js, Python 예제를
함께 제공합니다.

연동 가이드 ›

API 레퍼런스

엔드포인트별 요청 파라미터, 응답 필드,
오류 코드 및 요청 한도를
표로 확인할 수 있습니다.

API 레퍼런스 ›

샌드박스

승인·토큰 발급·구독 확인·사용량 보고를
테스트 키로 브라우저에서 바로 실행하고
실제 요청과 응답을 확인합니다.

샌드박스 열기 ›

API 키 관리

운영 키와 테스트 키의 발급·재발급,
리다이렉트 URI, 연동 해제,
연동할 서비스 ID를 관리합니다.

API 키 관리 ›

커넥트 API 주요 기능

  • 서비스에 접속한 사용자의 구독 여부를 실시간으로 판정합니다. 해지와 연체 상태도 즉시 반영됩니다.
  • 구독형 서비스의 월 제공 토큰·크레딧 사용량을 보고하고, 남은 보유량을 조회합니다.
  • 테스트 키로 서비스 심사 완료 전에 전체 연동 흐름을 검증합니다. 실제 구독과 결제에는 영향이 없습니다.
  • 표준 OAuth 2.0 인가 코드 방식(PKCE 지원)을 사용하므로 언어와 프레임워크에 관계없이 연동할 수 있습니다.

연동 전 준비사항

  • 크리에이터 계정과 크리에이터 모드
  • 연동할 서비스(테스트 키는 임시저장 상태도 가능)
  • 클라이언트 시크릿을 보관하고 토큰을 교환하는 서버
API 키와 샌드박스는 크리에이터 계정으로 로그인한 후 크리에이터 모드에서 이용할 수 있습니다. 가이드와 API 레퍼런스는 로그인 없이 확인할 수 있습니다.