DownloadFile#
השיטה מיועדת להורדת קבצים נכנסים ויוצאים. קישורים לקבצים נכנסים מועברים ב הודעות נכנסות, ואתה יכול גם להשתמש בהם LastIncomingMessages שִׁיטָה. אתה יכול לקבל קישורים לקבצים יוצאים באמצעות LastOutgoingMessages שִׁיטָה.
תקופת אחסון הקבצים ובהתאם לכך, היכולת להוריד אותם מוגבלת על ידי WhatsApp
בַּקָשָׁה#
לפרמטרים של בקשת 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