# ShareAI Builder에 애플리케이션을 단계별로 연결하는 방법

고객을 ShareAI에 연결하고 유용한 AI 일정표를 준비하며 AI 지출을 제어할 수 있는 예약 앱을 빌드하세요.

45–60분 · 18 실용적인 단계 · 애플리케이션 빌더 · Node.js 예제

구현하기

## 구축할 수 있는 고객 연결.

세 가지 구체적인 결과물: 고객 연결, 예약 준비, 통합 검증 준비.

### 로그인 및 갱신 가능한 세션

고객이 자신의 ShareAI 계정을 선택하고, 앱을 승인한 후 JamZY로 돌아옵니다.

**다음 상황에서 이를 검증할 수 있습니다.**

로그인, 세션 새로 고침 및 성공적으로 연결 해제.

### 유용한 준비 초안

예약 목표를 의도적인 AI 요청을 통해 일정표와 질문으로 전환하세요.

**다음 상황에서 이를 검증할 수 있습니다.**

초안을 생성하세요; 예약을 저장해도 AI 호출은 이루어지지 않습니다.

### 검증할 수 있는 설정

선택적 AI 비용을 설명하고 검토 제출에 필요한 플랫폼 확인을 수집하세요.

**다음 상황에서 이를 검증할 수 있습니다.**

포함된 모든 플랫폼과 요청된 범위에 대한 확인이 기록됩니다.

## 당신이 빌드할 것을 확인하세요.

귀하는 고객이 이해할 수 있는 연결을 구축할 것입니다: 그들의 ShareAI 계정, 선택적 AI 준비 초안, 그리고 약속으로 돌아가는 명확한 경로.

귀하가 작업할 위치 완성된 예제

귀하의 애플리케이션을 ShareAI Builder에 연결하고, 등록에서 검토 준비가 완료된 통합 테스트까지 진행하십시오. 이 워크스루는 JamZY라는 작은 Node.js 약속 애플리케이션을 사용하여 각 단계를 보여줍니다: 앱 등록, 웹 플랫폼 구성, 고객의 ShareAI 계정을 연결하고 승인된 AI 요청을 전송합니다. 동일한 단계를 귀하의 제품에 적용하십시오.

| 기능 | 고객이 동의하는 내용 | JamZY가 보여주는 것 |
| --- | --- | --- |
| ShareAI로 로그인 | 귀하의 앱이 요청하는 계정 연결 및 신원 정보. | 인증된 사용자 정보에서 가져온 개인 고객 신원. |
| ShareAI로 결제 · AI 사용 | 고객이 선택한 개인 또는 조직 계정을 사용하여 승인된 추론 수행. | 해당 계정의 적격 크레딧으로 자금이 지원되는 약속 준비 초안. |
| Builder 마크업 | 승인된 애플리케이션 계약에서 수락된 추가 AI 사용 요금. | 승인 및 계약 게시 후 선택적 사용 수익화. |
| 제품 결제 | 별도의 ShareAI 결제 프로세스에서 제시된 특정 구매. | 확장 설명 [결제 워크스루](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/). 약속 데모는 결제 프로세스를 구현하지 않습니다. |

ShareAI 계정, 앱을 소유할 개인 또는 조직 계정을 사용할 수 있는 권한, 공개 HTTPS 콜백, 로고, 작동하는 개인정보 보호, 약관 및 계정 삭제 페이지를 보유하십시오. 예제를 실행하려면 Node.js 22 이상과 애플리케이션의 HTTPS 주소를 사용하십시오.

JamZY · 약속 참조 애플리케이션 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LnBuZw.DZt_5dnvNF40T34-7MJsXw?v=219eca92cbe5)

로컬 예약 일정 관리와 고객이 자금을 지원하는 AI 준비는 별도의 작업입니다. 이 데모에서는 캘린더 초대가 전송되지 않습니다.

1. 예약 유형과 기간을 선택하세요.
2. 사용 가능한 데모 슬롯을 선택하세요.
3. 선택적으로 AI 어시스턴트를 사용하려면 ShareAI을(를) 연결하세요.
4. AI는 이 명시적 작업 후에만 실행됩니다. 예약만으로는 ShareAI을(를) 호출하지 않습니다.

**귀하의 애플리케이션 세부정보를 사용하십시오**

스크린샷은 예제 애플리케이션 세부 정보를 사용합니다. ShareAI 주소는 이 가이드에서 프로덕션 주소입니다. 준비 생성은 실제 AI 요청을 생성하며 크레딧을 사용할 수 있습니다. 데모 약속을 선택하거나 저장하는 것은 그렇지 않습니다. 검증 확인은 귀하의 성공적인 통합 테스트에 의해 완료됩니다.

**계속할 준비가 되었을 때**

계정 로그인, AI 소비, 선택적 추가 요금 및 확인된 제품 구매를 구분할 수 있습니다. 이 가이드를 읽는 데 유료 요청은 필요하지 않습니다.

## Builder 프로그램에 참여하기

귀하의 애플리케이션과 고객 관계를 소유하는 Builder ID를 생성하게 됩니다.

귀하가 작업할 위치 콘솔 → Builder Program

1. ShareAI 계정을 생성하거나 로그인하세요. JamZY를 소유할 개인 또는 조직 계정을 선택하세요. 설정 과정에서 동일한 계정을 사용하세요.
2. 열기 [ShareAI 콘솔에서 Builder Program](https://console.shareai.now/app/builder/)귀하의 작업에 맞는 Builder 활동을 선택하세요. 이 가이드에서는 귀하가 소유한 애플리케이션에 대한 제품 회사 경로를 선택하세요. Client Work는 고객에게 제공되는 서비스에 해당하며, 통합은 기존 애플리케이션을 연결하는 것입니다.
3. 프로그램 등록을 소유할 개인 또는 조직 계정을 신청 전에 선택하세요. 조직은 검증 전에 신청서를 제출할 수 있지만, 직원 승인만으로는 접근이 활성화되지 않습니다. Console의 온보딩 체크리스트에서 조직 이메일 및 회사 검증을 완료하세요. 승인된 조직은 두 가지 검증이 완료될 때까지 "검증 대기 중" 상태로 유지됩니다. Builder, Provider 및 Creator 프로그램은 이 규칙을 따릅니다.
4. 승인 후, Builder Program → Product를 엽니다. 액터 스위처는 귀하가 편집 중인 계정을 식별합니다.

Builder Program · 등록 진입점 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2Vucm9sbG1lbnQucG5n.qBq2qLDjzgk2_IqYv0zTco?v=2e8bf9ef5454)

제품 경로로 시작한 후 JamZY를 소유할 계정 등록을 완료하세요.

1. Console로 이동하여 Builder Program에 등록하세요.

**계속할 준비가 되었을 때**

Builder Program은 의도된 소유자를 위해 열리며 새 앱을 제공합니다. 등록 결정, 애플리케이션 검토, 공개 정보 검토 및 Monetization Gateway 승인은 별도의 단계입니다.

