# API: प्रोग्रामिंग इंटरफ़ेस क्या होता है?

> API क्या है? यह वह अनुबंध है जिससे दो सॉफ़्टवेयर आपस में डेटा का आदान-प्रदान करते हैं। क्यूबेक के एक छोटे व्यवसाय (PME) का आँकड़ों वाला उदाहरण और अक्सर होने वाली आम गलतियाँ भी जानें, आसान भाषा में।

अपडेट किया गया 15 अक्टूबर 2026 · https://app.pilotiko.com/hi/glossary/api

API (application programming interface), यानी एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस, किसी सॉफ़्टवेयर द्वारा उपलब्ध कराई गई सुविधाओं और नियमों का वह समूह है, जिससे कोई दूसरा प्रोग्राम उपयोगकर्ता की स्क्रीन से गुज़रे बिना, अपने आप उसके साथ काम कर सके। यह एक समझौते की तरह काम करती है: पता होता है कि क्या माँगना है, किस रूप में माँगना है, और बदले में क्या मिलेगा।

## संक्षेप में
- API प्रोग्रामों के लिए होती है, इंसानों के लिए नहीं: यह हाथ से डेटा भरने की जगह लेती है।
- एक सटीक माँग, एक अनुमानित जवाब: यही समझौता है।
- API तब जवाब देती है जब उससे पूछा जाए; webhook अपने आप सूचना दे देता है।
- हर एक्सेस सीमित, पहचाना हुआ और रद्द किया जा सकने वाला होना चाहिए।

## API का शब्दशः अर्थ क्या है?

API अंग्रेज़ी के « application programming interface » से बना है। MDN Web Docs, जो वेब डेवलपर्स के लिए मुख्य संदर्भ दस्तावेज़ है, इसे सुविधाओं और नियमों का ऐसा समूह बताता है जो यूज़र इंटरफ़ेस के बजाय स्वचालित तरीके से किसी सॉफ़्टवेयर के साथ काम करना संभव बनाता है। वह इसकी तुलना उस सॉफ़्टवेयर और अन्य प्रोग्रामों के बीच एक समझौते से करता है [1]।

ब्राउज़र में API से, उदाहरण के लिए, कैमरे या लोकेशन तक पहुँचा जा सकता है। कंपनियों के बीच API की मदद से बुकिंग साइट किसी एजेंडा के खाली समय-स्लॉट पढ़ सकती है, या अकाउंटिंग सॉफ़्टवेयर किसी मैनेजमेंट टूल से इनवॉइस प्राप्त कर सकता है [1]।

## API के ज़रिए आदान-प्रदान कैसे होता है?

