Wie finde ich IDs für die API?

Wenn du mit unserer API arbeitest, brauchst du für viele Anfragen eine ID – zum Beispiel die eines bestimmten Deal-Typs, einer Pipeline-Stufe oder einer anderen Einstellung. Nicht jede dieser IDs lässt sich direkt über einen API-Endpunkt abfragen. In diesem Artikel zeigen wir dir zwei einfache Wege, wie du trotzdem an die IDs kommst.

Variante 1: ID aus der URL ablesen

Der einfachste Weg: Rufe den gewünschten Eintrag in CentralStationCRM direkt im Browser auf. In vielen Fällen steht die ID dann in der URL.

Ein Beispiel: Du möchtest die ID eines bestimmten Deal-Typs herausfinden. Geh dazu in die Einstellungen und öffne den Deal-Typ zum Bearbeiten. Die URL sieht dann so aus:

https://dein-account.centralstationcrm.net/account_settings/deal_types/37858/edit

Die Zahl vor /edit – in diesem Fall 37858 – ist die ID des Deal-Typs, die du für die API verwenden kannst.

Das funktioniert an vielen Stellen im System: Überall dort, wo du einen einzelnen Eintrag bearbeiten kannst und die URL eine Zahl enthält, ist das in der Regel die zugehörige ID.

Variante 2: ID aus dem Quellcode auslesen

Manchmal gibt es aber Einträge, die keine eigene Bearbeiten-Seite mit ID in der URL haben – zum Beispiel die einzelnen Stufen eines Deal-Typs (deal_type_stages). Und auch in der API gibt es für solche Objekte nicht immer einen eigenen Endpunkt, über den du die IDs bequem abrufen könntest.

In diesen Fällen hilft ein Blick in den Quellcode der Seite. So gehst du vor:

1. Öffne die Seite, auf der der gewünschte Eintrag zu sehen ist (z. B. die Bearbeiten-Ansicht des Deal-Typs, in dem die Stufen definiert sind).

2. Mache einen Rechtsklick auf das Formularfeld der jeweiligen Stufe und wähle „Element untersuchen" (oder „Inspect", je nach Browser).

3. Im geöffneten Quellcode siehst du die einzelnen Eingabefelder. In den Attributen id oder name der Felder findest du die IDs der jeweiligen Einträge.

Mit dieser ID kannst du dann über die API gezielt auf den entsprechenden Eintrag zugreifen.