SSD Nodes Learn Hosting plans →
गाइड Matt Connorलेखक: Matt Connor

API क्या है? ऐप्स HTTP पर आपस में कैसे बात करते हैं

API क्या है, आसान हिंदी में समझें: HTTP और API का फ़र्क, UPI और DigiLocker जैसे उदाहरण, curl से अपनी पहली API कॉल, और 401, 404, 429 जैसे जवाबों का असली मतलब।

API क्या है: छोटा जवाब

API क्या है, यह समझने से पहले एक बात साफ़ कर लें। दवा उद्योग (pharma) में API का मतलब Active Pharmaceutical Ingredient होता है। यह लेख सॉफ़्टवेयर वाले API के बारे में है।

सॉफ़्टवेयर में API (Application Programming Interface) एक तय समझौता है। इसमें लिखा होता है कि एक प्रोग्राम दूसरे प्रोग्राम को कौन-सी रिक्वेस्ट (request) भेज सकता है, और बदले में उसे कैसा जवाब (response) मिलेगा। वेब पर यह बातचीत लगभग हमेशा HTTP के ऊपर चलती है। इसलिए "HTTP या API" का जवाब सीधा है: HTTP वह तरीका है जिससे संदेश जाता और आता है, और API वह समझौता है कि संदेश में क्या लिखा होगा।

एक उदाहरण लें। आपका मौसम वाला ऐप खुद मौसम नहीं नापता। वह किसी सर्वर से एक तय फ़ॉर्मेट में पूछता है "इस जगह का मौसम बताओ"। सर्वर भी एक तय फ़ॉर्मेट में संख्याएँ लौटाता है। सवाल का ढाँचा और जवाब का ढाँचा, दोनों पहले से तय हैं। यही ढाँचा API है।

HTTP और API में क्या फ़र्क है?

HTTP (Hypertext Transfer Protocol) रिक्वेस्ट और रिस्पॉन्स का एक नियम है। हर रिक्वेस्ट में एक मेथड (method) होता है। HTTP का मानक दस्तावेज़ RFC 9110 कहता है कि रिक्वेस्ट का मतलब मुख्य रूप से मेथड से तय होता है। GET का मतलब है "इस चीज़ की मौजूदा जानकारी मुझे दो"। POST का मतलब है "जो डेटा मैं भेज रहा हूँ, उसे प्रोसेस करो"। हर जवाब के साथ तीन अंकों का एक status code आता है, जैसे 200 या 404।

HTTP यह नहीं बताता कि किसी खास सर्वर पर कौन-सा URL है, कौन-से हेडर चाहिए, या जवाब में कौन-से फ़ील्ड होंगे। यह काम API का है। एक ही HTTP पर हज़ारों अलग-अलग API चलते हैं, और हर API के अपने नियम हैं। ब्राउज़र जब कोई वेब पेज खोलता है, तब भी HTTP चलता है। पर तब जवाब इंसान के पढ़ने के लिए HTML होता है। API के जवाब में आम तौर पर प्रोग्राम के पढ़ने के लिए डेटा होता है, अक्सर JSON में। HTTP को गहराई से समझना हो, तो पहले HTTP क्या है और रिक्वेस्ट-रिस्पॉन्स कैसे चलता है पढ़ें।

India Stack: API के उदाहरण जो आप रोज़ इस्तेमाल करते हैं

