Eigene API mit ASP.NET Core: Todo API
Normalerweise befasse ich mich ja meistens mit dem Frontend einer App, aber in diesem Beitrag möchte ich nun zeigen, wie man mit wenig Aufwand eine eigene kleine API mit der Hilfe von ASP.NET Core entwickeln kann. Das Ziel wird sein eine eigene kleine Todo-API zu entwickeln, wo man neue Einträge hinzufügen, die Einträge abrufen, den Status von offen auf erledigt ändern und einzelne Einträge auch löschen kann.
ngrok: localhost nach außen freigeben
Wenn man beginnt an einer API zu arbeiten, wird diese meist zunächst über localhost verfügbar gemacht, aber dies hat zur Folge, dass der Zugriff auf die API wirklich nur auf dem eigenen Rechner möglich ist. An dieser Steller kommt ein kleines Kommandozeilen-Tool zum Einsatz, nämlich ngrok. Dieses Tool generiert eine URL für euch, welche den Zugriff von localhost auch von anderen Rechner ermöglicht. Dies hat den großen Vorteil, dass zum Beispiel gleich mehrere Entwickler Zugriff auf die API erhalten können, ohne selbst die API hosten zu müssen.
Liste öffentlicher APIs
Als Entwickler stand ich schon öfters vor dem Problem, welche APIs gibt es bereits auf dem Markt und welche lassen sich dadurch vielleicht auch relativ einfach in eigenen App-Projekten verwenden. Eine einfache Suche nach JSON API liefert nicht immer das passende Ergebnis und man muss teilweise sehr genau wissen, wonach man sucht um eine passende API zu finden. Hier kommt nun aber Projekt Public APIs von Todd Motto ins Spiel, denn dieser hat in einem GitHub-Repository eine Vielzahl von APIs aufgeführt, welche man schnell und einfach verwenden kann.
Mittlerweile hat das Projekt über 550 gelistete APIs, welche auch noch in verschiedenen Kategorien, wie zum Beispiel Tiere, Sport, Unterhaltung, News oder auch Musik kategorisiert sind. Ein Blick lohnt sich hier auf jeden Fall.
Da es bei diesem Projekt um APIs geht, ist es natürlich nicht verwunderlich, dass es ebenfalls eine API gibt, um die Daten abzugreifen und vielleicht in einer eigenen Anwendung zu verwenden. Unter dem Endpunkt https://api.publicapis.org/ findet man alle weiteren Informationen.Insgesamt ein sehr gelungenes Projekt, welches auch als Nachschlagewerk für öffentliche APIs dient. Die meisten APIs stehen zwar nur in einer englischen Version zur Verfügung, aber trotzdem lohnt sich immer mal wieder ein Blick.
mockable.io – Eine Api mocken
Meistens entwickle ich das Frontend einer Anwendung bzw. App, so dass mir meistens ein entsprechender Webdienst zur Verfügung gestellt wird, welcher mir die Daten z.B. per JSON liefert. Manchmal kommt es jedoch vor, dass die Entwicklung der API noch nicht abgeschlossen ist und ich diese somit noch nicht verwenden kann. An dieser Stelle kommt nun der kostenlose Dienst mockable.io ins Spiel. Dieser erlaubt es z.B. die JSON-Antwort, welche später das Backend liefert, zu simulieren und macht diese unter einen eigenen URL erreichbar.