AI Prosumer
JA

SHAREAIで構築する

アプリケーションをShareAI Builderに接続する方法(ステップバイステップ)

顧客をShareAIに接続し、有用なAIアジェンダを準備し、AI支出を管理できる予約アプリを構築する。

あなたが構築する体験

JamZY · 予約
実際のJamZY予約デモ:サービスと時間を選択し、オプションでShareAIを接続して準備を生成してください。

予約を選択する。ShareAIを接続する。計画を持って到着する。

あなたの実装

構築可能な顧客接続。

具体的な3つの成果物:顧客を接続し、予約を準備し、統合を検証可能な状態にする。

実装リファレンスを取得する
01顧客アクセス

サインインと更新可能なセッション

顧客がShareAIアカウントを選択し、アプリを承認してJamZYに戻る。

OAuth + PKCEアカウント同意
以下のときに検証可能:

サインイン、セッションの更新、正常な切断。

顧客接続を構築する
02予約AI

有用な準備ドラフト

予約目標をAIリクエストを通じてアジェンダと質問に変換する。

顧客負担のAIモデルアクセス
以下のときに検証可能:

ドラフトを生成する;予約を保存してもAIコールは発生しない。

準備フローを構築する
03条件 & レビュー

検証可能なセットアップ

オプションのAI料金を説明し、レビュー提出に必要なプラットフォームチェックを収集する。

承認された契約プラットフォームチェック
以下のときに検証可能:

含まれるすべてのプラットフォームと要求されたスコープには記録されたチェックがある。

条件を設定し、アプリを検証する

エディタに取り込む

エージェントと一緒に構築する。

実装目標、必要な入力、受け入れチェックを含む完全なガイドをコピーする。コード例、表、ドキュメントリンクを一緒に保持する。

完全ガイド実装コンテキスト検証チェック
その他の形式
Markdownとして表示 Markdownをダウンロード

必要な形式でプロジェクトの準備が整う。

更新済み

構築する内容を見る

顧客が理解できる接続を構築します: 彼らのShareAIアカウント、オプションのAI準備ドラフト、および予約への明確な経路。

作業場所 完成した例

アプリケーションをShareAI Builderに接続し、登録からテスト済みの統合がレビュー準備完了になるまでのプロセスを行います。このウォークスルーでは、JamZYという小規模なNode.js予約アプリケーションを使用して、各ステップを示します: アプリの登録、Webプラットフォームの設定、顧客のShareAIアカウントの接続、および承認されたAIリクエストの送信。これらの手順を自分の製品にも適用してください。

機能顧客が同意する内容JamZYが示すもの
ShareAIでログインアカウント接続とアプリが要求する識別情報。認証されたユーザー情報からのプライベートな顧客識別情報。
ShareAIで支払う · AI使用顧客が選択した個人または組織アカウントを使用して承認された推論を実行。そのアカウントの適格なクレジットで資金提供された予約準備ドラフト。
Builder マークアップ承認されたアプリケーション契約で受け入れられた追加のAI使用料。承認および契約公開後のオプションの使用収益化。
製品の支払い別のShareAIチェックアウトで提示される特定の購入。拡張機能の説明 支払いウォークスルー。予約デモはチェックアウトを実装していません。

ShareAIアカウント、アプリを所有する個人または組織アカウントを使用する許可、公開HTTPSコールバック、ロゴ、および機能するプライバシー、利用規約、アカウント削除ページを用意してください。例を実行するには、Node.js 22以降とアプリケーション用のHTTPSアドレスを使用してください。

JamZY · 予約リファレンスアプリケーション スクリーンショットを拡大 ↗
実際のJamZY予約デモ:サービスと時間を選択し、オプションでShareAIを接続して準備を生成してください。
ローカルの予約スケジュールと顧客負担のAI準備は別々のアクションです。このデモではカレンダー招待は送信されません。
  1. 予約タイプと期間を選択してください。
  2. 利用可能なデモスロットを選択してください。
  3. オプションのAIアシスタントを使用するにはShareAIを接続してください。
  4. AIはこの明示的なアクション後にのみ実行されます。予約だけではShareAIを呼び出しません。
自分のアプリの詳細を使用する

スクリーンショットには例示用のアプリケーション詳細が使用されています。ShareAI はこのガイド内で本番アドレスを指します。準備の生成は実際のAIリクエストを発生させ、クレジットを消費する可能性があります。デモ予約を選択または保存してもクレジットは消費されません。検証チェックは、独自の統合テストが成功した場合に完了します。

次に進む準備が整いました。

アカウントログイン、AI消費、オプションの追加料金、確定した製品購入を区別できます。このガイドを読むこと自体には有料リクエストは必要ありません。

Builder Programに参加する

アプリケーションとその顧客関係を所有するBuilderのアイデンティティを作成します。

