フォルダロックのリストを取得
指定したフォルダのフォルダロックの詳細を取得します。
このエンドポイントを使用するには、フォルダの所有者または共同所有者として認証されている必要があります。
リクエスト
bearer [ACCESS_TOKEN]
application/json
クエリパラメータ
stringクエリ内必須
"12345"フォルダを表す一意の識別子。
フォルダIDを確認するには、ウェブアプリケーションでこのフォルダにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/folder/123の場合、folder_idは123です。
Boxアカウントのルートフォルダは常にID 0で表されます。
レスポンス
application/jsonフォルダロック
フォルダに適用されたすべてのフォルダロックの詳細 (ロックの種類やロックを適用したユーザーを含む) を返します。
application/jsonクライアントエラー
Authorizationヘッダーで指定されているアクセストークンが認識されないか、指定されていない場合に返されます。
application/jsonクライアントエラー
フォルダが見つからない場合、またはユーザーにフォルダへのアクセス権限が与えられていない場合に返されます。
application/jsonクライアントエラー
folder_idが認識されていない形式で指定されている場合に返されます。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -i -X GET "https://api.box.com/2.0/folder_locks?folder_id=33552487093" \
-H "authorization: Bearer <ACCESS_TOKEN>"iOS
client.folders.listLocks(folderId: "22222") { results in
switch results {
case let .success(iterator):
for i in 1 ... 10 {
iterator.next { result in
switch result {
case let .success(folderLock):
print("- \(folderLock.id)")
case let .failure(error):
print(error)
}
}
}
case let .failure(error):
print(error)
}
}レスポンスの例
{
"entries": [
{
"folder": {
"id": "12345",
"etag": "1",
"type": "folder",
"sequence_id": "3",
"name": "Contracts"
},
"id": "12345678",
"type": "folder_lock",
"created_by": {
"id": "11446498",
"type": "user"
},
"created_at": "2020-09-14T23:12:53Z",
"locked_operations": {
"move": true,
"delete": true
},
"lock_type": "freeze"
}
],
"limit": 1000,
"next_marker": 3000,
"prev_marker": 1000
}