API څه شی دی او هغه شیان باید په پام کې ونیول شي کله چې د API رامینځته کول؟

API (Application Programming Interface) د لارښوونو، معیارونو، یا اړتیاو یوه ټولګه ده چې یو سافټویر یا اپلیکیشن ته وړتیا ورکوي چې د غوره خدماتو لپاره د بل اپلیکیشن، پلیټ فارم، یا وسیلې ځانګړتیاوې یا خدمتونه وکاروي. په لنډه توګه، دا هغه څه دي چې ایپس ته اجازه ورکوي یو بل سره اړیکه ونیسي.

 

API د ټولو ایپسونو اساس دی چې د معلوماتو سره معامله کوي یا د دوه محصولاتو یا خدماتو ترمینځ اړیکه فعالوي. دا د ګرځنده غوښتنلیک یا پلیټ فارم ځواک ورکوي ترڅو خپل ډیټا د نورو ایپسونو/پلیټ فارمونو سره شریک کړي او د پراختیا کونکو د ښکیلتیا پرته د کارونکي تجربه اسانه کړي. 

برسیره پردې، APIs له سکریچ څخه د پرتله کولو وړ پلیټ فارم یا سافټویر رامینځته کولو اړتیا لرې کوي. تاسو کولی شئ اوسنی یو یا بل پلیټ فارم یا ایپ وکاروئ. د دې دلیلونو له امله، د API پراختیا پروسه د ایپ پراختیا کونکو او د شرکت اجرایوي دواړو لپاره تمرکز دی.

 

د API کار کول

فرض کړئ چې تاسو د الوتنې بک کولو لپاره ځینې XYZ ایپ یا ویب پاڼه پرانیزئ. تاسو فورمه ډکه کړه، د تګ او راتګ وختونه، ښار، د الوتنې معلومات، او نور اړین معلومات شامل کړل، بیا یې وسپارل. د څو ثانیو په اوږدو کې، د الوتنو لیست په سکرین کې د قیمت، وخت، د څوکۍ شتون، او نورو توضیحاتو سره څرګندیږي. دا واقعا څنګه پیښیږي؟

 

د داسې سختو معلوماتو چمتو کولو لپاره، پلیټ فارم د هوایی ډګر ویب پاڼې ته یو غوښتنه لیږلې ترڅو د دوی ډیټابیس ته لاسرسی ومومي او د غوښتنلیک پروګرام انٹرفیس له لارې اړوند معلومات ترلاسه کړي. ویب پاڼې د هغه معلوماتو سره ځواب ورکړ چې د API ادغام پلیټ فارم ته سپارلی او پلیټ فارم یې په سکرین کې ښودلی.

 

دلته، د الوتنې بکینګ اپلیکیشن/پلیټ فارم او د هوایی کرښو ویب پاڼه د پای ټکي په توګه عمل کوي پداسې حال کې چې API د معلوماتو شریکولو پروسه منځګړیتوب کوي. کله چې د پای ټکي د خبرو اترو په اړه وغږیږئ، API په دوو لارو کار کوي، د بیلګې په توګه، REST (د نمایندګۍ ریاست لیږد) او SOAP (د ساده اعتراض لاسرسي پروتوکول).

 

که څه هم دواړه میتودونه اغیزمنې پایلې راوړي، a د ګرځنده ایپ پراختیایی شرکت د SOAP په پرتله REST ته ترجیح ورکوي ځکه چې د SOAP APIs درانه او پلیټ فارم پورې تړلي دي.

 

د API د ژوند دورې د پوهیدو او پوهیدو لپاره چې API څنګه په تفصیل سره کار کوي، نن ورځ زموږ متخصصینو سره اړیکه ونیسئ!

 

د API رامینځته کولو لپاره وسیلې

پداسې حال کې چې د API رامینځته کولو پروسې کې د API ډیزاین وسیلو او ټیکنالوژیو ډیری برخه شتون لري ، د پراختیا کونکو لپاره د APIs رامینځته کولو لپاره مشهور API پرمختیا ټیکنالوژي او اوزار په لاندې ډول دي:

 

