Skip to main content
Mit der blueplant-API verbindest du blueplant mit anderer Software. Statt Daten von Hand einzugeben, legst du sie automatisiert an – zum Beispiel beim Übernehmen von Kunden aus deinem Warenwirtschafts- oder CRM-System. Die API ist eine REST-Schnittstelle: Dein System schickt Anfragen an eine Internetadresse, blueplant legt die Daten an und antwortet mit der ID des neuen Objekts.
Die API ist eine Anlage-Schnittstelle: Du kannst damit neue Stammdaten anlegen. Daten lesen oder ändern geht über die API derzeit nicht – dafür nutzt du das Web-Programm.

​
Was du anlegen kannst

Kunden & Standorte

Kunden, ihre Standorte und Kontaktpersonen.

Pflanzen & Produkte

Pflanzenarten, Behälter und die Produkte an den Standorten.

​
Basis-Adresse

Alle Anfragen gehen an: 
https://api.blueplant.app/api/v1
Daten werden als JSON gesendet und empfangen (Content-Type: application/json).

​
So legst du los

1

API-Schlüssel erstellen

Erzeuge im Web-Programm unter Einstellungen einen API-Schlüssel. Mehr dazu auf der Seite Authentifizierung.
2

Schlüssel mitsenden

Schicke den Schlüssel bei jeder Anfrage im Header ApiKey mit.
3

Erste Anfrage senden

Lege zum Beispiel einen Kunden an – siehe Kunde anlegen.
Eine sinnvolle Reihenfolge: erst Kunde, dann Standort und Kontaktperson, danach Pflanze und Behälter und zuletzt das Produkt – denn ein Produkt verweist auf Kunde, Standort und Pflanze.