15 preguntas que deberías facer sobre a súa API antes de seleccionar unha plataforma

Preguntas de selección de API

Un bo amigo e mentor escribiu unha pregunta para min e gustaríame usar as miñas respostas para esta publicación. As súas preguntas estaban un pouco máis centradas nunha industria (correo electrónico), polo que xeneralicei as miñas respostas a todas as API. Preguntou que preguntas debería facer unha empresa a un provedor sobre a súa API antes de facer unha selección.

Por que precisas API?

An interface de programación de aplicacións (API) é a interface que proporciona un sistema informático, unha biblioteca ou unha aplicación para permitir que outros programas informáticos fagan solicitudes de servizos dela e / ou que permitan intercambiar datos entre eles.

Wikipedia

Así como escribe unha URL e obtén unha resposta de novo nunha páxina web, a API é un método onde os seus sistemas poden solicitar e obter unha resposta para sincronizar os datos entre eles. Mentres as empresas buscan transformarse dixitalmente, automatizar tarefas a través das API é unha boa forma de mellorar a eficiencia na organización e reducir os erros humanos.

As API son fundamentais para a automatización, especialmente nas aplicacións de mercadotecnia. Un dos retos á hora de mercar un gran vendedor cun completo API é que os recursos e gastos de desenvolvemento adoitan ser un pensamento posterior. O equipo de mercadotecnia ou CMO pode impulsar a compra dunha aplicación e ás veces o equipo de desenvolvemento non recibe moita información.

Investigar as capacidades de integración dunha plataforma a través dunha API require máis que a simple pregunta, Hai algunha API?

Se inicias sesión cunha aplicación cunha API mal soportada ou documentada, farás tolear ao teu equipo de desenvolvemento e é probable que as túas integracións resulten curtas ou fallen por completo. Atopa o provedor axeitado e a túa integración funcionará e a túa xente de desenvolvemento estará encantada de axudarche.

Preguntas de investigación sobre as súas capacidades de API:

  1. Característica Gap - Identificar que características da súa interface de usuario están dispoñibles a través da interface de programación de aplicacións. Que características ten a API que a IU non ten e viceversa?
  2. Escala - Preguntar cantas chamadas se fan ás súas API diariamente. Teñen un grupo dedicado de servidores? A cantidade é incriblemente importante xa que quere identificar se a API é un pensamento posterior ou realmente parte da estratexia da empresa.
  3. documentación - Solicite a documentación da API. Debe ser robusto, describir todas as funcións e variables dispoñibles na API.
  4. comunidade - Pregunta se teñen ou non unha comunidade de desenvolvedores en liña dispoñible para compartir código e ideas con outros desenvolvedores. As comunidades de desenvolvedores son fundamentais para iniciar os seus esforzos de desenvolvemento e integración de xeito rápido e eficiente. En lugar de aproveitar o "tipo API" da empresa, tamén está a aproveitar a todos os seus clientes que xa tiveron probas e erros ao integrar a súa solución.
  5. DESCANSO vs XABÓN - Preguntar de que tipo API teñen ... Normalmente hai API REST e API de servizos web (SOAP). É posible que estean desenvolvendo ambos. Integrarse con calquera ten vantaxes e maldicións ... debería estar familiarizado coas capacidades dos seus recursos de integración (TI).
  6. idiomas - Pregunta con que plataformas e aplicacións se integraron con éxito e solicita contactos para que coñezas daqueles clientes a dificultade de integración e o bo funcionamento da API.
  7. Limitacións - Pregunta que limitacións ten o provedor no número de chamadas por hora, por día, por semana, etc. Se non estás cun provedor escalable, o teu crecemento será limitado polo cliente.
  8. Mostras - ¿Ofrecen unha biblioteca de exemplos de código para comezar facilmente? Moitas empresas publican SDK (kits de desenvolvemento de software) para diferentes idiomas e marcos que acelerarán a súa cronoloxía de integración.
  9. sandbox - ¿Ofrecen un entorno final ou de caixa de probas non de produción para que poida probar o seu código?
  10. Recursos - Pregunta se teñen recursos dedicados á integración dentro da súa empresa. Teñen un grupo de consultoría interno dispoñible para a integración? Se é así, prema algunhas horas no contrato.
  11. seguridade - Como se autentican usando a API? Son credenciais de usuario, claves ou outras metodoloxías? ¿Poden restrinxir as solicitudes por enderezo IP?
  12. Uptime - Pregunta cal é o seu API o tempo de actividade e a taxa de erros son e cando son as horas de mantemento. Tamén son importantes as estratexias para traballar arredor delas. ¿Teñen procesos internos que se volverán intentar? API chamadas no caso de que o rexistro non estea dispoñible debido a outro proceso? ¿É algo que elaboraron na súa solución?
  13. SLA - Teñen un Service Level Agreement onde os tempos de actividade deben ser superiores ao 99.9%?
  14. Roadmap - Que características futuras incorporan á súa API e cales son os calendarios de entrega previstos?
  15. Integracións - Que integracións produtivas desenvolveron ou que desenvolveron terceiros? Ás veces, as empresas poden renunciar ao desenvolvemento interno das funcións cando xa existe e está a ser compatible outra integración produtiva.

A clave destas preguntas é que a integración "casa" coa plataforma. Non queres casar con alguén sen saber todo o que podes sobre el, non si? Isto é o que acontece cando a xente compra unha plataforma sen coñecer as súas capacidades de integración.

Máis alá dunha API, tamén debes intentar descubrir que outros recursos de integración poden ter: codificación de barras, mapeamento, servizos de limpeza de datos, RSS, formularios web, widgets, integracións formais de socios, motores de script, caídas de SFTP, etc.

2 Comentarios

  1. 1

¿Que pensas?

Este sitio usa Akismet para reducir o spam. Aprende a procesar os teus datos de comentarios.