Was bedeutet offene API-Schnittstelle?

Offene API, API bedeutet Anwendungsprogrammierschnittstelle, offene API bedeutet offene Anwendungsprogrammierschnittstelle. Wenn wir sagen, dass ein Programm eine API öffnet, bedeutet dies, dass es eine Schnittstelle öffnet, damit die Programme anderer Leute Ihre Programmdaten aufrufen können. So wie Ihr Computer, Ihr Mobiltelefon usw. über einige USB-Schnittstellen verfügen, kann man auch von offenen Schnittstellen sprechen. Über diese Schnittstellen können andere Funktionen wie das Einlegen von U-Disks, das Aufladen usw. ausführen.

Entwicklungsmethoden

Wenn Sie eine offene API veröffentlichen und diese schwierig zu integrieren ist und nicht mit Relevant geliefert wird Standards oder beigefügte, aber nicht geeignete Standards, dann wird kein Entwickler das System nutzen. Der beste Weg, um sicherzustellen, dass Ihre API von anderen verwendet werden kann, besteht darin, sie in Ihrer eigenen Anwendung zu verwenden. Dies ist das Sprichwort „Machen Sie es und verwenden Sie es“.

Die Entscheidung, welcher API-Standard verwendet werden soll, ist sehr wichtig, da die Zielgruppe jedes API-Standards sehr spezifisch ist. Wenn Sie eine große Anzahl von Benutzern unterstützen möchten, verwenden Sie eine einfache API, die keinen großen Overhead erfordert, beispielsweise eine RESTful-API. Der REST-Standard ist sehr breit gefächert. Die beste Vorgehensweise besteht darin, sicherzustellen, dass Ihre API konsistent ist. Ich verwende beispielsweise kein SOAP, weil es zu komplex ist.

SOAP ist das Hauptprotokoll zum Erstellen webbasierter APIs, aber im Vergleich zu REST und JSON ist es zu alt. Ich habe festgestellt, dass die Verwendung von JSON als Antwort anstelle von SOAP und XML das Leben viel einfacher macht. Mit JSON kann ich ein einfaches Objektformat zurückgeben, das in fast jeder Sprache analysiert werden kann.

Durch das Anhängen von Standards an gängige APIs zur Authentifizierung (z. B. OpenID, OAuth und SAML) kann die Verwendung Ihrer API für Entwickler und Nicht-Entwickler gleichermaßen benutzerfreundlich sein. Wenn Sie sich nicht um die Authentifizierung von Benutzern kümmern, verwenden Sie eine einfache HTTP-basierte oder tokenbasierte Authentifizierung anstelle von OpenID, OAuth oder SAML, die hauptsächlich für die Authentifizierung von Benutzern konzipiert sind.

Außerdem wäre es für Entwickler von Vorteil, eine offene API bereitzustellen, die selbst dokumentiert ist. Ich habe vor kurzem damit begonnen, Swagger-API-Dokumentation zu meiner API hinzuzufügen. Mit Swagger können Entwickler automatisch Code für APIs in mehreren Sprachen generieren. Wenn Sie diesen Ansatz nicht verfolgen, sollten Sie zumindest sicherstellen, dass Sie API-Client-Bibliotheken bereitstellen, die die gängigsten Sprachen wie Java, Node.js, Python, Ruby und objektorientiertes C (das für die Entwicklung verwendet wird) verwenden mobile Anwendungen).

Der Schlüssel liegt darin, einfache Software-Glaubensbekenntnisse und -Standards zu befolgen. Erfinden Sie die API nicht neu, erschweren Sie die Authentifizierung nicht.

Das obige ist der detaillierte Inhalt vonWas bedeutet offene API-Schnittstelle?. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!