세부 정보가 필요하신가요?[Builder Program ↗](https://shareai.now/builders/join/)[Builder documentation ↗](https://shareai.now/docs/builders/)

## 신청 생성하기

JamZY에 자체 애플리케이션 기록을 제공하여 해당 ID, 액세스 및 상업적 조건을 함께 유지합니다.

귀하가 작업할 위치 Builder Program → Product → New app

1. Product에서 New app을 선택하세요. 초기 세부 정보를 채우기 위해 귀하의 공개 웹사이트를 입력하거나, 수동으로 작성하기를 선택하세요.
2. PNG 또는 JPEG 로고를 업로드하고, 이름으로 JamZY를 입력한 후, 제품을 명확한 한 문장으로 설명하세요. 웹사이트와 Builder 연락처 이메일을 검토하세요.
3. 설정 질문으로 계속 진행하세요. 답변은 진실되게 작성하세요. 이는 애플리케이션이 제공되고 결제되는 방식을 설명합니다.

애플리케이션 설정 · 세부 정보 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2NyZWF0ZS1hcHAucG5n.26JD5PFhP3AdM9h-QLR4jI?v=89dd90b67cd9)

계속하기 전에 앱 이름, 소개, 로고 및 공개 웹사이트를 검토하세요. 연락처 정보는 예시입니다.

1. 애플리케이션에 명확한 이름을 지정하세요.
2. 온보딩 질문으로 계속하세요.

애플리케이션 프로필에는 접근 가능한 공개 웹사이트를 사용하세요. 비공개 또는 로컬 전용 웹사이트는 개발 콜백이 올바르게 등록되었더라도 검증에 실패할 수 있습니다. 새 애플리케이션은 초안 상태로 시작됩니다. 공개하지 않고도 계속 편집할 수 있습니다. 애플리케이션 식별자는 OAuth 클라이언트 ID나 구독 ID와 다릅니다.

**계속할 준비가 되었을 때**

JamZY는 의도된 소유자의 Product 아래에 나타납니다. 모든 디바이스 플랫폼에 대해 추가 애플리케이션을 생성하지 마세요.

세부 정보가 필요하신가요?[등록 참조 ↗](https://shareai.now/docs/api/builders/auth/register-application/)[공개 프레젠테이션 가이드 ↗](https://shareai.now/application-guidance/)

## 귀하의 앱이 어떻게 제공되는지 설명하십시오

애플리케이션이 실행되는 위치와 자격 증명을 제어하는 주체에 맞는 OAuth 옵션을 받게 됩니다.

귀하가 작업할 위치 새 앱 → 애플리케이션 설정

JamZY 배포를 직접 운영하는 경우, SaaS, 벤더 호스팅 클라우드 앱, 고객이 자신의 소비 비용을 지불하는 모델, 그리고 AI 요청에 대한 ShareAI을 포함하여 제공에 맞는 가격 모델을 선택하십시오. 이는 모든 제품에 대한 요구 사항이 아닌 예시 답변입니다.

애플리케이션 설정 · 배포 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2RlcGxveW1lbnQucG5n.z2CCFEuD_5FSexYeMPd83A?v=a4e84e4528c3)

온보딩 답변은 서버 클라이언트 비밀이 사용 가능한지 여부를 결정합니다.

1. 애플리케이션이 실제로 실행되는 위치를 선택하세요.

| 앱 실행 위치 | OAuth 선택 | 자격 증명이 저장되는 위치 |
| --- | --- | --- |
| 호스팅된 백엔드 | 웹 서버 클라이언트는 클라이언트 비밀을 사용할 수 있습니다. PKCE는 여전히 적용됩니다. | 비밀과 토큰은 서버에 유지됩니다. |
| 브라우저 애플리케이션 / SPA | PKCE를 사용하는 공개 웹 클라이언트. | 내장된 클라이언트 비밀 없음. 적절한 브라우저 또는 백엔드 세션 디자인을 사용하십시오. |
| 자체 호스팅 또는 하이브리드 배포 | 온보딩 정책에 따라 PKCE를 사용하는 공개 클라이언트. | 고객 설치에 공유된 벤더 비밀을 배포하지 마십시오. |
| Windows, macOS, Linux, Android 또는 iOS | 활성화된 플랫폼마다 하나의 공개 클라이언트. | PKCE 및 플랫폼에 적합한 안전한 저장소; 비밀 번들 없음. |

다운로드 가능한 JamZY 샘플은 PKCE를 사용하는 공개 웹 클라이언트를 의도적으로 사용하며, 작은 백엔드가 있음에도 불구하고 브라우저 저장소에서 토큰을 유지하지 않습니다. 벤더 호스팅 답변은 서버 클라이언트를 허용하지만 이를 강제하지는 않습니다.

애플리케이션 정보 → 애플리케이션 설정에서 저장된 답변을 다시 확인할 수 있습니다. 배포 변경은 호환되지 않는 클라이언트 비밀을 제거하고 반복 검증을 요구할 수 있습니다. 저장하기 전에 영향을 검토하십시오.

**계속할 준비가 되었을 때**

저장된 배포는 실제 아키텍처를 설명합니다. 클라이언트 비밀 옵션은 해당 답변을 따르며, 비활성화된 옵션은 정책에 대한 설명이지 누락된 자격 증명이 아닙니다.

세부 정보가 필요하신가요?[클라이언트 등록 ↗](https://shareai.now/docs/api/builders/auth/register-application/)

## 귀하의 애플리케이션을 명확하게 소개하십시오

고객이 연결을 결정하기 전에 필요한 제품 세부 정보와 정책을 제공하십시오.

귀하가 작업할 위치 애플리케이션 정보

대시보드 후 애플리케이션 정보를 열고 세부 정보, 애플리케이션 설정, 프레젠테이션, 브랜딩, 갤러리 및 리뷰의 전용 섹션을 진행하십시오. 제품에 유용한 설명, 정확한 웹사이트 및 고객 워크플로우의 명확한 스크린샷을 제공하십시오.

애플리케이션 정보 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2luZm9ybWF0aW9uLnBuZw.gTT43COTCGPlcpxLYXCMCb?v=0ed11c1d57c9)

애플리케이션에 고유한 이름, 소개 및 공개 HTTPS 웹사이트를 부여하세요.

1. 세부 정보, 설정, 프레젠테이션 및 브랜딩을 자체 섹션에서 개발하세요.

자체 앱 아이덴티티를 사용하십시오. ShareAI 브랜딩은 통합 버튼 및 설명 자료에 포함되며, 제품 로고를 대체해서는 안 됩니다. 개인정보 보호, 약관 및 삭제 링크는 로그인 없이 접근 가능해야 합니다.

떠 있는 저장 작업이 나타나면 변경 사항을 저장하십시오. 공개 정보 제안에는 자체 리뷰가 있으며, 승인된 제안을 편집해도 라이브 공개 프레젠테이션이 조용히 대체되지 않습니다.

**계속할 준비가 되었을 때**

방문자는 JamZY이 무엇을 하는지, 누가 운영하는지, 삭제 요청 방법을 이해할 수 있습니다. 공개 세부 정보와 콜백 구성은 동일한 제품을 참조합니다.

