Endpoint für Nutzer-Vorschläge

Ein Endpoint für Nutzervorschläge ist zu implementieren und in der API-Spezifikation (appapi.yaml) zu dokumentieren.

Dem Endpoint soll ein optionaler Query-Parameter ?c=[0-10] übergeben werden können, der die maximale Anzahl an Nutzervorschlägen spezifiziert. Zurückgegeben wird ein Array mit einer zufälligen Auswahl von Instanzen des InfoUserSchema-Struct mit Nutzern, die nicht friend des anfragenden Nutzers sind. Der eingeloggte Nutzer selbst soll nicht als Suggestion zurückgegeben werden.

Existieren keine Nutzer, welche für Vorschläge nach den oben genannten Kriterien in Frage kommen, wird ein leeres Array zurückgegeben. Können Ist der Query-Parameter c nicht gesetzt, hat den Wert 0 oder einen anderen numerischen Wert <1, so wird der Standardwert 3 verwendet. Werte c>10 führen zu maximal 10 Vorschlägen. Alle nicht-numerischen Werte für c führen zu einem Fehler HTTP-Status 400 Bad Request.