Wie erkläre ich APIs einem nicht technischen Publikum?

Question

Ein kleiner Hintergrund: Ich habe die Möglichkeit, die Idee einer öffentlichen API dem Management eines großen Car-Sharing-Unternehmens in meinem Land zu präsentieren. Gegenwärtig sind die einzigen Optionen, um ein Auto zu buchen, eine sehr langsame Webschnittstelle und ein schwer zu erreichendes Callcenter. Ich bin begeistert von der Möglichkeit, meine eigene Suchoberfläche zu schreiben und diese Funktionalität in andere Produkte und Anwendungen zu integrieren.

Das Problem: Aufgrund der besonderen Art dieser Firma, muss ich zuerst meinen Vorschlag bekommen durch eine Kommission, die ausschließlich aus nicht-technischen und eher konservativen Leuten besteht. Wie erkläre ich einem solchen Publikum das Konzept einer API?

Answer 1

Seit Jahren basieren Verkäufer auf zwei Dingen: Eigenschaften und Nutzen. Jedes Merkmal sollte einen damit verbundenen Vorteil (für jemanden, und vorzugsweise für alle) haben. In diesem Fall planen Sie offenbar, eine monolithische Anwendung in (mindestens) zwei Teile zu zerlegen: ein Frontend und ein Backend. Die offensichtlichen Vorteile sind, dass 1) jeder unabhängig arbeitet, so dass die Entwicklung von jedem einfacher ist. 2) verschiedene Leute können die verschiedenen Stücke entwickeln, 3) es ist leichter, Kapazität zu erhöhen, indem man einfach mehr Hardware kauft.

Obwohl Sie es nicht explizit gesagt haben, würde ich vermuten, dass eine Absicht darin besteht, die API öffentlich zu dokumentieren. Dies ermöglicht externen Entwicklern, (zumindest einige) die Entwicklung des Front-End-Codes zu übernehmen (oft kostenlos, nicht weniger), während Sie die Kontrolle über die Teile behalten, die für Ihren Geschäftsprozess entscheidend sind. Sie können leichter [anderen erlauben], neuen Front-End-Code hinzuzufügen, um neue Marktsegmente zu adressieren, während Sicherheit/Gewissheit bleibt, dass der zugrundeliegende Geschäftsprozess dabei nicht gestört wird.

Answer 2

Erklären Sie keine technischen Details wie eine API. Nennen Sie das Geschäftsproblem und Ihre Lösung für das Geschäftsproblem - und wie es sich auf das Endergebnis auswirken würde.

Answer 3

Sie sollten erklären, welche Anwendungsfälle durch Ihren Projektvorschlag verbessert werden. Welche Vorteile können sie erwarten, wie Kundenzufriedenheit.

Answer 4

Die Antwort von HardCode ist insofern richtig, als Sie sich wirklich auf die geschäftlichen Probleme und Vorteile konzentrieren sollten.

Allerdings, wenn Sie wirklich fühlen Sie müssen etwas zu erklären, können Sie die medizinische Rezeption Analoge verwenden.

Eine Arztpraxis verfügt über eine eigene Patientendatenbank und ein Terminplanungssystem, das von ihrem medizinischen und administrativen Personal verwendet wird. Dies könnte intern sehr komplex sein.

Wenn Sie jedoch einen Termin als Patient buchen möchten, sprechen Sie mit der Rezeption mit einer einfachen Reihe von Befehlen - "Ich möchte einen Termin", "Ich möchte Arzt X sehen", "Ich fühle mich krank" und sie Schnittstelle zu ihren Systemen basierend auf Ihrer Krankengeschichte, den dargestellten Symptomen und der Verfügbarkeit von Ressourcen, um Ihnen einen Termin zu geben - "16:30 Uhr morgen" - in einfacher Sprache.

Also, grob gesprochen mit der Rezeptionist analog zu einem externen Programm mit einer API. Sie können mit einem komplexen System interagieren, um die benötigten Informationen zu erhalten, ohne sich mit den internen Komplexitäten auseinandersetzen zu müssen.

Answer 5

Sie können den Nutzen einer Mobiltelefon-App verstehen, die mit dem Buchungssystem interagieren kann, und eine API ist eine notwendige Komponente dafür. Der zweite Vorteil, dass die API öffentlich ist, ist, dass Sie diese App nicht unbedingt schreiben müssen, eine andere Person wird dazu in der Lage sein (ob sie das tatsächlich tun oder nicht, ist natürlich eine andere Frage).