作業場所 コンソール → Builder Program

  1. ShareAI アカウントを作成またはサインインします。JamZY を所有する個人または組織アカウントを選択し、セットアップ全体で同じアカウントを使用してください。
  2. 開く ShareAI コンソール内のBuilder Programあなたの作業に合ったBuilderアクティビティを選択してください。このガイドでは、所有するアプリケーションのための製品会社パスを選択します。クライアントワークは顧客に提供されるサービス用であり、統合は既存のアプリケーションを接続するためのものです。
  3. プログラム登録を適用する前に、個人または組織アカウントを選択して所有者を指定します。組織は検証前に申請を提出できますが、スタッフの承認だけではアクセスが有効化されません。Consoleのオンボーディングチェックリストで組織のメールと会社の検証を完了してください。承認された組織は、両方のチェックが完了するまで「Pending verification」の状態のままです。Builder、Provider、およびCreatorプログラムはこのルールに従います。
  4. 承認後、Builder Program → Product を開きます。アクタースイッチャーは、編集しているアカウントを識別します。
Builder Program · 登録エントリーポイント スクリーンショットを拡大 ↗
Builder Programランディングページは製品パスを紹介し、Consoleでの登録へのリンクを提供します。
製品パスから始めて、JamZYを所有するアカウントの登録を完了してください。
  1. Consoleに進んでBuilder Programに登録してください。
次に進む準備が整いました。

Builder Program は対象の所有者向けに開き、新しいアプリを提供します。登録の決定、アプリケーションのレビュー、公開情報のレビュー、および Monetization Gateway の承認は別々のステップです。

あなたの申請を作成する

JamZY に独自のアプリケーションレコードを提供し、そのアイデンティティ、アクセス、商業条件を一元化します。

作業場所 ビルダープログラム → 製品 → 新しいアプリ

  1. Product で New app を選択します。初期詳細を入力するために公開ウェブサイトを入力するか、「手動で記入します」を選択してください。
  2. PNG または JPEG ロゴをアップロードし、JamZY を名前として入力し、製品を明確な1文で説明してください。ウェブサイトとBuilderの連絡先メールを確認してください。
  3. セットアップ質問に進みます。回答は正直に記入してください。それらはアプリケーションがどのように提供され、支払われるかを説明します。
アプリケーションセットアップ · 詳細 スクリーンショットを拡大 ↗
続行する前にアプリ名、紹介文、ロゴ、公開ウェブサイトを確認してください。連絡先情報は説明用です。
続行する前にアプリ名、紹介文、ロゴ、公開ウェブサイトを確認してください。連絡先情報は説明用です。
  1. アプリケーションに明確な名前を付けてください。
  2. オンボーディング質問に進んでください。

アプリケーションプロファイルにはアクセス可能な公開ウェブサイトを使用してください。プライベートまたはローカル専用のウェブサイトは、開発用コールバックが正しく登録されていても検証に失敗する可能性があります。新しいアプリケーションはドラフトとして開始されます。公開せずに編集を続けることができます。そのアプリケーション識別子は、OAuthクライアントIDやサブスクリプションIDとは異なります。

次に進む準備が整いました。

JamZY は、対象のオーナーの製品の下に表示されます。すべてのデバイスプラットフォームごとに追加のアプリケーションを作成しないでください。

アプリの提供方法を説明する

アプリが実行される場所とその認証情報を管理する人に適したOAuthオプションを取得できます。

作業場所 新しいアプリ → アプリケーション設定

自分で運用するJamZYデプロイメントの場合、提供するサービスに合った料金モデルを選択してください。SaaS、ベンダーホスト型クラウドアプリ、顧客が自身の消費分を支払う場合、そしてAIリクエスト用のShareAI。これらは例示的な回答であり、すべての製品に必須ではありません。

アプリケーション設定 · デプロイメント スクリーンショットを拡大 ↗
オンボーディング回答によってサーバークライアントシークレットが利用可能かどうかが決まります。
オンボーディング回答によってサーバークライアントシークレットが利用可能かどうかが決まります。
  1. アプリケーションが実際に実行される場所を選択してください。
アプリが実行される場所OAuthの選択資格情報の保存場所
ホストされたバックエンドWebサーバークライアントはクライアントシークレットを使用する場合があります。PKCEは引き続き適用されます。シークレットとトークンはサーバー上に保持されます。
ブラウザアプリケーション / SPAPKCEを使用する公開Webクライアント。埋め込みクライアントシークレットはありません。適切なブラウザまたはバックエンドセッション設計を使用してください。
自己ホスト型またはハイブリッド配布オンボーディングポリシーに基づくPKCEを使用する公開クライアント。共有ベンダーシークレットを顧客インストールに配布しないでください。
Windows、macOS、Linux、AndroidまたはiOS有効化された各プラットフォームごとに1つの公開クライアント。PKCEとプラットフォームに適した安全なストレージ; バンドルされたシークレットはありません。

ダウンロード可能なJamZYサンプルは、意図的にPKCEを使用する公開Webクライアントを採用していますが、小規模なバックエンドを持っています。サーバーはトークンをブラウザストレージに保存しません。ベンダーホスト型の回答ではサーバークライアントが許可されますが、それを選択することを強制するものではありません。

