請求 API

呼び出しプロジェクトのソース認識残高スナップショット。すべてのミリクレジット額は標準的な10進文字列です。これはスナップショットであり支払い権限ではありません；カード、税金、現金引き出しレールが利用不可の間は rails_available は false です。

呼び出しプロジェクトの不変の投稿済みジャーナルエントリーに対する安定したカーソルページネーション。保留は投稿済みエントリーではありません。修正は元のイベントへのリンクで書き換えません。この表面には任意の付与や支払いの変更はありません。

呼び出し元プロジェクトの 1 UTC か月間の使用状況。提供および受信したバイト（課金されることはありません）、支払者のプランの無料ストレージを超えて課金されるストレージ（allowance.storage_bytes）、ならびに月あたり無料の 10,000件にカウントされる API リクエスト、課金対象のプロジェクトストリームイベント、Webhook 配信の試行。自ら支払うプロジェクトは独自のプールを読み取ります。

別の支払者が支払うプロジェクトは、その支払者の他のプロジェクトとプールを共有します。自身のシェアを読み取り、payer は支払者を示します。支払者のプール合計は支払者の請求読み取りに残ります。

組織が screenRIG の iPhone と iPad のアプリ（バンドル ai.screenrig.app）から App Store を通じて購入できるもの、およびその購入に付くアカウントトークン。

有効な組織の指定管理者（プランと請求を管理する人）が必要です。スタッフと、組織の委任先リセラーの管理者は、products やトークンなしで購入オプションを読み取れます。それ以外の人には 404 not_found が返ります。

リセラーに委任されている組織には products が一覧されません。リセラーが組織のプランを支払うためです。account_token は、サーバーが組織ごとに1回作成して保持するランダムな UUID です。アプリはこれを appAccountToken として StoreKit に渡すので、すべてのトランザクションとサーバー通知が組織を特定します。

購入できない読み取り者に対しては、account_token はすべてゼロの UUID です。products には、呼び出し元が今購入できるプランが App Store 製品1つずつで並びます：plus、education（education_eligible が true の間のみ）、premium。education_eligible は、スタッフが K-12 の学校または学区を認証した場合、またはオファーを読み取る管理者の認証済みアカウントメールアドレスが K-12 学校ドメインのものである場合に true になります（education_eligibility_source が school_email）。そのような管理者がオファーを開くか取引を記録すると、組織は一度だけ対象となり、一致したドメインを記した組織の監査エントリが書き込まれ、同じオファーに Education が含まれます。

スタッフの判断は、どちらの結果であっても最終的なもので、自動判定で上書きされることはありません。

組織が別の経路（スタッフ、請求書払い、別のサブスクリプション）ですでに同じレベルまたは上位のプランを持っている場合、そのプランは提示されません。ただし、そのプランを保持している App Store サブスクリプションの本人には、サブスクリプショングループ内でプランを変更できるよう提示されます。products が空でないとき、can_purchase は true です。subscription は組織の App Store サブスクリプションで、ない場合は null です。

レスポンスは private かつ no-store です。

組織のために購入された StoreKit 2 の署名付きトランザクション（Transaction.jwsRepresentation）を1件記録し、組織をそのプランにします。有効な組織の指定管理者、同一オリジンの Cookie 認証、JWT セッションの場合は CSRF ヘッダーが必要です。

サーバーは、JWS を、x5c チェーンから Apple Root CA - G3（本番以外では Xcode の StoreKit テスト用ルートも）まで、バンドル ID ai.screenrig.app、製品 ID、環境（Production は本番のみ。App Review と TestFlight は本番に対してサンドボックスアカウントで購入するため、Sandbox はどこでも。Xcode は本番以外のみ）、そして appAccountToken が組織の account_token（getAppStoreOffer）と等しいことで検証します。リクエストには、誰が支払ったかを示すものはありません。

プランは、サブスクリプションの最新のトランザクションの製品に従います。上位のプランはすぐに適用され、下位のプランは、プラン変更と同様に、請求の次の UTC 月境界に達したときに適用されます。トランザクションまたはそれより古いものを再送しても何も変わらず、サブスクリプションは現状のまま返されます。期限切れのトランザクションは記録されますが、プランは変更されません。

アプリは、2xx または確定的な 4xx 問題の後にトランザクションを完了します。問題：app_store_transaction_invalid（422）、app_store_account_mismatch（409）、education_not_eligible（403）、app_store_plan_conflict（409）、billed_by_reseller（409。組織はリセラーに委任されており、リセラーがそのプランを支払います）。

Apple の App Store Server Notifications V2（signedPayload ボディ）。本番環境とサンドボックス環境について App Store Connect で設定する URL です。公開：署名付きペイロードが資格情報であり、recordAppStoreTransaction がトランザクションを検証するのと同じ方法で、その中の署名付きトランザクションと更新情報とともに検証されます。

SUBSCRIBED、DID_RENEW、DID_CHANGE_RENEWAL_PREF、DID_CHANGE_RENEWAL_STATUS（および OFFER_REDEEMED、RENEWAL_EXTENDED、REFUND_REVERSED）は最新のトランザクションを適用します。更新ではサブスクリプションが延長され、アップグレードではプランがすぐに変わり、ダウングレードでは下位の製品が期間終了時に更新されたときに変わります。

EXPIRED、GRACE_PERIOD_EXPIRED、REFUND、REVOKE はサブスクリプションを終了し、それが設定したプランを、請求がプランを削除するときと同じく、次の UTC 月境界で削除します。すでに付与されたものは取り戻しません。その後にスタッフまたは請求書払いで組織に設定されたプランが削除されることはありません。

それ以外のタイプ、プランではない製品の通知、組織を特定しない通知は、受理されてログに記録されます。200 は受理を示します。検証できないペイロードは 422 の app_store_transaction_invalid 問題になります。サーバー側の障害は 5xx で、Apple が再送します。クライアントアドレスごとに制限されます。