• Apigee

دا د ګوګل د API مدیریت چمتو کونکی دی چې د پراختیا کونکو او متشبثینو سره مرسته کوي ترڅو د API ادغام چلند بیا رامینځته کولو سره ډیجیټل بدلون کې بریا ترلاسه کړي.

 

• APIMatic او API ټرانسفارمر

دا د API پراختیا لپاره نور مشهور وسیلې دي. دوی د لوړ کیفیت SDKs او د API ځانګړي فارمیټونو څخه د کوډ ټوټې رامینځته کولو لپاره پرمختللي اتوماتیک تولید وسیلې وړاندیز کوي او په نورو مشخصاتو جوړښتونو کې یې بدلوي ، لکه RAML ، API بلیوپرینټ ، او داسې نور.

 

• د API ساینس 

دا وسیله په اصل کې د دواړو داخلي APIs او بهرني APIs د فعالیت ارزولو لپاره کارول کیږي.

 

• API سرور بې ساختماني 

دا محصولات د ګرځنده اپلیکیشن پراختیا کونکو سره د کلاوډ میشته سرور زیربنا په مرسته د APIs ډیزاین کولو ، جوړولو ، خپرولو او کوربه کولو کې مرسته کوي.

 

• API-پلیټ فارم

دا د خلاصې سرچینې PHP چوکاټونو څخه دی چې د ویب API پراختیا لپاره مناسب دی.

 

• لیکنه 0

دا د پیژندنې مدیریت حل دی چې د APIs تصدیق او تایید لپاره کارول کیږي.

 

• ClearBlade

دا ستاسو په پروسه کې د IoT ټیکنالوژۍ د منلو لپاره د API مدیریت چمتو کونکی دی.

 

• GitHub

دا د خلاصې سرچینې git ذخیره کوربه توب خدمت پراختیا کونکو ته اجازه ورکوي د کوډ فایلونه اداره کړي ، غوښتنې غوښتنې ، نسخه کنټرول ، او نظرونه چې په ټول ګروپ کې توزیع شوي. دا دوی ته اجازه ورکوي چې خپل کوډ په شخصي ذخیره کې خوندي کړي.

 

• پوسټ مین

دا اساسا د API وسیلې چین دی چې پراختیا کونکو ته ځواک ورکوي چې د دوی د API فعالیت چلولو ، ازموینه ، سند او ارزونه وکړي.

 

• سویګر

دا د خلاصې سرچینې چوکاټ دی چې د API پراختیا سافټویر لپاره کارول کیږي. د ټیکنالوژۍ لوی لوی شرکتونه لکه ګیټی امیجز او مایکروسافټ سویګر کاروي. که څه هم نړۍ د APIs څخه ډکه ده، د API ټیکنالوژۍ د ګټو په کارولو کې لاهم لوی تشه شتون لري. پداسې حال کې چې ځینې APIs په اپلیکیشن کې ادغام یو هوا رامینځته کوي ، نور یې په خوب کې بدلوي.

 

د اغیزمن API ځانګړتیاوې باید ولري

• د مهال ویش تعدیل یا د معیارونو له مخې لټون

د API ترټولو مهم ځانګړتیا چې یو اپلیکیشن باید ولري د تعدیل مهال ویش/د معیارونو له مخې لټون. یو API باید کاروونکو ته اجازه ورکړي چې د مختلف معیارونو پراساس ډاټا وپلټي، لکه نیټه. دا ځکه چې دا هغه بدلونونه دي (تازه کول، ایډیټ کول او ړنګول) چې موږ یوازې د لومړني لومړني معلوماتو ترکیب وروسته په پام کې نیسو.

 

• انځورګر 