保存された回答は、アプリケーション情報 → アプリケーション設定の下で再確認できます。デプロイメントの変更により、互換性のないクライアントシークレットが削除され、再確認が必要になる場合があります。保存する前にその影響を確認してください。

次に進む準備が整いました。

保存されたデプロイメントは、実際のアーキテクチャを記述します。クライアントシークレットオプションはその回答に従います。無効化されたオプションはポリシーの説明であり、資格情報の欠如を意味するものではありません。

詳細が必要ですか?クライアント登録 ↗

アプリケーションを明確に紹介する

顧客が接続を決定する前に必要な製品の詳細とポリシーを提供してください。

作業場所 アプリケーション情報

ダッシュボードの後にアプリケーション情報を開きます。詳細、アプリケーション設定、プレゼンテーション、ブランディング、ギャラリー、レビューの専用セクションを順に進めてください。製品に役立つ説明、正確なウェブサイト、顧客のワークフローの明確なスクリーンショットを提供してください。

アプリケーション情報 スクリーンショットを拡大 ↗
アプリケーションに独自の名前、紹介文、公開HTTPSウェブサイトを付けてください。
アプリケーションに独自の名前、紹介文、公開HTTPSウェブサイトを付けてください。
  1. 詳細、セットアップ、プレゼンテーション、ブランディングをそれぞれのセクションで開発してください。

独自のアプリケーションアイデンティティを使用してください。ShareAIのブランディングは統合ボタンや説明資料に使用されるべきであり、製品ロゴを置き換えるべきではありません。プライバシー、利用規約、削除リンクはサインインなしでアクセス可能にしてください。

浮動保存アクションが表示されたら変更を保存してください。公開情報提案には独自のレビューがあります。承認された提案を編集しても、ライブの公開プレゼンテーションが無言で置き換えられることはありません。

次に進む準備が整いました。

訪問者はJamZYが何をするのか、誰が運営しているのか、削除をリクエストする方法を理解できます。公開情報とコールバック設定は同じ製品を参照します。

顧客が承認できる内容を選択する

実際にアポイントメント体験で使用するアクセスを要求し、その請求目的を明確にします。

作業場所 アプリケーション → ユースケース

ユースケースでは、アカウント接続のために ShareAI を有効にし、サポートする予定の顧客負担フローのために Pay with ShareAI を有効にします。製品がAI使用に対して追加料金を得る場合にのみ、Monetization Gateway アクセスをリクエストしてください。Consoleに表示される承認ステータスに従ってください。

Log-in with ShareAI、Pay with ShareAI、およびMonetization Gatewayには、個別の構成および承認状態があります。
Log-in with ShareAI、Pay with ShareAI、およびMonetization Gatewayには、個別の構成および承認状態があります。
  1. ShareAIを使用したログインを構成します。
  2. 顧客資金による使用を有効化します。
スコープそれを要求する理由
openidクライアントスコープのアイデンティティを使用してアカウントを接続します。
profile / emailプロファイルまたはメールのクレームは、製品がそれを必要とする場合にのみ要求してください。
inferenceアプリケーション設定で許可されている場合に、サポートされているAI推論エンドポイントを呼び出します。
monetization_gateway顧客が受け入れたAI請求契約を使用して、追加料金のかかる推論を行います。
payments顧客の支払いリクエストを作成および確認します。各購入には依然として確認が必要です。

JamZY リクエスト openid profile inference monetization_gateway。それは要求しません payments また、チェックアウトを通じて製品を販売しません。Consoleで機能を有効にしても、既存のアクセストークンにそれが付与されるわけではありません。顧客はスコープと条件を承認する必要があります。

次に進む準備が整いました。

機能、設定されたスコープ、および承認リクエストが一致します。アプリが決して使用しない、または検証できないオプションのアクセスを要求することは避けてください。

Web統合を設定する

ブラウザベースの JamZY 体験のために1つのWebクライアントを作成し、適切な認証方法を使用します。

作業場所 OAuth設定 → Web

  1. OAuth設定を開きます。プラットフォームグリッドからWebを選択します。プラットフォームごとに1つのクライアントを設定できます:Web、Windows、macOS、Linux、Android、iOS。
  2. このサンプルでは、ブラウザアプリケーション / SPA、公開PKCEクライアントを選択します。サーバーWebアプリケーションは、デプロイメントポリシーがそれを許可し、バックエンドがシークレットを保護できる場合にのみ適切です。
  3. 自分のWebクライアントIDをコピーします。統合中はプラットフォームをテスト中に保ちます。スクリーンショットからIDをコピーしたり、別の製品のために共有デモの登録を再利用したりしないでください。
OAuth設定 · プラットフォームグリッド スクリーンショットを拡大 ↗
プラットフォームごとに1つの登録クライアント。未構成のプラットフォームはオプションのままです。
プラットフォームごとに1つの登録クライアント。未構成のプラットフォームはオプションのままです。
  1. 単一のWeb統合を開く。
  2. 製品が対応している場合のみAndroidを追加してください。
