freie Spenden-Datenbank – Schnittstelle per API

API digitale Schnittstelle für Sachspenden Daten

mit Transparenz möchten wir den Gebraucht-Möbelmarkt voran bringen:

Jeder Programmierer kann die deutschlandweite (und künftig Vielländer) Möbelspenden-Datenbank auslesen.
Hinweis: wer nicht programmieren kann, klickt hier

Warum haben wir diese API erstellt:

  • Damit jeder, sofort und kostenfrei erfahren kann wo welche Sachspenden gerade stehen
  • Jede Stadt, Landkreis, Verein und Verband kann mithilfe dieser Schnittstelle die Sachspenden auf seiner Internetseite anzeigen, die für seine Leser interessant sind.

PS: wir suchen einen ehrenamtlichen Programmierer/in der/die ein konfigurierbares Web-Widget hierzu erstellen kann.  Ähnlich: https://www.bvg.de/de/Service/Kundenservice/Web-Widgets oder https://www.wetter.com/apps_und_mehr/website/homepagewidget/

Beispiel-Möglichkeiten:

  • Kultusministerium: alle verfügbaren Schulmöbelspenden in seinem Bundesland
  • Gartenverein: alle verfügbaren Gartenmöbelspenden in seiner Region
  • Sozialeinrichtung:  im gleichen Stadtteil Küchen, Wohn- und Schlafzimmermöbel

Funktionen:

  1. Mit dieser Schnittstelle können Möbelspenden
    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

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
– 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)

hinzugefügt wurde nun noch der Ausgabewert: available

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.