ډیری وختونه، دا پیښیږي چې موږ نه غواړو بشپړ معلومات بدل کړو، مګر یوازې یو نظر. په داسې سناریو کې، API باید د دې وړتیا ولري چې معلومه کړي چې څومره ډاټا په یوځل کې ښودل کیږي او په کوم فریکونسۍ کې. دا باید پای کارونکي ته د نمبر په اړه هم خبر کړي. د پاتې معلوماتو پاڼې.

 

• ترتیب کول

د دې لپاره چې ډاډ ترلاسه شي چې پای کارونکي د معلوماتو ټولې پاڼې په یو یو سره ترلاسه کوي، API باید کاروونکو ته ځواک ورکړي چې ډاټا د ترمیم وخت یا کوم بل حالت سره سم ترتیب کړي.

 

• د JSON ملاتړ یا REST

که څه هم اجباري نه وي، دا ښه ده چې خپل API په پام کې ونیسئ چې RESTful وي (یا د JSON مالتړ چمتو کول (REST)) د اغیزمن API پراختیا لپاره. REST APIs بې حالته، لږ وزن لري، او تاسو ته اجازه درکوي چې د اپلوډ ګرځنده اپلیکیشن پروسه بیا هڅه وکړئ که دا ناکام شي. دا د SOAP په قضیه کې خورا سخت دی. سربیره پردې ، د JSON ترکیب د ډیری برنامو ژبو سره ورته دی ، کوم چې د ګرځنده اپلیکیشن پراختیا کونکي لپاره دا اسانه کوي چې دا په کومې بلې ژبې کې تجزیه کړي.

 

• د OAuth له لارې اجازه ورکول

دا بیا اړینه ده چې ستاسو د غوښتنلیک برنامه انٹرفیس د OAuth له لارې واک ورکړي ځکه چې دا د نورو میتودونو په پرتله ګړندی دی چې تاسو اړتیا لرئ یوازې په یوه تڼۍ کلیک وکړئ او دا ترسره شوی.

 

په لنډه توګه، د پروسس وخت باید لږترلږه وي، د غبرګون وخت ښه وي، او د امنیت کچه ​​لوړه وي. دا خورا مهم دی چې ستاسو د غوښتنلیک خوندي کولو لپاره د API پراختیا غوره عملونو کې هڅې وکړئ ، په هرصورت ، دا د ډیټا ډیټا سره معامله کوي.

 

د API اصطلاحات

 

1. د API کیلي - کله چې یو API د پیرامیټر له لارې غوښتنه چیک کړي او غوښتونکی پوهیږي. او مجاز کوډ د غوښتنې کیلي ته لیږدول شوی او ویل کیږي چې د API کیلي وي.
2. پای ټکی - کله چې د یو سیسټم څخه API د بل سیسټم سره اړیکه ونیسي، د ارتباطي چینل یوه پای د پای ټکی په توګه پیژندل کیږي.
3. JSON - JSON یا Javascript توکي د ډیټا فارمیټ لپاره کارول کیږي چې د APIs غوښتنې پیرامیټونو او غبرګون بدن لپاره کارول کیږي. 
4. GET - د سرچینو ترلاسه کولو لپاره د API HTTP میتود کارول
5. پوسټ - دا د سرچینو جوړولو لپاره د RESTful API HTTP میتود دی. 
6. OAuth - دا د اعتبار ورکولو یو معیاري چوکاټ دی چې پرته له کوم سند شریکولو څخه د کارونکي اړخ څخه لاسرسی وړاندې کوي. 
7. REST - هغه پروګرامونه چې د دوو وسیلو / سیسټمونو ترمنځ د اړیکو موثریت لوړوي. REST یوازینی معلومات شریکوي کوم چې اړین دي نه بشپړ معلومات. په دې جوړښت کې پلي شوي سیسټمونو ته ویل کیږي چې د آرامۍ سیسټمونه دي، او د RESTful سیسټمونو ترټولو لوی مثال د ورلډ وایډ ویب دی.
8. SOAP - SOAP یا د ساده آبجیکٹ لاسرسي پروتوکول د پیغام رسولو پروتوکول دی چې د کمپیوټر شبکې کې د ویب خدماتو اجرا کولو کې د جوړښت شوي معلوماتو شریکولو لپاره.
9. ځنډ - دا د غوښتنې څخه ځواب ته د API پراختیا پروسې لخوا اخیستل شوي ټول وخت په توګه تعریف شوی.
10. د نرخ محدودیت - دا پدې مانا ده چې د غوښتنلیکونو شمیر محدودول چې یو کارن کولی شي په هر وخت کې API ته زیان ورسوي.

 