भारत में API का सबसे बड़ा उदाहरण शायद India Stack है। उसकी वेबसाइट indiastack.org अपनी पहचान इन शब्दों में देती है: "A collection of open APIs empowering people and businesses" (14 नवंबर 2026 को पढ़ा गया)। मतलब, India Stack खुद को खुले API का एक संग्रह कहता है। उसकी होमपेज टाइमलाइन में ये नाम आते हैं:

  • UPI (Unified Payments Interface): India Stack का payments पेज इसे भारत का अपना real-time मोबाइल पेमेंट सिस्टम कहता है। वही पेज बताता है कि सभी लाइसेंस वाले बैंक एक NPCI सर्वर से जुड़े हैं। इसलिए किसी fintech कंपनी को UPI से जुड़े बैंकों तक पहुँचने के लिए APIs का सिर्फ़ एक सेट चाहिए, हर बैंक के लिए अलग नहीं।
  • Aadhaar eKYC: यह सहमति (consent) पर चलने वाली रिक्वेस्ट और रिस्पॉन्स सेवा है। सेवा माँगने वाली संस्था पहले यूज़र की सहमति लेती है, बायोमेट्रिक या OTP से। India Stack का identity पेज e-KYC की API specification का लिंक भी देता है।
  • DigiLocker: identity पेज इसे भारत सरकार की ओर से Aadhaar धारकों के लिए एक public utility कहता है। संस्थाएँ इससे जुड़कर यूज़र की सहमति से उसके दस्तावेज़ जाँच सकती हैं।
  • Account Aggregator: यह नियंत्रित (regulated) संस्थाओं का एक framework है। ये संस्थाएँ यूज़र की सहमति से डेटा साझा करने के लिए एक interface देती हैं। India Stack की टाइमलाइन के अनुसार यह framework 2021 में 8 बैंकों के साथ शुरू हुआ।

इन उदाहरणों से एक ज़रूरी बात निकलती है। API "खुला" होने का मतलब यह नहीं कि कोई भी उसे कॉल कर सकता है। India Stack का identity पेज साफ़ लिखता है कि e-auth और e-KYC सेवाएँ सिर्फ़ बैंक, लाइसेंस वाली NBFC, टेलीकॉम कंपनियों और सरकारी संस्थाओं के लिए हैं। इसलिए आप अपने hobby project से Aadhaar eKYC को कॉल नहीं कर सकते। कौन कॉल कर सकता है, यह भी API के समझौते का हिस्सा है।

एक API कॉल के हिस्से कौन-से होते हैं?

हर HTTP API कॉल में लगभग यही टुकड़े होते हैं:

  1. Endpoint URL: वह पता जहाँ रिक्वेस्ट जाती है। इसमें base URL और path होता है, जैसे https://api.github.com और /zen।
  2. Method: GET जानकारी पढ़ने के लिए, POST डेटा भेजकर कुछ करवाने के लिए।
  3. Headers: रिक्वेस्ट के साथ चलने वाली अतिरिक्त जानकारी, जैसे आप किस फ़ॉर्मेट में जवाब चाहते हैं।
  4. API key: आपकी पहचान। सर्वर इसी से तय करता है कि रिक्वेस्ट किसकी है और उसकी अनुमति है या नहीं। यह आम तौर पर एक हेडर में जाती है।
  5. Body: POST रिक्वेस्ट में भेजा गया डेटा, ज़्यादातर JSON में।
  6. Status code: सर्वर के जवाब का पहला संकेत, जो बताता है कि रिक्वेस्ट सफल हुई या नहीं।

अब इन्हें एक असली कॉल में देखते हैं।

खुद चलाकर देखें: GitHub API पर पहली कॉल

GitHub का REST API https://api.github.com पर है। उसके docs में GET /zen नाम का एक endpoint है, जो "Zen of GitHub" से एक random वाक्य लौटाता है। GitHub के docs इसका curl उदाहरण बिना Authorization हेडर के दिखाते हैं, इसलिए पहली कॉल के लिए यह अच्छा है। अपने कंप्यूटर या VPS के terminal में चलाएँ:

curl --request GET \
  --url "https://api.github.com/zen" \
  --header "Accept: application/vnd.github+json" \
  --header "X-GitHub-Api-Version: 2022-11-28"

