API Dokumentation - One Piece Datenbank

Was ist diese API?

Eine kostenlose, öffentliche REST-API mit deutschsprachigen Daten zu One Piece Charakteren und Teufelsfrüchten. Perfekt für Entwickler die deutsche One Piece Daten brauchen.

789 Charaktere mit Crew, Bounty, Job, Größe und 7 Kampf-Stats
180 Teufelsfrüchte mit Typ, Beschreibung und Stats
201 Crews mit Mitgliederanzahl
Komplett auf Deutsch
Keine Registrierung nötig
CORS aktiviert — von überall nutzbar

Base-URL: https://onepiece.tsd-studio.de/api/public
Rate-Limit: 100 Anfragen pro Minute pro IP
Format: JSON

Schnellstart

Einfach einen GET-Request senden — keine API-Keys, keine Registrierung:

// JavaScript Beispiel
fetch('https://onepiece.tsd-studio.de/api/public/characters/1')
  .then(res => res.json())
  .then(data => console.log(data.data.name));
// Ausgabe: "Monkey D. Ruffy"

// Python Beispiel
import requests
r = requests.get('https://onepiece.tsd-studio.de/api/public/characters/search?q=zoro')
print(r.json()['data'][0]['name'])
# Ausgabe: "Roronoa Zoro"

# curl
curl https://onepiece.tsd-studio.de/api/public/stats

Endpoints

Meta-Informationen

GET /api/public/stats

Gibt Überblicks-Informationen zur Datenbank zurück.

{
  "ok": true,
  "data": {
    "version": "1.0",
    "language": "de",
    "characters": 789,
    "devilFruits": 180,
    "crews": 201
  }
}

Alle Charaktere

GET /api/public/characters

Gibt alle Charaktere paginiert zurück.

Parameter	Typ	Default	Beschreibung
`page`	number	1	Seitennummer
`perPage`	number	50	Ergebnisse pro Seite (max 200)
`crew`	string	-	Nach Crew filtern

Beispiel: /api/public/characters?crew=Strohhut-Piraten

Einzelner Charakter

GET /api/public/characters/:id

Gibt einen Charakter mit allen Details zurück, inklusive Teufelsfrucht-Daten falls vorhanden.

{
  "ok": true,
  "data": {
    "id": 1,
    "name": "Monkey D. Ruffy",
    "crew": "Strohhut-Piraten",
    "job": "Kapitän",
    "bounty": "3000000000",
    "height": "174cm",
    "fruitType": "Mythische Zoan",
    "devilFruitId": null,
    "stats": {
      "combat": 9.6,
      "toughness": 9.6,
      "haki": 9.4,
      "skills": 9.2,
      "influence": 9.7,
      "iq": 6.2,
      "speed": 9.3
    },
    "devilFruit": null
  }
}

Charakter-Suche

GET /api/public/characters/search?q=...

Sucht nach Charakteren anhand von Name oder Crew. Mindestens 2 Zeichen.

Parameter	Typ	Beschreibung
`q`	string	Suchbegriff (min. 2 Zeichen)

Alle Teufelsfrüchte

GET /api/public/devil-fruits

Gibt alle Teufelsfrüchte paginiert zurück.

Parameter	Typ	Default	Beschreibung
`page`	number	1	Seitennummer
`perPage`	number	50	Ergebnisse pro Seite (max 200)
`type`	string	-	Typ-Filter: Paramecia, Zoan, Logia

Einzelne Teufelsfrucht

GET /api/public/devil-fruits/:id

{
  "ok": true,
  "data": {
    "id": 6,
    "name": "Hana Hana no Mi",
    "type": "Paramecia",
    "description": "Blüten-Frucht. Körperteile überall sprießen lassen.",
    "userName": "Nico Robin",
    "stats": { "combat": 5, "toughness": 2, "skill": 8, "iq": 3, "speed": 2 }
  }
}

Alle Crews

GET /api/public/crews

Gibt alle Crew-Namen mit Mitgliederanzahl zurück, sortiert nach Größe.

Response-Format

Alle Antworten folgen dem gleichen Schema:

// Erfolg
{ "ok": true, "data": { ... }, "meta": { "total": 789, "page": 1, "perPage": 50 } }

// Fehler
{ "ok": false, "error": "Fehlermeldung" }

HTTP-Status-Codes: 200 Erfolg, 400 Ungültige Anfrage, 404 Nicht gefunden, 429 Rate-Limit erreicht.

Hinweise

Die Daten basieren auf dem aktuellen Manga-Stand (bis Elbaf/Riesen-Insel Arc)
Bounties sind als String gespeichert (große Zahlen)
Stats reichen von 0.0 bis 10.0
Charaktere ohne bekanntes Bounty haben "0" als Wert
Die API ist read-only — keine Schreibzugriffe möglich
Bei Fragen oder Feedback: Kontaktformular auf tsd-studio.de