公開WebクライアントはPKCEを使用し、クライアントシークレットを持ちません。クライアントIDは編集不可です。
公開WebクライアントはPKCEを使用し、クライアントシークレットを持ちません。クライアントIDは編集不可です。
  1. 自分のWebクライアントIDをコピーしてください。
  2. 公開クライアントはシークレットを受け取りません。

異なるプラットフォームは異なる資格情報とコールバックルールを持ちます。それらは別々の製品ではありません:サブスクリプションと顧客管理はアプリケーションに統合されています。アプリケーションテスターはプラットフォーム間で共有され、保留中の招待を含めて最大5つの場所を持ちます。オーナーはテスターの場所を消費しません。

次に進む準備が整いました。

正確に1つのWebプラットフォームが存在します。設定していないネイティブプラットフォームは、ローンチを妨げません。

詳細が必要ですか?プラットフォーム登録 ↗

顧客をアプリに戻す

承認後、正確なコールバックを使用して顧客をアプリケーションに戻します。

作業場所 Web → 設定

Web → 設定で、アプリケーションが処理する正確なHTTPSコールバックを登録します。このガイドでは https://jamzy.example/oauth/callback を例として使用します。 を置き換えてください jamzy.example JamZY のコピーをデプロイするHTTPSドメインに置き換え、その同じコールバックをアプリケーション設定で使用してください。

デプロイされたアプリケーションが処理するコールバックを登録します。
デプロイされたアプリケーションが処理するコールバックを登録します。
  1. デプロイされたアプリケーションが処理するコールバックを登録します。

同意画面の名前、利用規約、プライバシーおよび削除情報を提供してください。必要なスコープのみを有効にし、保存してください。スキーム、ホスト、パス、および適用可能なクエリの詳細は、承認リクエストおよびコード交換と一致する必要があります。ワイルドカードやURLフラグメントは使用しないでください。

プラットフォーム実装するコールバック
Webアプリケーション上の正確なHTTPSアドレス。
AndroidアプリケーションIDに一致するリバースドメインアプリスキーム、またはパッケージとSHA-256署名フィンガープリントを使用した検証済みHTTPSアプリリンク。
iOS一致するアプリスキーム、またはバンドルIDとApple App IDプレフィックスを使用した検証済みHTTPSユニバーサルリンク。
Windows / macOS / Linux許可された正確なHTTPSコールバック、一致するリバースドメインアプリケーションスキーム、または127.0.0.1 / [::1]上のサポートされるループバックリダイレクト。ループバックポートは可変です。

インストールされたアプリはシステムブラウザで認証を行い、登録されたコールバックを通じて戻ります。要求される関連ファイルを公開し、Consoleで関連付け検証を実行してください。フォーム内で妥当と思われるコールバックは、インストールされたアプリがそれを受信する証拠にはなりません。

次に進む準備が整いました。

認証フローを通じてコールバックを開くと、アプリに戻ります。ランダムなコードや一致しない状態は拒否されます。

自分のJamZYアプリケーションを実行する

アポイントメントインターフェースとそのShareAI接続が、独自のアプリケーション識別子で動作します。

作業場所 アプリケーション → 環境設定

JamZYは、オプションのAI準備アシスタントを備えたアポイントメントアプリケーションです。そのスケジューラーはブラウザ専用のデモンストレーションであり、カレンダープロバイダー、メール配信、またはアポイントメント支払いはありません。ShareAI認証およびAI API統合は、実際に設定されたアップストリームを使用します。

ダウンロード JamZYリファレンスソース。これにはNodeサーバー、ブラウザUI、テスト、およびセットアップREADMEが含まれていますが、証明書、シークレット、依存関係、セッションは含まれていません。実行する前にファイルを確認してください。Nodeプロセスを公開オリジンを保持するHTTPSリバースプロキシの背後に配置してください。

# .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
# 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
環境を一緒に保つ

アプリケーションを作成する コンソール.shareai.now。そのプロダクションクライアントIDを使用して https://auth.shareai.now と https://api.shareai.now/api/v1。その jamzy.example アドレスはアプリのプレースホルダーであり、ホストされたデモではありません。セキュアセッションCookieが機能するように、独自のアプリをHTTPSで提供してください。

JamZYは比較用にAPIキー接続も提供します。このウォークスルーではウォレット/OAuthボタンを使用します。APIキーは顧客のJamZYOAuth契約を確立せず、顧客認証フローの代替にはなりません。

次に進む準備が整いました。

アプリはHTTPSを通じて読み込まれます。その公開オリジン、登録されたコールバック、およびクライアントIDは登録内容と一致します。トークンやシークレットはページソースやlocalStorageには表示されません。

最初の顧客を接続する

顧客が自身のShareAIアカウントを選択し、アプリが必要とするアクセスを承認できるようにします。

作業場所 JamZY → ShareAIウォレットで支払う

