Intro
Amin'ny tsindry vitsivitsy amin'ny desktop na fitaovana, afaka mividy, mivarotra na mamoaka na inona na inona, amin'ny fotoana rehetra. Ahoana marina no mitranga? Ahoana no vaovao avy eto ho any? Ny mahery fo tsy fantatra dia ny API.
Inona ny API?
API dia midika hoe an FAMPIANARANA FAMPANDROSOANA. Ny API dia maneho singa iray amin'ny rindrambaiko, ny fiasany, ny fidirana, ny vokatra ary ny karazana fototra. Ahoana anefa no hanazavanao ny API amin'ny teny anglisy tsotra? Ny API dia miasa toy ny iraka izay mamindra ny fangatahanao avy amin'ny fampiharana iray ary mamerina ny valiny aminao.
Ohatra 1: Rehefa mitady sidina an-tserasera ianao. Mifandray amin'ny tranokalan'ny zotram-piaramanidina ianao. Ny tranonkala dia manazava ny fipetrahana sy ny vidin'ny sidina amin'io daty sy ora io. Mifidy ny sakafonao na ny fipetrahanao, ny entanao, na ny fangatahanao biby fiompy ianao.
Saingy, raha tsy mampiasa tranokala mivantana an'ny zotram-piaramanidina ianao na mampiasa mpandraharaha fitsangatsanganana an-tserasera izay manambatra angona avy amin'ny zotram-piaramanidina maro. Mba hahazoana ny vaovao dia misy fampiharana mifandray amin'ny API an'ny zotram-piaramanidina. Ny API no interface izay maka angon-drakitra avy amin'ny tranokalan'ny mpivezivezy mankany amin'ny rafitry ny zotram-piaramanidina.
Mitaky ny valintenin'ny zotram-piaramanidina ihany koa izany ary manatitra avy hatrany. Izany dia manamora ny fifandraisana misy eo amin'ny serivisy fitsangatsanganana, ary ny rafitry ny zotram-piaramanidina - ny famandrihana ny sidina. Ny API's dia misy tranomboky ho an'ny mahazatra, firafitry ny angona, kilasin'ny zavatra ary miovaova. Ohatra, serivisy SOAP sy REST.
Ohatra 2: Best Buy dia manome ny vidin'ny Deal of the Day manokana amin'ny alàlan'ny tranokalany. Io angona io ihany no ao amin'ny fampiharana finday. Ny fampiharana dia tsy manahy momba ny rafitra vidin'ny anatiny - afaka miantso ny Deal of the Day API izy ary manontany hoe, inona ny vidiny manokana? Best Buy dia mamaly amin'ny fampahalalana nangatahana amin'ny endrika mahazatra izay asehon'ny fampiharana amin'ny mpampiasa farany.
Ohatra3: Ny API ho an'ny media sosialy dia tena ilaina. Ny mpampiasa dia afaka miditra amin'ny atiny ary mitazona ny isan'ny kaonty sy ny tenimiafina tazony ho ambany, mba hahafahany mitazona zavatra tsotra.
- Twitter API: Mifandraisa amin'ny ankamaroan'ny fiasa Twitter
- Facebook API: Ho an'ny fandoavam-bola, angon-drakitra mpampiasa, ary ny fidirana
- Instagram API: Asio marika ireo mpampiasa, jereo ny sary malaza
Ahoana ny momba ny REST & SOAP API?
SOAP ary HAFA mampiasa serivisy mampiasa API, fantatra amin'ny anarana hoe Web API. Ny serivisy tranonkala dia tsy miankina amin'ny fahalalana teo aloha momba ny fampahalalana. SOAP dia protocol serivisy tranonkala izay tsy miankina amin'ny sehatra maivana. SOAP dia protocole hafatra mifototra amin'ny XML. Tsy toy ny serivisy tranonkala SOAP, ny serivisy Restful dia mampiasa maritrano REST, namboarina ho an'ny fifandraisana amin'ny teboka.
Serivisy tranonkala SOAP
- SOAP Sender - mamorona sy mampita hafatra.
- SOAP Receiver - mahazo sy manodina ny hafatra.
- SOAP Intermediary- mandray sy manodina ny bloc header.
Serivisy Tranonkala FAHASALAMANA
Representation State Transfer (REST) dia mifandraika amin'ny fifandraisan'ny mpanjifa sy ny mpizara ary ny fomba fiasan'ny fanjakana. Ny maritrano fialan-tsasatra, ny REST Server dia manome fahafahana miditra amin'ny mpanjifa. Mikarakara ny famakiana sy ny fanovana na ny fanoratana ny loharanon-karena ny Rest. Ny Uniform Identifier (URI) dia mamaritra ny loharano misy rakitra. Izany dia hisambotra ny toetry ny loharanon-karena.
Ny REST dia maivana kokoa noho ny maritrano SOAP. Izy io dia manara-maso ny JSON, fiteny azo vakin'ny olombelona izay mamela ny fifampizaràna angon-drakitra sy mora kokoa ny mampiasa angona, fa tsy XML ampiasain'ny maritrano SOAP.
Misy fitsipika maromaro amin'ny famolavolana Restful Web Service, izay:
- Addressability - Ny loharano tsirairay dia tokony hanana URL iray farafahakeliny.
- Ny tsy fisian'ny fanjakana - Ny serivisy miala sasatra dia serivisy tsy misy fanjakana. Ny fangatahana dia tsy miankina amin'izay fangatahana taloha nataon'ny serivisy. Ny HTTP dia natao ho protocole tsy misy fanjakana.
- Cacheable - Ny angon-drakitra voamarika ho fivarotana azo tehirizina ao amin'ny rafitra ary ampiasaina indray amin'ny ho avy. Toy ny valin'ny fangatahana mitovy fa tsy mamokatra vokatra mitovy. Ny faneriterena ny cache dia ahafahan'ny fanamarihana ny angona valinteny ho azo tehirizina na tsy azo cache.
- Interface fanamiana - Mamela ny interface mahazatra sy manara-penitra ampiasaina amin'ny fidirana. Ny fampiasana angon-drakitra voafaritra amin'ny fomba HTTP. Ny fanarahana ireo foto-kevitra ireo dia miantoka, ny fampiharana REST dia maivana.
Ny tombony amin'ny REST
- Mampiasa endrika tsotra kokoa ho an'ny hafatra
- Manolotra fahombiazana maharitra maharitra
- Izy io dia manohana ny fifandraisana tsy misy fanjakana
- Ampiasao ny fenitra HTTP sy ny fitsipi-pitenenana
- Ny angona dia azo alaina ho loharano
Ny tsy fahampian'ny REST
- Tsy mahomby amin'ny fenitry ny serivisy amin'ny Internet toy ny Security Transactions sns.
- Ny fangatahana REST dia tsy azo esorina
REST vs SOAP Comparison
Ny fahasamihafana misy eo amin'ny serivisy SOAP sy REST.
SOAP Web Service | Rest Web Service |
Mitaky enta-mavesatra mavesatra raha oharina amin'ny REST. | Ny REST dia maivana satria mampiasa URI ho an'ny endrika angona. |
Ny fiovan'ny serivisy SOAP dia matetika mitondra fiovana lehibe amin'ny kaody eo amin'ny lafiny mpanjifa. | Ny kaody amin'ny lafiny mpanjifa dia tsy misy fiantraikany amin'ny fiovan'ny serivisy amin'ny famatsiana tranonkala REST. |
Ny karazana fiverenana dia karazana XML foana. | Manome fahaiza-manao isan-karazany momba ny endriky ny angona naverina. |
Protokol hafatra mifototra amin'ny XML | Protocol amin'ny maritrano |
Mitaky tranomboky SOAP amin'ny faran'ny mpanjifa. | Tsy ilaina ny fanohanan'ny tranomboky ampiasaina matetika amin'ny HTTP. |
Manohana WS-Security sy SSL. | Manohana SSL sy HTTPS. |
SOAP dia mamaritra ny fiarovana azy manokana. | Mandova fepetra fiarovana avy amin'ny fitateram-bahoaka fototra ny tolotra tranonkala RESTful. |
Karazan'ny Politika famoahana API
Ny politikan'ny famoahana ny API dia:
Politika famoahana manokana:
Ny API dia tsy misy afa-tsy amin'ny fampiasana ny orinasa anatiny.
Politika famoahana mpiara-miasa:
Ny API dia tsy misy afa-tsy ho an'ny mpiara-miasa manokana. Ny orinasa dia afaka mifehy ny kalitaon'ny API noho ny fanaraha-maso izay afaka miditra amin'izany.
Politika famoahana ho an'ny daholobe:
Ny API dia natao ho an'ny besinimaro. Ny fisian'ny politikan'ny famoahana dia azon'ny besinimaro. Ohatra: Microsoft Windows API sy Apple's Cocoa.
Famaranana
Ny API dia misy na aiza na aiza, na mamandrika sidina ianao na mifandray amin'ny rindranasa media sosialy. Ny SOAP API dia mifototra amin'ny serasera XML, tsy mitovy amin'ny REST API izy io satria tsy mitaky fanitsiana manokana.
Ny famolavolana ny serivisy Rest Web dia tokony hifanaraka amin'ny foto-kevitra sasany, ao anatin'izany ny adiresy, ny tsy fisian'ny fanjakana, ny cacheability ary ny interface tsara. Ny fitsipika famoahana API dia azo zaraina ho sokajy telo: API tsy miankina, API mpiara-miasa ary API ho an'ny daholobe.
Misaotra anao namaky ity lahatsoratra ity. Jereo ny lahatsoratra momba ny Guide to API Security 2022.
