TILDA HILFE-CENTER

Tilda API

Automatische Integration von Tilda Projekten in Ihre eigene Website
Alle Anfragen werden mit der GET-Methode gesendet und die Antwort wird im JSON-Format zurückgegeben.

Die erfolgreiche Antwort lautet:
{
  "status": "GEFUNDEN",
  ...
}
Die Fehlerantwort lautet:
{
  "status": "FEHLER",
  ...
}
Die Anzahl der Anfragen ist begrenzt: 150 pro Stunde.
Die API wird verwendet, um auf Tilda erstellte Inhalte mit Ihrer Website zu synchronisieren. Es ist verboten, den Server von Tilda aufzufordern, Daten für jeden Besuch Ihres Benutzers auf Ihrer Website abzurufen.

Alle Inhalte (einschließlich Bilder, Skripts und Stile) müssen auf Ihrem Server gespeichert werden, bevor sie an Benutzer verteilt werden können. Wenn Sie Last erzeugen, indem Sie ständig Anfragen an Tilda API-Server senden, wird Ihr Konto möglicherweise gesperrt und die API-Funktion deaktiviert.

Wenn der Synchronisationsalgorithmus gut organisiert ist, sollte es 1-3 Anfragen geben, daher sind 150 Anfragen an den Server pro Stunde mehr als genug. Nach der Synchronisierung sollten keine Anfragen erfolgen, bis Sie etwas auf der Seite geändert haben. In diesem Fall müssen Sie die Informationen erneut synchronisieren.
Regeln und Einschränkungen für die Verwendung von Tilda Funktionen auf Ihrem Server
Wie man anfängt
Bitte beachten Sie, dass die API-Funktion nur für Abonnenten des Tilda Business Plans verfügbar ist. Zunächst benötigen Sie einen öffentlichen Schlüssel und einen geheimen Schlüssel. Sie finden sie im API-Abschnitt auf Tilda: Website-Einstellungen → Export → API-Integration.
Liste der Anfragen
Liste der Projekte
/v1/getprojectslist

Projektinformationen
/v1/getprojectinfo

Liste der Projektseiten
/v1/getpageslist

Seiteninformationen (+ Body-HTML-Code)
/v1/getpage

Seiteninformationen (+ ganzseitiger HTML-Code)
/v1/getpagefull

Seiteninformationen für den Export (+ Body-HTML-Code)
/v1/getpageexport

Vollständige Seiteninformationen für den Export (+ ganzseitiger HTML-Code)
/v1/getpagefullexport
Die URLs für alle Anforderungen: https://api.tildacdn.info
In jeder Anforderung müssen Sie Variablen senden: publickey und secretkey und optional, je nach Anforderung, projectid oder pageid.
Sie können die Pfadwerte für Bilder (export_imgpath), JS-Dateien (export_jspath) und CSS-Dateien (export_csspath) auf der Registerkarte "Exportieren" in Website-Einstellungen jedes Projekts festlegen.
Daher können Sie relative oder absolute Pfade zu den Dateien angeben, die auf Ihrem Server gespeichert werden, wenn Sie genaue Seitenkopien auf Ihrem Server erstellen möchten.
PHP-Bibliothek für die schnelle Bereitstellung der Synchronisation auf Ihrem Server
Abrufen der Liste der Projekte
GET-Anforderungs-URL:
https://api.tildacdn.info/v1/ getprojectslist/?publickey=00000000000000000000&secretkey=00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
GET-Anfrage-URL:
https://api.tildacdn.info/v1/getprojectslist/?publickey=00000000000000000000&secretkey=00000000000000000000
Antwort im JSON-Format:
{
  "status": "GEFUNDEN",
  "Ergebnis": [
    {
      "id": "0",
      "title": "Erstes Projekt",
      "descr": "Einige Infos"
    },
    {
      "id": "1",
      "Titel": "Zweites Projekt",
      "descr": ""
    },
    ...
  ]
}
Abrufen von Projektinformationen:
GET-Anforderungs-URL:
https://api.tildacdn.info/v1/ getProjectInfo/?publicKey=000000000000000000000&secretkey=0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
GET-Anfrage-URL:
https://api.tildacdn.info/v1/getprojectinfo/?publickey=00000000000000000000&secretkey=00000000000000000000&projectid=0
Antwort im JSON-Format:
{
  "status": "GEFUNDEN",
  "Ergebnis": {
    "id": "0",
    "title": "Projekttitel",
    "descr": "",
    "customdomain": "project.com",
    "export_csspath": "",
    "export_jspath": "",
    "export_imgpath": "",
    "indexpageid": "0",
    "customcsstext": "y",
    "favicon": "",
    "page404id": "0",
    "Bilder": [
      {
        "von": "",
        "zu": ""
      }
      ...
    ]
  }
}
Um ein Beispiel für die Konfigurationsdatei Ihres Webservers zu erhalten, fügen Sie der Anforderungs-URL den webconfig-Parameter mit dem Wert htaccess oder nginx hinzu.