इस कमांड के हिस्से पढ़िए। --request GET मेथड है। --url endpoint है। पहला हेडर Accept: application/vnd.github+json वही है जिसे GitHub के docs सुझाते हैं। दूसरा हेडर X-GitHub-Api-Version बताता है कि आप REST API का कौन-सा version चाहते हैं। docs के उदाहरण में यही 2022-11-28 लिखा है। जवाब में आपको एक छोटा वाक्य दिखना चाहिए। कमांड दोबारा चलाएँ, तो वाक्य बदल सकता है, क्योंकि endpoint random वाक्य देता है।

GitHub के docs एक और नियम लिखते हैं: हर रिक्वेस्ट में एक valid User-Agent हेडर होना चाहिए, और जिस रिक्वेस्ट में यह नहीं है उसे GitHub ठुकरा देता है। आपको इसे लिखना नहीं पड़ा, क्योंकि GitHub के troubleshooting पेज के अनुसार curl अपने आप एक valid User-Agent भेजता है। अगर आप अपना प्रोग्राम किसी library से लिखते हैं, तो यह हेडर खुद जोड़ें।

Status code और हेडर कैसे देखें?

-i flag जवाब के हेडर भी दिखाता है:

curl -i "https://api.github.com/zen"

सबसे ऊपर की लाइन में status code दिखेगा। GitHub के docs इस endpoint के लिए 200 लिखते हैं। नीचे आपको x-ratelimit- से शुरू होने वाले हेडर दिखने चाहिए। GitHub के rate-limit पेज के अनुसार x-ratelimit-limit बताता है कि कुल कितनी रिक्वेस्ट की अनुमति है। x-ratelimit-remaining बताता है कि कितनी बची हैं। x-ratelimit-reset बताता है कि गिनती कब दोबारा शुरू होगी।

Query parameter क्या होता है?

GitHub का GET /octocat endpoint Octocat को ASCII art में लौटाता है। docs इसमें एक वैकल्पिक s parameter लिखते हैं। इसमें लिखे शब्द Octocat के speech bubble में आते हैं:

curl "https://api.github.com/octocat?s=Namaste"

URL में ? के बाद का हिस्सा query parameter है। यह भी API के समझौते में लिखा है। अगर आप कोई ऐसा parameter भेजें जो docs में नहीं है, तो उसका असर तय नहीं है। docs जो कहते हैं, वही भरोसे लायक है।

कॉल अचानक 403 या 429 क्यों देने लगी?

GitHub के docs के अनुसार बिना authentication वाली रिक्वेस्ट की primary rate limit 60 रिक्वेस्ट प्रति घंटा है। limit पार होने पर जवाब 403 या 429 आता है, और x-ratelimit-remaining की value 0 होती है। x-ratelimit-reset की value UTC epoch seconds में होती है। इसे पढ़ने लायक समय में बदलने के लिए Linux पर चलाएँ:

date -d @1767225600

यहाँ 1767225600 की जगह अपने हेडर वाली संख्या लिखें। उस समय के बाद गिनती फिर शुरू होती है।

एक और बात उलझा सकती है। GitHub के troubleshooting पेज के अनुसार, अगर आप किसी private resource को बिना सही authentication के माँगते हैं, तो जवाब 404 Not Found आता है, 403 नहीं। इसका मतलब है कि GitHub पर 404 का अर्थ हमेशा "यह चीज़ है ही नहीं" नहीं होता। हो सकता है वह मौजूद हो, पर आपको उसे देखने की अनुमति न हो।

Status codes: 200, 401, 404 और 429 का मतलब