세부 정보가 필요하신가요?[프레젠테이션 체크리스트 ↗](https://shareai.now/application-guidance/)[로고 & 버튼 사용 ↗](https://shareai.now/brand-guidance/)

## 고객이 승인할 수 있는 항목을 선택하십시오

귀하의 약속 경험에서 실제로 사용하는 액세스를 요청하고 청구 목적을 명확히 하십시오.

귀하가 작업할 위치 애플리케이션 → 사용 사례

Use Cases에서 계정 연결을 위해 ShareAI 로그인 활성화 및 지원하려는 고객 자금 흐름을 위해 Pay with ShareAI를 활성화합니다. 제품이 AI 사용에 추가 요금을 발생시킬 경우에만 Monetization Gateway 액세스를 요청하십시오. Console에 표시된 승인 상태를 따르십시오.

사용 사례 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3VzZS1jYXNlcy5wbmc.zRU3Lp1TsQuYD7ClWUWS-X?v=090d8c81e6da)

Log-in with ShareAI, Pay with ShareAI 및 Monetization Gateway는 별도의 구성 및 승인 상태를 가집니다.

1. ShareAI으로 로그인 구성을 설정합니다.
2. 고객이 자금을 지원하는 사용을 활성화합니다.

| 범위 | 요청 이유 |
| --- | --- |
| `openid` | 클라이언트 범위의 ID를 사용하여 계정을 연결하십시오. |
| `profile` / `email` | 귀하의 제품이 필요로 하는 경우에만 프로필 또는 이메일 클레임을 요청하십시오. |
| `inference` | 애플리케이션 구성에서 허용된 경우 지원되는 AI 추론 엔드포인트를 호출하십시오. |
| `monetization_gateway` | 고객이 수락한 AI 청구 계약을 사용하여 추가 요금이 부과된 추론을 수행하십시오. |
| `payments` | 고객 결제 요청을 생성하고 검사하십시오. 각 구매는 여전히 확인이 필요합니다. |

JamZY 요청 `openid profile inference monetization_gateway`요청하지 않습니다. `payments` 결제를 통해 제품을 판매하지 않습니다. Console에서 기능을 활성화한다고 해서 기존 액세스 토큰에 이를 부여하는 것은 아닙니다: 고객은 범위와 조건을 승인해야 합니다.

**계속할 준비가 되었을 때**

구성된 범위 및 권한 요청은 기능과 일치합니다. 앱에서 사용하지 않거나 확인할 수 없는 선택적 액세스를 요청하지 마십시오.

세부 정보가 필요하신가요?[범위 참조 ↗](https://shareai.now/docs/api/builders/auth/scopes/)[결제 & 추가 요금 안내 ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)

## 웹 통합을 설정하십시오

브라우저 기반 JamZY 경험을 위한 하나의 웹 클라이언트를 생성하고 올바른 인증 방법을 사용하십시오.

귀하가 작업할 위치 OAuth 설정 → 웹

1. OAuth 설정을 엽니다. 플랫폼 그리드에서 웹을 선택하십시오. 플랫폼당 하나의 클라이언트를 구성할 수 있습니다: 웹, Windows, macOS, Linux, Android 및 iOS.
2. 이 샘플에서는 브라우저 애플리케이션 / SPA, 공개 PKCE 클라이언트를 선택하십시오. 서버 웹 애플리케이션은 배포 정책이 이를 허용하고 백엔드가 비밀을 보호할 수 있는 경우에만 적합합니다.
3. 자신의 웹 클라이언트 ID를 복사하십시오. 통합하는 동안 플랫폼을 테스트 상태로 유지하십시오. 스크린샷에서 ID를 복사하거나 다른 제품에 대해 공유 데모의 등록을 재사용하지 마십시오.

OAuth 설정 · 플랫폼 그리드 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3BsYXRmb3Jtcy5wbmc.d1VzRklfuF_87b8KTVlPjn?v=1412f421168b)

플랫폼당 하나의 등록된 클라이언트. 구성되지 않은 플랫폼은 선택 사항으로 남습니다.

1. 단일 웹 통합 열기.
2. 제품이 Android를 지원할 때만 추가하세요.

웹 · 개요 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3dlYi1jbGllbnQucG5n.AQKecrfiIFG89MpuUlH8uP?v=8f56b706ab2d)

공개 웹 클라이언트는 PKCE를 사용하며 클라이언트 비밀이 없습니다. 클라이언트 ID는 편집됩니다.

1. 자신의 웹 클라이언트 ID를 복사하세요.
2. 공개 클라이언트는 비밀을 받지 않습니다.

서로 다른 플랫폼은 서로 다른 자격 증명 및 콜백 규칙을 가집니다. 이는 별도의 제품이 아닙니다: 구독 및 고객 관리는 애플리케이션에 대해 통합됩니다. 애플리케이션 테스터는 플랫폼 간에 공유되며, 최대 다섯 곳(보류 중인 초대 포함)을 포함합니다; 소유자는 테스터 자리를 소비하지 않습니다.

**계속할 준비가 되었을 때**

정확히 하나의 웹 플랫폼이 존재합니다. 구성하지 않은 네이티브 플랫폼은 출시를 차단하지 않습니다.

세부 정보가 필요하신가요?[플랫폼 등록 ↗](https://shareai.now/docs/api/builders/auth/register-application/)

## 고객을 귀하의 앱으로 다시 연결하십시오

권한 부여 후 고객을 귀하의 애플리케이션으로 반환하며, 귀하가 소유한 정확한 콜백을 사용합니다.

귀하가 작업할 위치 웹 → 구성

웹 → 구성에서 귀하의 애플리케이션이 처리하는 정확한 HTTPS 콜백을 등록하십시오. 이 가이드는 `https://jamzy.example/oauth/callback` 예제로 사용됩니다. 교체하십시오 `jamzy.example` JamZY의 복사본을 배포하는 HTTPS 도메인으로 교체하고, 애플리케이션 구성에서 동일한 콜백을 사용하십시오.

웹 · 구성 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2NhbGxiYWNrcy5wbmc.VYHbGU1Skc_78NvwYGAAz5?v=6af56597b3d7)

배포된 애플리케이션이 처리하는 콜백을 등록하십시오.

1. 배포된 애플리케이션이 처리하는 콜백을 등록하십시오.

동의 화면 이름, 약관, 개인정보 및 삭제 정보를 제공하십시오. 필요한 범위만 활성화한 후 저장하십시오. 스키마, 호스트, 경로 및 적용 가능한 쿼리 세부 정보는 권한 요청 및 코드 교환과 일치해야 합니다. 와일드카드 또는 URL 프래그먼트를 사용하지 마십시오.

| 플랫폼 | 구현할 콜백 |
| --- | --- |
| 웹 | 애플리케이션에서 정확한 HTTPS 주소. |
| 안드로이드 | 애플리케이션 ID와 일치하는 역도메인 앱 스킴 또는 패키지와 SHA-256 서명 지문이 확인된 HTTPS 앱 링크. |
| iOS | 일치하는 앱 스킴 또는 번들 ID와 Apple App ID 접두사가 확인된 HTTPS 유니버설 링크. |
| 윈도우 / macOS / 리눅스 | 허용된 정확한 HTTPS 콜백, 일치하는 역도메인 애플리케이션 스킴, 또는 127.0.0.1 / \[::1\]에서 지원되는 루프백 리디렉션. 루프백 포트는 가변적일 수 있음. |