Wenn Sie nginx verwenden, müssen Sie das empfangene Beispiel in den Serverabschnitt der Konfigurationsdatei Ihres Webservers einfügen.
Abrufen der Liste der Projektseiten
GET-Anforderungs-URL:
https://api.tildacdn.info/v1/ GetPagesList/?publicKey=000000000000000000000&SecretKey=00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
GET-Anfrage-URL:
https://api.tildacdn.info/v1/getpageslist/?publickey=00000000000000000000&secretkey=00000000000000000000&projectid=0
Antwort im JSON-Format:
{
  "status": "GEFUNDEN",
  "Ergebnis": [
    {
      "id": "1001",
      "Projekt-ID": "0",
      "title": "Seitentitel zuerst",
      "descr": "",
      "img": "",
      "featureimg": "",
      "Alias": "",
      "date": "2014-05-16 14:45:53",
      "sort": "80",
      "veröffentlicht": "1419702868",
      "Dateiname": "Seite1001.html"
    },
    {
      "id": "1002",
      "Projekt-ID": "0",
      "title": "Seitentitel an zweiter Stelle",
      "descr": "",
      "img": "",
      "featureimg": "",
      "Alias": "",
      "Datum": "2014-05-17 10:50:00",
      "sortieren": "90",
      "veröffentlicht": "1419702277",
      "Dateiname": "Seite1002.html"
    },
    ...
  ]
}
Abrufen der Seiteninformationen
+ HTML-Code
GET-Anforderungs-URL:
https://api.tildacdn.info/v1/ getpage/?publickey=00000000000000000000&secretkey=000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
GET-Anfrage-URL:
https://api.tildacdn.info/v1/getpage/?publickey=00000000000000000000&secretkey=00000000000000000000&pageid=1001
Antwort im JSON-Format:
{
  "status": "GEFUNDEN",
  "Ergebnis": {
    "id": "1001",
    "Projekt-ID": "0",
    "title": "Seitentitel",
    "descr": "",
    "img": "",
    "featureimg": "",
    "Alias": "",
    "date": "2014-05-16 14:45:53",
    "sort": "80",
    "veröffentlicht": "1419702868",
    "html": "etwas HTML-Seitencode",
    "Dateiname": "Seite1001.html",
    "js": [
      ...
    ],
    "css": [
      ...
    ]
  }
}
Abrufen der Seiteninformationen
+ vollständiger HTML-Code
GET-Anforderungs-URL:
https://api.tildacdn.info/v1/ GetPageFull/?publicKey=000000000000000000000&secretkey=0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
GET-Anfrage-URL:
https://api.tildacdn.info/v1/getpagefull/?publickey=00000000000000000000&secretkey=00000000000000000000&pageid=1001
Antwort im JSON-Format:
{
  "status": "GEFUNDEN",
  "Ergebnis": {
    "id": "1001",
    "Projekt-ID": "0",
    "title": "Seitentitel",
    "descr": "",
    "img": "",
    "featureimg": "",
    "Alias": "",
    "date": "2014-05-16 14:45:53",
    "sort": "80",
    "veröffentlicht": "1419702868",
    "html": "etwas HTML-Seitencode",
    "Dateiname": "Seite1001.html"
  }
}
Abrufen der Seiteninformationen für den Export
+ HTML-Code der Hauptseite
GET-Anforderungs-URL:
https://api.tildacdn.info/v1/ getpageexport/?publickey=00000000000000000000&secretkey=00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
GET-Anfrage-URL:
https://api.tildacdn.info/v1/getpageexport/?publickey=00000000000000000000&secretkey=00000000000000000000&pageid=1001
Antwort im JSON-Format:
{
  "status": "GEFUNDEN",
  "Ergebnis": {
    "id": "1001",
    "Projekt-ID": "0",
    "title": "Seitentitel",
    "descr": "",
    "img": "",
    "featureimg": "",
    "Alias": "",
    "date": "2014-05-16 14:45:53",
    "sort": "80",
    "veröffentlicht": "1419702868",
    "Bilder": [
      {
        "von": "",
        "zu": ""
      },
      {
        "von": "",
        "zu": ""
      },
      {
        "von": "",
        "zu": ""
      }
    ],
    "html": "HTML-Code der Hauptseite mit lokalen Links zu Dateien",
    "Dateiname": "Seite1001.html"
  }
}
Wichtig: Wir empfehlen Ihnen, die statischen Seitendateien (Skripts und Stile) jedes Mal herunterzuladen und auf dem neuesten Stand zu halten, wenn Sie diese Anforderung verwenden. Diese Dateien ändern sich ständig, und Sie können nicht überprüfen, ob die Dateien über die API aktualisiert werden.
Abrufen der Seiteninformationen für den Export
+ ganzseitiger HTML-Code
GET-Anforderungs-URL:
https://api.tildacdn.info/v1/ GetPageFullExport/?publicKey=000000000000000000000&secretkey=000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
GET-Anfrage-URL:
https://api.tildacdn.info/v1/getpagefullexport/?publickey=00000000000000000000&secretkey=00000000000000000000&pageid=1001
Antwort im JSON-Format:
{
  "status": "GEFUNDEN",
  "Ergebnis": {
    "id": "1001",
    "Projekt-ID": "0",
    "title": "Seitentitel",
    "descr": "",
    "img": "",
    "featureimg": "",
    "Alias": "",
    "date": "2014-05-16 14:45:53",
    "sort": "80",
    "veröffentlicht": "1419702868",
    "Bilder": [
      {
        "von": "",
        "zu": ""
      },
      {
        "von": "",
        "zu": ""
      },
      {
        "von": "",
        "zu": ""
      }
    ],
    "html": "ganzseitiger HTML-Code mit lokalen Links zu Dateien",
    "Dateiname": "Seite1001.html"
  }
}
Wichtig: Wir empfehlen Ihnen, die statischen Seitendateien (Skripts und Stile) jedes Mal herunterzuladen und auf dem neuesten Stand zu halten, wenn Sie diese Anforderung verwenden. Diese Dateien ändern sich ständig, und Sie können nicht überprüfen, ob die Dateien über die API aktualisiert werden.
Webhook (oder Rückruf)
Die Synchronisierung kann automatisch durchgeführt werden. Geben Sie dazu die Skript-URL an, an die eine Anfrage mit Benachrichtigung gesendet wird, wenn Sie auf die Schaltfläche "Veröffentlichen" klicken. Auf diese Weise können Sie Inhalte aktualisieren und neue Seiten auf Ihrem Server hinzufügen.

