Help Center/ KooDrive/ API Reference/ API/ File Management/ Obtaining the Full Name and ID Paths of a File

Updated on 2024-07-30 GMT+08:00

View PDF

Obtaining the Full Name and ID Paths of a File

Function

Obtain the full name and ID paths of a file.

URI

GET /koodrive/ose/v1/files/path

**Table 1** Query Parameters
Parameter	Mandatory	Type	Description
fileId	Yes	String	File ID.
containerId	Yes	String	Space ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Authorization	Yes	String	Access token. Token authentication is used to call KooDrive APIs. A token indicates the permission. When an API is called, the token is added to the request header to obtain the operation permission. For details about how to obtain an access token, see the corresponding developer guide. The format is Bearer+{access_token}.
X-Traceid	No	String	Message log trace ID. The value contains 58 bits.
language	No	String	Language code, which complies with the internationalization specifications. For example, en-US indicates English (United States). English (United States) is used by default.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
code	String	Response code.
msg	String	Response message.
fileIdPath	String	Full path of the file ID.
namePath	String	Full path of the file name.

Example Requests

Queries the full directory path of a file.

GET /koodrive/ose/v1/files/path?fileId=FqS6hLLy_DkjlWdfOnEdCErhsmokRvdXI&containerId=IAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4

Authorization:Bearer+10f88*********4791e9ff

Example Responses

Status code: 200

Full path information.

{
  "fileIdPath" : "/DEUI7pa0C24ArootIAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4/FkbdCAceMj89bprz5xLJASID1eaRqjlRP/FqIAmBlIz7ovbThxeUBlOpbnCHaP_MTUL/FqS6hLLy_DkjlWdfOnEdCErhsmokRvdXI",
  "namePath" : "/rootIAADfsBFCO6WtAtuA315074383680425b8aa9a130cba2d4/007/001/Batch Task Test",
  "code" : 0,
  "msg" : "OK"
}