설치된 앱은 시스템 브라우저에서 인증을 수행하고 등록된 콜백을 통해 반환됩니다. HTTPS 앱 링크를 주장하려면 필요한 연관 파일을 게시하고 Console에서 연관 검증을 실행하세요. 양식에서 그럴듯해 보이는 콜백은 설치된 앱이 이를 수신한다는 증거가 아닙니다.

**계속할 준비가 되었을 때**

인증 흐름을 통해 콜백을 열면 앱으로 돌아갑니다. 무작위 코드나 상태 불일치는 거부됩니다.

세부 정보가 필요하신가요?[PKCE & 리디렉션 ↗](https://shareai.now/docs/api/builders/auth/authorization-code-pkce/)[디스커버리 & 아이덴티티 ↗](https://shareai.now/docs/api/builders/auth/identity-discovery/)

## 귀하의 자체 JamZY 애플리케이션을 실행하십시오

귀하의 애플리케이션 식별자와 함께 ShareAI 연결을 실행하는 약속 인터페이스를 갖게 됩니다.

귀하가 작업할 위치 애플리케이션 → 환경 구성

JamZY는 선택적 AI 준비 도우미가 포함된 약속 애플리케이션입니다. 해당 스케줄러는 브라우저 전용 데모입니다: 캘린더 제공자, 이메일 전송 또는 약속 결제가 없습니다. ShareAI 인증 및 AI API 통합은 실제로 구성된 업스트림을 사용합니다.

다운로드 [JamZY 참조 소스](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LXJlZmVyZW5jZS56aXA.jOyG9kwmFZrdMQEhTNGl0J?v=248a37ba4612). 여기에는 Node 서버, 브라우저 UI, 테스트 및 설정 README가 포함되어 있으며, 인증서, 비밀, 종속성 또는 세션은 포함되어 있지 않습니다. 실행 전에 파일을 검토하세요. Node 프로세스를 공용 원본을 유지하는 HTTPS 역방향 프록시 뒤에 배치하세요.

```bash
# .env — replace both identifiers with YOUR registered application.
JAMZY_PUBLIC_ORIGIN=https://jamzy.example
SHAREAI_CLIENT_ID=YOUR_WEB_CLIENT_ID
SHAREAI_APP_ID=YOUR_APPLICATION_UUID
SHAREAI_AUTH_ORIGIN=https://auth.shareai.now
SHAREAI_API_BASE_URL=https://api.shareai.now/api/v1
SHAREAI_SCOPES="openid profile inference monetization_gateway"
PORT=3443
BIND_HOST=127.0.0.1
```

```bash
# Node 22+, behind your HTTPS reverse proxy
node --env-file=.env server.mjs

# Mocked upstream tests; these do not spend credits
node --test test/server.test.mjs
```

**환경을 함께 유지**

애플리케이션 생성 위치 [콘솔.쉐어ai.지금](https://console.shareai.now/app/builder/). 프로덕션 클라이언트 ID를 사용하여 `https://auth.shareai.now` 그리고 `https://api.shareai.now/api/v1`. `jamzy.example` 주소는 호스팅된 데모가 아닌 애플리케이션의 자리 표시자입니다. 보안 세션 쿠키가 작동하도록 HTTPS를 통해 자체 애플리케이션을 제공하세요.

JamZY는 비교를 위한 API 키 연결도 제공합니다. 이 워크스루는 wallet/OAuth 버튼을 사용합니다. API 키는 고객의 JamZY OAuth 동의를 설정하지 않으며 고객 인증 흐름의 대체가 아닙니다.

**계속할 준비가 되었을 때**

애플리케이션은 HTTPS를 통해 로드됩니다. 공용 원본, 등록된 콜백 및 클라이언트 ID는 등록과 일치합니다. 페이지 소스나 localStorage에 토큰 또는 비밀이 나타나지 않습니다.

## 첫 번째 고객을 연결하십시오

고객이 자신의 ShareAI 계정을 선택하고 애플리케이션이 필요한 액세스를 승인하도록 허용합니다.

귀하가 작업할 위치 JamZY → ShareAI Wallet로 결제

JamZY에서 ShareAI Wallet로 결제를 선택하세요. 애플리케이션은 ShareAI 인증 페이지를 엽니다. 고객은 로그인하고, 개인 또는 조직 계정을 선택하며, 애플리케이션과 요청된 액세스를 확인하고, 적용 가능한 구독 약관을 수락합니다.

1. **JamZY → 인증**무작위 상태와 PKCE 검증자를 생성하고, S256 챌린지를 인증 요청과 함께 전송합니다.
2. **고객 → 인증**결제 계정을 선택하고 접근 및 청구 조건을 검토합니다. 취소 시 JamZY가 연결 해제 상태로 유지되어야 합니다.
3. **인증 → 콜백**단기 유효, 일회용 코드와 상태를 수신합니다. 동일한 세션에 대해 상태를 검증합니다.
4. **백엔드 → 토큰**해당 코드를 원래의 검증자와 동일한 리디렉션 URI로 교환합니다. 공개 클라이언트는 클라이언트 비밀을 전송하지 않습니다.
5. **백엔드 → 사용자 정보**액세스 토큰을 사용하여 인증된 신원을 읽은 후, JamZY의 자체 보안 세션을 설정합니다.

웹 · 프로덕션 엔드포인트 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2VuZHBvaW50cy5wbmc.wcHciknhu_5PQG6wrO4zan?v=63ad6d9e8724)

console.shareai.now에서 클라이언트 ID와 함께 이 프로덕션 ShareAI 주소를 사용하세요.

1. auth.shareai.now/oauth/authorize에서 인증하세요.
2. auth.shareai.now/oauth/token에서 코드와 갱신 토큰을 교환하세요.

```javascript
const verifier = randomBytes(32).toString('base64url');
const state = randomBytes(32).toString('base64url');
const challenge = createHash('sha256').update(verifier).digest('base64url');
const authorize = new URL('https://auth.shareai.now/oauth/authorize');
authorize.search = new URLSearchParams({
  client_id: clientId, response_type: 'code', redirect_uri: callback,
  scope: 'openid profile inference monetization_gateway', state,
  code_challenge: challenge, code_challenge_method: 'S256',
}).toString();
// Save state + verifier in the server session BEFORE redirecting.
// The downloadable server implements state expiry and one-time consumption.
```

인증된 클라이언트 범위의 고객 레코드를 로컬에서 키로 사용합니다. `sub` 및 발급자/클라이언트 컨텍스트. 개인 및 조직 인증은 서로 다른 결제 계정을 선택할 수 있습니다. 고객 ID는 전역 사용자 ID, 이메일 주소 또는 내부 조직 데이터베이스 ID가 아닙니다. 플랫폼 간에 표시 이름을 일치시켜 신원을 병합하지 마십시오.

**계속할 준비가 되었을 때**

취소, 상태 불일치, 재사용된 코드 및 만료된 인증은 안전하게 실패합니다. 정상적인 흐름은 토큰을 노출하지 않고 인증된 계정을 반환합니다.

세부 정보가 필요하신가요?[코드 교환 완료 ↗](https://shareai.now/docs/api/builders/auth/authorization-code-pkce/)[비공개 고객 신원 ↗](https://shareai.now/docs/api/builders/auth/pairwise-identities/)

## 고객을 안전하게 연결 상태로 유지하십시오

토큰이 만료되더라도 승인된 요청을 유지하면서, 고객에게 연결 해제의 신뢰할 수 있는 방법을 제공합니다.

귀하가 작업할 위치 애플리케이션 → 세션 및 토큰 처리

| 자격 증명 | 목적 | 처리 방법 |
| --- | --- | --- |
| 인증 코드 | 인증 페이지에서의 일회성 전달. | 일치하는 검증자와 콜백을 사용하여 한 번 교환합니다. 이는 API 토큰이 아닙니다. |
| 액세스 토큰 | 승인된 권한 및 범위 내에서 API 호출을 승인합니다. | 전송 방법 `Authorization: Bearer …`. 만료 및 엔드포인트 인증 오류를 준수하십시오. |
| 갱신 토큰 | 추가 로그인 없이 유효한 권한 내에서 대체 액세스 토큰을 획득합니다. | 안전하게 저장하십시오. 갱신 작업을 직렬화하고 회전된 자격 증명을 원자적으로 교체하십시오. |
| ID 토큰 | 클라이언트를 위한 OpenID Connect 신원 주장. | 사용하는 경우, 서명, 발급자, 대상, 만료 및 nonce를 적절히 검증하십시오. 이를 추론 Bearer 토큰으로 사용하지 마십시오. |
| 클라이언트 비밀 | 허가된 기밀 서버 클라이언트를 인증합니다. | 서버에 저장하십시오. 이는 모든 토큰과 다르며 공개 클라이언트에 번들로 포함되지 않습니다. |

```bash
# Public client refresh; run on a trusted terminal with scoped test credentials.
curl --fail-with-body 'https://auth.shareai.now/oauth/token' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=refresh_token' \
  --data-urlencode "client_id=$SHAREAI_CLIENT_ID" \
  --data-urlencode "refresh_token=$SHAREAI_REFRESH_TOKEN"
```

반환된 `expires_in` 수명을 발명하지 말고 사용하십시오. 갱신이 대체 갱신 토큰을 반환하면 새 액세스 토큰과 함께 하나의 업데이트로 저장하십시오. 세션당 하나의 갱신만 진행하여 동시 요청이 회전된 토큰을 재사용하지 않도록 하십시오. 유효하지 않거나 취소된 갱신 권한은 재연결이 필요하며, 무한 루프를 생성하지 마십시오.

새 Monetization Gateway 계약을 추가하거나 새 권한 또는 조건을 조용히 수락할 수 없습니다. 고객을 다시 인증 프로세스로 보내 새 권한 또는 조건을 얻으십시오. JamZY는 자격 증명을 서버 메모리에 최대 1시간 데모 세션 동안만 저장하며, 확인되지 않은 ID 토큰을 신뢰하는 대신 사용자 정보를 인증하고 Secure, HttpOnly, SameSite 쿠키를 사용합니다. 프로덕션 서비스는 자체적으로 지속 가능하고 보호된 세션 설계가 필요합니다.

연결이 끊어지면, 해당되는 경우 새로 고침/액세스 자격 증명을 취소하고 애플리케이션 세션을 지우십시오. 브라우저 쿠키를 지우는 것만으로는 ShareAI 권한을 취소하거나 유료 구독을 해지하지 않습니다. 코드, 토큰, 비밀 또는 개인적인 프롬프트 내용을 기록하지 않도록 하십시오.

**계속할 준비가 되었을 때**

만료는 하나의 제어된 새로 고침을 트리거하며, 새 토큰이 기존 토큰을 대체합니다. 연결 해제는 애플리케이션 세션을 지우고 모든 취소 실패를 보고합니다.

세부 정보가 필요하신가요?[새로 고침 & 회전 ↗](https://shareai.now/docs/api/builders/auth/refresh-tokens/)[취소 & 내역 조회 ↗](https://shareai.now/docs/api/builders/auth/revoke-introspect/)[사용자 정보 & 검색 ↗](https://shareai.now/docs/api/builders/auth/identity-discovery/)[OAuth 보안 모범 사례 ↗](https://www.rfc-editor.org/rfc/rfc9700.html)

## AI를 사용하여 첫 번째 약속을 준비하십시오

고객이 자금을 지원한 명시적인 AI 요청을 통해 약속 목표를 의제로 전환하고 유용한 질문을 작성하게 됩니다.

귀하가 작업할 위치 사용 가능한 모델 → JamZY → 준비하세요

애플리케이션에서 사용 가능한 모델을 엽니다. 제품에서 제공할 모델과 공급자를 선택하고 구성을 저장합니다. 카탈로그를 로드할 수 없는 경우 진행하기 전에 업스트림 가용성 오류를 해결하십시오. OAuth 클라이언트를 반복적으로 변경해도 이를 복구할 수 없습니다.

사용 가능한 모델 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL21vZGVscy5wbmc.PXvmpf7nx9UhAHYgLQ8HHi?v=7c62a7dcb41c)

고객이 사용할 수 있는 모델과 공급자를 선택하세요. 계속하기 전에 모든 카탈로그 오류를 해결하세요.

1. 모델 카탈로그는 이 애플리케이션에 속합니다.

JamZY는 연결 후에만 카탈로그를 로드합니다. 허용된 텍스트 모델을 선택하고 짧은 약속 목표를 입력한 다음 준비 생성을 신중히 선택하십시오. 선택한 계정에는 적격 크레딧과 필요한 AI 청구 조건이 수락되어야 합니다. 날짜를 선택하고 약속을 검토하고 저장하는 것은 추론 요청을 보내지 않습니다.

```bash
curl --fail-with-body 'https://api.shareai.now/api/v1/chat/completions' \
  -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"model":"YOUR_ENABLED_MODEL_SLUG","messages":[{"role":"user","content":"Create a short agenda and three questions for a 15-minute appointment about planning a booking app."}],"stream":false,"max_tokens":192}'
```

### JamZY에서 약속 흐름을 따르십시오.

1. 일정에서 서비스를 선택하십시오: 15분 소개, 30분 프로젝트 계획 또는 60분 심층 대화.
2. 날짜와 사용 가능한 시간을 선택하십시오. 시간은 브라우저에 표시된 시간대를 사용합니다. 가용성은 예시적이며 저장된 약속은 이 브라우저에만 영향을 미칩니다.
3. 준비하세요에서 개인 정보를 제외한 예제 목표를 입력하십시오. 모델을 선택한 다음 준비 생성을 선택하십시오. JamZY는 선택한 서비스와 목표를 ShareAI에 보내고 반환된 텍스트를 안전하게 렌더링하며 예약을 변경하지 않습니다.
4. 의제를 직접 검토하십시오. 약속 검토를 선택하고 서비스, 날짜, 시간 및 기간을 확인한 다음 데모 약속 확인을 선택하십시오. 이 작업은 AI를 호출하거나 결제를 처리하지 않습니다.
5. 내 약속을 열어 저장된 데모 기록을 확인하십시오. 지속성을 확인하려면 새로 고침하거나 삭제하여 슬롯을 다시 사용할 수 있도록 하십시오. 서비스, 날짜, 시간 및 임의의 로컬 참조만 저장되며 AI 초안, 목표, 토큰 및 키는 약속과 함께 저장되지 않습니다.

이 브라우저 전용 데모 예약을 저장하기 전에 서비스, 날짜, 시간 및 기간을 검토하세요. [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LXJldmlldy5wbmc.77e3cMlfs1G-t-jYrNxzoI?v=dcf04d3d6647)

이 브라우저 전용 데모 예약을 저장하기 전에 서비스, 날짜, 시간 및 기간을 검토하세요.

1. 확인하기 전에 전체 선택 항목을 검토하세요.
2. 이 작업은 데모 기록을 저장하며, AI를 호출하거나 결제를 처리하지 않습니다.

내 예약은 로컬 데모 기록을 표시합니다. 기록을 제거하면 해당 예시 슬롯이 다시 사용 가능해집니다. [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LWFwcG9pbnRtZW50cy5wbmc.KGiTkFaDpNeep2RKpzxHNE?v=1d5bce9412c4)

내 예약은 로컬 데모 기록을 표시합니다. 기록을 제거하면 해당 예시 슬롯이 다시 사용 가능해집니다.

1. 기록은 개인 정보나 AI 노트 없이 이 브라우저에 유지됩니다.
2. 데모 예약을 제거하고 해당 슬롯을 해제하세요.

실제 예약 제품은 서버 측 예약 저장소, 가용성 확인, 시간대 처리, 취소 정책 및 캘린더 또는 알림 통합이 필요합니다. 이는 ShareAI 인증과는 별개입니다. AI 출력을 제안으로 유지하고 향후 예약 작업을 애플리케이션 규칙을 통해 검증하십시오.

허가된 카탈로그에서 반환된 모델 슬러그를 사용하십시오. 실제 응답 계약을 처리하십시오: JamZY는 ShareAI의 네이티브를 지원합니다. `message.content` 봉투 및 OpenAI 스타일 `choices[0].message.content`HTTP 200이 불완전하거나 중첩된 오류 응답을 포함하는 경우 성공적인 응답이 아닙니다.

지출 한도 초과 또는 신용 부족 응답 시, 유용한 설명과 제공된 고객 청구 링크를 표시하십시오. 선택된 계정을 유지하십시오. 한도를 우회하거나, 지불자를 조용히 변경하거나, 청구된 작업을 루프에서 재시도하지 마십시오.

**계속할 준비가 되었을 때**

준비 생성은 사용 가능한 일정과 질문을 반환합니다. 요청은 허가된 고객 및 애플리케이션, 선택된 모델 및 승인된 조건에 귀속됩니다. AI 초안은 약속을 예약하거나 변경할 수 없습니다.

세부 정보가 필요하신가요?[OAuth 채팅 요청 ↗](https://shareai.now/docs/api/builders/chat-completions/chat-with-oauth/)[청구 복구 ↗](https://shareai.now/docs/api/builders/billing-errors-and-spending-limits/)

## 선택적 AI 수익을 설정하십시오

구독 제안에서 추가 AI 요금을 설명하고 고객이 수락할 수 있는 조건을 게시하십시오.

귀하가 작업할 위치 애플리케이션 → 구독

앱의 Use Cases를 통해 Monetization Gateway 액세스를 요청하십시오. 해당 관리 정책에 의해 이미 승인되지 않은 경우 설문지를 작성하고 상태를 따르십시오. 승인은 구성 가능하게 하며, 고객 권한 및 결제 동의는 별도로 유지됩니다.

구독 · 개요 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3N1YnNjcmlwdGlvbnMucG5n.1fAD7CKPa38_SZFh5zuI9P?v=f1ef4ee6680b)

새 애플리케이션은 게시된 계약 없이 시작됩니다. 조건을 게시하기 전에 제안을 추가하세요.

1. 자체 편집기에서 제안을 생성하세요.

1. 구독 열기. 제안을 추가하고 명확한 이름을 지정하며 고객이 지불할 Builder 마크업을 설명하십시오. 생성된 구독 ID는 읽기 전용이며 이 애플리케이션에 범위가 지정됩니다. 통합이 필요할 때 복사하십시오.
2. 각 구독을 자체 편집기에서 편집하십시오. 네트워크 비용과 선택된 모델 및 사용 가정을 기반으로 한 수익을 검사하려면 추정치를 사용하십시오. 추정치는 미리보기이며, 보장된 가격이나 승인된 조건이 아닙니다.
3. 초안을 함께 검토한 후 요구 사항이 충족되면 계약 버전을 게시하십시오. 게시된 버전은 새로운 고객이 수락할 수 있는 내용을 설명합니다.
4. 개요 및 계약 배포를 사용하여 각 승인된 버전에 남아 있는 계정 수를 확인하십시오. 고객은 명시적으로 대체를 수락할 때까지 승인된 조건을 유지합니다. 새 버전을 게시한다고 해서 자동으로 이전 조건으로 전환되지 않습니다. 승인된 계약을 유지하는 기본 전환을 유지하십시오. 추가 앱 작업 전에 갱신된 동의를 요구하도록 선택한 경우, 고객이 새 조건을 승인할 때까지 기존 액세스가 중단될 수 있습니다.

예시 전용: 20% Builder 마크업은 €1.00의 적격 네트워크 비용에 추가됩니다 €0.20. 표준 가격 책정에서, ShareAI의 5% 수수료는 청구 가능한 이벤트 수집 전에 해당 €0.20 마크업에만 적용됩니다. 실제 계산을 위해 라이브 견적기와 승인된 계약을 사용하세요. 이 흐름에서의 구독 제안은 AI 청구 계약이며, 계정 연결만으로는 고정 반복 요금이 청구되지 않습니다.

구독 · 제안 편집기 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3N1YnNjcmlwdGlvbi1lZGl0b3IucG5n.ajS-FCMdefa7Br_i-9U6yV?v=028a19d93ad7)

예시 초안 제안입니다. 생성된 구독 ID는 읽기 전용이며 이 애플리케이션에 범위가 지정됩니다.

1. 고객 대상 제안 이름을 사용하세요.
2. 이 제안에 대한 AI `surcharge`을(를) 설정하세요.

ShareAI 동의 화면은 승인된 약관에 대해 권위적입니다. JamZY의 공개 클라이언트는 사용자 정보에서 승인된 청구 계획을 추론할 수 없으므로 연결 패널이 활성 구독을 주장하거나 약속의 가격을 발명하지 않습니다.

**계속할 준비가 되었을 때**

제안은 요금을 설명하며, 고객이 계약을 수락할 수 있습니다. 어떤 고객이 이전 약관에 남아 있는지와 그 이유를 이해합니다.

세부 정보가 필요하신가요?[완전한 수익화 안내 ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)[승인된 계약 ↗](https://shareai.now/docs/api/builders/auth/billing-agreements/)

## 포함된 플랫폼이 작동하는지 증명하십시오

애플리케이션 검토 제출에 필요한 실제 엔드포인트 및 범위 확인을 수집합니다.

귀하가 작업할 위치 OAuth 설정 → 테스터 및 검증

OAuth 설정 열기 → 테스터를 초대하고 애플리케이션 전체에서 최대 다섯 명의 테스터를 초대합니다. 대기 중인 초대는 자리를 소비하지만 액세스를 부여하지 않으며, 수신자가 수락해야 합니다. 소유자 액세스와 초대된 테스터 액세스는 공개 프로덕션 액세스와 다릅니다.

애플리케이션 테스터 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3Rlc3RlcnMucG5n.3_3h6Y0TjTv3r0ttIn9bok?v=60cba368b3d5)

단일 테스터 명단이 모든 플랫폼에 사용됩니다. 보류 중인 초대는 다섯 자리 제한에 포함됩니다.

1. 다섯 자리는 전체 애플리케이션에서 공유됩니다.
2. 여기에서 테스터를 초대한 후, 그들의 수락을 기다리세요.

웹 · 검증 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3ZlcmlmaWNhdGlvbi5wbmc.xLD6z4RV0ddX6p0qkaLhqc?v=d758a8f881d9)

