# Public

## Read file

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

```json
{"openapi":"3.0.0","info":{"title":"Koneksi API Services","version":"1.0.0"},"servers":[{"url":"https://uat.koneksi.co.kr","description":"UAT"},{"url":"https://staging.koneksi.co.kr","description":"Staging"}],"paths":{"/clients/v1/public/files/{file}/read":{"get":{"tags":["Public"],"summary":"Read file","description":"Retrieves public details of a file by its ID. No authentication required.","parameters":[{"name":"file","in":"path","description":"The ID of the file to read.","required":true,"schema":{"type":"string"}},{"name":"Client-ID","in":"header","schema":{"type":"string"},"required":true},{"name":"Client-Secret","in":"header","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"File details retrieved successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"access":{"type":"string","description":"The access level of the file."},"id":{"type":"string","description":"The ID of the file."},"is_encrypted":{"type":"boolean","description":"Indicates if the file is encrypted."},"size":{"type":"integer","description":"The size of the file in bytes."}}},"message":{"type":"string","description":"A success message."},"meta":{"type":"object","properties":{"status":{"type":"string","description":"The status of the operation."}}}}}}}},"404":{"description":"File not found."},"500":{"description":"Server error. An error occurred while processing the request."}}}}}}
```

## Download file

> 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.

```json
{"openapi":"3.0.0","info":{"title":"Koneksi API Services","version":"1.0.0"},"servers":[{"url":"https://uat.koneksi.co.kr","description":"UAT"},{"url":"https://staging.koneksi.co.kr","description":"Staging"}],"paths":{"/clients/v1/public/files/{file}/download":{"get":{"tags":["Public"],"summary":"Download file","description":"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.","parameters":[{"name":"file","in":"path","description":"The ID of the file to download.","required":true,"schema":{"type":"string"}},{"name":"stream","in":"query","description":"Set to `false` to download encrypted files. Defaults to `true` for streaming public files. Required if `Passphrase` is provided.","required":false,"schema":{"type":"boolean"}},{"name":"key","in":"query","description":"Optional temporary token for downloading files.","required":false,"schema":{"type":"string"}},{"name":"Passphrase","in":"header","description":"Passphrase required to decrypt an encrypted file. Must be provided with `stream=false` for encrypted file downloads.","required":false,"schema":{"type":"string"}},{"name":"password","in":"header","description":"Optional password for password-protected files.","required":false,"schema":{"type":"string"}},{"name":"Client-ID","in":"header","schema":{"type":"string"},"required":true},{"name":"Client-Secret","in":"header","schema":{"type":"string"},"required":true}],"responses":{"200":{"description":"File downloaded successfully. Returns the file content."},"400":{"description":"Bad request. Missing required parameters (e.g., `Passphrase` with `stream=false` for encrypted files)."},"404":{"description":"File not found."},"500":{"description":"Server error. An error occurred while processing the request."}}}}}}
```
