jonboi.de

Wort des Tages API

Alle Endpunkte haben den Prefix /Wort-des-Tages und können von api.jonboi.de abgefragt werden.

Zum Beispiel liefert eine GET-Request an api.jonboi.de/Wort-des-Tages/Wort das aktuelle Wort-des-Tages.

/Wort

GET

Gibt das aktuelle Wort-des-Tages zurück. 
{
    "Wort": string,
    "Bedeutungen": [{"Bedeutung": string, "Beispiele": string[]}]
}

/Wort/DD-MM-YYYY

GET

Gibt das Wort-des-Tages für das angegebene Datum zurück. Erwartet immer ein gepaddetes Datum im Format DD-MM-YYYY. 
{
    "Wort": string,
    "Bedeutungen": [{"Bedeutung": string, "Beispiele": string[]}]
}

/Rating

GET

Gibt eine Liste an Bewertungen für das aktuelle Wort-des-Tages zurück. 
[
  {
    "Name": string,
    "Rating": {
                "Exotik": number,
                "Relevanz": number,
                "Eindruck": number,
                "Unbekanntheit": number
              }
  }
]
Hierbei liegt die Bewertung für Exotik und Unbekanntheit zwischen 0 und 2 und die Bewertung für Relevanz und Eindruck zwischen 0 und 3.

POST

Reiche eine Bewertung für das Wort-des-Tages des angebenen Datums ein. 
{
    "Name": string,
    "Rating": {
                "Exotik": number,
                "Relevanz": number,
                "Eindruck": number,
                "Unbekanntheit": number
              }
}
Auch hier muss Exotik und Unbekanntheit zwischen 0 und 2 liegen und Relevanz und Eindruck zwischen 0 und 3.

/Rating/DD-MM-YYYY

GET

Gibt eine Liste an Bewertungen für das Wort-des-Tages des angegebenen Datums zurück. Erwartet immer ein gepaddetes Datum im Format DD-MM-YYYY 
[
  {
    "Name": string,
    "Rating": {
                "Exotik": number,
                "Relevanz": number,
                "Eindruck": number,
                "Unbekanntheit": number
              }
  }
]
Hierbei liegt die Bewertung für Exotik und Unbekanntheit zwischen 0 und 2 und die Bewertung für Relevanz und Eindruck zwischen 0 und 3.

POST

Reiche eine Bewertung für das aktuelle Wort-des-Tages ein. 
{
    "Name": string,
    "Rating": {
                "Exotik": number,
                "Relevanz": number,
                "Eindruck": number,
                "Unbekanntheit": number
              }
}
Auch hier muss Exotik und Unbekanntheit zwischen 0 und 2 liegen und Relevanz und Eindruck zwischen 0 und 3.

/Top

GET

Gibt eine Liste der top 50 best bewerteten Wörter zurück. 
[
  {
    "Wort": string,
    "Date": string,
    "Rating": {
                "Exotik": number,
                "Relevanz": number,
                "Eindruck": number,
                "Unbekanntheit": number
              }
  }
]
Hierbei liegt die Bewertung für Exotik und Unbekanntheit zwischen 0 und 2 und die Bewertung für Relevanz und Eindruck zwischen 0 und 3.

/Top/N-M

GET

Gibt eine Liste der top M-N+1 best bewerteten Wörter beginnend ab dem Nten Wort zurück. Eine Anfrage an /Wort-des-Tages/Top/50-100 wird also alle Wörter von Platz 50 bis 100 zurückgeben. Erwartet immer ein gepaddetes Datum im Format DD-MM-YYYY 
[
  {
    "Wort": string,
    "Date": string,
    "Rating": {
                "Exotik": number,
                "Relevanz": number,
                "Eindruck": number,
                "Unbekanntheit": number
              }
  }
]
Hierbei liegt die Bewertung für Exotik und Unbekanntheit zwischen 0 und 2 und die Bewertung für Relevanz und Eindruck zwischen 0 und 3.

/Top/Exotik,/Top/Relevanz,/Top/Eindruck,/Top/Unbekanntheit

GET

Gibt eine Liste der top 50 best bewerteten Wörter in dieser Kategorie zurück. 
[
  {
    "Wort": string,
    "Date": string,
    "Rating": {
                "Exotik": number,
                "Relevanz": number,
                "Eindruck": number,
                "Unbekanntheit": number
              }
  }
]
Hierbei liegt die Bewertung für Exotik und Unbekanntheit zwischen 0 und 2 und die Bewertung für Relevanz und Eindruck zwischen 0 und 3.

/Top/Exotik/N-M,/Top/Relevanz/N-M,/Top/Eindruck/N-M,/Top/Unbekanntheit/N-M

GET

Gibt eine Liste der top M-N+1 best bewerteten Wörter in der angebenen Kategorie, beginnend ab dem Nten Wort zurück. Erwartet immer ein gepaddetes Datum im Format DD-MM-YYYY 
[
  {
    "Wort": string,
    "Date": string,
    "Rating": {
                "Exotik": number,
                "Relevanz": number,
                "Eindruck": number,
                "Unbekanntheit": number
              }
  }
]
Hierbei liegt die Bewertung für Exotik und Unbekanntheit zwischen 0 und 2 und die Bewertung für Relevanz und Eindruck zwischen 0 und 3.