새로운 통합은 실제 성공적인 호출이 기록될 때까지 보류 중인 검사를 표시합니다. 이 참조 초안은 검토를 통과하지 않았습니다.

1. Console은 실제 엔드포인트 성공을 기록합니다.
2. 요청된 모든 범위는 또한 실행되어야 합니다.

게시하려는 각 플랫폼에 대해 검증을 열고 필요한 엔드포인트 및 모든 구성된 범위에 대해 실제 성공적인 호출을 완료합니다. 검색 및 서명 키를 확인하고, 인증/콜백, 코드 교환, 갱신, 인증된 사용자 정보 및 취소를 테스트합니다. 기밀 클라이언트는 관련된 인트로스펙션도 테스트해야 합니다. 네이티브로 주장된 HTTPS 링크는 연관 검증이 필요합니다.

프로필/이메일 범위는 실제 반환된 클레임이 필요합니다. 이메일이 필요한 개인 테스트 계정을 사용하십시오. `inference` 및 `monetization_gateway` 범위는 완료된 승인된 AI 요청이 필요합니다. 결제는 성공적인 범위 결제 API 호출이 필요합니다. 일반적인 성공적인 HTTP 응답, 브라우저 스크린샷 또는 수동 체크리스트는 Console의 기록된 확인을 대체하지 않습니다.

