Medien-ID

/v1/media/{media-id}

Verwende diesen Endpunkt mit einer bestimmten ID, um deine Medien abzurufen oder zu löschen.

Bevor du beginnst

Bevor du dein Medium abrufen oder löschen kannst, musst du es mithilfe von /v1/media hochladen.

Abrufen

Nachdem du deine Medien erfolgreich hochgeladen hast, erhältst du eine Antwort mit einer Medien-ID. Verwende diese ID in allen Anfragen, mit denen du die im WhatsApp Business API-Client gespeicherten Medien abrufen möchtest.

Dieses Verfahren zum Abrufen von Medien wird auch verwendet, wenn ein*e Benutzer*in dir ein Bild sendet, das von deinem Webhook empfangen wird. Wenn du eine Nachricht empfängst, die Medien enthält, lädt der WhatsApp Business API-Client diese Medien herunter. Sobald die Medien heruntergeladen wurden, erhältst du eine Benachrichtigung über deinen Webhook. Verwende die Medien-ID aus der Benachrichtigung, um die Medien abzurufen.

Mit den Einstellungen zum automatischen Herunterladen von Medien kannst du festlegen, dass der WhatsApp Business API-Client Medien automatisch herunterlädt.

Beispiel

GET /v1/media/media-id

Als Beispiel verwenden wir das Bild, das du im vorherigen Abschnitt hochgeladen hast:

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

Verwende den Parameter -o, um dieses Beispielmedium an eine Datei zu senden, wie unten gezeigt:

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

Wenn dein Aufruf erfolgreich ist, erhältst du eine Antwort mit dem Status 200 OK und den Binärdaten des Mediums.

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

binary-media-data

Falls du ein Tool wie Postman verwendet hast, wird das Bild angezeigt. Bei Verwendung eines Befehlszeilen-Tools werden die Binärdaten angezeigt. Wenn du die Daten an eine Datei gesendet hast, wird das Bild in deinem Dateibrowser angezeigt.

Wenn kein Medium gefunden wurde, wird ein 404 Not Found-Antwortcode ohne Text zurückgegeben.

Falls du eine andere Fehlermeldung erhältst, findest du weitere Informationen unter Fehlercodes und Statusmeldungen.

Löschen

Um ein Medium im WhatsApp Business API-Client zu löschen, sendest du eine DELETE-Anfrage zusammen mit der ID des Mediums, das du löschen möchtest, an den media-Node. Verwende die ID aus der Antwort auf die Anfrage zum Hochladen des Mediums oder aus der Mediennachricht von einem Webhook.

Beispiel

Anfrage:

DELETE /v1/media/media-id

Bei einer erfolgreichen Antwort wird 200 OK und entweder null oder {} zurückgegeben. Wenn das Medium nicht gefunden wurde, enthält die Antwort den Fehlercode 404 Not Found und keinen Text. Falls du eine andere Fehlermeldung erhältst, findest du weitere Informationen unter Fehlercodes und Statusmeldungen.