> For the complete documentation index, see [llms.txt](https://koneksi.gitbook.io/koneksi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://koneksi.gitbook.io/koneksi-docs/dive-api.md).

# Dive API

Diving은 공용 IPFS 네트워크에서 비공개로 유지되는 콘텐츠를 업로드하는 프로세스입니다. PINK dive를 사용하면 콘텐츠를 비공개로 유지하고 지정한 기간 동안 지속되는 액세스 토큰을 프로그래밍 방식으로 생성할 수 있습니다.

Dive API는 파일과 폴더를 업로드하고, 콘텐츠를 나열하고, 콘텐츠를 보고 다운로드하기 위한 액세스 토큰을 생성하는 데 사용할 수 있습니다.

dive 콘텐츠를 보려면 유효한 액세스 토큰을 포함해야 합니다. 전용 게이트웨이를 통해 dive 콘텐츠를 볼 때는 액세스 토큰이 필요합니다. 액세스 토큰 생성 엔드포인트를 사용하여 액세스 토큰을 생성할 수 있습니다. dive 콘텐츠를 보기 위한 링크를 구성하는 방법은 다음과 같습니다:

**단일 파일:**

GATEWAY\_URL/ipfs/FILE\_CID?accessToken=TOKEN

**폴더 내 파일:**

GATEWAY\_URL/ipfs/FOLDER\_CID/FILE\_NAME?accessToken=TOKEN

GATEWAY\_URL을 전용 게이트웨이의 URL로, FILE\_CID를 파일의 CID로, FOLDER\_CID를 폴더의 CID로, FILE\_NAME을 파일의 이름으로, TOKEN을 생성된 액세스 토큰으로 바꾸세요.

API Endpoint 활용 및 비공개 콘텐츠에 대한 액세스 토큰 생성에 대한 자세한 지침은 PINK dive API 설명서를 참조하시기 바랍니다.