Как мне объяснить API нетехнической аудитории? - PullRequest
8 голосов
/ 26 января 2010

Немного предыстории: у меня есть возможность представить идею публичного API руководству крупной компании по обмену автомобилями в моей стране. В настоящее время единственными вариантами бронирования автомобиля являются очень медленный веб-интерфейс и труднодоступный колл-центр. Поэтому я рад возможности написать свой собственный интерфейс поиска, интегрировать эти функции в другие продукты и приложения и т. Д.

Проблема: из-за особого характера этой компании, я сначала должен получить мое предложение через комиссию, которая полностью состоит из нетехнических и довольно консервативных людей. Как объяснить концепцию API такой аудитории?

Ответы [ 5 ]

10 голосов
/ 26 января 2010

Не объясняйте технические детали, такие как API. Укажите бизнес-проблему и ваше решение бизнес-проблемы - и как это повлияет на их итоги.

4 голосов
/ 26 января 2010

В течение многих лет продавцы основывали свои идеи на двух вещах: Особенности и Преимущества. Каждая функция должна иметь соответствующую выгоду (для кого-то, и желательно для всех). В этом случае вы, очевидно, планируете разбить то, что по сути является монолитным приложением, на (как минимум) две части: переднюю часть и заднюю часть. Очевидные преимущества заключаются в том, что 1) каждый работает независимо, поэтому разработка каждого из них легче. 2) разные люди могут разрабатывать разные части, 3) увеличить емкость проще, просто купив больше оборудования.

Хотя вы не сказали об этом явно, я предполагаю, что одно из намерений состоит в том, чтобы публично документировать API. Это позволяет сторонним разработчикам взять на себя (по крайней мере, некоторую) разработку интерфейсного кода (часто бесплатно, не менее), в то время как вы сохраняете контроль над частями, важными для вашего бизнес-процесса. Вы можете легче [разрешить другим] добавлять новый интерфейсный код для работы с новыми сегментами рынка, сохраняя при этом безопасность / уверенность в том, что основной бизнес-процесс не будет нарушен.

3 голосов
/ 26 января 2010

HardCode ответ верен в том, что вы действительно должны сосредоточиться на бизнес-вопросах и преимуществах.

Однако, если вы действительно чувствуете, что вам нужно что-то объяснить, вы можете воспользоваться аналогом медицинского регистратора.

Медицинская практика имеет собственную базу данных пациентов и систему планирования встреч, используемую ее администратором и медицинским персоналом. Это может быть довольно сложно внутри.

Однако, когда вы хотите записаться на прием в качестве пациента, вы разговариваете с администратором с помощью простого набора команд: «Я хочу назначить встречу», «Я хочу посетить доктора X», «Я чувствую себя больным», и они взаимодействуют к их системам, основанным на вашей истории болезни, представленных симптомах и наличии ресурсов, чтобы назначить вам встречу - «16:30 завтра» - на простом языке.

Итак, грубо говоря, использование регистратора аналогично внешней программе, использующей API. Он позволяет вам взаимодействовать со сложной системой, чтобы получать необходимую информацию, не сталкиваясь с внутренними сложностями.

1 голос
/ 26 января 2010

Они смогут понять преимущества наличия приложения для мобильного телефона, которое может взаимодействовать с системой бронирования, и API является необходимым компонентом этого.Второе преимущество публичности API заключается в том, что вам не обязательно писать это приложение, а кто-то другой сможет это сделать (независимо от того, действительно ли они это делают, это, конечно, другой вопрос).

0 голосов
/ 26 января 2010

Вы должны объяснить, какие варианты использования будут улучшены вашим проектным предложением. Какие выгоды они могут ожидать, такие как удовлетворенность клиентов.

...