API REST vs SOAP API de la tecnología

Las dos arquitecturas principales para las API son REST y SOAP. Al crear su API, realmente tienes tres opciones: REST, SOAP, o ambos. API REST son conocidos por ser fácil y rápida de desarrollar para, pero, la solicitud se envía en claro, independientemente del tipo de cifrado utilizado. API SOAP son más complejos, que requieren un mayor esfuerzo para generar la respuesta y controlar la solicitud, pero permiten una mayor flexibilidad al añadir soporte de espacio de nombres. Proporcionar API de ambos tipos puede parecer una opción atractiva, pero tenga en cuenta que será el doble de su mantenimiento, soporte, y el tiempo de la documentación para la vida de la API.

Ambos métodos de la API ya se han introducido en longitud; esta sección se concentra en las diferencias a tener en cuenta en el desarrollo de una API.

REST API

Cuando se recibe una petición REST, la información vendrá a través de GET. Como tal, toda la información tendrá que ser una URL codificada durante la transmisión, es probable que desee para descodificarlo antes de someterlo a ningún tratamiento posterior (con la excepción de nombres de usuario y contraseñas, que generalmente son procesados como está). Los diferentes tipos solicitud debe ser enviada a los puntos finales diferentes (URL), si desea utilizar una única secuencia de comandos para manejar todas las solicitudes, puede presentarlo a los desarrolladores de esa manera (todas las solicitudes de ir a un extremo único), o configurar su web servidor a los extremos del mapa a muchos a una única secuencia de comandos. Yo generalmente sugiere este último, es en línea con el pliego de condiciones y que le permite realizar cambios más adelante sin afectar a los desarrolladores utilizar interfaces externas.

Considere la posibilidad de permitir a los desarrolladores utilizar un interfaz web para hacer peticiones en contra de la API. Esto puede ser de gran utilidad cuando se trata de diagnosticar un problema, los desarrolladores serán capaces de determinar rápidamente si el problema es la solicitud o de sus códigos. Las herramientas más que se puede brindar a los desarrolladores en cuanto a diagnóstico, más fácil será el desarrollo de su sitio.

SOAP API

Cuando la solicitud SOAP entra, en primer lugar, se deben comprobar para asegurarse de que cumple con el formato especificado por el documento WSDL. Si está utilizando una herramienta como NuSOAP, esto se hace para usted. De hecho, la mayoría de las API SOAP utiliza algún tipo de marco que se ocupa de un montón de trabajo pesado al manejar las solicitudes. API SOAP utilizar un extremo único para todas las solicitudes (por regla general, algunos API grandes delimitación de las competencias dispares en diferentes criterios de valoración), y como resultado que probablemente sea una secuencia de comandos grandes en ese punto, o un montón de require () llama a ejecutar dependiendo de la convocatoria en cuestión.

Considere la posibilidad de permitir a los desarrolladores utilizar una interfaz web, donde puede pegar documentos de toda solicitud en un formulario, y ejecutarlos en contra de su servidor. Hablando desde la experiencia directa, que tiene algo como esto disponible es de gran utilidad para los desarrolladores cuando se trata de diagnosticar un problema. Proporcionar las secuencias de comandos o funciones en su sitio para permitir a los desarrolladores crear manualmente las solicitudes también serán de gran ayuda para los desarrolladores que no utilicen un marco de SOAP.

presentado por Emanuela Hedrick