완료되지 않은 플랫폼에 대해 세 가지 선택지가 있습니다: 완료하고 검증하거나, 게시에서 제외하여 소유자/테스터 전용으로 유지하거나, 제거합니다. 실행하지 않은 콜백 또는 범위를 포함한 플랫폼을 포함하지 마십시오. 구성 변경은 확인을 무효화할 수 있으므로 최종 변경 후 기록된 상태를 새로 고치십시오.

**계속할 준비가 되었을 때**

포함된 모든 플랫폼은 필요한 구성, 엔드포인트 및 범위 확인을 완료한 것으로 표시됩니다. 가이드의 개인 체크리스트는 읽기 보조 도구일 뿐입니다.

세부 정보가 필요하신가요?[엔드포인트 검증 ↗](https://shareai.now/docs/api/builders/auth/revoke-introspect/)[참조 시작 ↗](https://shareai.now/docs/builders/applications/launch-application/)

## 귀하의 앱을 제출하고 고객을 따르십시오

검토 준비 상태, 게시 방법 및 이후 고객 액세스를 추적할 위치를 알게 됩니다.

귀하가 작업할 위치 애플리케이션 → 대시보드

1. 대시보드로 돌아가서 모든 미해결 작업을 해결합니다. 애플리케이션 및 포함된 모든 플랫폼이 요구 사항을 충족할 때까지 검토 제출은 사용할 수 없어야 합니다.
2. ShareAI 검토를 위해 애플리케이션을 제출하세요. 대시보드와 활동 및 결정에서 결정 및 요청된 변경 사항을 추적할 수 있습니다. 공개 발표 및 수익화 게이트웨이 요청은 별도의 결정이 있을 수 있습니다.
3. 승인 후, 사용 가능한 공개 제어를 사용하여 애플리케이션을 게시하세요. 포함된 플랫폼이 프로덕션 준비 상태인지 확인하세요. 제외된 플랫폼은 Testing 상태로 유지됩니다.
4. 애플리케이션 수준 계정을 위해 Customers를 열고, 승인된 계약 배포를 위해 Subscriptions를 엽니다. Analytics를 통해 AI 사용 및 수익을 추적할 수 있습니다. 고객 식별자는 적절한 클라이언트/승인 컨텍스트에 비공개로 유지됩니다.

Dashboard · 출시 준비 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2Rhc2hib2FyZC5wbmc.2hIAeRjQpgXmhBWVPD5_zB?v=38be9c6d668e)