JamZYから、ShareAIウォレットで支払うを選択します。アプリはShareAI認証ページを開きます。顧客はサインインし、個人または組織アカウントを選択し、アプリと要求されたアクセスを確認し、適用されるサブスクリプション条件を承認します。

  1. JamZY → 認証ランダムなstateとPKCE verifierを作成し、そのS256チャレンジを認可リクエストと共に送信します。
  2. 顧客 → 認証支払いアカウントを選択し、アクセスおよび請求条件を確認します。キャンセルするとJamZYが切断されたままになります。
  3. 認証 → コールバック短期間有効な一度限りのコードとstateを受け取ります。同じセッションに対してstateを検証します。
  4. バックエンド → トークンそのコードを元のverifierおよび同一のリダイレクトURIと交換します。パブリッククライアントはclient secretを送信しません。
  5. バックエンド → ユーザー情報アクセストークンを使用して認証されたIDを読み取り、JamZY独自の安全なセッションを確立します。
Web · 本番エンドポイント スクリーンショットを拡大 ↗
console.shareai.nowからのクライアントIDを使用して、これらの本番ShareAIアドレスを使用してください。
console.shareai.nowからのクライアントIDを使用して、これらの本番ShareAIアドレスを使用してください。
  1. auth.shareai.now/oauth/authorizeで認証してください。
  2. auth.shareai.now/oauth/tokenでコードとリフレッシュトークンを交換してください。
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ではありません。表示名を一致させてプラットフォーム間でIDを統合しないでください。

次に進む準備が整いました。

キャンセル、不一致のstate、再利用されたコード、有効期限切れの認可は安全に失敗します。通常のフローでは、トークンを公開することなく認証されたアカウントを返します。

顧客を安全に接続し続ける

トークンが期限切れになる間も認可されたリクエストを維持し、顧客に信頼できる切断方法を提供します。

作業場所 アプリケーション → セッションとトークンの処理

認証情報目的処理方法
認可コード認可ページからの一度限りの引き渡し。一度だけ交換し、一致するverifierとコールバックを使用します。これはAPIトークンではありません。
アクセストークン承認された付与およびスコープ内でAPI呼び出しを認可します。送信方法 Authorization: Bearer …。有効期限とエンドポイントの認可エラーを尊重してください。
リフレッシュトークン付与が有効な間、再サインインなしで代替アクセストークンを取得します。安全に保存します。リフレッシュ操作を直列化し、回転した資格情報を原子的に置き換えます。
IDトークンクライアントのためのOpenID Connect IDアサーション。使用する場合は、署名、発行者、オーディエンス、有効期限、nonceを適宜検証してください。推測的なBearerトークンとして使用しないでください。
クライアントシークレット許可された機密サーバークライアントを認証します。サーバーに保存します。これはすべてのトークンとは異なり、パブリッククライアントにバンドルされることはありません。
# 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 有効期間を発明する代わりに。リフレッシュが代替リフレッシュトークンを返す場合、新しいアクセストークンと共に1つの更新としてそれを永続化します。セッションごとに1つのリフレッシュを許可し、同時リクエストが回転したトークンを再利用しないようにします。無効または取り消されたリフレッシュ付与は再接続が必要です。無限ループに陥らないでください。

リフレッシュではスコープを追加したり、新しい Monetization Gateway 契約を黙って受け入れたりすることはできません。新しい権限や条件のために、顧客を再度認証プロセスに送ってください。JamZYは資格情報をサーバーメモリに最大1時間のデモセッションの間のみ保存し、未確認のIDトークンを信頼する代わりにユーザー情報を認証し、Secure, HttpOnly, SameSiteクッキーを使用します。本番サービスには独自の耐久性のある保護されたセッション設計が必要です。

切断時には、該当する場合にリフレッシュ/アクセス資格情報を取り消し、アプリケーションセッションをクリアしてください。ブラウザクッキーをクリアするだけでは、ShareAIの付与を取り消したり、有料サブスクリプションをキャンセルしたりすることはできません。コード、トークン、シークレット、または個人のプロンプト内容をログに記録することは避けてください。

次に進む準備が整いました。

有効期限が切れると、1回の制御されたリフレッシュがトリガーされ、新しいトークンが古いものと置き換わります。切断時にはアプリケーションセッションをクリアし、取り消しの失敗を報告します。

AIを使った最初の予約を準備する

アポイントメントの目標をアジェンダと有用な質問に変え、明示的な顧客資金提供AIリクエストを行います。

作業場所 利用可能なモデル → JamZY → 準備を整える

アプリケーション内で利用可能なモデルを開きます。製品が提供するモデルとプロバイダーを選択し、構成を保存してください。カタログが読み込めない場合は、進む前に上流の可用性エラーを解決してください。OAuthクライアントを繰り返し変更しても修復されません。

お客様が使用できるモデルとプロバイダーを選択してください。続行する前にカタログエラーを解決してください。
お客様が使用できるモデルとプロバイダーを選択してください。続行する前にカタログエラーを解決してください。
  1. モデルカタログはこのアプリケーションに属します。

