Partner OAuth 연동

Beta. OAuth 모드는 순차적으로 오픈 중입니다. 문의해 주시면 앱을 등록해 드립니다.

ofox를 자사 제품에 통합할 계획이라면, 사용자는 OAuth 버튼을 눌러 ofox에서 로그인과 권한 부여를 마친 뒤 앱으로 돌아올 수 있습니다. 이 방식으로 가입한 신규 사용자는 자동으로 귀하의 partner 채널에 집계되며, 추천 링크를 통한 가입과 완전히 동일하게 처리됩니다.

연동 방법

앱이 아직 개발 중이어도 신청할 수 있습니다. 제품이 완성될 때까지 기다릴 필요가 없습니다. OAuth 연동은 현재 Beta 단계이며, 등록 정보는 팀에서 확인합니다.

아직 파트너 프로그램에 가입하지 않았다면 먼저 Partner 페이지 에서 신청하세요. 이미 신청했거나 활성화된 파트너는 다시 신청할 필요가 없습니다.
아래 등록 정보를 hi@ofox.ai로 보내거나 기존 지원 메일에 회신하세요.
앱 정보, 콜백 주소, 필요한 권한을 확인한 뒤 OAuth 앱을 등록하고 추천 채널에 연결한 다음, 해당 연동 설정을 제공합니다.
제품에 OAuth 2.1 연동을 완료하고 권한 부여, 앱 복귀, 모델 호출 흐름을 확인하세요.

채널 귀속을 위해 추천 매개변수를 따로 붙일 필요는 없으며, 등록 시 저희가 설정합니다. OAuth 자체의 콜백 주소, 권한, 인증 흐름은 제공된 연동 설정에 따라 구현해야 합니다.

앱 등록 시 필요한 정보

항목	설명할 내용
앱 이름과 용도	가칭도 괜찮습니다. 주요 기능, 대상 사용자, ofox 모델 서비스를 어떻게 사용하는지 설명해 주세요
앱 형태	웹, 데스크톱 클라이언트, 모바일 앱, 브라우저 확장 프로그램 또는 CLI 도구인지, 자체 백엔드 서비스가 있는지
OAuth 콜백 주소(Redirect URI)	권한 부여 후 앱으로 돌아오는 전체 주소입니다. 테스트 환경과 운영 환경을 각각 적어 주세요. 실제 등록 전에 주소를 확정해야 하며, 아직 정해지지 않았다면 기술 구성을 먼저 설명해 주세요
Partner 정보	파트너 프로그램 신청에 사용한 이메일과 추천 링크 또는 추천 코드. 같은 메일에서 이미 제공한 내용은 다시 보내지 않아도 됩니다
필요한 기능	모델 호출, 잔액 또는 사용량 표시, 조직 정보 조회, 로그인 유지가 필요한지. 권한을 직접 고를 필요 없이 요구 사항만 설명해 주세요
제품 링크와 로고(추후 제출 가능)	공식 사이트, 저장소, 데모 페이지 또는 스크린샷이 있으면 함께 보내 주세요. 아직 출시 전이라면 간단한 소개로 충분하며 로고는 나중에 보내도 됩니다

콜백 주소는 등록한 값과 정확히 일치해야 하며 와일드카드는 지원하지 않습니다. 프로토콜, 도메인, 포트, 경로, 끝의 /까지 모두 같아야 합니다. 웹 운영 환경에서는 HTTPS 사용을 권장합니다. 데스크톱, 모바일 또는 로컬 개발 환경이라면 등록 시 콜백 방식을 설명해 주세요.

연동 문의를 위해 전체 소스 코드나 완성된 제품을 먼저 제출할 필요는 없습니다. 신청 메일에 비밀번호, API Key, Client Secret, Access Token을 보내지 마세요.

아래 템플릿을 복사해 사용하고, 아직 정해지지 않은 항목은 “확인 예정”으로 표시하세요.


앱 이름:
앱 용도 / 대상 사용자:
앱 형태 / 백엔드 유무:
테스트 환경 콜백 주소:
운영 환경 콜백 주소:
Partner 신청 이메일:
Partner 추천 링크 또는 추천 코드:
필요한 기능:
제품 링크 / 소개(있는 경우):
로고(있는 경우):

연동 전 확인 사항

클라이언트 유형: 백엔드가 있어 비밀 키를 안전하게 보관할 수 있는 앱과 브라우저·데스크톱·모바일에서 직접 실행되는 앱은 연동 설정이 다릅니다. 실제 구조를 설명해 주세요. Client Secret을 프런트엔드 코드나 사용자에게 배포하는 설치 파일에 넣지 마세요.
권한 범위: 제품에 실제로 필요한 권한만 신청하세요. 모델 호출에는 llm.invoke가 필요하며, 그 밖의 기능은 요구 사항에 따라 확인합니다. 승인된 권한은 실제 권한 부여 결과를 따릅니다.
연동 테스트: 등록 후 제공된 설정에 따라 연동하세요. 문제가 생기면 작업 단계, 민감 정보를 제거한 오류 메시지, 발생 시간을 알려 주시고 토큰이나 비밀 키는 보내지 마세요.

무엇이 집계되나

신규 가입만 해당됩니다. ofox 계정이 없는 사용자가 귀하의 OAuth 버튼을 누르면 ofox 로그인 페이지로 이동하여 가입 플로우로 전환해 가입을 완료합니다 —— 바로 그 시점에 채널 연결이 생성됩니다. 이후 해당 사용자의 충전과 사용량은 일반 partner 수수료 정산을 따릅니다.

이미 ofox 계정이 있는 사용자의 귀속은 변경되지 않습니다. 귀하의 앱을 인증해도 바뀌지 않습니다 —— 그 사용자가 어떤 partner에도 연결된 적이 없더라도 마찬가지입니다. 다른 partner에 연결된 사용자와 전혀 연결이 없는 사용자 모두에게 적용됩니다.

이는 의도된 설계입니다. 추천 연결은 계정에 대해 평생 유지되며 배타적입니다. 재연결을 허용하면 한 partner가 다른 partner가 유치한 사용자를 가져가게 됩니다.

첫 호출 시의 scope

가입 직후 받은 access token에는 아직 llm.invoke가 포함되지 않을 수 있습니다.

llm.invoke는 이메일이 인증된 사용자에게만 발급됩니다. 가입 완료 시점에 인증이 끝나 있는지는 사용자가 어떤 방식으로 가입했는지에 따라 달라집니다.

가입 방식	완료 시 이메일 인증 여부	첫 token의 `llm.invoke`
비밀번호 없는 링크	예 — 링크를 여는 것 자체가 인증	발급됨
이메일 + 비밀번호	아니오	인증 전까지 제외됨

scope가 제외되어도 token 요청 자체는 성공합니다. 응답의 scope 필드가 실제로 발급된 집합입니다(RFC 6749 §3.3). 요청한 대로 받았다고 가정하지 말고 이 필드를 읽으세요. llm.invoke 없이 LLM API를 호출하면 403 insufficient_scope가 반환됩니다.

사용자가 이메일 인증을 마친 뒤 token을 다시 받으면(또는 refresh하면) llm.invoke가 포함됩니다.

수수료

귀속된 사용자는 실제 API 사용량 기준 표준 단계별 partner 수수료(최대 9%)로 정산됩니다. $50부터 출금 가능하며 월 단위로 정산합니다. 최신 조건은 Partner 페이지 를 참고하세요.