Wie erkläre ich APIs einem nicht technischen Publikum?

8

Ein kleiner Hintergrund: Ich habe die Möglichkeit, dem Management eines großen Carsharing-Unternehmens in meinem Land die Idee einer öffentlichen API zu präsentieren. Gegenwärtig sind die einzigen Optionen, um ein Auto zu buchen, eine sehr langsame Webschnittstelle und ein schwer zu erreichendes Call Center. Daher freue ich mich über die Möglichkeit, meine eigene Suchoberfläche zu schreiben und diese Funktionalität in andere Produkte und Anwendungen zu integrieren.

Das Problem: Wegen der Besonderheit dieses Unternehmens muss ich zuerst meinen Vorschlag durch eine Kommission machen, die ausschließlich aus nicht-technischen und eher konservativen Leuten besteht. Wie erkläre ich einer solchen Zielgruppe das Konzept einer API?

    
Christian Studer 25.01.2010, 21:55
quelle

5 Antworten

4

Seit Jahren basieren Verkäufer auf zwei Dingen: Eigenschaften und Nutzen. Jedes Merkmal sollte einen damit verbundenen Vorteil haben (für jemanden und vorzugsweise für jeden). 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 einfacher, Kapazität zu erhöhen, indem man einfach mehr Hardware kauft.

Obwohl Sie es nicht explizit gesagt haben, würde ich eine Absicht darin sehen, 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 anzusprechen, während Sicherheit / Gewissheit erhalten bleibt, dass der zugrunde liegende Geschäftsprozess dabei nicht gestört wird.

    
Jerry Coffin 25.01.2010, 22:13
quelle
10

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 auswirkt.

    
HardCode 25.01.2010 21:57
quelle
3

HardCodes Antwort ist richtig, da Sie sich wirklich auf die geschäftlichen Probleme und Vorteile konzentrieren sollten.

Wenn Sie jedoch wirklich das Gefühl haben, etwas erklären zu müssen, können Sie das Analphabet der medizinischen Rezeption 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 interagieren zu ihren Systemen auf der Grundlage Ihrer Krankengeschichte, die Symptome präsentiert und Ressourcenverfügbarkeit, um Ihnen einen Termin - "4:30 Uhr morgen" - in einfacher Sprache.

Grob gesagt ist die Verwendung der Rezeptionistin analog zu einem externen Programm, das eine API verwendet. Es ermöglicht Ihnen, mit einem komplexen System zu interagieren, um die benötigten Informationen zu erhalten, ohne sich mit den internen Komplexitäten auseinandersetzen zu müssen.

    
Cruachan 25.01.2010 22:29
quelle
1

Sie werden 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, jemand anderes wird dazu in der Lage sein (ob sie das nun tatsächlich tun oder nicht, ist natürlich eine andere Frage).

    
Andrew McGregor 25.01.2010 23:26
quelle
0

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

    
stacker 25.01.2010 22:05
quelle