미디어 ID

/v1/media/{media-id}

해당 ID에 대해 이 엔드포인트를 사용하여 미디어를 검색하거나 삭제합니다.

시작하기 전에

미디어를 검색하거나 삭제하기 전에 /v1/media를 통해 미디어를 업로드해야 합니다.

검색

성공적으로 미디어 업로드를 완료한 후에는 미디어 ID가 포함된 응답을 수신합니다. 요청에서 해당 ID를 사용하여 WhatsApp Business API 클라이언트에 저장된 미디어를 검색합니다.

이렇게 미디어를 검색하는 프로세스는 사용자가 비즈니스의 Webhooks에서 수신한 이미지를 비즈니스로 보낼 경우에도 사용합니다. 미디어가 포함된 메시지를 수신하면 WhatsApp Business API 클라이언트가 미디어를 다운로드합니다. 미디어가 다운로드되면 Webhook를 통해 알림을 수신합니다. 해당 알림에서 확인한 미디어 ID를 사용하여 미디어를 검색합니다.

미디어 자동 다운로드 설정을 통해 WhatsApp Business API 클라이언트가 미디어를 자동으로 다운로드하도록 설정할 수 있습니다.

예

GET /v1/media/media-id

이전 섹션에서 업로드한 예시 이미지를 사용한 예는 다음과 같습니다.

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' 

이 예시 미디어를 파일로 보내려면 아래와 같이 -o 매개변수를 사용합니다.

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' \
  -o path/filename

호출이 성공하면 200 OK 상태와 바이너리 미디어 데이터를 포함하는 응답이 표시됩니다.

Content-Type: image/jpeg or other appropriate media type
Content-Length: content-size

binary-media-data

포스트맨과 같은 도구를 사용할 경우 이미지가 표시됩니다. 명령줄 도구를 사용할 경우 바이너리 데이터가 표시됩니다. 데이터를 파일로 보냈을 경우 파일 브라우저에 이미지가 표시됩니다.

미디어를 찾을 수 없는 경우 본문 없는 404 Not Found 응답 코드가 반환됩니다.

다른 오류 메시지가 발생한 경우 자세한 내용은 오류 및 상태 메시지를 참조하세요.

삭제

WhatsApp Business API 클라이언트에서 미디어를 삭제하려면 삭제하려는 미디어의 ID와 함께 DELETE 요청을 media 노드로 보냅니다. 미디어 업로드에 대한 응답 또는 Webhooks의 미디어 메시지의 ID를 사용합니다.

예

요청:

DELETE /v1/media/media-id

성공적인 응답에는 200 OK와 null 또는 {}가 표시됩니다. 미디어를 찾을 수 없는 경우 본문 없는 404 Not Found 응답이 표시됩니다. 다른 오류 메시지가 발생한 경우 자세한 내용은 오류 및 상태 메시지를 참조하세요.