애플리케이션과 포함된 플랫폼에 미해결 요구 사항이 있을 경우 검토가 차단됩니다.

1. 검토 제출 전에 필요한 작업을 해결하세요.

고객 [스크린샷 확대 ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2N1c3RvbWVycy5wbmc.qbIDq-R5JMA6K48ws4kWaB?v=cc0470083fec)

애플리케이션 보기에서는 내부 조직 데이터베이스 ID를 표시하지 않고 연결된 계정을 함께 보여줍니다.

1. 고객 관리는 애플리케이션에 대해 통합됩니다.

출시 후 적격 고객과 함께 전체 흐름을 다시 시도하세요: 연결, 계정 및 동의 검사, 짧은 약속 준비 초안을 생성, 안전하게 새로 고침, 청구 실패 처리, 그런 다음 연결 해제. 성공적인 저장이 작동을 증명한다고 가정하지 말고 라이브 사용자 경험을 확인하세요.

**작동하지 않을 때**

**Callback 불일치:** 등록된 URL과 두 요청 값을 정확히 비교하세요. **승인되지 않은 테스트 사용자:** 초대 수락 및 선택된 계정을 확인하십시오. **누락된 범위 또는 계약:** 활성화된 액세스만 요청하고 이를 수락하려면 다시 연결하십시오. **모델 없음:** 사용 가능한 모델 및 제공자 제한을 확인하십시오. **새로 고침 실패:** 실패한 로컬 세션을 지우고 다시 연결하십시오. **검토 차단됨:** 다른 OAuth 클라이언트를 생성하기보다는 플랫폼 검사를 확인하십시오.

**계속할 준비가 되었을 때**

앱은 의도된 고객을 위해 작동하며, 기록된 검사는 게시 상태를 지원하며 고객은 권한을 제어하거나 취소할 수 있습니다.

