파일 또는 디렉토리 고정(pin)하기

이 Endpoint를 사용하면 단일 파일 또는 디렉토리를 업로드하고 고정(pinning)할 수 있습니다. API가 요청을 수락하도록 하려면 payload에 대한 읽기 스트림을 제공해야 합니다.

단일 파일을 업로드하고 고정(pinning)할 때 파일 자체 외에 추가 정보를 유연하게 포함할 수 있습니다. 추가 세부 정보를 제공하기 위해 요청에 PINKOptions 및 PINKMetadata를 포함할 수 있습니다.

이 Endpoint를 통해 사용자는 전체 디렉토리를 IPFS에 고정할 수도 있습니다. 이 프로세스는 단일 파일 고정(pinning)과 비슷하지만 몇 가지 차이점이 있습니다. 단일 파일을 제공하는 대신 파일 배열을 제공하고 디렉토리 내의 각 파일에 대한 상대 파일 경로를 지정해야 합니다.

서버는 각 파일에 대해 제공된 정확한 경로를 사용하므로 각 파일 경로가 업로드 중인 "기본" 디렉토리로 시작해야 한다는 점에 유의해야 합니다. 예를 들어 로컬 컴퓨터의 디렉토리가 "./../myBuilds/desiredBuild"에 있는 경우, 각 파일 경로는 "desiredBuild"로 시작해야 합니다.

다음은 got 라이브러리를 사용하여 디렉터리를 업로드하는 JavaScript 예제입니다. axios 또는 다른 HTTP 라이브러리를 사용하여 동일한 일반 절차를 적용할 수 있다는 점을 명심하세요.

업로드 구현

사용 사례에 따라 API를 구현하는 데 사용되는 다양한 방법이 있습니다.

클라이언트 측에서 API Key를 사용하는 것은 안전하지 않다는 점을 사용자에게 상기시키고자 합니다. 우리는 Key가 안전하게 저장되는 Back-end 서버를 사용하는 것이 더 나은 방법이라고 생각합니다. 그러나 사용자가 클라이언트 측에서 직접 파일을 업로드해야 하는 경우가 있을 수 있습니다. 필요에 따라 이러한 구성 요소를 자유롭게 활용하세요!

API Key와 같은 민감한 정보를 다룰 때는 주의를 기울이고 적절한 보안 조치를 취해야 한다는 점을 잊지 마세요.