mit Transparenz möchten wir den Gebraucht-Möbelmarkt voran bringen:
Jeder Programmierer kann über eine Schnittstelle sowohl unsere deutschlandweite (und künftig Vielländer) Sachspenden-Datenbank sowie viele weitere Gebrauchtmöbel-Datenbanken auslesen.
Hinweis: wer nicht programmieren kann, klickt hier
Warum haben wir diese API erstellt:
- Damit jeder, sofort und kostenfrei erfahren kann wo welche Gegenstände gerade stehen
- Jede Stadt, Landkreis, Verein und Verband kann mithilfe dieser Schnittstelle die Sachen auf seiner Internetseite/Newsletter/Landkarte … anzeigen, die für seine Leser / Zielgruppe interessant sind.
PS: wir suchen ehrenamtliche Helfer und Programmierer
Datenbestand
Viele Datenbanken mit täglich über 30.000 Möbelstücken stehen uns zur Verfügung. Viele sind bereits jetzt über diese API zugänglich, weitere Datenbanken werden schrittweise eingebunden.
So sind die Gebrauchtmöbel aus der Sachspenden-Datenbank von WeiterGeben.org, von fast 100 regionalen Verschenkmärkten, Gebrauchtportalen und Gebrauchthändlern über eine Schnittstelle verfügbar.
Beispiel-Möglichkeiten:
- Kultusministerium: alle verfügbaren Schulmöbel in seinem Bundesland
- Gartenverein: alle verfügbaren Gartenmöbel in seiner Region
- Sozialeinrichtung: im gleichen Stadtteil Küchen, Wohn- und Schlafzimmermöbel
Funktionen:
- Mit dieser Schnittstelle können Gebrauchtmöbel
im gesamten deutschsprachigen Raum (Deutschland, Österreich, Liechtenstein, Schweiz), komplett oder regional (grenzübergreifend da Radius basiert) angezeigt werden. - Es können Sachspenden angezeigt werden die
EXKLUSIVE für Gemeinnützige und/oder Sachspenden für die Allgemeinheit bereit gestellt werden. - Ausserdem können einzelne, mehrere oder alle 11 Kategorien ausgewählt werden
(Büro, Garten, Gastronomie, Gesundheit, Kinder, Laden, Lager, Schule, Sport, Wohnung, Werkstatt)
API für gebrauchte Gegenstände
https://weitergeben.org/wp-json/wgorg/v1/infosystem/get-offers
HTTP-Anfrage-Methode: GET
siehe: JSON-Parameter für Gebrauchtmöbel (funktioniert nur mit Firefox !)
Benötigte Parameter:
- country
(eines dieser Länder: DE, AT, CH, LI) - zip
(= Postleitzahl, Deutschland 5stellig, andere Länder 4stellig) - radius
( ‚0‘ für gesamt deutschsprachiger Raum ) - categories
(Mehrere Kategorien mit ‚_‘ verbunden. ‚Alle‘ für alle Kategorien)
Optionale Parameter:
- min-amount
Minimale Anzahl: Anzahl die von einem Produkt noch übrig sein soll
Empfehlung: da über 50% der Angebote einzelne Möbelstücke sind sollten Sie „1“ eintragen - charitable
Gemeinnützig:
* Wahrheitswert, wenn wahr (1), werden Produkte für nur Gemeinnützige angezeigt.
* Wenn falsch (0), werden nur auch der Öffentlichkeit zugängliche angezeigt.
* Wenn nichts angegeben wird beide - defective
Defekt / nicht defekt:
* Wahrheitswert, wenn wahr (1), werden ? defekte Möbel angezeigt.
* Wenn falsch (0), werden nur ? defekte Möbel angezeigt.
* Wenn nichts angegeben wird beide - available
ab diesem Datum kann man den Gegenstand abholen - incl_ext_srcs
so wird zusätzlich auch in anderen (externen) Gebraucht-Datenbanken gesucht
Rückgabewerte (JSON-Format):
– ID
– Land
– Stadt
– PLZ
– Distanz
– Kategorie
– Anzahl noch übrig
– Zustand
– Abnutzungsgrad (normale Gebrauchsspuren / starke Gebrauchsspuren)
„worn_down“
– Nur für Gemeinnützige (wahr/falsch)
– Bilder (Liste mit urls)
– item (Produkt)
– Link zum Angebot
– Erstellungsdatum
– amount_remaining (aktuell verfügbare Menge)
– Preis (bei Möbelspenden / Vermittlungsgebühr wird immer „0“ ausgegeben. Falls über den Parameter incl_ext_srcs auch zusätzliche Gebrauchtmöbel-Datenbanken abgefragt werden, wird der Verkaufspreis übermittelt)
Wichtig:
Sollten Sie nicht für eine gemeinnützige Organisation/en arbeiten, dann lassen Sie sich bitte nur die „Nur für Gemeinnützige = falsch“ anzeigen !
PS: Möbel spenden kann man manuell über dieses Formular:
https://weitergeben.org/moebel-spenden-formular/
Ein großes Dankenschön geht an unseren ehrenamtlichen Helfer Moritz, der diese API (und vieles mehr) erstellt hat und an Jerome für die tollte Unterstützung.