Eine definierte Schnittstelle, über die Programme Funktionen oder Daten anderer Systeme nutzen.
Beispiel aus der Praxis
Ein Agent kann über eine API einen Datensatz lesen. Schlüssel gehören auf den Server, mit minimalen Rechten.
Eine Schnittstelle mit klarer Wirkung
Das Lesen eines Bestellstatus und das Ändern einer Lieferadresse sollten als unterschiedliche Operationen betrachtet werden. Ein Agent benötigt nur die Zugriffe, die sein Auftrag verlangt. Ein vorhandener API-Schlüssel ist kein Grund, alle angebotenen Funktionen freizugeben.
Fehler unterscheiden
Eine fehlende Berechtigung verlangt eine andere Reaktion als ein vorübergehend nicht erreichbarer Dienst. Wiederholungen sollten begrenzt sein und bei schreibenden Aufrufen berücksichtigen, ob eine frühere Anfrage bereits verarbeitet wurde.