Sie können den Link zum Webhook im API-Abschnitt Ihres Projekts angeben: Website-Einstellungen → Export → API-Integration:
Die Benachrichtigung wird mit der GET-Methode gesendet.
Parameter: pageid, projectid, published, publickey

Ihr Webhook muss bestätigen, dass die Anforderung empfangen wurde. Die erwartete Antwort auf die erfolgreiche Anforderung ist "ok"
(In PHP nur "ok" wiederholen;)

Wenn der Tilda Server nicht die erwartete Antwort erhält, gibt es 2 weitere Versuche, die Anfrage an Ihren Server zu wiederholen (insgesamt 3 Anfragen).

Die Anfrage kann nicht sofort, sondern mit einer Verzögerung von 1 bis 20 Minuten nach der Veröffentlichung der Seite gesendet werden. Wenn die Anfrage also nicht sofort eingegangen ist, müssen Sie überprüfen, ob sie nicht innerhalb des angegebenen Zeitraums eingegangen ist.
Wichtig: Die maximale Antwortwartezeit von Ihrem Server beträgt 5 Sekunden. Wenn die Antwort nicht empfangen wird, wird die Verbindung getrennt. Deshalb sollten Sie diese Benachrichtigung speichern und dann eine Synchronisierung durchführen, z. B. über cron. Normalerweise, wenn Sie viele Bilder auf der Seite haben, ist diese Zeit nicht genug.
wie man
Beispiele für Nutzungsszenarien
Es gibt zwei gängige Szenarien für die Verwendung der Tilda API: Wenn Sie das Exportieren und Speichern aller Projektdateien auf Ihrem Server automatisieren müssen und wenn Sie auf Tilda erstellte Seiten in Ihre Website-Vorlagen integrieren müssen.
So exportieren Sie alle Seiten im Projekt
Unser Ziel ist es, das in unserem Tilda Account veröffentlichte Projekt auf unserem lokalen Server zu speichern.
  • Geben Sie auf der Registerkarte Exportieren der Website-Einstellungen die Pfade für Bilder, JS-Dateien und CSS-Dateien an, z. B. /images, /js und /css.
  • Merken Sie sich die Projekt-ID des benötigten Projekts;
  • Erstellen Sie ein Skript auf Ihrem Server, das Anforderungen an die API sendet, Dateien erstellt und Informationen in diesen Dateien speichert.
  • Erstellen Sie Ordner auf dem Server, in die Sie Dateien kopieren (images, js, css).
  1. Rufen Sie Informationen zu dem Projekt ab, das Sie benötigen, indem Sie die getprojectinfo-Anforderung senden.
  2. Durchlaufen Sie das Bildarray , das Sie in der Anforderungsantwort erhalten haben. Es gibt eine Liste von Dateien darin. Sie finden die Quelladresse der Datei in der Variablen from und den lokalen Namen, den Sie zum Speichern der Datei in der to-Variablen verwenden müssen. Kopieren Sie die Dateien an die gewünschte Stelle. Diese Dateien gelten für alle Seiten im Projekt.
  3. Wenn Sie den webconfig-Parameter zur vorherigen Anforderung hinzugefügt haben, müssen Sie entweder eine . htaccess-Datei und füllen Sie sie mit dem Wert der webconfig-Variablen oder speichern Sie diesen Wert im Serverbereich der Konfigurationsdatei Ihres Nginx-Webservers .
  4. Rufen Sie die Liste aller Seiten in unserem Projekt ab, indem Sie die getpageslist-Anfrage senden.
  5. Durchlaufen Sie die Seitenliste, die Sie erhalten haben. Für jede Seite:
  • Rufen Sie die Seiteninformationen für den Export ab, indem Sie die getpagefullexport-Anforderung senden.
  • Speichern Sie die auf der Seite verwendeten Bilder, Skripts und Stile aus den images-, js- und css-Arrays auf dem Server.
  • Erstellen Sie eine neue Auslagerungsdatei (unter Verwendung des Namens aus der Dateinamenvariablen ) und füllen Sie sie mit dem HTML-Variablenwert .

