Spenden-Schnittstelle für Alle per API

API digitale Schnittstelle für Sachspenden Daten

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

Mit wenig Programmieraufwand kann jeder die deutschlandweite (und künftig Vielländer) Möbelspenden-Datenbank auslesen.

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

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
  • 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

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)
– Titel
– Link zum Angebot
– Erstellungsdatum

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

Api-Rückgabe


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.