REST API vs SOAP API-technologie


  Share  
|

De twee primaire architecturen voor API's worden REST en SOAP. Bij het aanmaken van uw API, je echt drie opties: REST, SOAP, of beide. REST API's bekend om staan zijn eenvoudig en snel te ontwikkelen voor, maar het gehele verzoek wordt verstuurd in de heldere, ongeacht het type van encryptie gebruikt. SOAP API's worden complexer, die meer inspanning om de respons te genereren en behandelen het verzoek, maar zorgen voor een grotere flexibiliteit door toevoeging van namespace support. Het verstrekken van API's van beide typen klinkt misschien als een aantrekkelijke optie, maar houd in gedachten dat het verdubbelen uw onderhoud, ondersteuning en documentatie tijd voor het leven van de API.

API Beide methoden zijn al geïntroduceerd op lengte; dit deel concentreert zich op de verschillen in mening te houden bij de ontwikkeling van een API.

REST API

Bij ontvangst van een verzoek REST, zal de informatie komen via GET. Als zodanig zal alle informatie moeten worden URL-gecodeerd tijdens de transmissie, je zal waarschijnlijk wilt decoderen alvorens het te onderwerpen aan een verdere verwerking (de uitzondering gebruikersnamen en wachtwoorden, die over het algemeen als verwerkte-is). Verschillende soorten verzoek moet worden gericht aan verschillende eindpunten (URL's), als je wilt een script te gebruiken om alle verzoeken te behandelen, kunt u ofwel presenteren aan ontwikkelaars op die manier (alle verzoeken naar een eindpunt), of configureer uw website server in kaart veel eindpunten aan een script. Ik zou in het algemeen suggereren het laatste, het is inline met de specificatie en het u toestaat om later wijzigingen aanbrengen zonder dat de externe interfaces ontwikkelaars gebruiken.

SOAP API

Wanneer de SOAP verzoek komt, moet eerst worden gecontroleerd om ervoor te zorgen dat het voldoet aan het formaat van uw WSDL-document. Als u een hulpmiddel gebruikt, zoals nuSOAP, is dit voor u gedaan. In feite zijn de meeste SOAP API's gebruiken een kader dat zorgt voor veel van het zware werk bij de behandeling van de verzoeken. SOAP API's gebruiken een eindpunt voor alle aanvragen (als regel enkele grote API's aparte uiteenlopende functies op verschillende eindpunten), en als gevolg hiervan zult u waarschijnlijk hebt een grote script op dat punt, of veel require () oproepen uitgevoerd afhankelijk van de specifieke oproep.

Overweeg zodat ontwikkelaars een web-interface gebruiken waar ze gehele verzoek documenten kunt plakken op een formulier, en lopen ze tegen je server. Spreken uit directe ervaring, met zoiets als dit beschikbaar is van groot nut voor ontwikkelaars wanneer het proberen om de diagnose een probleem. Het verstrekken van scripts of functies op uw site om ontwikkelaars in staat te stellen aanvragen handmatig zal ook van de bijstand aan ontwikkelaars geen gebruik van een SOAP kader.

een artikel afkomstig van Emanuela Hedrick


Share  

© 2005-2010 E-articles.info All Rights Reserved - Terms and conditions