Wenn es Ihr Ziel ist, Seiten von Tilda in Ihre Vorlage zu integrieren (die bereits die Kopfzeile, das Menü, die Fußzeile usw. hat), dann folgen Sie den gleichen Schritten, aber verwenden Sie diegetpageexportAnfrage. Es gibt Body-HTML-Code zurück, den Sie in den Inhaltsbereich Ihrer Vorlage einfügen können. Bitte beachten Sie, dass Sie in diesem Fall Skripte und Stile manuell in die Vorlage einfügen müssen.
Integration ohne Kopieren von Bildern und JS/CSS-Dateien

Wenn Ihr Projekt nicht stark ausgelastet ist und Sie keine statischen Dateien auf Ihrem Server speichern möchten, verwenden Sie die getpage-Anforderung, die HTML-Code für den Text zurückgibt. Die Bilder werden vom Tilda Server geladen. Die Hauptsache ist, dass Sie daran denken, JS- und CSS-Dateien zu Ihrer Vorlage hinzuzufügen. Die Liste dieser Dateien wird in js- und css-Variablen der Anforderungsantwort zurückgegeben.

Ein Beispiel für eine einfache Anfrage mit PHP:
$result = file_get_contents('https://api.tildacdn.info/v1/getprojectinfo/?publickey=0000000000000000000&secretkey=00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
$project = json_decode($result, wahr);
print_r($project);
Wenn Sie die API-Exportfunktion verwenden, müssen Sie gemäß den Nutzungsbedingungen von Tilda auf jeder exportierten Seite die Kennung „Made on Tilda“ mit einem Link zu https://tilda.cc als Quelle angeben.
Hergestellt auf
Tilda