Status code पढ़ना API के साथ काम करने का आधा हिस्सा है। RFC 9110 और RFC 6585 इनके अर्थ तय करते हैं:

  • 2xx: रिक्वेस्ट सफलतापूर्वक मिली। 200 OK का मतलब है कि रिक्वेस्ट सफल हुई।
  • 4xx: गलती client की तरफ़ लगती है। यानी आपकी रिक्वेस्ट में कुछ ठीक करना है।
  • 401 Unauthorized: रिक्वेस्ट पर अमल नहीं हुआ, क्योंकि उसमें valid authentication credentials नहीं हैं। RFC 9110 के अनुसार 401 भेजने वाले सर्वर को WWW-Authenticate हेडर भी भेजना होता है।
  • 404 Not Found: सर्वर को उस resource की मौजूदा जानकारी नहीं मिली। 404 यह नहीं बताता कि यह कमी अस्थायी है या स्थायी।
  • 429 Too Many Requests: आपने तय समय में बहुत ज़्यादा रिक्वेस्ट भेजीं, यानी rate limiting। जवाब में Retry-After हेडर हो सकता है, जो बताता है कि कितनी देर रुकना है।

429 मिलने पर लूप में तुरंत दोबारा कॉल न करें। इससे सिर्फ़ और रिक्वेस्ट जुड़ती हैं। हेडर पढ़ें, बताया गया समय रुकें, फिर कोशिश करें।

JSON: ज़्यादातर API का डेटा फ़ॉर्मेट

JSON (JavaScript Object Notation) को RFC 8259 एक हल्का, text-based और किसी भी प्रोग्रामिंग भाषा से स्वतंत्र डेटा फ़ॉर्मेट कहता है। उसका media type application/json है। जब आप POST रिक्वेस्ट में JSON body भेजते हैं, तो content-type: application/json हेडर सर्वर को बताता है कि body किस फ़ॉर्मेट में है।

JSON में डेटा key और value के जोड़ों में होता है। key हमेशा double quotes में होती है। value कोई text, संख्या, list या दूसरा object हो सकती है। अगला उदाहरण इसे असली body में दिखाता है।

API key क्या है? Claude API का उदाहरण

GitHub वाली कॉल में key नहीं लगी। पर कई API, खासकर पैसे से चलने वाले AI API, बिना key के जवाब नहीं देते। Claude API इसका साफ़ उदाहरण है। उसके docs उसे https://api.anthropic.com पर चलने वाला RESTful API कहते हैं। संदेश भेजने का endpoint POST /v1/messages है।

Claude के docs के अनुसार हर रिक्वेस्ट में anthropic-version और content-type: application/json हेडर ज़रूरी हैं। key Authorization: Bearer <key> हेडर में जाती है। पुराना x-api-key हेडर अब legacy fallback कहलाता है। वह अब भी चलता है, और docs के कुछ curl उदाहरण उसी को इस्तेमाल करते हैं। key आप Claude Console में बनाते हैं। docs कहते हैं कि SDK और CLI key को ANTHROPIC_API_KEY environment variable से पढ़ते हैं।

key को कमांड में सीधे टाइप न करें, वरना वह shell history में रह जाती है। पहले उसे बिना दिखाए पढ़ें:

read -s ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY

फिर कॉल करें:

curl --request POST https://api.anthropic.com/v1/messages \
  --header "Authorization: Bearer $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2026-10-21" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-opus-5-5",
    "max_tokens": 1000,
    "messages": [
      {"role": "user", "content": "API को एक वाक्य में समझाइए।"}
    ]
  }'

यहाँ हर हिस्सा पहचानिए। मेथड POST है, क्योंकि आप डेटा भेजकर काम करवा रहे हैं। --data के अंदर JSON body है। उसमें model बताता है कि कौन-सा मॉडल चाहिए, max_tokens जवाब की अधिकतम लंबाई तय करता है, और messages में आपका संदेश है। सफल जवाब JSON में आता है। docs के नमूने में उसके फ़ील्ड हैं id, type, role, model, content, stop_reason, stop_sequence, stop_details और usage। जवाब का text content में होता है, और usage बताता है कि कितने tokens लगे। यह कॉल मुफ़्त नहीं है। बिल कैसे बनता है, यह input और output tokens से Claude API का खर्च में समझाया गया है। अपनी billing की स्थिति Console में देखें।

