XÂY DỰNG VỚI SHAREAI
Xây dựng một ứng dụng đặt lịch hẹn kết nối khách hàng với ShareAI, chuẩn bị các lịch trình AI hữu ích và giúp họ kiểm soát chi phí AI của mình.
Trải nghiệm bạn sẽ xây dựng
JamZY · Lịch hẹnChọn một lịch hẹn. Kết nối ShareAI. Đến với một kế hoạch.
TRIỂN KHAI CỦA BẠN
Ba kết quả cụ thể: kết nối khách hàng, chuẩn bị lịch hẹn của họ và làm cho tích hợp sẵn sàng để xác minh.
Một khách hàng chọn tài khoản ShareAI của họ, phê duyệt ứng dụng của bạn và quay lại JamZY.
Đăng nhập, làm mới phiên và ngắt kết nối thành công.
Biến mục tiêu lịch hẹn thành một lịch trình và các câu hỏi thông qua một yêu cầu AI có chủ đích.
Tạo một bản nháp; lưu một lịch hẹn không thực hiện cuộc gọi AI nào.
Giải thích các phí AI tùy chọn và thu thập các kiểm tra nền tảng mà bài đánh giá của bạn cần.
Mỗi nền tảng được bao gồm và phạm vi yêu cầu đều có các kiểm tra được ghi lại.
ĐƯA VÀO TRÌNH SOẠN THẢO CỦA BẠN
Sao chép toàn bộ hướng dẫn với mục tiêu triển khai, các đầu vào cần thiết và các kiểm tra chấp nhận. Giữ các ví dụ mã, bảng và liên kết tài liệu cùng nhau.
Sẵn sàng cho dự án của bạn, ở định dạng bạn cần.
Đã cập nhật
Bạn sẽ xây dựng một kết nối mà khách hàng của bạn có thể hiểu: tài khoản ShareAI của họ, bản nháp chuẩn bị AI tùy chọn và một lộ trình rõ ràng quay lại cuộc hẹn của họ.
Nơi bạn sẽ làm việc Ví dụ hoàn chỉnh của bạn
Kết nối ứng dụng của bạn với ShareAI Builder, từ đăng ký đến tích hợp đã được kiểm tra sẵn sàng để xem xét. Hướng dẫn này sử dụng JamZY, một ứng dụng cuộc hẹn Node.js nhỏ, để hiển thị từng bước: đăng ký ứng dụng, cấu hình nền tảng Web của nó, kết nối tài khoản ShareAI của khách hàng và gửi yêu cầu AI được ủy quyền. Áp dụng các bước tương tự cho sản phẩm của riêng bạn.
| Khả năng | Những gì khách hàng đồng ý | Những gì JamZY chứng minh |
|---|---|---|
| Đăng nhập với ShareAI | Một kết nối tài khoản và thông tin nhận dạng mà ứng dụng của bạn yêu cầu. | Danh tính khách hàng riêng tư từ thông tin Người dùng đã xác thực. |
| Thanh toán với ShareAI · Sử dụng AI | Sử dụng tài khoản cá nhân hoặc tổ chức được khách hàng chọn để suy luận được ủy quyền. | Bản nháp chuẩn bị cuộc hẹn được tài trợ bởi các tín dụng đủ điều kiện của tài khoản đó. |
| Builder đánh dấu | Phí sử dụng AI bổ sung trong hợp đồng ứng dụng đã được chấp nhận. | Kiếm tiền từ việc sử dụng tùy chọn, sau khi được phê duyệt và công bố hợp đồng. |
| Thanh toán sản phẩm | Một giao dịch mua cụ thể được trình bày trong phần thanh toán ShareAI riêng biệt. | Một phần mở rộng được giải thích trong hướng dẫn thanh toán. Bản demo cuộc hẹn không triển khai thanh toán. |
Có tài khoản ShareAI, quyền sử dụng tài khoản cá nhân hoặc tổ chức sẽ sở hữu ứng dụng, một callback HTTPS công khai, một logo, và các trang chính sách bảo mật, điều khoản và xóa tài khoản hoạt động. Để chạy ví dụ, sử dụng Node.js 22 hoặc mới hơn và một địa chỉ HTTPS cho ứng dụng của bạn.
Ảnh chụp màn hình sử dụng chi tiết ứng dụng ví dụ. ShareAI trong hướng dẫn này là địa chỉ sản xuất. Việc tạo chuẩn bị sẽ thực hiện một yêu cầu AI thực tế và có thể tiêu tốn tín dụng; việc chọn hoặc lưu một cuộc hẹn demo không làm điều này. Các kiểm tra xác minh được hoàn thành bởi các bài kiểm tra tích hợp thành công của riêng bạn.
Bạn có thể phân biệt đăng nhập tài khoản, tiêu thụ AI, phụ phí tùy chọn và một giao dịch mua sản phẩm đã được xác nhận. Đọc hướng dẫn này không yêu cầu một yêu cầu trả phí.
Bạn sẽ tạo danh tính Builder sở hữu ứng dụng của bạn và các mối quan hệ khách hàng của nó.
Nơi bạn sẽ làm việc Console → Chương trình Builder
Builder Program mở cho chủ sở hữu dự kiến và cung cấp Ứng dụng mới. Quyết định ghi danh, đánh giá ứng dụng, đánh giá thông tin công khai và phê duyệt Monetization Gateway là các bước riêng biệt.
Bạn sẽ cung cấp cho JamZY hồ sơ ứng dụng riêng của nó, để danh tính, quyền truy cập và các điều khoản thương mại của nó được giữ cùng nhau.
Nơi bạn sẽ làm việc Chương trình Builder → Sản phẩm → Ứng dụng mới
Sử dụng một trang web công khai có thể truy cập được cho hồ sơ ứng dụng. Một trang web riêng tư hoặc chỉ cục bộ có thể không vượt qua xác thực ngay cả khi callback phát triển của bạn đã được đăng ký đúng cách. Ứng dụng mới bắt đầu ở trạng thái nháp. Bạn có thể tiếp tục chỉnh sửa mà không cần công khai. Mã định danh ứng dụng của nó khác với OAuth client ID hoặc subscription ID.
JamZY xuất hiện dưới mục Product dành cho chủ sở hữu dự kiến. Không tạo thêm ứng dụng cho mỗi nền tảng thiết bị.
Bạn sẽ nhận được các tùy chọn OAuth phù hợp với nơi ứng dụng của bạn chạy và ai kiểm soát thông tin xác thực của nó.
Nơi bạn sẽ làm việc Ứng dụng mới → Thiết lập ứng dụng
Đối với một triển khai JamZY mà bạn tự vận hành, hãy chọn mô hình định giá phù hợp với dịch vụ của bạn, SaaS, ứng dụng đám mây do nhà cung cấp lưu trữ, khách hàng tự thanh toán cho mức tiêu thụ của họ, và ShareAI cho các yêu cầu AI. Đây là các câu trả lời ví dụ, không phải yêu cầu cho mọi sản phẩm.
| Nơi ứng dụng chạy | Lựa chọn OAuth | Nơi lưu trữ thông tin xác thực |
|---|---|---|
| Backend do bạn lưu trữ | Máy chủ web client có thể sử dụng một client secret. PKCE vẫn được áp dụng. | Secret và token được giữ trên máy chủ của bạn. |
| Ứng dụng trình duyệt / SPA | Web client công khai với PKCE. | Không có client secret được nhúng. Sử dụng thiết kế phiên trình duyệt hoặc backend phù hợp. |
| Phân phối tự lưu trữ hoặc kết hợp | Web client công khai với PKCE theo chính sách onboarding. | Không phân phối một vendor secret dùng chung cho các cài đặt của khách hàng. |
| Windows, macOS, Linux, Android hoặc iOS | Một Web client công khai cho mỗi nền tảng được kích hoạt. | PKCE và lưu trữ an toàn phù hợp với nền tảng; không có secret được đóng gói. |
Mẫu tải xuống JamZY cố ý sử dụng một Web client công khai với PKCE, mặc dù nó có một backend nhỏ. Máy chủ giữ token ngoài bộ nhớ trình duyệt. Một câu trả lời do nhà cung cấp lưu trữ cho phép một server client; nó không bắt buộc bạn phải chọn một cái.
Bạn có thể xem lại các câu trả lời đã lưu trong Thông tin Ứng dụng → Thiết lập ứng dụng. Các thay đổi triển khai có thể loại bỏ các client secret không tương thích và yêu cầu xác minh lại. Xem xét tác động đó trước khi lưu.
Triển khai đã lưu mô tả kiến trúc thực tế của bạn. Tùy chọn client-secret tuân theo câu trả lời đó; một tùy chọn bị vô hiệu hóa là giải thích chính sách, không phải thiếu thông tin xác thực.
Bạn sẽ cung cấp cho khách hàng các chi tiết sản phẩm và chính sách họ cần trước khi họ quyết định kết nối.
Nơi bạn sẽ làm việc Thông tin Ứng dụng
Mở Thông tin Ứng dụng sau Dashboard. Làm việc qua các phần chuyên dụng: chi tiết, thiết lập ứng dụng, trình bày, thương hiệu, thư viện và đánh giá. Cung cấp cho sản phẩm một mô tả hữu ích, một trang web chính xác và ảnh chụp màn hình rõ ràng về quy trình làm việc của khách hàng.
Sử dụng danh tính ứng dụng của riêng bạn. Thương hiệu ShareAI thuộc về nút tích hợp và tài liệu giải thích; nó không nên thay thế logo sản phẩm của bạn. Giữ các liên kết về quyền riêng tư, điều khoản và xóa có thể truy cập mà không cần đăng nhập.
Lưu thay đổi khi hành động lưu nổi xuất hiện. Đề xuất thông tin công khai có phần đánh giá riêng; chỉnh sửa một đề xuất đã được phê duyệt không thay thế âm thầm bản trình bày công khai đang hoạt động.
Một khách truy cập có thể hiểu JamZY làm gì, ai vận hành nó, và cách yêu cầu xóa. Chi tiết công khai và cấu hình callback đề cập đến cùng một sản phẩm.
Bạn sẽ yêu cầu quyền truy cập mà trải nghiệm cuộc hẹn của bạn thực sự sử dụng và làm rõ mục đích thanh toán của nó.
Nơi bạn sẽ làm việc Ứng dụng → Trường hợp sử dụng
Trong Trường hợp sử dụng, kích hoạt Đăng nhập với ShareAI để kết nối tài khoản và Pay with ShareAI cho luồng được tài trợ bởi khách hàng mà bạn dự định hỗ trợ. Yêu cầu quyền truy cập Monetization Gateway chỉ khi sản phẩm của bạn sẽ kiếm thêm phí từ việc sử dụng AI. Theo dõi trạng thái phê duyệt hiển thị trong Console.
| Phạm vi | Tại sao bạn sẽ yêu cầu nó |
|---|---|
openid | Kết nối một tài khoản bằng danh tính được giới hạn phạm vi của nó. |
profile / email | Chỉ yêu cầu các yêu cầu hồ sơ hoặc email nếu sản phẩm của bạn cần chúng. |
inference | Gọi các endpoint suy luận AI được hỗ trợ khi được phép bởi cấu hình ứng dụng. |
monetization_gateway | Sử dụng thỏa thuận thanh toán AI được khách hàng chấp nhận cho suy luận có phụ phí. |
payments | Tạo và kiểm tra các yêu cầu thanh toán của khách hàng. Mỗi giao dịch mua vẫn cần xác nhận. |
Các yêu cầu JamZY openid profile inference monetization_gateway. Nó không yêu cầu payments và không bán một sản phẩm thông qua thanh toán. Việc bật một khả năng trong Console không cấp nó cho một token truy cập hiện có: khách hàng phải ủy quyền các phạm vi và điều khoản.
Các khả năng, phạm vi được cấu hình và yêu cầu ủy quyền phải đồng nhất. Tránh yêu cầu quyền truy cập tùy chọn mà ứng dụng của bạn không bao giờ sử dụng hoặc không thể xác minh.
Bạn sẽ tạo một khách hàng Web cho trải nghiệm JamZY dựa trên trình duyệt, với phương thức xác thực phù hợp.
Nơi bạn sẽ làm việc Cài đặt OAuth → Web
Các nền tảng khác nhau có thông tin xác thực và quy tắc callback khác nhau. Chúng không phải là các sản phẩm riêng biệt: đăng ký và quản lý khách hàng được tổng hợp cho ứng dụng. Người kiểm tra ứng dụng được chia sẻ trên các nền tảng, với tối đa năm vị trí bao gồm các lời mời đang chờ xử lý; chủ sở hữu không tiêu tốn một vị trí kiểm tra.
Chính xác một nền tảng Web tồn tại. Các nền tảng gốc mà bạn chưa cấu hình không chặn việc ra mắt của bạn.
Bạn sẽ đưa khách hàng quay lại ứng dụng của mình sau khi ủy quyền, sử dụng một callback chính xác mà bạn sở hữu.
Nơi bạn sẽ làm việc Web → Cấu hình
Trong Web → Cấu hình, đăng ký callback HTTPS chính xác mà ứng dụng của bạn xử lý. Hướng dẫn này sử dụng https://jamzy.example/oauth/callback làm ví dụ. Thay thế jamzy.example bằng tên miền HTTPS nơi bạn triển khai bản sao của JamZY, và sử dụng cùng callback đó trong cấu hình ứng dụng của bạn.
Cung cấp tên màn hình đồng ý, điều khoản, thông tin quyền riêng tư và xóa. Chỉ bật các phạm vi bạn cần, sau đó lưu. Scheme, host, path và các chi tiết truy vấn áp dụng phải khớp với yêu cầu ủy quyền và trao đổi mã. Không sử dụng ký tự đại diện hoặc đoạn URL.
| Nền tảng | Callback để triển khai |
|---|---|
| Web | Địa chỉ HTTPS chính xác trên ứng dụng của bạn. |
| Android | Một app scheme đảo ngược tên miền khớp với ID ứng dụng, hoặc một HTTPS App Link đã được xác minh với gói và dấu vân tay ký SHA-256. |
| iOS | Một app scheme khớp, hoặc một HTTPS Universal Link đã được xác minh với bundle ID và tiền tố Apple App ID. |
| Windows / macOS / Linux | Một callback HTTPS chính xác được phép, một app scheme đảo ngược tên miền khớp, hoặc một loopback redirect được hỗ trợ trên 127.0.0.1 / [::1]. Cổng loopback có thể thay đổi. |
Các ứng dụng đã cài đặt ủy quyền trong trình duyệt hệ thống và trả về qua callback đã đăng ký. Đối với các liên kết ứng dụng HTTPS đã được xác nhận, hãy xuất bản tệp liên kết yêu cầu và chạy xác minh liên kết trong Console. Một callback trông có vẻ hợp lý trong một biểu mẫu không phải là bằng chứng rằng ứng dụng đã cài đặt của bạn nhận được nó.
Mở callback thông qua luồng ủy quyền sẽ trả về ứng dụng của bạn. Một mã ngẫu nhiên hoặc trạng thái không khớp sẽ bị từ chối.
Bạn sẽ có giao diện cuộc hẹn và kết nối ShareAI của nó chạy với các định danh ứng dụng của riêng bạn.
Nơi bạn sẽ làm việc Ứng dụng của bạn → Cấu hình môi trường
JamZY là một ứng dụng cuộc hẹn với một trợ lý chuẩn bị AI tùy chọn. Bộ lập lịch của nó chỉ là một trình diễn trên trình duyệt: không có nhà cung cấp lịch, gửi email hoặc thanh toán cuộc hẹn. Tích hợp ủy quyền ShareAI và API AI sử dụng upstream thực đã được cấu hình.
Tải xuống Tham khảo nguồn JamZY. Nó chứa máy chủ Node, giao diện người dùng trình duyệt, các bài kiểm tra và README thiết lập; không có chứng chỉ, bí mật, phụ thuộc hoặc phiên. Xem xét các tệp trước khi chạy chúng. Đặt quy trình Node phía sau một HTTPS reverse proxy bảo toàn nguồn gốc công khai.
# .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.mjsTạo ứng dụng của bạn tại console.shareai.bây giờ. Sử dụng ID khách hàng sản xuất của nó với https://auth.shareai.now và https://api.shareai.now/api/v1. Địa chỉ jamzy.example là một placeholder cho ứng dụng của bạn, không phải là một bản demo được lưu trữ. Phục vụ ứng dụng của riêng bạn qua HTTPS để cookie phiên Bảo mật của nó hoạt động.
JamZY cũng cung cấp một kết nối API-key để so sánh. Hướng dẫn này sử dụng nút ví/OAuth. Một API key không thiết lập thỏa thuận OAuth JamZY của khách hàng và không thay thế cho luồng ủy quyền của khách hàng.
Ứng dụng tải qua HTTPS. Nguồn gốc công khai, callback đã đăng ký và ID khách hàng của nó khớp với đăng ký của bạn. Không có token hoặc bí mật nào xuất hiện trong mã nguồn trang hoặc localStorage.
Bạn sẽ để khách hàng chọn tài khoản ShareAI của họ và phê duyệt quyền truy cập mà ứng dụng của bạn cần.
Nơi bạn sẽ làm việc JamZY → Thanh toán bằng Ví ShareAI của bạn
Từ JamZY, chọn Thanh toán bằng Ví ShareAI của bạn. Ứng dụng mở trang ủy quyền ShareAI. Khách hàng đăng nhập, chọn tài khoản cá nhân hoặc tổ chức, kiểm tra ứng dụng và quyền truy cập được yêu cầu, và chấp nhận các điều khoản đăng ký áp dụng.
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.Khóa bản ghi khách hàng cục bộ bằng phạm vi client đã xác thực sub và ngữ cảnh issuer/client của nó. Các ủy quyền cá nhân và tổ chức có thể chọn các tài khoản thanh toán khác nhau. Một ID khách hàng không phải là một ID người dùng toàn cầu, địa chỉ email hoặc ID cơ sở dữ liệu tổ chức nội bộ. Không hợp nhất danh tính trên các nền tảng bằng cách khớp tên hiển thị.
Hủy bỏ, trạng thái không khớp, mã được phát lại và ủy quyền hết hạn sẽ thất bại an toàn. Luồng bình thường trả về một tài khoản đã xác thực mà không tiết lộ các token của nó.
Bạn sẽ giữ các yêu cầu được ủy quyền hoạt động khi các token hết hạn, đồng thời cung cấp cho khách hàng một cách đáng tin cậy để ngắt kết nối.
Nơi bạn sẽ làm việc Ứng dụng của bạn → Xử lý phiên và token
| Thông tin xác thực | Mục đích | Cách xử lý |
|---|---|---|
| Mã ủy quyền | Chuyển giao một lần từ trang ủy quyền. | Trao đổi một lần, sử dụng verifier và callback tương ứng. Nó không phải là một API token. |
| Mã truy cập | Ủy quyền các cuộc gọi API trong phạm vi và quyền đã chấp nhận. | Gửi dưới dạng Authorization: Bearer …. Tôn trọng thời hạn và lỗi ủy quyền điểm cuối. |
| Mã làm mới | Nhận các access token thay thế mà không cần đăng nhập lại trong khi quyền vẫn còn hiệu lực. | Lưu trữ an toàn. Tuần tự hóa các hoạt động làm mới và thay thế đồng thời thông tin xác thực đã xoay vòng. |
| Mã ID | Một khẳng định danh tính OpenID Connect cho client. | Nếu bạn sử dụng nó, xác thực chữ ký, issuer, audience, thời hạn và nonce nếu áp dụng. Không sử dụng nó như một Bearer token suy diễn. |
| Bí mật máy khách | Xác thực một server client bảo mật được phép. | Lưu trữ trên server. Nó khác với tất cả các token và không bao giờ được đóng gói trong một client công khai. |
# 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"Sử dụng expires_in được trả về thay vì tự tạo thời hạn. Nếu refresh trả về một refresh token thay thế, lưu trữ nó cùng với access token mới như một bản cập nhật. Cho phép một lần refresh đang thực hiện trên mỗi phiên để các yêu cầu đồng thời không sử dụng lại một token đã xoay vòng. Một quyền refresh không hợp lệ hoặc bị thu hồi yêu cầu kết nối lại; không lặp lại vô hạn.
Làm mới không thể thêm phạm vi hoặc âm thầm chấp nhận hợp đồng Monetization Gateway mới. Gửi khách hàng qua ủy quyền lại để có quyền hoặc điều khoản mới. JamZY chỉ lưu trữ thông tin xác thực trong bộ nhớ máy chủ tối đa một giờ cho phiên bản demo, xác thực thông tin Người dùng thay vì tin tưởng vào mã thông báo ID chưa được xác minh và sử dụng cookie Bảo mật, HttpOnly, SameSite. Một dịch vụ sản xuất cần thiết kế phiên bản bền vững và được bảo vệ riêng.
Khi ngắt kết nối, thu hồi thông tin xác thực làm mới/truy cập nếu có thể và xóa phiên ứng dụng. Chỉ xóa cookie trình duyệt không thu hồi quyền ShareAI hoặc hủy đăng ký trả phí. Tránh ghi nhật ký mã, mã thông báo, bí mật hoặc nội dung nhắc nhở cá nhân.
Hết hạn kích hoạt một lần làm mới có kiểm soát; mã thông báo mới thay thế mã cũ. Ngắt kết nối xóa phiên ứng dụng và báo cáo bất kỳ lỗi thu hồi nào.
Bạn sẽ biến mục tiêu cuộc hẹn thành một chương trình nghị sự và các câu hỏi hữu ích, với một yêu cầu AI được tài trợ rõ ràng bởi khách hàng.
Nơi bạn sẽ làm việc Các Mô Hình Có Sẵn → JamZY → Hãy chuẩn bị kỹ lưỡng
Mở Các Mô Hình Có Sẵn trong ứng dụng. Chọn các mô hình và nhà cung cấp mà sản phẩm của bạn sẽ cung cấp và lưu cấu hình. Nếu danh mục không thể tải, hãy giải quyết lỗi khả dụng từ nguồn trước khi tiếp tục; việc thay đổi khách hàng OAuth liên tục sẽ không sửa chữa được lỗi này.
JamZY chỉ tải danh mục của nó sau khi kết nối. Chọn một mô hình văn bản được phép, nhập một mục tiêu cuộc hẹn ngắn và chọn Tạo chuẩn bị một cách cẩn thận. Tài khoản được chọn cần có tín dụng hợp lệ và bất kỳ điều khoản thanh toán AI nào được chấp nhận. Việc chọn ngày, xem xét một cuộc hẹn và lưu nó không gửi yêu cầu suy luận.
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}'Một sản phẩm lập lịch thực sự cần một kho lưu trữ đặt lịch phía máy chủ, kiểm tra tính khả dụng, xử lý múi giờ, chính sách hủy và tích hợp lịch hoặc thông báo. Những điều này tách biệt với ủy quyền ShareAI. Giữ đầu ra AI như một đề xuất; xác thực bất kỳ hành động đặt lịch trong tương lai nào thông qua các quy tắc ứng dụng của riêng bạn.
Sử dụng một model slug được trả về bởi danh mục được phép. Xử lý hợp đồng phản hồi thực tế: JamZY hỗ trợ ShareAI nguyên bản message.content phong bì và kiểu OpenAI choices[0].message.content. HTTP 200 với phản hồi lỗi không đầy đủ hoặc lồng ghép không phải là phản hồi thành công.
Khi gặp phản hồi giới hạn chi tiêu hoặc tín dụng không đủ, hiển thị một giải thích hữu ích và liên kết thanh toán khách hàng được cung cấp. Bảo toàn tài khoản đã chọn. Không vượt qua giới hạn, thay đổi người trả tiền một cách âm thầm hoặc thử lại một thao tác bị tính phí trong vòng lặp.
Tạo chuẩn bị trả về một lịch trình sử dụng và câu hỏi. Yêu cầu được gán cho khách hàng và ứng dụng được ủy quyền, với model đã chọn và các điều khoản được chấp nhận. Bản nháp AI không thể đặt hoặc thay đổi một cuộc hẹn.
Bạn sẽ giải thích phí AI bổ sung của mình trong một đề nghị đăng ký và công bố các điều khoản mà khách hàng có thể chấp nhận.
Nơi bạn sẽ làm việc Ứng dụng → Đăng ký
Yêu cầu quyền truy cập Monetization Gateway thông qua Trường hợp sử dụng của ứng dụng nếu nó chưa được phê duyệt bởi chính sách quản trị áp dụng. Hoàn thành bảng câu hỏi và theo dõi trạng thái của nó. Phê duyệt cho phép cấu hình; sự cho phép của khách hàng và sự đồng ý thanh toán vẫn là các quyết định riêng biệt.
Chỉ ví dụ: một đánh dấu 20% Builder trên €1.00 của chi phí mạng đủ điều kiện thêm €0.20. Ở mức giá Tiêu chuẩn, phí ShareAI của 5% chỉ áp dụng cho đánh dấu €0.20 đó, trước bất kỳ Sự kiện Nhập liệu nào có thể tính phí. Sử dụng công cụ ước tính trực tiếp và hợp đồng đã được chấp nhận để tính toán thực tế. Một ưu đãi đăng ký trong luồng này là một thỏa thuận thanh toán AI; kết nối tài khoản một mình không ghi nợ một mức giá cố định định kỳ.
surcharge cho đề nghị này.Màn hình đồng ý ShareAI là cơ quan có thẩm quyền đối với các điều khoản đã được chấp nhận. Khách hàng công khai của JamZY không thể suy luận kế hoạch thanh toán đã được chấp nhận từ thông tin Người dùng, vì vậy bảng kết nối của nó không tuyên bố đăng ký đang hoạt động hoặc tạo ra giá cho cuộc hẹn.
Ưu đãi giải thích phí; hợp đồng có thể được khách hàng chấp nhận. Bạn hiểu khách hàng nào vẫn giữ các điều khoản cũ và lý do tại sao.
Bạn sẽ thu thập điểm cuối thực và kiểm tra phạm vi cần thiết để gửi ứng dụng của mình để xem xét.
Nơi bạn sẽ làm việc Cài đặt OAuth → Người kiểm tra và Xác minh
Mở cài đặt OAuth → Người kiểm tra và mời tối đa năm người kiểm tra toàn ứng dụng. Lời mời đang chờ xử lý tiêu tốn một vị trí nhưng không cấp quyền truy cập; người nhận phải chấp nhận. Quyền truy cập của chủ sở hữu và quyền truy cập của người kiểm tra được mời khác với quyền truy cập sản xuất công khai.
Đối với mỗi nền tảng bạn dự định xuất bản, mở Xác minh. Hoàn thành các cuộc gọi thành công thực sự cho các điểm cuối yêu cầu và mọi phạm vi đã cấu hình. Kiểm tra các khóa khám phá và ký; kiểm tra ủy quyền/hoàn lại, trao đổi mã, làm mới, thông tin Người dùng đã xác thực và thu hồi. Các khách hàng bí mật cũng phải kiểm tra introspection áp dụng. Các liên kết HTTPS đã được tuyên bố cần xác minh liên kết.
Một phạm vi hồ sơ/email cần các thông tin trả về thực tế; sử dụng tài khoản thử nghiệm cá nhân nơi email là bắt buộc. Các phạm vi inference và monetization_gateway cần một yêu cầu AI được ủy quyền hoàn tất. Thanh toán cần một cuộc gọi API thanh toán được định phạm vi thành công. Một phản hồi HTTP thành công chung chung, ảnh chụp màn hình trình duyệt hoặc danh sách kiểm tra thủ công không thay thế được các kiểm tra được ghi lại trong Console.
Bạn có ba lựa chọn cho một nền tảng chưa hoàn thành: hoàn thành và xác minh nó, loại trừ nó khỏi xuất bản để nó chỉ dành cho chủ sở hữu/người kiểm tra, hoặc xóa nó. Không bao gồm một nền tảng với các điểm cuối hoặc phạm vi mà bạn chưa thực hiện. Thay đổi cấu hình có thể làm mất hiệu lực các kiểm tra, vì vậy hãy làm mới trạng thái đã ghi nhận sau khi bạn thực hiện các thay đổi cuối cùng.
Mỗi nền tảng được bao gồm hiển thị cấu hình yêu cầu, điểm cuối và các kiểm tra phạm vi là hoàn thành. Danh sách kiểm tra cá nhân của hướng dẫn chỉ là một công cụ đọc.
Bạn sẽ biết điều gì đã sẵn sàng để xem xét, cách hoạt động của việc xuất bản và nơi theo dõi quyền truy cập của khách hàng sau đó.
Nơi bạn sẽ làm việc Ứng dụng → Bảng điều khiển
Thử toàn bộ quy trình lại với một khách hàng đủ điều kiện sau khi khởi chạy: kết nối, kiểm tra tài khoản và sự đồng ý, tạo một bản nháp chuẩn bị cuộc hẹn ngắn, làm mới an toàn, xử lý lỗi thanh toán, sau đó ngắt kết nối. Xác minh trải nghiệm người dùng trực tiếp thay vì giả định rằng việc lưu thành công chứng minh nó hoạt động.
Không khớp cuộc gọi lại: so sánh URL đã đăng ký và cả hai giá trị yêu cầu một cách chính xác. Người kiểm thử không được phép: xác nhận chấp nhận lời mời và tài khoản đã chọn. Thiếu phạm vi hoặc hợp đồng: chỉ yêu cầu quyền truy cập đã được kích hoạt và kết nối lại để chấp nhận. Không có mô hình: kiểm tra Các Mô Hình Có Sẵn và các hạn chế của nhà cung cấp. Lỗi làm mới: xóa phiên cục bộ bị lỗi và kết nối lại. Xem xét bị chặn: kiểm tra các kiểm tra nền tảng thay vì tạo một OAuth client khác.
Ứng dụng hoạt động cho khách hàng dự định, các kiểm tra đã ghi nhận hỗ trợ trạng thái xuất bản của nó, và khách hàng có thể kiểm soát hoặc thu hồi quyền ủy quyền.
Chọn tài khoản cá nhân hoặc tổ chức sẽ sở hữu việc đăng ký chương trình trước khi nộp đơn. Các tổ chức có thể gửi đơn đăng ký trước khi xác minh, nhưng chỉ riêng việc phê duyệt của nhân viên không kích hoạt quyền truy cập. Hoàn thành xác minh email tổ chức và công ty từ danh sách kiểm tra giới thiệu trong Console. Một tổ chức được phê duyệt vẫn ở trạng thái Đang chờ xác minh cho đến khi cả hai bước kiểm tra được hoàn thành. Builder, Nhà cung cấp và các chương trình Creator tuân theo quy tắc này.
Xem Monetization Gateway giá cả · Khám phá ShareAI for Startups · Phạm vi và quyền
Điều khoản & Điều kiện, Chính sách Quyền riêng tư và hướng dẫn xóa công khai của bạn phải khớp với ứng dụng và vẫn có thể truy cập được mà không cần đăng nhập. Việc chấp nhận chương trình ShareAI, phê duyệt Monetization Gateway, quyền OAuth của khách hàng và hợp đồng thanh toán được chấp nhận là các quyết định riêng biệt. Làm mới không thể thêm quyền hoặc chấp nhận các điều khoản thương mại mới.
Phạm vi surcharge cũ vẫn được chấp nhận cho các tích hợp hiện có. Các ví dụ mới sử dụng monetization_gateway. Giữ nguyên các trường dây hiện có như surcharge_bps và surcharge_percentage.
Xem Monetization Gateway giá cả · Khám phá ShareAI for Startups · Phạm vi và quyền
Phí tiêu chuẩn 5% của Builder markup. Đối với €2.00 chi phí mạng AI và một 10% markup, khách hàng trả €2.20. ShareAI nhận được €0.01 của €0.20 markup; Builder có €0.19 trước Event Ingestion.
Lần đầu tiên 1,000 yêu cầu Sản xuất đã được giải quyết Monetization Gateway miễn phí mỗi tháng dương lịch (UTC), được chia sẻ trên tài khoản Builder. Các yêu cầu bổ sung có giá €0.04 mỗi 1,000 trước khi áp dụng các khoản giảm giá đủ điều kiện. Một yêu cầu đã được giải quyết tạo ra một sự kiện.
Pay with ShareAI tự nó, chỉ truy cập inference, các khóa API tài khoản thông thường và lưu lượng Staging hoặc thử nghiệm không phát sinh Monetization Gateway Event Ingestion.
ShareAI for Startups cung cấp một khoản trợ cấp hàng tháng chung cho các phí thực tế ShareAI trên một ứng dụng đã được phê duyệt. Các cấp độ hiện tại Launch, Growth và Momentum liệt kê €1,000, €5,000 và €10,000 mỗi tháng. Cùng một ngân sách bao gồm phí phần trăm của ShareAI trên Builder markup và nhập sự kiện có thể tính phí cùng nhau. Đây không phải là khoản trợ cấp markup tổng, hạn ngạch sự kiện miễn phí riêng biệt hoặc AI miễn phí inference. 1.000 sự kiện miễn phí đầu tiên của tài khoản 1,000 không tiêu thụ khoản trợ cấp này.
Phí nhập sự kiện còn lại được thanh toán từ thu nhập mới của yêu cầu Builder, sau đó là thu nhập AI khả dụng Builder và tín dụng AI không bị hạn chế. Phí AI của khách hàng và sản phẩm payments vẫn tách biệt.
ShareAI có thể phê duyệt phí cụ thể cho ứng dụng hoặc hỗ trợ phí trong một khoảng thời gian cố định hoặc cho đến khi thay đổi. Xem xét giá hiện tại của ứng dụng và các Chương trình Đặc biệt trong Console để biết các điều khoản đã được phê duyệt, hiệu lực và khoản trợ cấp đã tiêu thụ. Thay đổi cấp độ hoặc ghi đè giá không đặt lại mức sử dụng hàng tháng của ứng dụng.
Launch giữ tùy chọn Đăng nhập với ShareAI. Growth và Momentum yêu cầu điều này; Momentum cũng yêu cầu huy hiệu chính thức ShareAI for Startups trong chân trang ứng dụng. ShareAI kiểm tra huy hiệu hàng tuần. Các nỗ lực đã được xác nhận để vượt qua yêu cầu có thể dẫn đến hạ cấp, loại bỏ khỏi Chương trình Startup hoặc rút khỏi Marketplace theo các điều khoản chương trình đã chấp nhận.
Mức giá doanh nghiệp được cấu hình bởi nhóm ShareAI cho tài khoản Builder sau khi đồng ý một đề nghị cá nhân hóa. Tỷ lệ phần trăm được chỉ định và mức phí sự kiện áp dụng cho các yêu cầu trong tương lai.
Xem Monetization Gateway giá cả · Khám phá ShareAI for Startups · Phạm vi và quyền