Public

Read file

get

https://uat.koneksi.co.krhttps://staging.koneksi.co.kr

/clients/v1/public/files/{file}/read

Retrieves public details of a file by its ID. No authentication required.

Path parameters

filestringRequired

The ID of the file to read.

Example: 68679c0786ad78162a99d6af

Header parameters

Client-IDstringRequiredExample: id_UGacp3OrGbGt78bpwzmhkB42cfhTL0US2dPMTbVb1E

Client-SecretstringRequiredExample: sk_1e9KhX0ZReeT6Avugl8cA2rBvKdD2z05LB9VrA4q3hY

Responses

200

File details retrieved successfully.

application/json

404

File not found.

500

Server error. An error occurred while processing the request.

get

/clients/v1/public/files/{file}/read

HTTPcURLJavaScriptPython

GET /clients/v1/public/files/{file}/read HTTP/1.1
Host: uat.koneksi.co.kr
Client-ID: text
Client-Secret: text
Accept: */*

{
  "data": {
    "access": "private",
    "id": "68679c0786ad78162a99d6af",
    "is_encrypted": false,
    "size": 797374
  },
  "message": "file read successfully",
  "meta": {
    "status": "success"
  }
}

Download file

get

https://uat.koneksi.co.krhttps://staging.koneksi.co.kr

/clients/v1/public/files/{file}/download

Downloads a public file by its ID. No authentication required. For encrypted files, provide stream=false in query params and a Passphrase header. Optional password header can be used for password-protected files. An optional key query parameter can be provided as a temporary token for file access.

Path parameters

filestringRequired

The ID of the file to download.

Example: 6853e14d78e8cc3e4c66fb

Query parameters

streambooleanOptional

Set to false to download encrypted files. Defaults to true for streaming public files. Required if Passphrase is provided.

Example: false

keystringOptional

Optional temporary token for downloading files.

Example: abc123xyz

Header parameters

PassphrasestringOptional

Passphrase required to decrypt an encrypted file. Must be provided with stream=false for encrypted file downloads.

Example: Test123!

passwordstringOptional

Optional password for password-protected files.

Example: Password123!

Client-IDstringRequiredExample: id_UGacp3OrGbGt78bpwzmhkB42cfhTL0US2dPMTbVb1E

Client-SecretstringRequiredExample: sk_1e9KhX0ZReeT6Avugl8cA2rBvKdD2z05LB9VrA4q3hY

Responses

200

File downloaded successfully. Returns the file content.

No content

400

Bad request. Missing required parameters (e.g., Passphrase with stream=false for encrypted files).

404

File not found.

500

Server error. An error occurred while processing the request.

get

/clients/v1/public/files/{file}/download

HTTPcURLJavaScriptPython

GET /clients/v1/public/files/{file}/download HTTP/1.1
Host: uat.koneksi.co.kr
Client-ID: text
Client-Secret: text
Accept: */*

No content