ウェブリンクを作成

curl -i -X POST "https://api.box.com/2.0/web_links" \ -H "authorization: Bearer <ACCESS_TOKEN>" \ -H "content-type: application/json" \ -d '{ "name": "Cloud Content Management", "url": "https://box.com", "parent": { "id": "0" } }'

{ "id": "11446498", "type": "web_link", "etag": "1", "url": "https://www.example.com/example/1234", "sequence_id": "3", "name": "My Bookmark", "parent": { "id": "12345", "type": "folder", "etag": "1", "sequence_id": "3", "name": "Contracts" }, "description": "Example page", "path_collection": { "total_count": 1, "entries": [ { "id": "12345", "type": "folder", "etag": "1", "sequence_id": "3", "name": "Contracts" } ] }, "created_at": "2012-12-12T10:53:43-08:00", "modified_at": "2012-12-12T10:53:43-08:00", "trashed_at": "2012-12-12T10:53:43-08:00", "purged_at": "2012-12-12T10:53:43-08:00", "created_by": { "id": "11446498", "type": "user", "name": "Aaron Levie", "login": "ceo@example.com" }, "modified_by": { "id": "11446498", "type": "user", "name": "Aaron Levie", "login": "ceo@example.com" }, "owned_by": { "id": "11446498", "type": "user", "name": "Aaron Levie", "login": "ceo@example.com" }, "shared_link": { "url": "https://www.box.com/s/vspke7y05sb214wjokpk", "effective_access": "company", "effective_permission": "can_download", "is_password_enabled": true, "download_count": 3, "preview_count": 3, "download_url": "https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg", "vanity_url": "https://acme.app.box.com/v/my_url/", "vanity_name": "my_url", "access": "open", "unshared_at": "2018-04-13T13:53:23-07:00", "permissions": { "can_download": true, "can_preview": true, "can_edit": false } }, "item_status": "active" }

承認

Authorization

string

header

必須

The access token received from the authorization server in the OAuth 2.0 flow.

ボディ

application/json

url

string

必須

このウェブリンクのリンク先となるURL。"http://"または"https://"で始まっている必要があります。

例:

"https://box.com"

parent

object

必須

ウェブリンクの作成先となる親フォルダ。

Show child attributes

name

string

ウェブリンクの名前。設定されてない場合は、デフォルトでURLに設定されます。

例:

"Box Website"

description

string

ウェブリンクの説明。

例:

"Cloud Content Management"

レスポンス

新しく作成されたウェブリンクオブジェクトを返します。

ウェブリンクとは、URLを指すオブジェクトです。これらのオブジェクトはBoxウェブアプリケーション内ではブックマークとも呼ばれます。

ウェブリンクオブジェクトはファイルオブジェクトと同様に扱われ、通常のファイルに適用されるアクションの大部分もサポートしています。

string

必須

このウェブリンクの一意の識別子。

例:

"11446498"

type

enum<string>

必須

値は常にweb_linkになります。

利用可能なオプション:

web_link

例:

"web_link"

etag

string

このウェブリンクのエンティティタグ。If-Matchヘッダーで使用します。

例:

"1"

url

string

このウェブリンクが指すURL。

例:

"https://www.example.com/example/1234"

sequence_id

string | null

この項目に適用された最新のUser Eventを表す数値の識別子。

これをGET /eventsエンドポイントと組み合わせて使用すると、この識別子が読み取られる前に発生した可能性があるUser Eventを除外できます。

たとえば、Box DriveなどのアプリケーションがAPIを介して項目を取得し、その項目の変更に関連するUser Eventの発生を監視する場合などがこれに該当します。User Eventのsequence_idが最初に取得されたリソースのsequence_idよりも小さいか同じである場合、アプリケーションはそのようなUser Eventをすべて無視します。

例:

"3"

name

string

ウェブリンクの名前。

例:

"My Bookmark"

parent

フォルダ (Mini) · object

ウェブリンクが属する親オブジェクト。

Show child attributes

description

string

ウェブリンクに付加される説明。この説明は、Boxウェブアプリケーション内に表示されます。

例:

"Example page"

path_collection

パスのコレクション · object

ルートフォルダを起点にした、このウェブリンクを含むフォルダツリー。

Show child attributes

created_at

string<date-time>

このファイルがBoxのサーバー上に作成された日時。

例:

"2012-12-12T10:53:43-08:00"

modified_at

string<date-time>

このファイルがBoxサーバー上で最後に更新された日時。

例:

"2012-12-12T10:53:43-08:00"

trashed_at

string<date-time> | null

このファイルがごみ箱に移動された日時。

例:

"2012-12-12T10:53:43-08:00"

purged_at

string<date-time> | null

このファイルが完全に削除される日時。

例:

"2012-12-12T10:53:43-08:00"

created_by

ユーザー (Mini) · object

このウェブリンクを作成したユーザー。

Show child attributes

modified_by

ユーザー (Mini) · object

このウェブリンクを最後に変更したユーザー。

Show child attributes

owned_by

ユーザー (Mini) · object

このウェブリンクを所有するユーザー。

Show child attributes

shared_link

共有リンク · object

この項目の共有リンクオブジェクト。共有リンクがまだ作成されていない場合は、nullになります。

Show child attributes

item_status

enum<string>

この項目が削除されたかどうか。値には、active、trashed (ファイルがごみ箱に移動された場合)、deleted (ファイルが完全に削除された場合) があります。

利用可能なオプション:

active,

trashed,

deleted

例:

"active"

Documentation Index

承認

ボディ

レスポンス