Claude API की गलती का जवाब कैसा दिखता है?

Claude API गलती होने पर भी JSON लौटाता है। docs का अपना उदाहरण यह है:

{"type":"error","error":{"type":"not_found_error","message":"The requested resource could not be found."},"request_id":"req_011CSHoEeqs5C35K2UUqR7Fy"}

error.type पढ़कर आप कारण जान सकते हैं:

  • 401 के साथ authentication_error: key में दिक्कत है। docs के अनुसार key malformed, revoked या expired हो सकती है। एक आम कारण यह है कि ANTHROPIC_API_KEY खाली है, क्योंकि export किसी दूसरे terminal में किया था। printenv ANTHROPIC_API_KEY | wc -c चलाएँ। 0 दिखे, तो इस terminal में variable सेट नहीं है।
  • 404 के साथ not_found_error: endpoint का path, या URL में दी गई कोई ID, गलत है।
  • 429 के साथ rate_limit_error: आपकी organization ने rate limit छू ली, या usage tier की मासिक spend cap पूरी हो गई। rate limit वाले 429 में retry-after हेडर हो सकता है, जो बताता है कि कितने सेकंड रुकना है। मासिक spend cap वाले 429 में यह हेडर कभी नहीं आता, इसलिए रुककर दोबारा कोशिश करने से वह ठीक नहीं होगा।
  • 400 के साथ invalid_request_error: रिक्वेस्ट में कुछ गलत है। docs के अनुसार version 2026-10-21 में temperature, top_p और top_k हटा दिए गए हैं, और इनमें से कोई भी भेजने पर 400 आता है। पुराने tutorials से body कॉपी करते समय इसका ध्यान रखें।

request_id को सँभालकर रखें। support से बात करते समय यही पहचान काम आती है।

key को browser वाले code में क्यों नहीं रखना चाहिए?

Claude के docs साफ़ कहते हैं: Claude API को अपने back end से कॉल करें, उस code से नहीं जो यूज़र के browser में चलता है। browser में भेजा गया code हर यूज़र पढ़ सकता है, इसलिए उसमें रखी key हर किसी के हाथ में होती है। docs यह भी सलाह देते हैं कि keys को secrets manager में रखें, समय-समय पर बदलें, और जिस key के लीक होने का शक हो उसे बंद या delete करें। back end चलाने के लिए एक छोटा सर्वर काफ़ी है, और VPS क्या है और यह कैसे काम करता है उसकी शुरुआत के लिए अच्छी जगह है।

REST, GraphQL और gRPC में क्या फ़र्क है?

REST (Representational State Transfer) कोई protocol नहीं है। Roy Fielding ने अपने शोध-प्रबंध में इसे distributed hypermedia systems के लिए एक architectural style के रूप में रखा। मतलब, यह API डिज़ाइन करने का एक तरीका है। जो API इस तरीके पर चलते हैं, उन्हें RESTful कहते हैं। GitHub और Claude, दोनों के API ऊपर इसी ढंग से दिखे: हर resource का अपना URL है, और डेटा JSON में आता-जाता है।

GraphQL अपनी docs में खुद को API के लिए एक query language कहता है। साथ में यह एक server-side runtime भी है, जो आपके डेटा के लिए तय किए गए type system पर queries चलाता है। यह किसी खास database से बँधा नहीं है।

gRPC का आधार एक service और उसके उन methods को परिभाषित करना है जिन्हें दूर से कॉल किया जा सकता है। यह interface लिखने के लिए protocol buffers का इस्तेमाल कर सकता है। सबसे सीधे प्रकार, unary RPC, में client एक रिक्वेस्ट भेजता है और एक जवाब पाता है। शुरुआत करने वाले के लिए REST से शुरू करना ठीक है, क्योंकि इस लेख के दोनों उदाहरण उसी ढंग के हैं।

आगे क्या करें: AI API कॉल करना है तो

