開発者向け SIGNATURUM

コンテンツ保護ワークフロー全体のための1つのAPI

検証可能なデポジット、不可視の透かし、管理されたファイル、安全な埋め込み、コピー監視、およびデスクトップライセンスを、バージョン管理された単一のインターフェースを通じて製品に追加します。

ベースURLhttps://signaturum.com/api/v1Billing runtime 2.1

保護から侵害の監視まで

APIは、Signaturumダッシュボードおよびデスクトップアプリケーションと同じ商用サービスを公開しながら、権限、使用状況、および請求を一元管理します。

SHA-256フィンガープリントを登録するか、サーバーサイドハッシュ用にファイルをアップロードします。記録ステータス、証明書参照、およびブロックチェーンのメタデータを取得します。

画像、動画、およびPDFを保護し、検出を実行し、非同期ジョブを監視して、完成した保護済みの結果をダウンロードします。

一元管理されたストレージの下で、ファイルのアップロード、一覧表示、プレビュー、ストリーミング、ダウンロード、および削除を行います（動画の長さやPDFページ数の制限付き）。

保存されたコンテンツを、視聴回数、帯域幅、ドメイン、同時実行、およびブランディングの権利を備えた制御された埋め込みとして使用します。

監視対象オブジェクトを作成し、スキャンを開始して、プランで制御された深さと頻度でジョブ、候補、アラート、およびサポートされているソースを取得します。

広範なアカウント権限を公開することなく、専用のスコープを通じてデスクトップアプリケーションのライセンスをアクティブ化し、検証します。

APIアクセスと製品の使用は意図的に分けられています。これにより、インフラストラクチャの負荷を、デポジット、透かしジョブ、ストレージ、クローラースキャンのビジネス価値とは独立して価格設定できます。

各リクエストは、そのサブスクリプションのすべてのキーで共有されるアクティブなAPIプランを使用します。分、日、月、同時実行、およびアップロードサイズの制限は中央で適用されます。

要求された操作は、製品パッケージ (deposit.records, watermark.generations, vault.*, embed.*, crawler.*) でも利用可能である必要があります。読み取り専用の呼び出しは、通常、APIリクエストのみを消費します。

値は Billing V2 で構成され、プランやアカウントのオーバーライドによって異なる場合があります。 /usage エンドポイントは、有効な制限と現在の消費量を返します。

api.requests_minuteサブスクリプション全体で現在の1分間に許可されるリクエスト。

api.requests_dayサブスクリプション全体で現在のUTC 1日に許可されるリクエスト。

api.requests_monthアクティブな請求期間に許可されるリクエスト。

api.concurrent_requests短いリースを使用して処理中の最大同時リクエスト数。

api.max_upload_bytes1回のアップロードで許容される本体/ファイルの最大サイズ。

キーのプレフィックスは環境を識別し、テスト用の認証情報が本番用と間違われるのを防ぎます。

アプリケーションごとに個別のキーを発行し、必要なアクションのみを許可します。従来の広いスコープも移行中は引き続き受け入れられます。

usage:readdeposit:readdeposit:writewatermark:readwatermark:protectwatermark:detectfiles:readfiles:writecrawler:readcrawler:writedesktop:license

GET /usage はAPIの制限と製品の残高を返すため、統合側では大規模なバッチ処理を開始する前に作業を延期したり、正確なアップグレードメッセージを表示したりできます。

GET /api/v1/usagecURL

curl https://signaturum.com/api/v1/usage \
  -H "Authorization: Bearer sg_live_YOUR_API_KEY" \
  -H "Accept: application/json"

スコープ付きのキーを作成し、サンドボックスでテストして、準備ができたら同じ統合を本番環境に移行します。