Content Capture用のREST API

添付の削除

delete

/capture/api/v1.1/documents/{docId}/attachments/{attId}

この操作は、docIdおよびattIdパラメータで指定された添付をキャプチャから削除します。

指定されたドキュメントへの添付が「愛着のある」でない場合、エラーになります。

ノート: このリクエストで使用されるOAuthトークンは、このドキュメントが存在するステップへの攻撃アクセス権を付与されたアカウントを表す必要があります。アカウントが「管理者の取得」または「ユーザーの取得」を表す場合、違いは発生しません。

リクエスト

サポートされているメディア・タイプ

application/json

パス・パラメータ

attId: string

取得内の添付の一意の識別子。
docId: string

取得内の文書の一意の識別子。

ヘッダー・パラメータ

X-Requested-With: string

クロスサイト・リクエスト・フォージェリ(CSRF)攻撃を防ぐために使用されるヘッダー。サポートされている値はXMLHttpRequestのみです。

これは、削除するattachmentを表します。添付オブジェクト全体を指定できますが、必要な属性はstateTokenのみです。削除操作を続行できることを確認する必要があります。

stateTokenの値は、削除対象の現在の状態である添付からの値である必要があります。 stateToken値が添付の現在のstateToken値と一致しない場合、削除操作によってエラーが発生します。

ルート・スキーマ : schema

型: object

Show Source

stateToken: string

添付の特定の状態を表す生成された文字列値。

一般に、添付の変更を続行できるようにするために使用されます。本質的に言っているのだ... 「現在のstateTokenがこの値と一致する場合は、この添付を削除」。値が一致しない場合、変更は許可されず、操作によってエラーが発生します。

{
    "type":"object",
    "properties":{
        "stateToken":{
            "type":"string",
            "description":"<p>A generated string value that represents a particular state of the attachment.</p>\n<p>In general, it is used to allow modifications of the attachment to proceed. It is essentially saying ...\n<u><i>delete this attachment if its current <code>stateToken</code> matches this value</i></u>. If the values do\nnot match, the modification is not permitted and the operation results in an error.</p>\n"
        }
    },
    "required":[
        "stateToken"
    ]
}

トップに戻る

レスポンス

サポートされているメディア・タイプ

application/json

204レスポンス

内容なし

400レスポンス

不正リクエスト

情報が欠落しているか無効であるため(入力フィールドでの検証エラー、必須値の欠落など)、リクエストを処理できませんでした。レスポンスは「エラーの詳細」オブジェクトになります。

403レスポンス

禁止

リクエストは有効で、認識されましたが、サーバーはアクションを拒否しています。これは、リソースに必要な権限がないアカウント、または禁止されたアクション(たとえば、1つのみが許可されている重複アイテムの作成)を試みていることが原因である可能性があります。レスポンスは「エラーの詳細」オブジェクトになります。

404レスポンス

Not Found

リクエストに、存在しないリソースURIが含まれています。レスポンスは「エラーの詳細」オブジェクトになります。

409レスポンス

競合

このレスポンスは、リクエストがターゲット・リソースの現在の状態と競合することを示します。レスポンスは「エラーの詳細」オブジェクトになります。

通常、412 (Precondition Failed)のエラー・レスポンスが返されます。ただし、「競合」は、リソースに同時編集がある場合に発生する可能性があります。

412レスポンス

Precondition Failed

サーバーはリクエストの前提条件を満たしていません。レスポンスは「エラーの詳細」オブジェクトになります。

このエラー・レスポンスは、リクエスト本文で使用されているstateTokenがリソースの現在のstateTokenと一致しない場合、特に使用されます。

500レスポンス

内部サーバー・エラー

サーバーで予期しない状態が発生し、リクエストを処理できませんでした。レスポンスは「エラーの詳細」オブジェクトになります。

トップに戻る

例

例1:

次の例は、添付を削除する方法を示しています。

curl -X DELETE -H 'Accept: application/json' 'https://host:port/content/capture/api/v1/documents/dcf65d45-4f53-4f82-998c-5e189de1b6a1/attachments/b22046ce-2c30-49b3-b734-25f62dea5403'

これにより、IDが'dcf65d45-4f53-4f82-998c-5e189de1b6a1'のドキュメントのIDが'b22046ce-2c30-49b3-b734-25f62dea5403'の添付が削除されます。

リクエスト本文

{
 "stateToken": "07d5b2e35b64a1d89bf18c4809f132d8"
}

トップに戻る