세부 정보가 필요하신가요?[계속: ShareAI ↗로 결제](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)[Builder API 참조 ↗](https://shareai.now/docs/api/builders/)

## 조직 검증 및 프로그램 액세스

프로그램 등록을 소유할 개인 또는 조직 계정을 신청 전에 선택하세요. 조직은 검증 전에 신청서를 제출할 수 있지만, 직원 승인만으로는 접근이 활성화되지 않습니다. Console의 온보딩 체크리스트에서 조직 이메일 및 회사 검증을 완료하세요. 승인된 조직은 두 가지 검증이 완료될 때까지 "검증 대기 중" 상태로 유지됩니다. Builder, Provider 및 Creator 프로그램은 이 규칙을 따릅니다.

[Monetization Gateway 가격 책정 보기](https://shareai.now/ko/%eb%b9%8c%eb%8d%94-2/%ec%88%98%ec%9d%b5%ed%99%94-%ea%b2%8c%ec%9d%b4%ed%8a%b8%ec%9b%a8%ec%9d%b4/#mg-pricing) · [ShareAI for Startups을 탐색하세요](https://shareai.now/ko/%ec%8a%a4%ed%83%80%ed%8a%b8%ec%97%85-%ed%94%84%eb%a1%9c%ea%b7%b8%eb%9e%a8/) · [범위 및 권한](https://shareai.now/ko/%eb%ac%b8%ec%84%9c-2/api/%eb%b9%8c%eb%8d%94-2/%ec%9d%b8%ec%a6%9d/oauth-%eb%b2%94%ec%9c%84-%eb%b0%8f-%ea%b3%84%ec%a0%95-%ea%b2%bd%ea%b3%84/)

## 권한 및 승인된 조건

귀하의 공개 약관, 개인정보 보호정책 및 삭제 지침은 애플리케이션과 일치해야 하며 로그인 없이 접근 가능해야 합니다. ShareAI 프로그램 수락, Monetization Gateway 승인, 고객의 OAuth 권한 및 승인된 청구 계약은 별도의 결정 사항입니다. 새로 고침은 권한을 추가하거나 새로운 상업적 조건을 수락할 수 없습니다.

기존 통합을 위해 레거시 `surcharge` 범위가 여전히 허용됩니다. 새로운 예제는 `monetization_gateway`을 사용합니다. `surcharge_bps` 및 `surcharge_percentage`와 같은 기존 와이어 필드는 변경하지 마십시오.

[Monetization Gateway 가격 책정 보기](https://shareai.now/ko/%eb%b9%8c%eb%8d%94-2/%ec%88%98%ec%9d%b5%ed%99%94-%ea%b2%8c%ec%9d%b4%ed%8a%b8%ec%9b%a8%ec%9d%b4/#mg-pricing) · [ShareAI for Startups을 탐색하세요](https://shareai.now/ko/%ec%8a%a4%ed%83%80%ed%8a%b8%ec%97%85-%ed%94%84%eb%a1%9c%ea%b7%b8%eb%9e%a8/) · [범위 및 권한](https://shareai.now/ko/%eb%ac%b8%ec%84%9c-2/api/%eb%b9%8c%eb%8d%94-2/%ec%9d%b8%ec%a6%9d/oauth-%eb%b2%94%ec%9c%84-%eb%b0%8f-%ea%b3%84%ec%a0%95-%ea%b2%bd%ea%b3%84/)

## 게이트웨이 비용 및 Startup 지원

표준 요금은 5%의 Builder 마크업입니다. AI 네트워크 비용의 €2.00와 10% 마크업에 대해 고객은 €2.20를 지불합니다. ShareAI는 €0.01의 €0.20 마크업을 받습니다. Builder는 Event Ingestion 이전에 €0.19를 보유합니다.

매달 첫 번째 1,000 정산된 Production Monetization Gateway 요청은 Builder 계정 전체에서 무료로 제공됩니다 (UTC 기준). 추가 요청은 적격 할인 적용 전 €0.04당 1,000의 비용이 발생합니다. 하나의 정산된 요청은 하나의 이벤트를 생성합니다.

Pay with ShareAI 단독으로, `inference`-전용 접근, 일반 계정 API 키 및 스테이징 또는 테스트 트래픽은 Monetization Gateway 이벤트 수집 비용이 발생하지 않습니다.

ShareAI for Startups는 승인된 애플리케이션에 대한 실제 ShareAI 비용에 대해 공유 월간 할당을 제공합니다. 현재 Launch, Growth 및 Momentum 등급은 월별로 €1,000, €5,000, €10,000를 나열합니다. 동일한 예산은 ShareAI의 비율 비용과 Builder 마크업 및 청구 가능한 이벤트 수집을 함께 포함합니다. 이는 총 마크업 할당, 별도의 무료 이벤트 할당량 또는 무료 AI `inference`가 아닙니다. 계정의 첫 번째 1,000 무료 이벤트는 이를 소비하지 않습니다.

남은 이벤트 수집 비용은 요청의 새로운 Builder 수익에서 지불되며, 이후 사용 가능한 Builder AI 수익 및 제한 없는 AI 크레딧에서 지불됩니다. 고객 AI 비용 및 제품 `payments`는 별도로 유지됩니다.

ShareAI는 고정 기간 동안 또는 변경될 때까지 애플리케이션별 비용 또는 비용 지원을 승인할 수 있습니다. Console에서 애플리케이션의 현재 가격 및 특별 프로그램을 검토하여 승인된 조건, 유효성 및 소비된 할당량을 확인하십시오. 등급 변경 또는 가격 재정의는 애플리케이션의 월간 사용량을 초기화하지 않습니다.

Launch는 ShareAI로 로그인 옵션을 유지합니다. Growth 및 Momentum은 이를 요구하며, Momentum은 애플리케이션 하단에 공식 ShareAI for Startups 배지를 추가로 요구합니다. ShareAI는 배지를 주간으로 확인합니다. 요구 사항을 우회하려는 시도가 확인되면 Startup Program에서 강등, 제거 또는 Marketplace에서 철회될 수 있습니다.

엔터프라이즈 요율은 ShareAI 팀이 Builder 계정을 위해 맞춤형 제안을 동의한 후 구성됩니다. 할당된 비율 및 이벤트 요율은 향후 요청에 적용됩니다.

[Monetization Gateway 가격 책정 보기](https://shareai.now/ko/%eb%b9%8c%eb%8d%94-2/%ec%88%98%ec%9d%b5%ed%99%94-%ea%b2%8c%ec%9d%b4%ed%8a%b8%ec%9b%a8%ec%9d%b4/#mg-pricing) · [ShareAI for Startups을 탐색하세요](https://shareai.now/ko/%ec%8a%a4%ed%83%80%ed%8a%b8%ec%97%85-%ed%94%84%eb%a1%9c%ea%b7%b8%eb%9e%a8/) · [범위 및 권한](https://shareai.now/ko/%eb%ac%b8%ec%84%9c-2/api/%eb%b9%8c%eb%8d%94-2/%ec%9d%b8%ec%a6%9d/oauth-%eb%b2%94%ec%9c%84-%eb%b0%8f-%ea%b3%84%ec%a0%95-%ea%b2%bd%ea%b3%84/)

Source: https://shareai.now/ko/%EB%B8%94%EB%A1%9C%EA%B7%B8-2/%EC%A0%9C%ED%92%88/%EB%B9%8C%EB%8D%94-%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%A8/%EA%B0%80%EC%9D%B4%EB%93%9C-%EC%82%AC%EC%9A%A9-%EB%B0%A9%EB%B2%95/shareai-builder%EC%97%90-%EC%95%A0%ED%94%8C%EB%A6%AC%EC%BC%80%EC%9D%B4%EC%85%98%EC%9D%84-%EB%8B%A8%EA%B3%84%EB%B3%84%EB%A1%9C-%EC%97%B0%EA%B2%B0%ED%95%98%EB%8A%94-%EB%B0%A9%EB%B2%95/