PlantDB
REST API · JSON

Für Entwickler

Baue deine App auf strukturierten, offenen Pflanzendaten. Sanctum-Bearer-Token, OpenAPI-Dokumentation, Mehrsprachigkeit per Accept-Language.

Zur API-Dokumentation

Getting Started

  1. Account anlegen und im Admin-Panel einen Named API Key erstellen.
  2. Endpoint aufrufen — z. B. GET /api/v1/plants — mit Authorization: Bearer <token>.
  3. Response verarbeiten — alle Endpunkte liefern JSON, folgen konsistenter Fehler-Struktur und respektieren Accept-Language.

Authentifizierung

PlantDB nutzt Laravel Sanctum mit Personal Access Tokens. Jeder API-Key ist einem Nutzer-Account zugeordnet, kann benannt und einzeln widerrufen werden. Sende den Token im Authorization-Header als Bearer-Token.

Rate Limits

Tier Limit Zuordnung
Anonym100 / TagIP-basiert
Free1.000 / TagAPI-Token
Pro50.000 / TagAPI-Token
Enterpriseunlimitiertauf Anfrage

Beispiel-Snippets

curl

curl -H "Authorization: Bearer $PLANTDB_TOKEN" \
     -H "Accept-Language: de" \
     https://plantdb-api.test/api/v1/plants

PHP

use Illuminate\Support\Facades\Http;

$plants = Http::withToken($token)
    ->withHeaders(['Accept-Language' => 'de'])
    ->get('https://plantdb-api.test/api/v1/plants')
    ->json('data');

JavaScript

const res = await fetch('https://plantdb-api.test/api/v1/plants', {
  headers: {
    Authorization: `Bearer ${token}`,
    'Accept-Language': 'de',
  },
});
const { data } = await res.json();