API Hub
Was du vor dem Aufruf wissen musst.
Zu jeder Version stehen Authentifizierung, Spezifikation und Messwerte. Quelle und Datum sind angegeben.
Zur Version erfasst
Authentifizierung und Spezifikation sind für jede Version erfasst.
Zwei Versionen derselben API können unterschiedliche Authentifizierungsmethoden haben. Deshalb gehören diese Fakten zur jeweiligen Version und nennen ihre Quelle.
Authentifizierung
Keine Authentifizierung, API-Schlüssel oder Nutzerautorisierung werden für jede Version erfasst. Ändert sich die Methode, bleibt der Eintrag der alten Version unverändert.
Spezifikation
Der Eintrag nennt den Ort der Spezifikation, ihren Anbieter und das Datum der Bestätigung.
Messung
Messwerte nennen immer Kennzahl, Methode, Bedingungen, Einheit und Zeitpunkt.
Quelle
Jede Tatsache nennt den Anbieter, eine öffentliche Quelle oder eine Messung der Community als Ursprung. Importierte Daten verweisen auf Quelle und Lizenz.
Messungen und Bewertungen sind verschieden. Bewertungen geben Meinungen wieder. Messungen zeigen, was unter bestimmten Bedingungen gemessen wurde.
Messung
Lies zuerst diese fünf Angaben zu einer Messung.
Prüfe Kennzahl, Methode, Bedingungen, Einheit und Zeitpunkt. Achte beim Vergleich auch auf Ergebnis, Gegenstand und Umfang.
Kennzahl
Was gemessen wird.
Methode
Wie gemessen wird.
Bedingungen
Unter welchen Bedingungen gemessen wird.
Einheit
Einheit des Messwerts.
Zeitpunkt
An welchem Tag gemessen wurde. Ältere Ergebnisse behalten ihr Datum.
Ergebnisse derselben Kennzahl bilden einen Verlauf und lassen sich mit anderen APIs vergleichen.
Fehlende Daten
Unbekannt, null und nicht zutreffend sind verschiedene Angaben.
Nicht gemessen bedeutet unbekannt, nicht null. Nicht zutreffende Kennzahlen gelten nicht als fehlende Daten. Fehlende Daten werden nicht zu irreführenden Bewertungen.
Kläre die Authentifizierung, bevor du die API einbindest.
Finde APIs, verfolge Versionsänderungen und teile deine Erfahrungen mit anderen.