अगर आप अपने प्रोग्राम से कोई AI API कॉल करना चाहते हैं, तो यह क्रम रखें:

  1. ऊपर वाली GitHub कॉल चलाएँ, और status code और हेडर पढ़ने की आदत डालें।
  2. Claude API में authentication और API key कैसे काम करते हैं पढ़ें। key बनाना और उसे सुरक्षित रखना वहीं से समझें।
  3. key को ANTHROPIC_API_KEY environment variable में रखें, code में नहीं।
  4. पहली POST /v1/messages कॉल curl से करें, फिर उसे अपने back end के code में लाएँ।
  5. बिल पर नज़र रखें। हर जवाब का usage फ़ील्ड log करें, और Console में खर्च देखते रहें।

अगर आप खुद कोई मॉडल अपने सर्वर पर चलाते हैं, तो आप API देने वाले बन जाते हैं। तब सुरक्षा आपकी ज़िम्मेदारी है, और अपने Ollama API endpoint को सुरक्षित करने का तरीका वहीं काम आएगा। अपने API को असली सेवा से जोड़ने से पहले टेस्ट करना हो, तो self-hosted API testing और mocking के टूल देखें।

FAQ

HTTP और API में क्या फ़र्क है?

HTTP वह protocol है जिससे रिक्वेस्ट और रिस्पॉन्स जाते-आते हैं। इसमें मेथड (जैसे GET और POST) और status code (जैसे 200 और 404) होते हैं। API किसी खास सेवा का समझौता है: कौन-सा URL, कौन-से हेडर, body किस फ़ॉर्मेट में, और जवाब में कौन-से फ़ील्ड। वेब पर ज़्यादातर API, HTTP के ऊपर चलते हैं।

क्या UPI एक API है?

India Stack अपनी वेबसाइट पर खुद को "A collection of open APIs" कहता है, और उसकी सूची में UPI है। पर India Stack का payments पेज UPI को एक real-time मोबाइल पेमेंट सिस्टम कहता है। वही पेज बताता है कि fintech कंपनियों को UPI से जुड़े बैंकों तक पहुँचने के लिए APIs का एक ही सेट चाहिए। यानी UPI एक पेमेंट सिस्टम है, जिस तक कंपनियाँ API के ज़रिए पहुँचती हैं।

API कॉल में 401, 404 और 429 का क्या मतलब है?

401 का मतलब है कि रिक्वेस्ट में valid authentication credentials नहीं हैं, यानी key गायब है या गलत है। 404 का मतलब है कि सर्वर को वह resource नहीं मिला। GitHub पर private चीज़ बिना authentication के माँगने पर भी 404 आता है। 429 का मतलब है कि आपने तय समय में बहुत ज़्यादा रिक्वेस्ट भेजीं। जवाब में Retry-After हेडर हो, तो उतना रुककर दोबारा कोशिश करें।

क्या हर API के लिए API key चाहिए?

नहीं। GitHub के docs /zen और /octocat के curl उदाहरण बिना Authorization हेडर के दिखाते हैं, और बिना authentication वाली रिक्वेस्ट की limit 60 प्रति घंटा है। Claude API जैसे पैसे से चलने वाले API में हर रिक्वेस्ट के साथ key भेजनी होती है। कुछ सेवाएँ, जैसे Aadhaar eKYC, सिर्फ़ तय तरह की संस्थाओं के लिए खुली हैं।

API key को कहाँ रखना सुरक्षित है?

key को अपने सर्वर पर environment variable या secrets manager में रखें। उसे browser में चलने वाले code में, या Git में commit होने वाली फ़ाइल में, कभी न रखें। Claude के docs कहते हैं कि API को अपने back end से कॉल करें, keys को समय-समय पर बदलें, और लीक होने का शक हो तो key बंद या delete करें।

क्या यह लेख उपयोगी था?

#api#http#rest#json#web-basics#beginners