API digitale Schnittstelle für Sachspenden Daten

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:

  1. 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.
  2. Es können Sachspenden angezeigt werden die
    EXKLUSIVE für Gemeinnützige und/oder Sachspenden für die Allgemeinheit bereit gestellt werden.
  3. 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 !

 

API Erklärung MöbelspendenAPI Erklärung Sachspenden Json

zu sehen: Programmierer-code


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.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert