API

ファイルをマーク

Business または Enterprise ワークスペースのファイルをマークし、マークしたコピーをダウンロードします。

POST/api/v1/mark

ファイルをマークし、マークしたコピーを返します。本文は multipart/form-data です。

認証

Authorization: Bearer mf_…

このヘッダーを送ります。セッション Cookie はありません。curl と他のサーバークライアントは受け付けます。別のサイトのブラウザは拒否されます。

パラメーター

名前型必須説明
filefileはいマークするファイルです。Business と Enterprise は 100 MB、PDF 500 ページ、10 分までの動画を受け付けます。サイズ、長さ、ページ数はワークスペースのプランに従います。
identifierstringはい1〜32 文字で、制御文字は使えません。あとからこのコピーが検出されたときに見るラベルです。読める文字としてファイルには書かれません。

リクエスト

curl -X POST https://markedfile.com/api/v1/mark \
  -H "Authorization: Bearer mf_…" \
  -F "file=@contract.pdf" \
  -F "identifier=northwind"

レスポンス

{
  "file": "JVBERi0xLjQK…",
  "mime": "application/pdf",
  "name": "contract.pdf",
  "kind": "pdf",
  "layers": [
    {
      "name": "Metadata",
      "detail": "Authenticated workspace reference; the identifier stays on the server",
      "screenshot": "No",
      "crop": "No",
      "reencode": "No"
    }
  ],
  "remaining": 1
}

file はマークしたバイト列の base64 です。mime、name、kind はダウンロードを説明します。layers は適用された層を列挙します。プランに有効なファイルの上限がないとき、remaining はこのマークのあとの有効なファイル数です。上限があるとき、remaining は残りの新しいマーク数です。Business と Enterprise に上限はありません。ファイルを削除すると検出は終わります。

エラー

JSON 本文の error フィールドの文は英語です。

状態説明
400ファイルが空か、識別子が空、32 文字を超える、または制御文字を含みます。
401キーがない、失効している、または不明です。JSON 本文に "code": "api-key" が含まれます。
403ワークスペースに有効な Business または Enterprise プランがなくなりました（本文に "code": "enterprise" が含まれます）。またはブラウザが cross-site か same-site のリクエストを送りました。
413ファイルがプランのアップロード上限を超えているか、PDF のページ数がプランの上限を超えています。
422ファイルを処理できませんでした。
429このキーは現在の 1 分間に 40 件を超えるファイルをマークしました。

制限

このキーは 1 分に 40 リクエストです。カウンターは製品のデータベースに保存され、再起動後も残ります。