د سم API جوړولو لپاره غوره تمرینونه

• Throttling وکاروئ

د اپلیکیشن تروتلینګ یو عالي تمرین دی چې د ترافیک د ډیریدو ریډائریټ کولو ، بیک اپ APIs ، او د DoS (د خدماتو انکار) بریدونو څخه د دې خوندي کولو لپاره په پام کې ونیسئ.

 

• د پلي کونکي په توګه ستاسو د API دروازې په پام کې ونیسئ

پداسې حال کې چې د throttling قواعدو ترتیب کول، د API کیلي پلي کول، یا OAuth، د API دروازه باید د تطبیق نقطه په توګه وګڼل شي. دا باید د یو پولیس په توګه واخیستل شي چې یوازې سم کاروونکو ته اجازه ورکوي ډیټا ته لاسرسی ومومي. دا باید تاسو ته ځواک درکړي چې پیغام کوډ کړئ یا محرم معلومات ایډیټ کړئ، او پدې توګه، تحلیل او اداره کړئ چې ستاسو API څنګه کارول کیږي.

 

• د HTTP طریقې ته اجازه ورکړئ

څرنګه چې ځینې پراکسي یوازې د GET او POST میتودونو ملاتړ کوي، نو تاسو اړتیا لرئ چې خپل RESTful API د HTTP طریقه بدله کړئ. د دې کولو لپاره، د دودیز HTTP سرلیک X-HTTP-Method-Override وکاروئ.

 

• د APIs او زیربنا ارزونه وکړئ

په اوسني وخت کې، د ریښتیني وخت تحلیل ترلاسه کول ممکن دي، مګر څه شی که چیرې د API سرور شک وي چې د حافظې لیک، د CPU ضایع کول، یا داسې نورې مسلې لري؟ د داسې حالتونو په پام کې نیولو لپاره، تاسو نشئ کولی یو پرمخ وړونکی په دنده کې وساتئ. په هرصورت ، تاسو کولی شئ دا په بازار کې د ډیری وسیلو په کارولو سره په اسانۍ سره ترسره کړئ ، لکه د AWS کلاوډ واچ.

 

• امنیت ډاډمن کړي

تاسو باید ډاډ ترلاسه کړئ چې ستاسو د API ټیکنالوژي خوندي ده مګر د کاروونکي دوستۍ په قیمت کې نه. که کوم کارن د 5 دقیقو څخه ډیر په تصدیق کې مصرف کړي نو دا پدې معنی ده چې ستاسو API د کارونکي دوستانه کیدو څخه لرې دی. تاسو کولی شئ د خپل API خوندي کولو لپاره د ټوکن پراساس تصدیق وکاروئ.

 

• لاسوند

وروستی مګر لږ تر لږه، دا د ګرځنده ایپسونو لپاره د API لپاره پراخ اسناد رامینځته کول ګټور دي چې د ګرځنده اپلیکیشن نورو پراختیا کونکو ته اجازه ورکوي په اسانۍ سره ټوله پروسه درک کړي او د غوره کاروونکي تجربې وړاندیز کولو لپاره معلومات وکاروي. په بل عبارت، د اغیزمن API پراختیا په پروسه کې ښه API اسناد به د پروژې پلي کولو وخت، د پروژې لګښت کم کړي او د API ټیکنالوژۍ موثریت ته وده ورکړي.