Partner OAuth 연동

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

ofox를 이미 자사 제품에 통합하셨다면, 사용자는 OAuth 버튼으로 인증할 수 있으며 앱을 벗어날 필요가 없습니다. 이 방식으로 가입한 신규 사용자는 자동으로 귀하의 partner 채널에 집계됩니다 —— 추천 링크를 통한 가입과 완전히 동일합니다.

도입 방법

문의하여 애플리케이션을 등록합니다.
저희가 OAuth 애플리케이션을 생성하고 귀하의 추천 채널에 연결합니다.
표준 OAuth 2.1 플로우로 인증 버튼을 제품에 연동합니다.

표준 OAuth 플로우 외에 귀하 측에서 설정할 것은 없습니다 —— 추가 파라미터, URL 형식 규약, SDK 모두 필요 없습니다. 채널 매핑은 저희 서버에서 설정합니다.

무엇이 집계되나

신규 가입만 해당됩니다. 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 페이지 를 참고하세요.