1. **क्लाइंट प्रोग्राम अपनी पहचान देता है** — वह एक कुंजी या टोकन दिखाता है जो साबित करता है कि उसे API को कॉल करने का अधिकार है। किसी व्यक्ति की ओर से काम करने के लिए अक्सर [OAuth](https://app.pilotiko.com/hi/glossary/oauth) का उपयोग होता है।
2. **वह एक सटीक माँग भेजता है** — उदाहरण: « 12 मार्च के लिए Saint-Jérôme की टीम के अपॉइंटमेंट दो »।
3. **सॉफ़्टवेयर जाँचता है और जवाब देता है** — वह डेटा तय फ़ॉर्मैट में लौटाता है, अक्सर JSON में, या एक स्पष्ट त्रुटि संदेश।
4. **क्लाइंट जवाब का उपयोग करता है** — वह डेटा दिखाता है, उसे किसी दूसरे टूल में कॉपी करता है या कोई कार्रवाई शुरू करता है।

## API या webhook: कौन-सा इस्तेमाल करें?

API में सवाल आप पूछते हैं, अपनी चुनी हुई घड़ी पर। यह जानने के लिए कि कोई डेटा बदला है या नहीं, सॉफ़्टवेयर से बार-बार पूछना पड़ता है: GitHub के दस्तावेज़ इसे « polling » कहते हैं। [webhook](https://app.pilotiko.com/hi/glossary/webhook) इसका उलटा करता है: कोई घटना होते ही सॉफ़्टवेयर आपको डेटा भेज देता है [2]।

| मापदंड | API (कॉल) | Webhook (सूचना) |
|---|---|---|
| पहल कौन करता है? | माँगने वाला प्रोग्राम | वह सॉफ़्टवेयर जहाँ घटना होती है |
| आदान-प्रदान का समय | जब पूछा जाए | घटना होते ही |
| आम उपयोग | सूची पढ़ना, फ़ाइल बनाना, ग्राहक खोजना | भुगतान या नई बुकिंग की सूचना पाना |
| मुख्य जोखिम | बेवजह बहुत बार पूछना | स्रोत की जाँच न करने पर नकली संदेश मिलना |

## API कितना समय बचा सकती है?

**उदाहरण: Québec की 5 तकनीशियनों वाली कीट-नियंत्रण कंपनी**

मान लीजिए: हर पूरा हुआ वर्क ऑर्डर इनवॉइस बनाने के लिए हाथ से अकाउंटिंग सॉफ़्टवेयर में दोबारा लिखा जाता है। API से जुड़ाव घंटे और इस्तेमाल हुए उत्पाद सीधे भेज देता है।

- प्रति सप्ताह पूरे हुए वर्क ऑर्डर : 60
- प्रति ऑर्डर दोबारा लिखने के मिनट : 4
- प्रति सप्ताह डेटा भरने का समय (60 × 4 मिनट) : 240 मिनट, यानी 4 घंटे
- प्रति माह दर्ज हुई दोबारा लिखने की गलतियाँ (अनुमान) : 6
- **= प्रति सप्ताह लगभग 4 घंटे की डेटा-एंट्री जो API से जुड़ाव बचा सकता है, बशर्ते दोनों सॉफ़्टवेयर में संगत API हो।**

## API के साथ किन गलतियों से बचना चाहिए?

- API कुंजी को ईमेल या साझा दस्तावेज़ में चिपका देना: जिसके पास भी वह हो, आपकी जगह कार्रवाई कर सकता है।
- किसी इंटीग्रेशन को पूरे अधिकार दे देना, जबकि उसे सिर्फ़ एजेंडा पढ़ना है।
- [ऑटोमेशन](https://app.pilotiko.com/hi/glossary/process-automation) बनाना और यह न सोचना कि API त्रुटि के साथ जवाब दे तो क्या होगा।
- यह मान लेना कि हर [सॉफ़्टवेयर-सेवा](https://app.pilotiko.com/hi/glossary/saas) में API होती है: NIST प्रोग्राम इंटरफ़ेस से एक्सेस को एक संभावना बताता है, अनिवार्यता नहीं [3]।
- अनुबंध खत्म होने के बाद पुराने प्रदाता के एक्सेस हटाना भूल जाना।

## Pilotiko के बारे में क्या?

Pilotiko की क्षमताओं की सूची में ग्राहकों को उपलब्ध कोई सार्वजनिक API नहीं बताई गई है। इसलिए हम यहाँ उसका दावा नहीं करते। अगर कोई खास इंटीग्रेशन आपके लिए ज़रूरी है, तो ट्रायल से पहले पूछ लें। Pilotiko के [AI एजेंट](https://app.pilotiko.com/hi/glossary/ai-agent) एप्लिकेशन में पहले से मौजूद डेटा के आधार पर काम करते हैं, और कोई भी भेजना किसी व्यक्ति की मंज़ूरी का इंतज़ार करता है।

## अक्सर पूछे जाने वाले सवाल

### API इस्तेमाल करने के लिए क्या प्रोग्रामर होना ज़रूरी है?

API बनाने या उसे सीधे कॉल करने के लिए हाँ, प्रोग्रामिंग की समझ चाहिए। लेकिन बहुत-से ऑटोमेशन टूल तैयार कनेक्टर देते हैं जो आपकी जगह API का इस्तेमाल करते हैं। तब आप बिना कोड लिखे सिर्फ़ जोड़ने वाले फ़ील्ड चुनते हैं।

### क्या API सुरक्षित होती है?

उतनी ही, जितनी अच्छी तरह आप अपने एक्सेस सँभालते हैं। हर इंटीग्रेशन के लिए अलग कुंजी रखें, अधिकार सिर्फ़ ज़रूरी हद तक दें और इस्तेमाल न होने वाली कुंजियाँ रद्द कर दें। कुंजी कभी ईमेल से साझा न करें।

### API और इंटीग्रेशन में क्या फ़र्क है?

API किसी सॉफ़्टवेयर द्वारा दिया गया प्रवेश-द्वार है। इंटीग्रेशन दो टूल के बीच वह असली जुड़ाव है जो एक या अधिक API का उपयोग करता है। कोई इंटीग्रेशन न होने पर भी API हो सकती है।

### « REST API » का क्या मतलब है?

यह वेब API की एक बहुत प्रचलित शैली है, जिसमें हर संसाधन (ग्राहक, अपॉइंटमेंट) का एक पता होता है और डेटा पढ़ने या बदलने के लिए HTTP प्रोटोकॉल की विधियाँ इस्तेमाल होती हैं। छोटे व्यवसाय के लिए अहम बात यह है कि दस्तावेज़ स्पष्ट और अद्यतन हो।

### क्या API सशुल्क हो सकती है?

हाँ। कुछ प्रदाता API को सिर्फ़ ऊँचे प्लान में देते हैं या प्रतिदिन कॉल की संख्या सीमित करते हैं। किसी प्रक्रिया को उस पर टिकाने से पहले ये सीमाएँ जाँच लें।

## स्रोत

1. MDN Web Docs, « API (glossaire) », https://developer.mozilla.org/fr/docs/Glossary/API (देखा गया 2026-10-15)
2. GitHub Docs, « About webhooks », https://docs.github.com/en/webhooks/about-webhooks (देखा गया 2026-10-15)
3. NIST, « SP 800-145, The NIST Definition of Cloud Computing », https://csrc.nist.gov/pubs/sp/800/145/final (देखा गया 2026-10-15)
