سریزه
په ډیسټاپ یا وسیلې کې د یو څو کلیکونو سره ، یو څوک کولی شي هر څه واخلي ، وپلوري یا خپاره کړي. دقیقا دا څنګه پیښیږي؟ څنګه کوي معلومات له دې ځایه هلته ورسېږئ؟ نه پیژندل شوی هیرو API دی.
API څه دی؟
API د یو لپاره ولاړ دی د غوښتنلیک د پروګرام کولو انٹرفیس. یو API د سافټویر برخې، د هغې عملیات، داخلې، محصولات، او اصلي ډولونه څرګندوي. مګر تاسو څنګه په ساده انګلیسي کې API تشریح کوئ؟ API د میسینجر په توګه کار کوي چې ستاسو غوښتنه له غوښتنلیک څخه لیږدوي او ځواب بیرته تاسو ته وړاندې کوي.
مثال 1: کله چې تاسو آنلاین الوتنې لټوئ. تاسو د هوایی ډګر ویب پاڼې سره اړیکه ونیسئ. ویب پاڼه په دې ځانګړې نیټه او وخت کې د ناستې او د الوتنې لګښت توضیح کوي. تاسو خپل خواړه یا څوکۍ، سامان، یا د پالتو غوښتنې غوره کوئ.
مګر، که تاسو د هوایی ډګر مستقیم ویب پاڼه نه کاروئ یا او د آنلاین سفر اجنټ کاروئ چې د ډیری هوایی شرکتونو ډاټا سره یوځای کوي. د معلوماتو ترلاسه کولو لپاره، یو غوښتنلیک د هوایی ډګر API سره اړیکه لري. API هغه انٹرفیس دی چې د سفر اجنټ ویب پا fromې څخه د هوایی ډګر سیسټم ته معلومات لیږي.
دا د هوایی ډګر ځواب هم اخلي او سم بیرته وړاندې کوي. دا د الوتنې د بک کولو لپاره د سفر خدمت، او د هوایی ډګر سیسټمونو ترمنځ متقابل عمل اسانه کوي. APIs د معمولونو، ډیټا جوړښتونو، اعتراض ټولګیو، او متغیرونو لپاره کتابتون ته اړتیا لري. د مثال په توګه، SOAP او REST خدمتونه.
مثال 2: غوره پیرود د دې ویب پاڼې له لارې د ورځې نرخ ځانګړي وړاندیز کوي. دا ورته ډیټا په خپل ګرځنده اپلیکیشن کې دی. ایپ د داخلي قیمتونو سیسټم په اړه اندیښنه نلري - دا کولی شي د ډیل آف دی ډی API ته زنګ ووهي او پوښتنه وکړي ، د نرخ ځانګړي څه دي؟ غوره پیرود د غوښتل شوي معلوماتو سره په معیاري ب formatه کې ځواب ورکوي چې ایپ پای کارونکي ته ښیې.
بېلګه 3: د ټولنیزو رسنیو لپاره APIs خورا مهم دي. کاروونکي کولی شي مینځپانګې ته لاسرسی ومومي او د حسابونو او پاسورډونو شمیر وساتي چې دوی یې ټیټ ساتي ، نو دوی کولی شي شیان ساده وساتي.
- د ټویټر API: د ډیری ټویټر افعالونو سره اړیکه ونیسئ
- د فیسبوک API: د تادیاتو، کاروونکي ډیټا، او ننوتلو لپاره
- د انسټاګرام API: کارونکي ټاګ کړئ ، د رجحان عکسونه وګورئ
د REST او SOAP API په اړه څه؟
صابون او پاتې د API مصرف کونکي خدمت وکاروئ ، چې د ویب API په نوم پیژندل کیږي. ویب خدمت د معلوماتو په مخکینۍ پوهه پورې اړه نلري. SOAP د ویب خدماتو پروتوکول دی چې د سپک وزن پلیټ فارم څخه خپلواک دی. SOAP د XML پر بنسټ د پیغام رسولو پروتوکول دی. د SOAP ویب خدمت برخلاف ، آرام خدمت د REST جوړښت کاروي ، د نقطې څخه نقطې مخابراتو لپاره جوړ شوی.
د SOAP ویب خدمت
- SOAP لیږونکی - د پیغام رامینځته کول او لیږدول.
- د SOAP رسیدونکی - پیغام ترلاسه کوي او پروسس کوي.
- SOAP منځګړی - د سر بلاکونه ترلاسه کوي او پروسس کوي.
د آرامۍ ویب خدمت
د نمایندګۍ ریاست لیږد (REST) د پیرودونکي او سرور تر مینځ اړیکې پورې اړه لري او دا چې څنګه دولت پروسس کوي. د آرام جوړښت، یو REST سرور پیرودونکي ته د سرچینو لاسرسی چمتو کوي. آرام د سرچینو لوستلو او ترمیم یا لیکلو اداره کوي. یونیفورم پیژندونکی (URI) سرچینې پیژني ترڅو سند ولري. دا به د سرچینې حالت ونیسي.
REST د SOAP معمارۍ څخه سپک دی. دا JSON پارس کوي، د انسان د لوستلو وړ ژبه چې د ډیټا شریکول او د ډیټا کارول اسانه کوي، د XML پرځای چې د SOAP جوړښت لخوا کارول کیږي.
د آرام ویب خدماتو ډیزاین کولو لپاره ډیری اصول شتون لري، کوم چې دا دي:
- د ادرس وړتیا - هره سرچینه باید لږترلږه یو URL ولري.
- بې وطنۍ - یو آرام خدمت یو بې دولت خدمت دی. یوه غوښتنه د خدمت لخوا د تیرو غوښتنو څخه خپلواکه ده. HTTP د بې ریاسته پروتوکول ډیزاین لخوا دی.
- د کیچ وړ - ډیټا په سیسټم کې د کیچ وړ پلورنځیو په توګه نښه شوې او په راتلونکي کې بیا کارول کیږي. لکه څنګه چې د ورته پایلې د تولید پرځای د ورته غوښتنې ځواب. د کیچ محدودیتونه د ځواب ډیټا نښه کول د کیچ وړ یا غیر کیچ وړ وړ وړ کوي.
- یونیفورم انٹرفیس - یو عام او معیاري انٹرفیس ته اجازه ورکوي چې د لاسرسي لپاره وکاروي. د HTTP میتودونو تعریف شوي ټولګه کارول. د دې مفاهیمو پابند کول ډاډ ورکوي، د REST تطبیق لږ وزن لري.
د REST ګټې
- د پیغامونو لپاره ساده بڼه کاروي
- د قوي اوږد مهاله موثریت وړاندیز کوي
- دا د بې ریاسته اړیکو ملاتړ کوي
- د HTTP معیارونه او ګرامر وکاروئ
- ډاټا د سرچینې په توګه شتون لري
د REST زیانونه
- د ویب خدماتو په معیارونو کې ناکامي لکه امنیتي لیږدونه او نور.
- د REST غوښتنې د توزیع وړ ندي
REST vs SOAP پرتله کول
د SOAP او REST ویب خدماتو ترمنځ توپیر.
د SOAP ویب خدمت | د آرام ویب خدمت |
د REST په پرتله درانه ان پټ پیلوډ ته اړتیا لري. | REST لږ وزن لري ځکه چې دا د ډیټا فارمونو لپاره URI کاروي. |
د SOAP خدماتو کې بدلون اکثرا د پیرودونکي اړخ کې کوډ کې د پام وړ بدلون لامل کیږي. | د مراجعینو اړخ کوډ د REST ویب چمتو کولو کې د خدماتو بدلون لخوا اغیزه نلري. |
د راستنیدو ډول تل د XML ډول دی. | د بیرته راستنیدونکو معلوماتو ب formه ته په پام سره استقامت چمتو کوي. |
د XML پر بنسټ د پیغام پروتوکول | د معمارۍ پروتوکول |
د پیرودونکي په پای کې د SOAP کتابتون ته اړتیا لري. | د کتابتون ملاتړ ته اړتیا نشته چې معمولا په HTTP کې کارول کیږي. |
د WS-امنیت او SSL ملاتړ کوي. | د SSL او HTTPS ملاتړ کوي. |
SOAP خپل امنیت تعریفوي. | RESTful ویب خدمتونه د لاندې ټرانسپورټ څخه امنیتي تدابیر په میراث کې دي. |
د API ریلیز پالیسیو ډولونه
د API لپاره د ریلیز پالیسۍ په لاندې ډول دي:
د شخصي خوشې کولو پالیسۍ:
API یوازې د داخلي شرکت کارولو لپاره شتون لري.
د شریک خوشې کولو پالیسۍ:
API یوازې د ځانګړو سوداګریزو شریکانو لپاره شتون لري. شرکتونه کولی شي د API کیفیت کنټرول کړي ځکه چې څوک ورته لاسرسی لري.
د عامه خوشې کولو پالیسۍ:
API د عامه کارونې لپاره دی. د خوشې کولو پالیسیو شتون د خلکو لپاره شتون لري. بېلګه: د مایکروسافټ وینډوز API او د ایپل کوکو.
پایله
APIs په هر ځای کې شتون لري، که تاسو الوتنې بک کوئ یا د ټولنیزو رسنیو غوښتنلیکونو سره ښکیل یاست. SOAP API د XML مخابراتو پراساس دی ، دا د REST API څخه توپیر لري پدې کې کوم ځانګړي ترتیب ته اړتیا نلري.
د آرام ویب خدماتو ډیزاین کول باید ځینې مفکورې تعقیب کړي، پشمول د پتې وړتیا، بې ثباتي، د کیش وړتیا، او یو معیاري انٹرفیس. د API خوشې کولو قواعد په دریو کټګوریو ویشل کیدی شي: خصوصي APIs، شریک APIs، او عامه APIs.
د دې مقالې لوستلو لپاره مننه. د لارښود په اړه زموږ مقاله وګورئ د API امنیت 2022.
