¿Cómo explico las API para una audiencia no técnica?

Question

Un poco de historia: tengo la oportunidad de presentar la idea de una API pública a la administración de una gran compañía de automóviles compartidos en mi país. Actualmente, las únicas opciones para reservar un automóvil son una interfaz web muy lenta y un centro de llamadas de difícil acceso. Así que estoy entusiasmado con la posibilidad de escribir mi propia interfaz de búsqueda, integrando esta funcionalidad en otros productos y aplicaciones, etc.

El problema: debido a la naturaleza especial de esta empresa, primero tendré que obtener mi propuesta a través de una comisión, que está compuesta en su totalidad por personas no técnicas y bastante conservadoras. ¿Cómo explico el concepto de API a una audiencia así?

Answer 1

Durante años, los vendedores tienen presentaciones basadas en dos cosas: Características y Beneficio. Cada característica debería tener un beneficio asociado (para alguien, y preferiblemente para todos). En este caso, al parecer estás planeando romper lo que es básicamente una aplicación monolítica en (al menos) dos piezas: una interfaz y una interfaz. Los beneficios obvios son que 1) cada uno funciona de forma independiente, por lo que el desarrollo de cada uno es más fácil. 2) diferentes personas pueden desarrollar las diferentes piezas, 3) es más fácil aumentar la capacidad simplemente comprando más hardware.

Aunque no lo ha dicho explícitamente, creo que una intención es documentar públicamente la API. Esto permite a los desarrolladores externos hacerse cargo (al menos algunos) del desarrollo del código de front-end (a menudo de forma gratuita, no menos) mientras usted retiene el control sobre las partes que son cruciales para su proceso de negocio. Puede [permitir más fácilmente] que otros usuarios agreguen nuevos códigos front-end para abordar nuevos segmentos de mercado, al mismo tiempo que conservan la seguridad/certeza de que el proceso comercial subyacente no se verá afectado en el proceso.

Answer 2

No explique detalles técnicos como una API. Indique el problema comercial y su solución al problema comercial, y cómo impactaría sus resultados.

Answer 3

Debe explicar qué casos de uso mejorará con su propuesta de proyecto. ¿Qué beneficios pueden esperar, como la satisfacción del cliente?

Answer 4

La respuesta de HardCode es correcta en cuanto a que realmente debería concentrarse en los problemas y beneficios del negocio.

Sin embargo, si realmente siente que necesita explicar algo que podría utilizar la anotación de recepcionista médica.

Una práctica médica tiene su propia base de datos de pacientes y el sistema de programación de citas utilizado por su personal administrativo y médico. Esto podría ser bastante complejo internamente.

Sin embargo, cuando desea reservar una cita como paciente, habla con la recepcionista con un simple conjunto de comandos: 'Quiero una cita', 'Quiero ver al doctor X', 'Me siento enfermo' y ellos interfaz a sus sistemas en función de su historial médico, los síntomas presentados y la disponibilidad de recursos para darle una cita - '4:30 pm mañana' - en un lenguaje simple.

Por lo tanto, hablando en términos generales con la recepcionista es análogo a un programa exterior que utiliza una API. Le permite interactuar con un sistema complejo para obtener la información que necesita sin tener que lidiar con las complejidades internas.

Answer 5

Ellos podrán entender el beneficio de tener una aplicación de teléfono móvil que pueda interactuar con el sistema de reserva, y una API es un componente necesario de eso. El segundo beneficio de que la API sea pública es que no necesariamente tendrá que escribir esa aplicación, sino que otra persona podrá (ya sea que lo haga o no) es otra pregunta, por supuesto).