JamZYは接続後にのみカタログを読み込みます。許可されたテキストモデルを選択し、短いアポイントメント目標を入力して、意図的に準備を生成してください。選択されたアカウントには、適格なクレジットと必要なAI請求条件の受諾が必要です。日付を選択し、アポイントメントを確認して保存しても推論リクエストは送信されません。

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ドラフト、目標、トークン、キーはアポイントメントと一緒に保存されません。
サービス、日付、時間、期間を確認して、このブラウザ専用デモ予約を保存してください。 スクリーンショットを拡大 ↗
サービス、日付、時間、期間を確認して、このブラウザ専用デモ予約を保存してください。
サービス、日付、時間、期間を確認して、このブラウザ専用デモ予約を保存してください。
  1. 確認する前に完全な選択を確認してください。
  2. このアクションはデモ記録を保存しますが、AIを呼び出したり支払いを受けたりすることはありません。
「私の予約」にはローカルデモ記録が表示されます。記録を削除すると、その説明用スロットが再び利用可能になります。 スクリーンショットを拡大 ↗
「私の予約」にはローカルデモ記録が表示されます。記録を削除すると、その説明用スロットが再び利用可能になります。
「私の予約」にはローカルデモ記録が表示されます。記録を削除すると、その説明用スロットが再び利用可能になります。
  1. 記録は個人情報やAIメモなしでこのブラウザに保持されます。
  2. デモ予約を削除してそのスロットを解放してください。

実際のスケジューリング製品には、サーバーサイドの予約ストア、可用性チェック、タイムゾーン処理、キャンセルポリシー、カレンダーまたは通知の統合が必要です。これらはShareAI認証とは別です。AI出力を提案として保持し、将来の予約アクションを独自のアプリケーションルールで検証してください。

許可されたカタログによって返されるモデルスラッグを使用します。実際のレスポンス契約を処理します: JamZY は ShareAI のネイティブ message.content エンベロープおよびOpenAIスタイルをサポートします。 choices[0].message.contentHTTP 200で不完全またはネストされたエラーレスポンスが返された場合、それは成功した返信ではありません。

支出制限またはクレジット不足のレスポンスが発生した場合、有益な説明と提供された顧客請求リンクを表示します。選択されたアカウントを保持します。その制限をバイパスしたり、支払者を黙って切り替えたり、課金された操作をループで再試行したりしないでください。

次に進む準備が整いました。

準備生成は、使用可能なアジェンダと質問を返します。リクエストは、承認された顧客とアプリケーションに帰属し、選択されたモデルと受け入れられた条件に基づいています。AIドラフトは、予約や予定変更を行うことはできません。

オプションのAI収益を設定する

サブスクリプションオファーで追加のAI料金を説明し、顧客が受け入れることができる条件を公開します。

作業場所 アプリケーション → サブスクリプション

アプリのユースケースを通じて Monetization Gateway アクセスをリクエストしてください。該当する管理ポリシーによってすでに承認されていない場合は、アンケートを完了し、そのステータスを確認してください。承認により構成が可能になりますが、顧客の許可と請求同意は別々に維持されます。

サブスクリプション · 概要 スクリーンショットを拡大 ↗
新しいアプリケーションは公開された契約なしで開始されます。条件を公開する前にオファーを追加してください。
新しいアプリケーションは公開された契約なしで開始されます。条件を公開する前にオファーを追加してください。
  1. 独自のエディターでオファーを作成してください。
  1. サブスクリプションを開きます。オファーを追加し、それに明確な名前を付け、顧客が支払う Builder マークアップを記述してください。生成されたサブスクリプションIDは読み取り専用で、このアプリケーションにスコープされています。統合が必要な場合はコピーしてください。
  2. 各サブスクリプションを独自のエディターで編集します。ネットワークコストと選択されたモデルおよび使用仮定に基づく収益を検査するためにEstimateを使用します。見積もりはプレビューであり、保証された価格や受け入れられた条件ではありません。
  3. ドラフトを一緒にレビューし、その要件が満たされたら契約バージョンを公開します。公開されたバージョンは、新しい顧客が受け入れることができる内容を説明します。
  4. 概要と契約配布を使用して、各受け入れバージョンに残っているアカウント数を確認します。顧客は明示的に代替を受け入れるまで受け入れた条件を保持します。新しいバージョンを公開しても、顧客を黙って移行することはありません。受け入れられた契約を保持するデフォルトの移行を維持してください。さらにアプリ操作を行う前に更新された同意を要求することを意図的に選択した場合、顧客が新しい条件を承認するまで既存のアクセスが中断される可能性があります。

これは計算例です。対象となるネットワーク費用 €1.00 に Builder が 20% を上乗せすると、上乗せ額は €0.20 になります。Standard 料金では、ShareAI の 5% の手数料はこの €0.20 の上乗せ額のみに適用され、課金対象の Event Ingestion の料金は別途計算されます。実際の計算は、現在の見積もりツールと承諾済みの契約を確認してください。このフローのサブスクリプションオファーは AI の請求契約です。アカウントの接続だけで固定の定期料金が引き落とされることはありません。

サブスクリプション · オファーエディター スクリーンショットを拡大 ↗
説明用のドラフトオファーです。その生成されたサブスクリプションIDは読み取り専用で、このアプリケーションにスコープされています。
説明用のドラフトオファーです。その生成されたサブスクリプションIDは読み取り専用で、このアプリケーションにスコープされています。
  1. 顧客向けのオファー名を使用してください。
  2. このオファーのAI surcharge を設定してください。

