パブリック・リンクAPIカタログの取得
get
/documents/api/{version}/metadata-catalog/publiclinks
サポートされているサービスを含むpubliclinksリソースのメタデータ情報を返します。
リクエスト
サポートされるメディア・タイプ
- application/json
- application/xml
パス・パラメータ
- version: string
バージョン値
レスポンス
サポートされるメディア・タイプ
- application/json
- application/xml
200レスポンス
リクエストが処理されました。 サポートされるサービスへのリンクを含むパブリック・リンク・メタデータ。
例
次の例は、パブリック・リンク・リソースの情報を返します。
GET .../api/1.2/metadata-catalog/publiclinks
リクエスト・ヘッダー
なし。
リクエスト本文
なし。
HTTPステータス・コード
HTTP_STATUS = 200
JSONレスポンス
{
"$schema": "http://json-schema.org/schema#",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "file or folder identifier"
},
"type": {
"type": "String",
"description": "has value 'publiclink'"
},
"assignedUsers": {
"type": "String",
"description": "list of users or groups that can access this link"
},
"createdDate": {
"type": "string",
"description": "public link creation time"
},
"lastModifiedDate": {
"type": "string",
"description": "public link last modified time"
},
"expirationDate": {
"type": "string",
"description": "public link expiration time"
},
"linkID": {
"type": "string",
"description": "public link identifier"
},
"linkName": {
"type": "string",
"description": "public link name"
},
"ownedBy": {
"type": "object",
"properties": {
"displayName" : {
"type": "string",
"description": "full name of file owner"
},
"id" : {
"type": "string",
"description": "ID of file owner"
},
"loginName": {
"type": "string",
"description": "login name of file owner"
},
"type" : {
"type": "string",
"description": "has value 'user'"
}
}
},
"role": {
"type": "string",
"description": "indicate the role allowed for the user of the public link"
},
"links": {
"type": "array",
"items": {
"$ref": "rest-schemas/link#"
}
},
"required": ["id", "type", "assignedUsers", "createdDate", "lastModifiedDate", "linkID", "linkName", "ownedBy", "role"]
},
"links": [
{
"rel": "describedBy",
"href": "http://service1-defaulttenant:8080/documents/api/1.2/metadata-catalog/publiclinks"
},
{
"rel": "self",
"href": "http://service1-defaulttenant:8080/documents/api/1.2/metadata-catalog/publiclinks",
"method": "GET"
},
{
"rel": "create-folder-publiclink",
"href": "http://service1-defaulttenant:8080/documents/api/1.2/publiclinks/folder/{id}",
"method": "POST"
},
{
"rel": "create-file-publiclink",
"href": "http://service1-defaulttenant:8080/documents/api/1.2/publiclinks/file/{id}",
"method": "POST"
},
{
"rel": "get-folder-publiclinks",
"href": "http://service1-defaulttenant:8080/documents/api/1.2/publiclinks/folder/{id}",
"method": "GET"
},
{
"rel": "get-file-publiclinks",
"href": "http://service1-defaulttenant:8080/documents/api/1.2/publiclinks/file/{id}",
"method": "GET"
},
{
"rel": "get-publiclink-info",
"href": "http://service1-defaulttenant:8080/documents/api/1.2/publiclinks/{linkID}",
"method": "GET"
},
{
"rel": "edit-publiclink",
"href": "http://service1-defaulttenant:8080/documents/api/1.2/publiclinks/{linkID}",
"method": "PUT"
},
{
"rel": "delete-publiclink",
"href": "http://service1-defaulttenant:8080/documents/api/1.2/publiclinks/{linkID}",
"method": "DELETE"
}
]
}