Erste Schritte
Beginnen Sie mit der Nutzung unserer APIs, indem Sie folgende Schritte ausführen:
  1. Ein Entwicklerkonto erstellen
  2. Eine App in der Entwicklerkonsole erstellen
  3. Ihren API-Key abrufen
  4. Ihre erste API-Anfrage senden

1. Erstellen Sie ein Entwicklerkonto

Gehen Sie auf Entwicklerkonto registrieren und füllen Sie das Formular aus, um ein Entwicklerkonto zu erstellen. Ein Entwicklerkonto ist ein Testkonto, mit dem Sie sofort Zugang zu vier Standorten erhalten. Dies bietet Ihnen die Möglichkeit, unsere APIs zu nutzen. In einem Entwicklerkonto durchgeführte Aktivitäten haben zu keinem Zeitpunkt Auswirkungen in der Produktion. Für die Nutzung unserer Powerlistings®-, Analyse-, Bewertungs-, Social- und Benutzer-Endpunkte ist ein Yext-Abonnement erforderlich. Weitere Informationen zum Abonnement finden Sie auf unserer Website.
YEXT-PARTNER Entwicklerkonten entsprechen nicht der Konfiguration Ihres Dashboards. Bitte kontaktieren Sie Ihren Account Manager; er erstellt gerne ein Yext-Sandbox-Konto für Sie.

2. Erstellen Sie eine App in der Entwicklerkonsole

  1. Melden Sie sich bei Ihrem Entwicklerkonto oder Ihrem aktuellen Yext-Konto an.
  2. Öffnen Sie die Entwicklerkonsole, indem Sie mit der Maus oben rechts auf der Seite über Ihren Namen fahren und Entwicklerkonsole auswählen.
  3. Klicken Sie in der Entwicklerkonsole auf + Neue App.
  4. Geben Sie die erforderlichen Daten ein und klicken Sie auf App erstellen.

3. Rufen Sie Ihren API-Schlüssel ab

Nachdem Sie Ihre App erstellt haben, finden Sie sie in der Entwicklerkonsole im Abschnitt „Ihre Apps“. Klicken Sie dort bitte auf den Namen der App. Der API-Key für die App sollte im Abschnitt „Anmeldeinformationen & Verknüpfung“ auf der Seite der App angezeigt werden.
APIKey2017
Kopieren Sie den API-Key und behalten Sie ihn in Reichweite, um den nächsten Schritt abzuschließen.

4. Senden Sie Ihre erste API-Anfrage

Öffnen Sie Ihren Webbrowser und gehen Sie zu folgender URL:

GET https://api.yext.com/v2/accounts/me/locations?api_key=IHR_API_KEY&v=JJJJJMMTT

where:
  • IHR_API_KEY der API-Key für Ihre App und
  • YYYYMMDD das heutige Datum ist.
Die API-Antwort sollte aus einer Liste von vier Standorten bestehen, die jeweils Niederlassungen von Yext sind:
{
    "meta": {
        "errors": [],
        "uuid": "f1128-b4ef-4803-a47a-3fd70"
    },
    "response": {
        "count": 4,
        "locations": [
            {
                "accountId": "1206158",
                "address": "7900 Westpark Drive",
                "address2": "Suite T200",
                "categoryIds": [
                    "668"
                ],
                "city": "McLean",
                "countryCode": "US",
                "description": "Yext ist der global führende Anbieter von Lösungen für das digitale Knowledge-Management und mit unserer Knowledge Engine erhalten Unternehmen die Kontrolle über ihre digitalen Informationen.",
                "featuredMessage": "Rufen Sie uns heute an",
                "folderId": "0",
                "id": "3686765",
                "isPhoneTracked": false,
                "language": "en",
                "localPhone": "6467624579",
                "locationName": "Yext",
                "locationType": "LOCATION",
                "phone": "8884442988",
                "state": "VA",
                "suppressAddress": false,
                "timestamp": 1475605507908,
                "websiteUrl": "https://locations.yext.com/us/va/mclean/7900-westpark-drive.html",
                "zip": "22102"
            },
            {
                "accountId": "1206158",
                "address": "48 Warwick St.",
                "address2": "Office 410",
                "categoryIds": [
                    "668"
                ],
                "city": "London",
                "countryCode": "GB",
                "description": "Yext ist der global führende Anbieter von Lösungen für das digitale Knowledge-Management und mit unserer Knowledge Engine erhalten Unternehmen die Kontrolle über ihre digitalen Informationen.",
                "featuredMessage": "Rufen Sie uns heute an",
                "folderId": "0",
                "id": "3686766",
                "isPhoneTracked": false,
                "language": "en",
                "locationName": "Yext",
                "locationType": "LOCATION",
                "phone": "2037052290",
                "state": "Gt Lon",
                "suppressAddress": false,
                "timestamp": 1475605508191,
                "websiteUrl": "https://locations.yext.com/gb/gt-lon/london/48-warwick-st-.html",
                "zip": "W1B 5AW"
            },
            {
                "accountId": "1206158",
                "address": "500 West Madison St.",
                "address2": "Suite 2810",
                "categoryIds": [
                    "668"
                ],
                "city": "Chicago",
                "countryCode": "US",
                "description": "Yext ist der global führende Anbieter von Lösungen für das digitale Knowledge-Management und mit unserer Knowledge Engine erhalten Unternehmen die Kontrolle über ihre digitalen Informationen.",
                "featuredMessage": "Rufen Sie uns heute an",
                "folderId": "0",
                "id": "3686767",
                "isPhoneTracked": false,
                "language": "en",
                "locationName": "Yext",
                "locationType": "LOCATION",
                "phone": "2129943900",
                "state": "IL",
                "suppressAddress": false,
                "timestamp": 1475605508686,
                "websiteUrl": "https://locations.yext.com/us/il/chicago/500-west-madison-st-.html",
                "zip": "60661"
            },
            {
                "accountId": "1206158",
                "address": "1 Madison Ave",
                "address2": "5th Floor",
                "categoryIds": [
                    "668"
                ],
                "city": "New York",
                "countryCode": "US",
                "description": "Yext ist der global führende Anbieter von Lösungen für das digitale Knowledge-Management und mit unserer Knowledge Engine erhalten Unternehmen die Kontrolle über ihre digitalen Informationen.",
                "featuredMessage": "Rufen Sie uns heute an",
                "folderId": "0",
                "id": "3686768",
                "isPhoneTracked": false,
                "language": "en",
                "localPhone": "2128136543",
                "locationName": "Yext",
                "locationType": "LOCATION",
                "phone": "8884442988",
                "state": "NY",
                "suppressAddress": false,
                "timestamp": 1475605509124,
                "websiteUrl": "https://locations.yext.com/us/ny/new-york/1-madison-ave.html",
                "zip": "10010"
            }
        ]
    }
}
Sie haben Ihre erste API-Anfrage erfolgreich gesendet.

Weitere Schritte

Weitere Informationen zu Ihren Möglichkeiten mit der Knowledge API finden Sie in folgenden Ressourcen:


Wenn Sie mit Ihrer Integration starten möchten, befolgen Sie bitte die Schritte im Leitfaden für die Integration mit Knowledge API.