Links
Antwortet eine Person dem Bot mit einem Foto, Video, Audio oder einer Datei und wird die Antwort in eine Variable gespeichert (Schalter „Antwort in eine Benutzervariable schreiben“ im Abschnitt „Zusätzlich“ des Blocks), landet in der Variable nicht die Datei selbst, sondern ein Kurzlink darauf — etwa …/w/bK3x9. Ein solcher Kurzlink führt auch zur Datei beim Export einer Liste des Bots nach Excel.
Die Methode decodeShortLink macht aus einem solchen Link einen direkten Link zur Datei — so kann Ihr System sie herunterladen, ohne einer Weiterleitung zu folgen.
decodeShortLink
Liefert zu einem Kurzlink den direkten Link zur Datei.
https://watbot.org/de/api/v1/decodeShortLink| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
url |
String | ja | Der vollständige Kurzlink mit https:// und, falls vorhanden, dem Parameter ?k=…. Die Methode nimmt den Code nach /w/, die Domain wird nicht geprüft |
curl -X POST "https://watbot.org/de/api/v1/decodeShortLink" \
-H "Authorization: Bearer IHR_API_SCHLÜSSEL" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/w/bK3x9"}'
{
"data": {
"url": "https://files.example.com/bots/12345/passport-scan.jpg"
}
}
{
"error": "Kurzlink nicht gefunden",
"message": "Kurzlink nicht gefunden"
}
Aufgelöst werden nur Links auf Dateien, und nur solche, die zu Ihrem Bot oder Ihrer Liste gehören — auch zu einer Liste, die im Projekt statt im Bot angelegt ist. Kurzlinks anderer Art löst die Methode nicht auf. Ein abgelaufener Link wird nicht aufgelöst, so wie er sich auch beim Aufruf nicht öffnet.
Fehler der Methode (allgemeine unter Fehler):
| Code | Wann | Antwort |
|---|---|---|
403 |
Der Link gehört zu einem Bot oder einer Liste eines anderen Kontos oder ist weder an einen Bot noch an eine Liste gebunden | {"error": "…", "message": "…"} |
404 |
Es gibt keinen Kurzlink mit diesem Code, er ist abgelaufen, der Schlüssel ?k= passt nicht oder die Liste, zu der er führt, wurde gelöscht |
{"error": "…", "message": "…"} |
422 |
Der Link führt nicht zu einer Datei | {"error": "…", "message": "…"} |
422 |
url fehlt, ist keine URL oder enthält keinen Pfad /w/code |
{"message": "…", "errors": {"url": ["…"]}} |