API Notes in Hindi
API Notes in Hindi
एक एप्लिकेशन प्रोग्राम िंग इिं टरफेस (API) मिमिन्न सॉफ़्टिेयर अनुप्रयोगोिं के बीच सिंचार और डे टा साझा करने के
मिए एक सेतु के रूप ें कायय करता है । यह डे ििपसय को ौजूदा मसस्ट की काययक्ष ता का िाि उठाने और उन
पर मन ाय ण करने की अनु मत दे ता है , मजससे स य और प्रयास की बचत होती है ।
इस िेख ें, ह PHP का उपयोग करके एक API बनाने की प्रमिया का पता िगाएिं गे, जो एक िोकमप्रय सियर-साइड
प्लिमटिंग िाषा है । PHP API मिकमसत करने के मिए एक जबूत और िचीिा िातािरण प्रदान करता है , जो इसे िेब
PHP ें API बनाना सिंिािनाओिं की एक नई दु मनया खोिता है । यह आपको अन्य अनुप्रयोगोिं, चाहे िे िेब-आधाररत
होिं, ोबाइि होिं या डे स्कटॉप होिं, के मिए आपका डे टाबेस, सेिाएँ या कोई अन्य सिंसाधन उजागर करने की अनु मत
दे ता है । API बनाकर, आप डे ििपसय को आपके मसस्ट को उनके अनुप्रयोगोिं ें एकीकृत करने का अमधकार दे ते
हैं , मजससे इसकी पहिं च और उपयोमगता बढ़ जाती है ।
PHP ें API बनाना ियािह िग सकता है , मिशेष रूप से यमद आप िेब मिकास ें नए हैं । हािाँ मक, सही ज्ञान और
उपकरणोिं के साथ, यह एक रो ािं चक और पुरस्कृत प्रयास हो सकता है । यह िेख आपको अपने िातािरण को सेट
करने से िेकर अपने एिं डपॉइिं ट्स का दस्तािेजीकरण करने तक, PHP API बनाने की चरण-दर-चरण प्रमिया के
ाध्य से ागयदशयन करे गा।
चाहे आप एक शुरुआती होिं या एक अनुििी PHP डे ििपर, यह िेख आपको एक जबूत और अच्छी तरह से
प्रिेप्लखत API बनाने के मिए आिश्यक आिश्यक ज्ञान और तकनीकोिं से िैस करे गा। तो, आइए इस ें गोता िगाएँ
API क्या है ?
API, मजसका पूरा ना एप्लिकेशन प्रोग्राम िंग इिं टरफेस है , मनय ोिं और प्रोटोकॉि का एक सेट है जो मिमिन्न
सॉफ़्टिेयर अनुप्रयोगोिं को एक-दू सरे के साथ सिंचार और बातचीत करने की अनु मत दे ता है । यह उन तरीकोिं और
डे टा प्रारूपोिं को पररिामषत करता है मजन्हें अनुप्रयोग जानकारी का अनुरोध करने और आदान-प्रदान करने के मिए
API ध्यस्थ के रूप ें कायय करते हैं , मजससे डे ििपसय ौजूदा मसस्ट की काययक्ष ता और डे टा का िाि उठा
सकते हैं , मबना उनके आिं तररक कायों को स झे। िे अनुप्रयोगोिं के मिए एक ानकीकृत तरीका प्रदान करते हैं तामक
िे एक-दू सरे के साथ बातचीत कर सकें, जो अिंतः मियाशीिता और एकीकरण को बढ़ािा दे ते हैं ।
API को एक रे स्तरािं ें िेटर के रूप ें सोचें। जब आप मकसी रे स्तरािं ें जाते हैं , तो आपको रसोई ें प्रिेश करने और
खुद खाना पकाने की आिश्यकता नहीिं होती है । इसके बजाय, आप अपने आदे श को िेटर को सिंप्रेमषत करते हैं , जो
इसे रसोई ें सिंप्रेमषत करता है । रसोई खाना तैयार करती है और इसे िेटर के ाध्य से िापस आपके पास िेजती
है । इस पररदृश्य ें, िेटर API है , जो ग्राहक (अनुप्रयोग) और रसोई ( ौजूदा मसस्ट ) के बीच सिंचार की सुमिधा प्रदान
करता है ।
API का उपयोग मिमिन्न उद्दे श्योिं के मिए मकया जा सकता है । िे डे टाबेस से डे टा पुनः प्राप्त कर सकते हैं , गणना कर
सकते हैं , िुगतान सिंसामधत कर सकते हैं , और िी बहत कुछ कर सकते हैं । API के ाध्य से मिमशष्ट काययक्ष ताओिं
को उजागर करके, डे ििपसय ौजूदा मसस्ट पर मन ाय ण कर सकते हैं और नई एप्लिकेशन बना सकते हैं जो उनकी
API मिमिन्न प्रारूपोिं ें आते हैं , मजन ें िेब API शाम ि हैं , मजन्हें HTTP जैसे प्रोटोकॉि का उपयोग करके इिं टरनेट
पर एक्सेस मकया जाता है । िेब API का आ तौर पर रर ोट सियरोिं से डे टा पुनः प्राप्त करने, अनुप्रयोगोिं ें सोशि
ीमडया िेटफॉ य को एकीकृत करने और ऑनिाइन सेिाओिं तक पहिं चने के मिए उपयोग मकया जाता है ।
कुि म िाकर, आधुमनक सॉफ़्टिेयर मिकास ें API हत्वपूणय िूम का मनिाते हैं । िे डे ििपसय को ौजूदा सिंसाधनोिं
का िाि उठाने, मिकास प्रमियाओिं ें तेजी िाने और निाचारी और जुडे हए अनुप्रयोग बनाने ें सक्ष बनाते हैं ।
API की अिधारणा को स झना मकसी िी व्यप्लि के मिए आिश्यक है जो िेब मिकास ें शाम ि है , क्ोिंमक िे
गमतशीि और एकीकृत अनुप्रयोग बनाने की नीिंि प्रदान करते हैं ।
मिकास के मिए व्यापक रूप से उपयोग की जाती है । जब API बनाने की बात आती है , तो PHP कई िाि प्रदान
1. परिचचतता औि पहुँ च: PHP कई िषों से है और इसका एक बडा डे ििपर स ुदाय है । इसका तिब है
मक बहत सारे सिंसाधन, दस्तािेज, और ट्यूटोररयि उपिब्ध हैं , मजससे PHP को सीखना और इसके साथ
का करना आसान हो जाता है । यमद आपके पास पहिे से ही PHP का अनुिि है , तो PHP ें API बनाना
2. लचीलापन औि मापनीयता: PHP डे ििपसय को उनकी मिमशष्ट आिश्यकताओिं के अनुरूप API बनाने
की िचीिापन प्रदान करता है। चाहे आपको एक साधारण API की आिश्यकता हो जो डे टाबेस से डे टा
पुनः प्राप्त करता हो या एक जमटि API की आिश्यकता हो जो बडे पै ाने पर िेन-दे न को सिंिाि सके,
PHP इसे सिंिाि सकता है । PHP िी मिमिन्न फ्रे िकय और िाइब्रेरी प्रदान करता है जो मिकास प्रमिया को
सरि बनाता है , मजससे आपके अनुप्रयोग के बढ़ने के साथ-साथ आपके API को स्केि करना आसान हो
जाता है ।
3. चिस्तृत समर्थन औि एकीकिण: PHP मिमिन्न ऑपरे मटिं ग मसस्ट , िेब सियर, और डे टाबेस ें व्यापक
स थयन रखता है । यह MySQL, PostgreSQL, और Apache जैसी िोकमप्रय तकनीकोिं के साथ सहजता से
एकीकृत होता है , मजससे इसकी ौजूदा मसस्ट के साथ सिंगतता और बढ़ जाती है। यह PHP को ऐसे API
बनाने के मिए उपयुि बनाता है मजन्हें मिमिन्न सॉफ़्टिेयर िातािरणोिं के साथ बातचीत करने की
आिश्यकता होती है ।
4. प्रदर्थन औि दक्षता: PHP को तेज और कुशि बनने के मिए मडजाइन मकया गया है , मजससे यह उच्च-
प्रदशयन API बनाने के मिए उपयुि हो जाता है। इस ें एक हल्की सिंरचना और एक अिंतमनयमहत कैमशिंग
5. सुिक्षा: PHP ें एक जबूत सुरक्षा पाररप्लस्थमतकी तिंत्र है मजस ें सा ान्य िेब सुरक्षा चुनौमतयोिं को सिंिािने
के मिए अिंतमनयमहत सुमिधाएिं और कायय होते हैं । डे ििपसय सिंिेदनशीि डे टा की सुरक्षा सुमनमित करने और
सा ान्य क जोररयोिं को रोकने के मिए मिमिन्न सुरक्षा िाइब्रेरी और प्रथाओिं का उपयोग कर सकते हैं ।
6. समुदाय समर्थन औि अपडे ट्स: PHP ें डे ििपसय का एक समिय स ुदाय है जो इसके मिकास और
रखरखाि ें समिय रूप से योगदान करता है । यह सुमनमित करता है मक PHP िगातार मिकमसत हो रहा
है , मनयम त अपडे ट, बग मफक्स, और सुरक्षा पैच के साथ। अपने API मिकास के मिए PHP का उपयोग
कुि म िाकर, PHP API बनाने के मिए एक ठोस नीिंि प्रदान करता है । इसकी पहिं च, िचीिापन, प्रदशयन, और सुरक्षा
इसे डे ििपसय के बीच एक िोकमप्रय मिकल्प बनाते हैं । PHP की शप्लि का उपयोग करके, आप शप्लिशािी और
कुशि API बना सकते हैं जो ौजूदा मसस्ट के साथ सहजता से एकीकृत होते हैं और आपके अनुप्रयोगोिं के मिए
PHP के साथ API मिकास ें उतरने से पहिे, अपने मिकास िातािरण को ठीक से सेट करना आिश्यक है । यह
सुमनमित करता है मक आपके पास प्रिािी ढिं ग से अपना API बनाने और परीक्षण करने के मिए सिी आिश्यक
PHP API मिकास के मिए अपने िातािरण को सेट करने के ुख्य चरण मनम्नमिप्लखत हैं:
1. PHP स्र्ाचपत किें : अपनी किंप्यूटर पर PHP स्थामपत करके शुरू करें । PHP को आमधकाररक PHP
िेबसाइट से आसानी से डाउनिोड और इिं स्टॉि मकया जा सकता है । अपनी आिश्यकताओिं के अनुसार
सिंस्करण चुनें और अपने ऑपरे मटिं ग मसस्ट के मिए स्थापना मनदे शोिं का पािन करें ।
2. एक िेब सिथि सेट किें : API अनुरोधोिं को सिंिािने के मिए आपको एक िेब सियर की आिश्यकता होगी।
Apache या Nginx जैसे िेब सियर स्थामपत करें , क्ोिंमक िे PHP के साथ सबसे सा ान्यतः उपयोग मकए जाते
हैं । इन िेब सियरोिं ें से कोई िी PHP के साथ आसानी से एकीकृत होता है , जो एक प्लस्थर और मिश्वसनीय
3. एक डे टाबेस स्र्ाचपत किें : यमद आपका API डे टाबेस के साथ इिं टरै क्ट करता है , तो एक डे टाबेस प्रबिंधन
प्रणािी स्थामपत करें । MySQL या PostgreSQL जैसी िोकमप्रय डे टाबेस प्रणामियोिं का उपयोग करें , जो PHP
के साथ अच्छी तरह से का करती हैं । डे टाबेस की स्थापना सुमनमित करें और अपने एप्लिकेशन के डे टा
ििंडारण और पुनः प्राप्लप्त आिश्यकताओिं के मिए आिश्यक प्रारिं मिक सेटअप करें ।
4. कयड एचडटि चुनें: एक कोड एमडटर या एकीकृत मिकास िातािरण (IDE) चुनें जो PHP मिकास का स थयन
करता है । PhpStorm, Visual Studio Code, और Sublime Text जैसे IDE व्यापक PHP मिकास सुमिधाएँ
प्रदान करते हैं , मजन ें कोड हाइिाइमटिं ग, स्वचामित पूणयता, और मडबमगिंग उपकरण शाम ि हैं । एक ऐसा
5. अन्य चनभथिताएुँ स्र्ाचपत किें : यमद आपका API बाहरी िाइब्रेररयोिं या पैकेजोिं पर मनियर करता है , तो उन्हें
स्थामपत करें । PHP ें पैकेज ैनेजर Composer का उपयोग करके िाइब्रेरी और पैकेज प्रबिंमधत मकए जा
सकते हैं । आपके API के मिए आिश्यक िाइब्रेरी और मनियरताओिं को पररिामषत करने के मिए एक
composer.json फाइि बनाएँ ।
6. Git के सार् सोंस्किण चनयोंत्रण सेट किें : मिकास प्रमिया के दौरान अपने कोड ें पररितयनोिं को टर ै क करने
और प्रबिंमधत करने के मिए Git जैसे सिंस्करण मनयिंत्रण प्रणािी का उपयोग करें । एक Git ररपॉमजटरी सेट
करें और मनयम त रूप से अपने कोड को प्रमतबद्ध करें । GitHub या Bitbucket जैसी िेटफॉर्म्य का उपयोग
7. Postman या cURL का उपययग किके पिीक्षण उपकिण सेट किें : API एिं डपॉइिं ट्स का परीक्षण करने
के मिए Postman या cURL जैसे उपकरण स्थामपत करें । ये उपकरण आपको अपने API का अनुकरण
ह एक बुमनयादी API बनाएँ गे जो HTTP अनुरोधोिं को सिंिािता है और JSON प्रारूप ें प्रमतमिया करता है ।
2. हे डि सेट किें : JSON प्रारूप ें प्रमतमिया करने के मिए, सुमनमित करें मक आपका PHP प्लिट सही सा ग्री
प्रकार हे डर सेट करता है । यह ब्राउजर या API क्लाइिं ट को प्रमतमिया के स्वरूप को स झने ें दद करता
php
Copy code
header('Content-Type: application/json');
3. अनुियध चिचध की जाुँच किें : आपका API मिमिन्न HTTP मिमधयोिं (GET, POST, PUT, DELETE) को सिंिाि
सकता है । अनुरोध मिमध की पहचान करने के मिए, आप PHP ें $_SERVER िैमश्वक िेररएबि का उपयोग
php
Copy code
$method = $_SERVER['REQUEST_METHOD'];
4. एों डपॉइों ट बनाएुँ : मिमिन्न URL पाथ के आधार पर मिमिन्न एिं डपॉइिं ट्स बनाने के मिए PHP ें सशतय िॉमजक
php
Copy code
if ($method == 'GET') {
5. JSON प्रचतचिया बनाएुँ : अपनी प्रमतमिया डे टा को JSON प्रारूप ें एन्कोड करने के मिए PHP ें
json_encode() फिंक्शन का उपयोग करें । यह डे टा को सही प्रारूप ें पररिमतयत करता है , जो API क्लाइिं ट
Copy code
echo json_encode($response);
6. API का पिीक्षण किें : अपने ब्राउजर या Postman जैसे उपकरण का उपयोग करके अपना API परीक्षण
करें । URL पर जाएँ और दे खें मक क्ा यह अपेमक्षत प्रमतमिया दे ता है । उदाहरण के मिए, यमद आपका API
िोकिहोस्ट पर चि रहा है , तो मनम्नमिप्लखत URL का उपयोग करें : http://localhost/api.php।
API की िास्तमिक शप्लि तब आती है जब यह डे टाबेस के साथ इिं टरै क्ट कर सकता है , डे टा स्टोर कर सकता है ,
पुनः प्राप्त कर सकता है , अपडे ट कर सकता है , और हटा सकता है । इस चरण ें, ह एक MySQL डे टाबेस के साथ
इिं टरै क्ट करने के मिए PHP का उपयोग करें गे, तामक डे टा को स्टोर और पुनः प्राप्त मकया जा सके।
1. डे टाबेस कनेक्शन सेट किें : सबसे पहिे, एक MySQL डे टाबेस सेट करें और डे टा स्टोर करने के मिए
एक तामिका बनाएँ । PHP ें डे टाबेस कनेक्शन स्थामपत करने के मिए, mysqli एक्सटें शन या PDO का
php
Copy code
$host = 'localhost';
$dbname = 'your_database_name';
$username = 'your_username';
$password = 'your_password';
if ($conn->connect_error) {
}
2. डे टा प्राप्त किना: एक GET अनुरोध को सिंिािने के मिए, डे टाबेस से डे टा प्राप्त करने के मिए SQL क्वेरी
का उपयोग करें । प्राप्त डे टा को JSON प्रारूप ें पररिमतयत करें और क्लाइिं ट को िेजें। उदाहरण के मिए:
php
Copy code
if ($method == 'GET') {
$result = $conn->query($sql);
$data = array();
$data[] = $row;
echo json_encode($data);
3. डे टा जमा किना: POST अनुरोध को सिंिािने के मिए, डे टाबेस ें डे टा ज ा करने के मिए SQL INSERT
क्वेरी का उपयोग करें । डे टा को PHP ें $_POST िैमश्वक िेररएबि के ाध्य से प्राप्त करें । उदाहरण के
मिए:
php
Copy code
if ($method == 'POST') {
$name = $_POST['name'];
$email = $_POST['email'];
} else {
अपडे ट या हटाने के मिए SQL UPDATE और DELETE क्वेरी का उपयोग करें । उदाहरण के मिए:
php
Copy code
if ($method == 'PUT') {
parse_str(file_get_contents("php://input"), $_PUT);
$id = $_PUT['id'];
$name = $_PUT['name'];
$email = $_PUT['email'];
} else {
if ($method == 'DELETE') {
parse_str(file_get_contents("php://input"), $_DELETE);
$id = $_DELETE['id'];
} else {
5. डे टाबेस कनेक्शन बोंद किें : प्लिट के अिंत ें, डे टाबेस कनेक्शन बिंद करें । यह कनेक्शन को ररिीज करता
php
Copy code
$conn->close();
API की सुरक्षा हत्वपूणय है , मिशेष रूप से यमद यह सिंिेदनशीि डे टा के साथ इिं टरै क्ट करता है । इस चरण ें, ह
API सुरक्षा और प्रा ाणीकरण को िागू करने के मिए तकनीकोिं की खोज करें गे।
1. API कोंु जी प्रामाणीकिण: API कुिंजी एक अमितीय पहचानकताय है मजसे क्लाइिं ट को API अनुरोधोिं के साथ
िेजना होता है । सियर API कुिंजी की पुमष्ट करता है और केिि िैध अनुरोधोिं को स्वीकार करता है । एक सरि
API कुिंजी प्रा ाणीकरण िागू करने के मिए, मनम्नमिप्लखत कोड का उपयोग करें :
php
Copy code
$api_key = 'your_api_key';
if ($_SERVER['HTTP_API_KEY'] != $api_key) {
http_response_code(401);
exit();
2. सुिचक्षत कनेक्शन (HTTPS): सुमनमित करें मक आपका API HTTPS का उपयोग करता है , HTTP का
3. डे टा िैधता जाुँचें: सिी इनपुट डे टा की िैधता जाँ चें। सुमनमित करें मक डे टा अपेमक्षत प्रकार, सी ा और
प्रारूप ें है । इनपुट डे टा की िैधता जाँ च के मिए PHP ें मफल्टररिं ग और सत्यापन फिंक्शन का उपयोग
करें ।
4. SQL इों जेक्शन से बचाि: SQL इिं जेक्शन ह िोिं से बचाि के मिए SQL क्वेरी ें उपयोग मकए जाने िािे सिी
इनपुट डे टा को सुरमक्षत करें । इसका एक तरीका तैयार कथन (prepared statements) का उपयोग करना
है , जो क्वेरी और डे टा को अिग-अिग सिंसामधत करता है ।
जानकारी को बाहर रखें और सुमनमित करें मक सिी त्रुमट सिंदेश स्पष्ट और गैर-खुिासा करने िािे हैं ।
चरण ें, ह आपके PHP API के मिए दस्तािेज बनाने की प्रमिया का पता िगाएिं गे।
1. एों डपॉइों ट्स का चिििण दें : प्रत्येक API एिं डपॉइिं ट का उद्दे श्य, अपेमक्षत HTTP मिमधयाँ (GET, POST, आमद),
आिश्यक और िैकप्लल्पक पैरा ीटर, और प्रमतमिया प्रारूप का मििरण दें । उदाहरण के मिए:
plaintext
Copy code
GET /users
अपेमक्षत प्रमतमिया प्रदमशयत करें । यह डे ििपसय को यह स झने ें दद करता है मक API का सही तरीके
3. त्रुचट कयड औि सोंदेर्यों का दस्तािेजीकिण किें : सिंिामित त्रुमट कोड और सिंबिंमधत सिंदेशोिं को सूचीबद्ध
करें जो API प्रमतमिया ें उत्पन्न हो सकते हैं । यह डे ििपसय को API का सही तरीके से मडबग और हैं डि
करने ें दद करता है ।
दस्तािेजीकरण उपकरण का उपयोग करें , जो आपके API कोड से सीधे दस्तािेज उत्पन्न कर सकते हैं । ये
उपकरण एक इिं टरै प्लक्टि API सिंदिय प्रदान करते हैं जो डे ििपसय को API का परीक्षण और अन्वेषण करने
की अनु मत दे ते हैं ।
5. उपययगकताथ गाइड औि ट्यूटयरियल र्ाचमल किें : डे ििपसय को आरिं ि करने ें दद करने के मिए
API दस्तािेजीकरण को बनाए रखना हत्वपूणय है , खासकर जब आप िमिष्य ें API ें पररितयन या सुधार करते हैं ।
अपडे ट के मिए दस्तािेज को मसिंिोनाइज रखें तामक डे ििपसय को ह ेशा API के निीनत सिंस्करण के बारे ें
जानकारी रहे ।
चनष्कर्थ
PHP ें API बनाना िेब मिकास की सिंिािनाओिं को खोिता है । इस गाइड ने आपको PHP ें एक जबूत और
सुरमक्षत API बनाने के मिए आिश्यक चरण-दर-चरण मनदे श प्रदान मकए हैं । चाहे आप अपने डे टाबेस को एक्सपोज
कर रहे होिं, बाहरी सेिाओिं के साथ एकीकृत कर रहे होिं, या एक कस्ट िेब एप्लिकेशन बना रहे होिं, PHP एक
सही प्रथाओिं का पािन करते हए और अपने API को दस्तािेजीकरण करते हए, आप न केिि एक कायाय त्मक API
बना सकते हैं , बप्लल्क एक ऐसा API िी बना सकते हैं मजसका उपयोग, बनाए रखना, और स्केि करना आसान हो।