ShareAI の同意画面は、受諾された条件に関して権威あるものです。JamZY のパブリッククライアントは、ユーザー情報から受諾された請求プランを推測することができないため、その接続パネルはアクティブなサブスクリプションを主張したり、予約の価格を作り出したりすることはありません。

次に進む準備が整いました。

提案は料金を説明します。契約は顧客によって受諾されることができます。どの顧客が古い条件に留まっているのか、そしてその理由を理解します。

含まれるプラットフォームが機能することを証明する

アプリケーションをレビューに提出するために必要な実際のエンドポイントとスコープチェックを収集します。

作業場所 OAuth設定 → テスターと検証

OAuth設定を開く → テスターを選択し、アプリケーション全体で最大5人のテスターを招待します。保留中の招待は場所を消費しますが、アクセスを付与するものではありません。受信者は招待を受諾する必要があります。オーナーアクセスと招待されたテスターアクセスは、パブリックプロダクションアクセスとは異なります。

アプリケーションテスター スクリーンショットを拡大 ↗
単一のテスター名簿がすべてのプラットフォームに対応します。保留中の招待は5名の制限にカウントされます。
単一のテスター名簿がすべてのプラットフォームに対応します。保留中の招待は5名の制限にカウントされます。
  1. 5名の枠はアプリケーション全体で共有されます。
  2. ここでテスターを招待し、彼らの承認を待ってください。
新しい統合は、実際の成功した呼び出しが記録されるまで保留中のチェックを表示します。このリファレンスドラフトはレビューを通過していません。
新しい統合は、実際の成功した呼び出しが記録されるまで保留中のチェックを表示します。このリファレンスドラフトはレビューを通過していません。
  1. コンソールは実際のエンドポイント成功を記録します。
  2. 要求されたすべてのスコープも実行される必要があります。

公開を予定している各プラットフォームについて、検証を開きます。必要なエンドポイントとすべての設定済みスコープに対して実際の成功した呼び出しを完了します。ディスカバリーキーと署名キーを確認し、認証/コールバック、コード交換、リフレッシュ、認証されたユーザー情報、取り消しをテストします。機密クライアントは、適用可能なイントロスペクションもテストする必要があります。ネイティブで主張されたHTTPSリンクには関連付け検証が必要です。

プロファイル/メールスコープには実際に返されるクレームが必要です。メールが必須の個人テストアカウントを使用してください。inference および monetization_gateway スコープには、完了した認可されたAIリクエストが必要です。支払いには、成功したスコープ付き支払いAPIコールが必要です。一般的な成功HTTPレスポンス、ブラウザのスクリーンショット、または手動チェックリストは、Consoleの記録されたチェックの代わりにはなりません。

未完成のプラットフォームに対しては、次の3つの選択肢があります:完了して検証する、公開から除外してオーナー/テスター専用にする、または削除する。実行されていないコールバックやスコープを含むプラットフォームを含めないでください。構成変更はチェックを無効にする可能性があるため、最終変更後に記録されたステータスを更新してください。

次に進む準備が整いました。

含まれるすべてのプラットフォームは、必要な構成、エンドポイント、およびスコープチェックが完了していることを示します。ガイドの個人チェックリストは読み取り補助にすぎません。

アプリを提出し、その顧客をフォローする

レビューの準備が整っているもの、公開の仕組み、およびその後の顧客アクセスをどこで確認するかを理解します。

作業場所 アプリケーション → ダッシュボード

  1. ダッシュボードに戻り、未解決の各アクションを解決します。レビューの提出は、アプリケーションと含まれるすべてのプラットフォームが要件を満たすまで利用できないままである必要があります。
  2. ShareAIの審査に申請を提出してください。ダッシュボードおよびアクティビティ&決定で、決定や要求された変更を追跡できます。公開プレゼンテーションや収益化ゲートウェイのリクエストには、別々の決定がある場合があります。.
  3. 承認後、利用可能な公開コントロールを使用してアプリケーションを公開します。含まれるプラットフォームが本番環境に準備が整っていることを確認してください。除外されたプラットフォームはTestingのままです。
  4. アプリケーションレベルのアカウント用にCustomersを開き、受け入れられた契約配布用にSubscriptionsを開きます。Analyticsは、AI使用量と収益を追跡するのに役立ちます。顧客識別子は適切なクライアント/認証コンテキストに対してプライベートに保たれます。
アプリケーションと含まれるプラットフォームに未解決の要件がある場合、レビューはブロックされたままです。
アプリケーションと含まれるプラットフォームに未解決の要件がある場合、レビューはブロックされたままです。
  1. レビューを提出する前に必要なアクションを解決してください。
アプリケーションビューは接続されたアカウントをまとめて表示しますが、内部組織データベースIDは表示しません。
アプリケーションビューは接続されたアカウントをまとめて表示しますが、内部組織データベースIDは表示しません。
  1. 顧客管理はアプリケーションに集約されます。

