Skip to content

DownloadFile#

Test

השיטה מיועדת להורדת קבצים נכנסים ויוצאים. קישורים לקבצים נכנסים מועברים ב הודעות נכנסות, ואתה יכול גם להשתמש בהם LastIncomingMessages שִׁיטָה. אתה יכול לקבל קישורים לקבצים יוצאים באמצעות LastOutgoingMessages שִׁיטָה.

תקופת אחסון הקבצים ובהתאם לכך, היכולת להוריד אותם מוגבלת על ידי WhatsApp

בַּקָשָׁה#

POST
{{apiUrl}}/waInstance{{idInstance}}/downloadFile/{{apiTokenInstance}}
TEST

לפרמטרים של בקשת apiUrl, idInstance ו-apiTokenInstance, עיין ב לפני שמתחילים סָעִיף.

בקש פרמטרים#

פָּרָמֶטֶר סוּג הֶכְרֵחִי תֵאוּר
chatId string כֵּן מזהה צ'אט, לְדוּגמָה 7900023125@c.us
idMessage string כֵּן Mההודעה מועברת פנימה הודעות נכנסות או בעת שליחת קבצים באמצעות SendFileByUrl, SendFileByUpload פרמטר זה מועבר כחלק האחרון של בקשת ה-urlפרמטר זה מועבר כחלק האחרון של בקשת ה-url. פרמטר זה מועבר כחלק האחרון של בקשת ה-url

תְגוּבָה#

פרמטרי תגובה#

פָּרָמֶטֶר סוּג תֵאוּר
downloadUrl string קישור לקובץ מההודעה

בקשת גוף לדוגמה#

{
    "downloadUrl": "https://sw-media.storage.yandexcloud.net/1103912412/a6679d42-2f7f-4121-acfe-1f993dfcf123.png"
}

שגיאות DownloadFile#

לרשימה של שגיאות משותפות לכל השיטות, עיין ב שגיאות נפוצות סָעִיף

קוד HTTP מזהה שגיאה (דוגמה) Description
500 שגיאה פנימית בעת הורדת קובץ לפי chatId 790000312312@c.us ו-idMessage A322F800D3F12CD4858CC947DAFB77A2 הקובץ אינו זמין בשרתי WhatsApp, לא ניתן להוריד באמצעות API

בקש דוגמאות#

import requests
import json

url = "{{apiUrl}}/waInstance{{idInstance}}/downloadFile/{{apiTokenInstance}}"

payload = json.dumps({
  "chatId": "790000312312@c.us",
  "idMessage": "A322F800D3F12CD4858CC947DAFB77A2"
})
headers = {
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)
curl --location -g --request POST '{{apiUrl}}/waInstance{{idInstance}}/downloadFile/{{apiTokenInstance}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chatId": "79000001234@c.us",
    "idMessage": "A322F800D3F12CD4858CC947DAFB77A2"
}'
var restTemplate = new RestTemplate();
var requestUrl = new StringBuilder();
requestUrl
    .append({{apiUrl}})
    .append("/waInstance").append({{idInstance}})
    .append("/downloadFile/")
    .append({{apiTokenInstance}});

var headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);

var jsonBody = "{\"chatId\": \"79000001234@c.us\",\"idMessage\": \"A322F800D3F12CD4858CC947DAFB77A2\"}";

var requestEntity = new HttpEntity<>(jsonBody, headers);

var response = restTemplate.exchange(requestUrl.toString(), HttpMethod.POST, requestEntity, String.class);
System.out.println(response);
var requestUrl = new StringBuilder();
requestUrl
    .append({{apiUrl}})
    .append("/waInstance").append({{idInstance}})
    .append("/downloadFile/")
    .append({{apiTokenInstance}});

var response = Unirest.post(requestUrl.toString())
    .header("Content-Type", "application/json")
    .body("{\"chatId\": \"79000001234@c.us\",\"idMessage\": \"A322F800D3F12CD4858CC947DAFB77A2\"}")
    .asString();

System.out.println(response);
Sub DownloadFile()
    Dim url As String
    Dim RequestBody As String
    Dim http As Object
    Dim response As String

    ' The apiUrl, idInstance and apiTokenInstance values are available in console, double brackets must be removed
    url = "{{apiUrl}}/waInstance{{idInstance}}/downloadFile/{{apiTokenInstance}}"

    ' chatId - personal or group chat identifier whose message history you want to receive, count - number of messages to receive, default value 100
    RequestBody = "{""chatId"":""71234567890@c.us"",""idMessage"":""E5A2563784F535FD43B3B83142E1234E""}"

    Set http = CreateObject("MSXML2.XMLHTTP")

    With http
        .Open "POST", url, False
        .setRequestHeader "Content-Type", "application/json"
        .send RequestBody
    End With

    response = http.responseText

    Debug.Print response

    ' Outputting the answer to the desired cell
    Range("A1").Value = response

    Set http = Nothing
End Sub