起動後、適格な顧客でフロー全体を再試行してください: 接続、アカウントと同意の検査、短いアポイント準備ドラフトの生成、安全なリフレッシュ、請求失敗の処理、そして切断。成功した保存が機能を証明するのではなく、ライブユーザー体験を検証してください。

何かが機能しない場合

コールバックの不一致: 登録されたURLと両方のリクエスト値を正確に比較してください。 未承認のテスター: 招待の受諾と選択されたアカウントを確認してください。 スコープまたは契約が不足しています: 有効化されたアクセスのみをリクエストし、再接続して受諾してください。 モデルがありません: 利用可能なモデルとプロバイダーの制限を確認してください。 更新失敗: 失敗したローカルセッションをクリアして再接続してください。 レビューがブロックされました: 別のOAuthクライアントを作成するのではなく、プラットフォームチェックを確認してください。

次に進む準備が整いました。

アプリは意図された顧客のために動作し、記録されたチェックはその公開状態をサポートし、顧客は認可を制御または取り消すことができます。

組織検証とプログラムアクセス

プログラム登録を適用する前に、個人または組織アカウントを選択して所有者を指定します。組織は検証前に申請を提出できますが、スタッフの承認だけではアクセスが有効化されません。Consoleのオンボーディングチェックリストで組織のメールと会社の検証を完了してください。承認された組織は、両方のチェックが完了するまで「Pending verification」の状態のままです。Builder、Provider、およびCreatorプログラムはこのルールに従います。

Monetization Gateway 価格設定を表示 · ShareAI for Startups を探索する · スコープと権限

権限と受け入れられた条件

公開された利用規約、プライバシーポリシー、および削除手順はアプリケーションと一致し、サインインなしでアクセス可能な状態を維持する必要があります。ShareAI プログラム受け入れ、Monetization Gateway 承認、顧客のOAuth許可、および受け入れられた請求契約は別々の決定です。リフレッシュでは権限を追加したり、新しい商業条件を受け入れたりすることはできません。

レガシーsurchargeスコープは既存の統合で引き続き受け入れられます。新しい例ではmonetization_gatewayを使用します。surcharge_bpsやsurcharge_percentageなどの既存のワイヤフィールドは変更せずに保持してください。

Monetization Gateway 価格設定を表示 · ShareAI for Startups を探索する · スコープと権限

ゲートウェイ料金とStartupサポート

標準料金 5% は Builder のマークアップです。AIネットワークコストの €2.00 と 10% のマークアップに対して、顧客は €2.20 を支払います。ShareAI は €0.01 を受け取り、€0.20 のマークアップを適用します。Builder は Event Ingestion 前に €0.19 を持っています。

最初の1,000確定済みProductionMonetization Gatewayリクエストは、各暦月(UTC)において無料で、Builderアカウント全体で共有されます。追加のリクエストは、適用可能な割引前に€0.04ごとに1,000の費用がかかります。1つの確定済みリクエストは1つのイベントを生成します。

Pay with ShareAI 単体、inference のみのアクセス、通常のアカウントAPIキーおよびステージングまたはテストトラフィックは Monetization Gateway イベントインジェスチョンを発生させません。

ShareAI for Startupsは、承認されたアプリケーションにおける実際のShareAI料金に対する共有月額手当を提供します。現在のLaunch、Growth、Momentumの各ティアは、月額€1,000、€5,000、€10,000をリストしています。同じ予算は、ShareAIのBuilderマークアップに対する割合料金と請求可能なイベントインジェストを一緒にカバーします。これは総マークアップ手当、別々の無料イベントクォータ、または無料AIinferenceではありません。アカウントの最初の1,000無料イベントはこれを消費しません。

残りのイベントインジェスト料金はリクエストの新しいBuilder収益から支払われ、その後利用可能なBuilderAI収益および制限のないAIクレジットが使用されます。顧客AI料金と製品paymentsは別々に保持されます。

ShareAIは、固定期間または変更されるまでのアプリケーション固有の料金や料金支援を承認できます。コンソールでアプリケーションの現在の価格設定および特別プログラムを確認し、承認された条件、有効性、および消費された手当を確認してください。ティア変更や価格設定の上書きは、アプリケーションの月間使用量をリセットしません。

LaunchではShareAIを使用したログインがオプションのままです。GrowthおよびMomentumではこれが必要であり、Momentumではさらにアプリケーションフッターに公式ShareAI for Startupsバッジが必要です。ShareAIはバッジを毎週チェックします。要件を回避しようとする試みが確認された場合、Startup Programからの降格、削除、または受け入れられたプログラム条件に基づくMarketplaceからの撤退につながる可能性があります。

エンタープライズ料金は、ShareAI チームが Builder アカウントに対して個別のオファーに合意した後に設定されます。割り当てられた割合とイベント料金は、将来のリクエストに適用されます。

Monetization Gateway 価格設定を表示 · ShareAI for Startups を探索する · スコープと権限

このページについて質問する

このページを探索するためのアシスタントを選択してください。または、ページをコピーして会話に貼り付けることもできます。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI