Nutrola का न्यूट्रिशन डेटा API: डेवलपर्स कैसे हमारी फूड डेटाबेस तक पहुँच सकते हैं
Nutrola के न्यूट्रिशन डेटा API के लिए डेवलपर गाइड। जानें कि कैसे हमारे सत्यापित फूड डेटाबेस तक पहुँचें जिसमें 3 मिलियन से अधिक प्रविष्टियाँ हैं, एंडपॉइंट्स, प्रमाणीकरण और वास्तविक उपयोग के मामलों का अन्वेषण करें।
क्या आप एक स्वास्थ्य, फिटनेस या खाद्य संबंधित ऐप बना रहे हैं? एक सबसे बड़ी चुनौती जो आपको सामना करनी पड़ेगी, वह है न्यूट्रिशन डेटा। आपको हजारों खाद्य पदार्थों के लिए सटीक कैलोरी और मैक्रो जानकारी की आवश्यकता है, यह अंतरराष्ट्रीय उत्पादों को कवर करे, और यह तब भी अद्यतित रहे जब निर्माता अपने उत्पादों को फिर से तैयार करते हैं।
अधिकांश डेवलपर्स USDA FoodData Central जैसे ओपन गवर्नमेंट डेटाबेस से डेटा खींचने से शुरू करते हैं। यह आपको एक आधार प्रदान करता है, लेकिन यह 47 देशों के ब्रांडेड उत्पादों, रेस्तरां के भोजन, या उन हजारों क्षेत्रीय खाद्य पदार्थों को कवर नहीं करता जो असली उपयोगकर्ता हर दिन खाते हैं। इन अंतरालों को भरना आपके लिए वर्षों का डेटा क्यूरेशन कार्य होगा।
Nutrola का न्यूट्रिशन डेटा API डेवलपर्स को उसी सत्यापित फूड डेटाबेस तक पहुँच प्रदान करता है जो हमारे ऐप को संचालित करता है — 3 मिलियन से अधिक प्रविष्टियाँ, कच्चे सामग्री, ब्रांडेड उत्पाद, रेस्तरां के भोजन और मिश्रित व्यंजनों को कवर करती हैं। हर प्रविष्टि हमारे मल्टी-लेयर गुणवत्ता नियंत्रण प्रक्रिया के माध्यम से सत्यापित की जाती है, वही प्रणाली जिसे 2 मिलियन से अधिक उपयोगकर्ता भरोसा करते हैं।
यह गाइड आपको हमारे API के साथ निर्माण शुरू करने के लिए आवश्यक सभी जानकारी प्रदान करती है: आर्किटेक्चर, प्रमाणीकरण, एंडपॉइंट्स, रेट लिमिट्स, और वास्तविक कोड उदाहरण।
API का अवलोकन
Nutrola न्यूट्रिशन डेटा API एक RESTful JSON API है। आप HTTP अनुरोध करते हैं, आपको JSON प्रतिक्रियाएँ मिलती हैं। SDK की आवश्यकता नहीं है, हालांकि हम सुविधा के लिए Python, JavaScript, और Swift के लिए क्लाइंट लाइब्रेरी प्रदान करते हैं।
बेस URL
https://api.nutrola.com/v1
सभी एंडपॉइंट्स HTTPS के माध्यम से प्रदान किए जाते हैं। सामान्य HTTP अनुरोधों को अस्वीकार कर दिया जाता है।
मुख्य क्षमताएँ
| क्षमता | विवरण |
|---|---|
| खाद्य खोज | 3M+ खाद्य प्रविष्टियों के बीच पूर्ण-पाठ खोज, श्रेणी, ब्रांड, और देश द्वारा फ़िल्टरिंग के साथ |
| बारकोड लुकअप | UPC, EAN, या अन्य बारकोड प्रारूपों द्वारा न्यूट्रिशन डेटा प्राप्त करें |
| न्यूट्रिशन विवरण | किसी भी खाद्य पदार्थ के लिए पूर्ण न्यूट्रिशन प्रोफ़ाइल (70+ पोषक तत्वों सहित) |
| सर्विंग साइज़ | मानक और वैकल्पिक सर्विंग साइज़ के साथ ग्राम रूपांतरण |
| रेसिपी विश्लेषण | सामग्री की एक सूची प्रस्तुत करें और संयुक्त न्यूट्रिशन डेटा प्राप्त करें |
| खाद्य श्रेणियाँ | श्रेणीबद्ध खाद्य श्रेणी टैक्सोनॉमी ब्राउज़ करें |
| ब्रांड डायरेक्टरी | ब्रांडेड खाद्य निर्माताओं की खोज और ब्राउज़ करें |
| ऑटोकम्प्लीट | खाद्य खोज इंटरफेस के लिए तेज़ टाइप-एड सुझाव |
प्रतिक्रिया प्रारूप
सभी प्रतिक्रियाएँ एक सुसंगत संरचना का पालन करती हैं:
{
"status": "success",
"data": { },
"meta": {
"request_id": "req_abc123",
"rate_limit_remaining": 245,
"rate_limit_reset": "2026-03-10T15:00:00Z"
}
}
त्रुटि प्रतिक्रियाएँ एक मशीन-पठनीय त्रुटि कोड और एक मानव-पठनीय संदेश शामिल करती हैं:
{
"status": "error",
"error": {
"code": "FOOD_NOT_FOUND",
"message": "प्रदान की गई ID से मेल खाने वाली कोई खाद्य प्रविष्टि नहीं है।",
"request_id": "req_xyz789"
}
}
प्रमाणीकरण
सभी API अनुरोधों के लिए Authorization हेडर में एक API कुंजी की आवश्यकता होती है।
API कुंजी प्राप्त करना
- developer.nutrola.com पर एक डेवलपर खाता बनाएं
- अपने डैशबोर्ड में API कुंजी अनुभाग पर जाएँ
- एक नई कुंजी उत्पन्न करें और आवश्यक स्कोप निर्दिष्ट करें
- कुंजी को सुरक्षित रूप से संग्रहीत करें — यह केवल एक बार प्रदर्शित होगी
अपनी API कुंजी का उपयोग करना
प्रत्येक अनुरोध हेडर में कुंजी शामिल करें:
Authorization: Bearer YOUR_API_KEY
curl के साथ उदाहरण:
curl -H "Authorization: Bearer ntr_live_abc123def456" \
https://api.nutrola.com/v1/foods/search?q=chicken+breast
API कुंजी स्कोप
| स्कोप | पहुँच स्तर |
|---|---|
foods:read |
खाद्य डेटा खोजें और प्राप्त करें (सबसे सामान्य) |
barcodes:read |
बारकोड लुकअप |
recipes:analyze |
रेसिपी न्यूट्रिशन विश्लेषण |
brands:read |
ब्रांड डायरेक्टरी पहुँच |
categories:read |
खाद्य श्रेणी टैक्सोनॉमी |
कुंजी को विशिष्ट क्षमताओं के लिए स्कोप किया जा सकता है। केवल foods:read वाली कुंजी बारकोड लुकअप तक पहुँच नहीं कर सकती। यह न्यूनतम विशेषाधिकार के सिद्धांत का पालन करता है — केवल वही स्कोप अनुरोध करें जो आपके एप्लिकेशन को आवश्यक हैं।
मुख्य एंडपॉइंट्स
खाद्य खोज
नाम, कीवर्ड, या वाक्यांश द्वारा डेटाबेस में खोजें।
GET /v1/foods/search
पैरामीटर:
| पैरामीटर | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
q |
string | हाँ | खोज क्वेरी (जैसे, "ग्रिल्ड चिकन ब्रेस्ट") |
category |
string | नहीं | खाद्य श्रेणी द्वारा फ़िल्टर करें (जैसे, "डेयरी", "सब्जियाँ") |
brand |
string | नहीं | ब्रांड नाम द्वारा फ़िल्टर करें |
country |
string | नहीं | ISO 3166-1 alpha-2 देश कोड (जैसे, "US", "DE", "JP") |
verified_only |
boolean | नहीं | केवल सत्यापित स्रोत डेटा वाली प्रविष्टियाँ लौटाएँ (डिफ़ॉल्ट: सत्य) |
page |
integer | नहीं | पृष्ठ संख्या (डिफ़ॉल्ट: 1) |
per_page |
integer | नहीं | प्रति पृष्ठ परिणाम, अधिकतम 50 (डिफ़ॉल्ट: 20) |
उदाहरण अनुरोध:
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.nutrola.com/v1/foods/search?q=greek+yogurt&country=US&per_page=5"
उदाहरण प्रतिक्रिया:
{
"status": "success",
"data": {
"results": [
{
"id": "food_8f2k9d",
"name": "Greek Yogurt, Plain, Nonfat",
"brand": null,
"category": "dairy",
"country": "US",
"verified": true,
"source": "USDA",
"nutrition_per_100g": {
"calories": 59,
"protein": 10.2,
"carbohydrates": 3.6,
"fat": 0.4,
"fiber": 0,
"sugar": 3.2,
"sodium": 36
},
"default_serving": {
"description": "1 container (170g)",
"grams": 170
}
}
],
"total_results": 342,
"page": 1,
"per_page": 5
}
}
खाद्य विवरण प्राप्त करें
विशिष्ट खाद्य पदार्थ के लिए पूर्ण न्यूट्रिशन प्रोफ़ाइल प्राप्त करें।
GET /v1/foods/{food_id}
उदाहरण अनुरोध:
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.nutrola.com/v1/foods/food_8f2k9d"
विवरण प्रतिक्रिया में पूर्ण पोषक तत्व विभाजन शामिल है — 70 से अधिक पोषक तत्वों सहित सभी विटामिन, खनिज, एमिनो एसिड, और फैटी एसिड प्रोफाइल। इसमें सभी उपलब्ध सर्विंग साइज़ और उनके ग्राम समकक्ष भी शामिल हैं।
आंशिक प्रतिक्रिया (मुख्य पोषक तत्व):
{
"status": "success",
"data": {
"id": "food_8f2k9d",
"name": "Greek Yogurt, Plain, Nonfat",
"nutrition_per_100g": {
"calories": 59,
"protein": 10.2,
"carbohydrates": 3.6,
"fat": 0.4,
"fiber": 0,
"sugar": 3.2,
"saturated_fat": 0.1,
"monounsaturated_fat": 0.1,
"polyunsaturated_fat": 0,
"cholesterol": 5,
"sodium": 36,
"potassium": 141,
"calcium": 110,
"iron": 0.1,
"vitamin_a": 4,
"vitamin_c": 0,
"vitamin_d": 0
},
"serving_sizes": [
{ "description": "1 container (170g)", "grams": 170 },
{ "description": "1 cup (245g)", "grams": 245 },
{ "description": "1 tbsp (15g)", "grams": 15 },
{ "description": "100g", "grams": 100 }
],
"allergens": ["milk"],
"source": "USDA",
"source_id": "170903",
"last_verified": "2026-02-15",
"confidence_score": 0.98
}
}
बारकोड लुकअप
अपने बारकोड द्वारा खाद्य उत्पाद की खोज करें।
GET /v1/barcodes/{barcode}
समर्थित प्रारूप: UPC-A, UPC-E, EAN-13, EAN-8
उदाहरण अनुरोध:
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.nutrola.com/v1/barcodes/0049000006346"
प्रतिक्रिया उसी खाद्य विवरण वस्तु को लौटाती है जैसे /foods/{food_id} एंडपॉइंट, जिसमें अतिरिक्त बारकोड-विशिष्ट फ़ील्ड जैसे barcode_format और regional_variants (विभिन्न देशों में समान उत्पाद के लिए खाद्य ID की एक सूची, जो विभिन्न फॉर्मूलेशन हो सकते हैं) शामिल हैं।
रेसिपी विश्लेषण
सामग्री की एक सूची प्रस्तुत करें और संयुक्त न्यूट्रिशन विभाजन प्राप्त करें।
POST /v1/recipes/analyze
अनुरोध शरीर:
{
"name": "Overnight Oats",
"servings": 2,
"ingredients": [
{ "food_id": "food_3k8m2n", "grams": 160 },
{ "food_id": "food_9p4q7r", "grams": 400 },
{ "food_id": "food_1a5b8c", "grams": 60 },
{ "food_id": "food_6d2e9f", "grams": 2, "description": "pinch of salt" }
]
}
आप सामग्री को टेक्स्ट के रूप में स्वचालित रूप से पार्स करने के लिए भी प्रस्तुत कर सकते हैं:
{
"name": "Overnight Oats",
"servings": 2,
"ingredients_text": "160g rolled oats, 400ml whole milk, 60g peanut butter, pinch of salt"
}
प्रतिक्रिया:
{
"status": "success",
"data": {
"name": "Overnight Oats",
"servings": 2,
"nutrition_per_serving": {
"calories": 425,
"protein": 18.5,
"carbohydrates": 42.3,
"fat": 21.2,
"fiber": 5.8
},
"nutrition_total": {
"calories": 850,
"protein": 37.0,
"carbohydrates": 84.6,
"fat": 42.4,
"fiber": 11.6
},
"ingredients_matched": [
{ "input": "160g rolled oats", "matched_food": "food_3k8m2n", "confidence": 0.97 },
{ "input": "400ml whole milk", "matched_food": "food_9p4q7r", "confidence": 0.99 },
{ "input": "60g peanut butter", "matched_food": "food_1a5b8c", "confidence": 0.96 },
{ "input": "pinch of salt", "matched_food": "food_6d2e9f", "confidence": 0.88 }
]
}
}
ऑटोकम्प्लीट
खोज इंटरफेस बनाने के लिए तेज़ टाइप-एड सुझाव।
GET /v1/foods/autocomplete?q={query}
पैरामीटर:
| पैरामीटर | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
q |
string | हाँ | आंशिक खोज क्वेरी (न्यूनतम 2 वर्ण) |
limit |
integer | नहीं | अधिकतम परिणाम, 1-10 (डिफ़ॉल्ट: 5) |
country |
string | नहीं | इस देश से परिणामों को प्राथमिकता दें |
प्रतिक्रिया समय इंटरैक्टिव उपयोग के लिए अनुकूलित हैं — आमतौर पर 50 मिलीसेकंड के भीतर। ऑटोकम्प्लीट एंडपॉइंट सरल खाद्य वस्तुओं (ID, नाम, ब्रांड, और श्रेणी केवल) को तेज़ रेंडरिंग के लिए लौटाता है।
रेट लिमिट और मूल्य निर्धारण
फ्री टियर
फ्री टियर विकास, परीक्षण, और छोटे पैमाने के अनुप्रयोगों के लिए डिज़ाइन किया गया है:
| सीमा | मान |
|---|---|
| प्रति दिन अनुरोध | 500 |
| प्रति मिनट अनुरोध | 30 |
| प्रति अनुरोध खाद्य खोज परिणाम | 20 |
| प्रति दिन रेसिपी विश्लेषण | 10 |
| प्रति दिन बारकोड लुकअप | 100 |
ग्रोथ टियर
मध्यम ट्रैफ़िक वाले उत्पादन अनुप्रयोगों के लिए:
| सीमा | मान |
|---|---|
| प्रति दिन अनुरोध | 25,000 |
| प्रति मिनट अनुरोध | 300 |
| प्रति अनुरोध खाद्य खोज परिणाम | 50 |
| प्रति दिन रेसिपी विश्लेषण | 500 |
| प्रति दिन बारकोड लुकअप | 5,000 |
| मूल्य | $49/माह |
एंटरप्राइज टियर
उच्च-ट्रैफ़िक अनुप्रयोगों, व्हाइट-लेबल समाधानों, और कस्टम आवश्यकताओं के लिए:
| विशेषता | विवरण |
|---|---|
| प्रति दिन अनुरोध | कस्टम (आम तौर पर 100K+) |
| रेट लिमिट | कस्टम |
| समर्पित समर्थन | शामिल |
| SLA | 99.9% अपटाइम गारंटी |
| कस्टम डेटा निर्यात | उपलब्ध |
| वेबहुक सूचनाएँ | डेटा अपडेट के लिए उपलब्ध |
| मूल्य | बिक्री से संपर्क करें |
रेट लिमिट जानकारी प्रत्येक API प्रतिक्रिया में meta ऑब्जेक्ट के माध्यम से और HTTP प्रतिक्रिया हेडर्स (X-RateLimit-Remaining, X-RateLimit-Reset) में शामिल होती है।
वास्तविक उपयोग के मामले
फिटनेस और वर्कआउट ऐप्स
यदि आप एक फिटनेस ऐप बना रहे हैं और बिना खाद्य डेटाबेस बनाए न्यूट्रिशन ट्रैकिंग जोड़ना चाहते हैं, तो Nutrola का API सबसे तेज़ रास्ता है। उपयोगकर्ताओं को भोजन लॉग करने के लिए खाद्य खोज और बारकोड एंडपॉइंट्स का उपयोग करें, और कस्टम भोजन प्रविष्टियों के लिए रेसिपी विश्लेषण एंडपॉइंट का उपयोग करें।
भोजन योजना प्लेटफार्म
भोजन योजना ऐप्स को सटीक न्यूट्रिशन डेटा की आवश्यकता होती है ताकि वे विशिष्ट मैक्रो लक्ष्यों को पूरा करने वाली योजनाएँ उत्पन्न कर सकें। API का विस्तृत पोषक तत्व विभाजन (70+ पोषक तत्व) सटीक भोजन योजना अनुकूलन की अनुमति देता है, न केवल कैलोरी और मैक्रोज़ बल्कि सूक्ष्म पोषक तत्वों, एलर्जी, और आहार प्रतिबंध संगतता भी।
स्वास्थ्य देखभाल और टेलीहेल्थ
स्वास्थ्य देखभाल प्लेटफार्म जो रोगी न्यूट्रिशन की निगरानी करते हैं, API के साथ एकीकृत कर सकते हैं ताकि उनके मौजूदा इंटरफेस में सटीक खाद्य लॉगिंग प्रदान की जा सके। सत्यापित डेटा स्रोत (USDA, EFSA, निर्माता-प्रत्यक्ष) नैदानिक न्यूट्रिशन निगरानी के लिए आवश्यक सटीकता मानकों को पूरा करते हैं।
रेस्तरां और खाद्य सेवा
रेस्तरां ऑर्डरिंग प्लेटफार्म API का उपयोग मेनू आइटम के लिए न्यूट्रिशन जानकारी प्रदर्शित करने के लिए कर सकते हैं। रेसिपी विश्लेषण एंडपॉइंट यहाँ विशेष रूप से उपयोगी है — एक डिश की सामग्री प्रस्तुत करें और बिना प्रत्येक आइटम की मैन्युअल गणना किए पूर्ण न्यूट्रिशन विभाजन प्राप्त करें।
अनुसंधान और अकादमी
न्यूट्रिशन शोधकर्ता API का उपयोग आहार अध्ययन में खाद्य कोडिंग को मानकीकृत करने के लिए कर सकते हैं। सुसंगत, सत्यापित डेटा उन अध्ययनों में माप त्रुटि को कम करता है जो प्रतिभागी-रिपोर्टेड न्यूट्रिशन डेटा पर निर्भर करते हैं।
कोड उदाहरण
Python: एक खाद्य खोजें और न्यूट्रिशन विवरण प्राप्त करें
import requests
API_KEY = "ntr_live_your_key_here"
BASE_URL = "https://api.nutrola.com/v1"
headers = {
"Authorization": f"Bearer {API_KEY}"
}
# एक खाद्य खोजें
search_response = requests.get(
f"{BASE_URL}/foods/search",
headers=headers,
params={"q": "chicken breast grilled", "per_page": 3}
)
results = search_response.json()["data"]["results"]
for food in results:
print(f"{food['name']} - {food['nutrition_per_100g']['calories']} cal/100g")
# पहले परिणाम के लिए पूर्ण विवरण प्राप्त करें
food_id = results[0]["id"]
detail_response = requests.get(
f"{BASE_URL}/foods/{food_id}",
headers=headers
)
food_detail = detail_response.json()["data"]
nutrition = food_detail["nutrition_per_100g"]
print(f"\n{food_detail['name']}")
print(f"Calories: {nutrition['calories']}")
print(f"Protein: {nutrition['protein']}g")
print(f"Carbs: {nutrition['carbohydrates']}g")
print(f"Fat: {nutrition['fat']}g")
print(f"Serving sizes: {food_detail['serving_sizes']}")
JavaScript: बारकोड स्कैनिंग एकीकरण
const API_KEY = "ntr_live_your_key_here";
const BASE_URL = "https://api.nutrola.com/v1";
async function lookupBarcode(barcode) {
const response = await fetch(
`${BASE_URL}/barcodes/${barcode}`,
{
headers: {
"Authorization": `Bearer ${API_KEY}`
}
}
);
if (!response.ok) {
if (response.status === 404) {
console.log("उत्पाद डेटाबेस में नहीं मिला");
return null;
}
throw new Error(`API त्रुटि: ${response.status}`);
}
const data = await response.json();
return data.data;
}
// उदाहरण उपयोग
const product = await lookupBarcode("0049000006346");
if (product) {
const serving = product.default_serving;
const factor = serving.grams / 100;
console.log(`${product.name} (${product.brand})`);
console.log(`प्रति ${serving.description}:`);
console.log(` कैलोरी: ${Math.round(product.nutrition_per_100g.calories * factor)}`);
console.log(` प्रोटीन: ${(product.nutrition_per_100g.protein * factor).toFixed(1)}g`);
console.log(` कार्ब्स: ${(product.nutrition_per_100g.carbohydrates * factor).toFixed(1)}g`);
console.log(` फैट: ${(product.nutrition_per_100g.fat * factor).toFixed(1)}g`);
}
Swift: एक ऑटोकम्प्लीट खोज फ़ील्ड बनाना
import Foundation
class NutrolaAPI {
private let apiKey: String
private let baseURL = "https://api.nutrola.com/v1"
init(apiKey: String) {
self.apiKey = apiKey
}
func autocomplete(query: String, limit: Int = 5) async throws -> [FoodSuggestion] {
guard query.count >= 2 else { return [] }
var components = URLComponents(string: "\(baseURL)/foods/autocomplete")!
components.queryItems = [
URLQueryItem(name: "q", value: query),
URLQueryItem(name: "limit", value: String(limit))
]
var request = URLRequest(url: components.url!)
request.setValue("Bearer \(apiKey)", forHTTPHeaderField: "Authorization")
let (data, _) = try await URLSession.shared.data(for: request)
let response = try JSONDecoder().decode(AutocompleteResponse.self, from: data)
return response.data.suggestions
}
}
struct FoodSuggestion: Codable {
let id: String
let name: String
let brand: String?
let category: String
}
struct AutocompleteResponse: Codable {
let status: String
let data: AutocompleteData
}
struct AutocompleteData: Codable {
let suggestions: [FoodSuggestion]
}
त्रुटि हैंडलिंग सर्वश्रेष्ठ प्रथाएँ
API मानक HTTP स्थिति कोड का उपयोग करता है:
| स्थिति कोड | अर्थ | सामान्य कारण |
|---|---|---|
| 200 | सफलता | अनुरोध सामान्य रूप से पूरा हुआ |
| 400 | खराब अनुरोध | आवश्यक पैरामीटर गायब या अवैध मान |
| 401 | अनधिकृत | अवैध या गायब API कुंजी |
| 403 | निषिद्ध | API कुंजी में आवश्यक स्कोप की कमी |
| 404 | नहीं मिला | खाद्य ID या बारकोड डेटाबेस में नहीं है |
| 429 | दर सीमित | बहुत अधिक अनुरोध; दर सीमा हेडर की जाँच करें |
| 500 | सर्वर त्रुटि | आंतरिक त्रुटि; पुनः प्रयास करें |
जब आपको 429 प्रतिक्रिया मिलती है, तो Retry-After हेडर आपको बताता है कि पुनः प्रयास करने से पहले कितने सेकंड का इंतजार करना है। 429 और 500 प्रतिक्रियाओं के लिए एक्सपोनेंशियल बैकऑफ लागू करना उत्पादन अनुप्रयोगों के लिए अत्यधिक अनुशंसित है।
डेटा ताजगी और अपडेट
Nutrola का डेटाबेस लगातार अपडेट होता है। ब्रांडेड उत्पाद प्रविष्टियाँ तब ताज़ा होती हैं जब निर्माता परिवर्तनों की रिपोर्ट करते हैं, आमतौर पर 48 घंटों के भीतर। सरकारी डेटाबेस प्रविष्टियाँ त्रैमासिक रूप से समन्वयित की जाती हैं जब नए रिलीज़ प्रकाशित होते हैं।
यदि आपका एप्लिकेशन API प्रतिक्रियाओं को कैश करता है (जिसकी हम सिफारिश करते हैं प्रदर्शन के लिए), तो हम खाद्य विवरण प्रतिक्रियाओं के लिए 24 घंटे और खोज परिणामों के लिए 1 घंटे का कैश TTL सुझाते हैं। खाद्य विवरण प्रतिक्रियाओं में last_verified फ़ील्ड आपको बताती है कि प्रविष्टि को अंतिम बार कब सत्यापित किया गया था।
एंटरप्राइज ग्राहकों के लिए, हम खाद्य प्रविष्टियों के अपडेट होने पर वेबहुक सूचनाएँ प्रदान करते हैं, ताकि आपका एप्लिकेशन कैश किए गए डेटा को सक्रिय रूप से अमान्य कर सके बजाय इसके कि कैश TTL समाप्त होने की प्रतीक्षा करे।
शुरुआत करना
- साइन अप करें developer.nutrola.com पर — इसमें एक मिनट से कम समय लगता है
- API कुंजी उत्पन्न करें जिन स्कोप की आपको आवश्यकता है
- ऊपर दिए गए curl उदाहरणों का उपयोग करके अपना पहला अनुरोध करें
- इंटरएक्टिव डॉक्यूमेंटेशन का अन्वेषण करें developer.nutrola.com/docs पर जहाँ आप सीधे अपने ब्राउज़र में एंडपॉइंट्स का परीक्षण कर सकते हैं
- डेवलपर समुदाय में शामिल हों हमारे Discord सर्वर पर समर्थन, फीचर अनुरोधों के लिए, और यह देखने के लिए कि अन्य डेवलपर्स क्या बना रहे हैं
यदि आपके पास प्रश्न हैं, समस्याएँ आती हैं, या आप एंटरप्राइज एकीकरण पर चर्चा करना चाहते हैं, तो हमारी डेवलपर रिलेशंस टीम से संपर्क करें api@nutrola.com पर।
अक्सर पूछे जाने वाले प्रश्न
क्या Nutrola API का उपयोग करना मुफ्त है?
हाँ, एक मुफ्त टियर है जिसमें प्रति दिन 500 अनुरोध शामिल हैं। यह विकास, परीक्षण, और छोटे पैमाने के अनुप्रयोगों के लिए उपयुक्त है। उच्च ट्रैफ़िक वाले उत्पादन अनुप्रयोगों के लिए, ग्रोथ टियर $49 प्रति माह से शुरू होता है जिसमें 25,000 दैनिक अनुरोध शामिल हैं। एंटरप्राइज योजनाएँ उच्च-ट्रैफ़िक उपयोग के मामलों के लिए कस्टम सीमाओं के साथ उपलब्ध हैं।
API कौन से डेटा प्रारूपों का समर्थन करता है?
API केवल JSON का उपयोग करता है दोनों अनुरोधों और प्रतिक्रियाओं के लिए। सभी एंडपॉइंट्स GET अनुरोधों के लिए मानक क्वेरी पैरामीटर और POST अनुरोधों के लिए JSON अनुरोध शरीर स्वीकार करते हैं। प्रतिक्रिया एन्कोडिंग UTF-8 है, जो सभी समर्थित भाषाओं में खाद्य नामों को सही ढंग से संभालती है।
API द्वारा प्रदान किए गए न्यूट्रिशन डेटा की सटीकता कितनी है?
Nutrola डेटाबेस में प्रत्येक प्रविष्टि एक मल्टी-लेयर सत्यापन प्रक्रिया के माध्यम से जाती है जिसमें सरकारी स्रोत सत्यापन, निर्माता डेटा क्रॉस-रेफरेंसिंग, AI-संचालित सांख्यिकीय जांच, और मानव विशेषज्ञ समीक्षा शामिल है। हमारी सटीकता मानक प्रयोगशाला विश्लेषण के खिलाफ 97.4% है, जबकि भीड़-स्रोत डेटाबेस के लिए उद्योग का औसत 70-85% है। प्रत्येक खाद्य प्रविष्टि में एक confidence_score फ़ील्ड शामिल होती है जो हमारे निश्चितता स्तर को इंगित करती है।
क्या मैं API का उपयोग करके एक व्यावसायिक उत्पाद बना सकता हूँ?
हाँ। API व्यावसायिक उपयोग के लिए डिज़ाइन किया गया है। मुफ्त टियर अपने दर सीमाओं के भीतर व्यावसायिक उत्पादों के लिए उपयोग किया जा सकता है। ग्रोथ और एंटरप्राइज योजनाएँ व्यावसायिक उपयोग अधिकारों के साथ शामिल हैं जिन पर आवेदन के प्रकार पर कोई प्रतिबंध नहीं है। पूर्ण विवरण के लिए सेवा की शर्तों की समीक्षा करें developer.nutrola.com पर।
क्या API अमेरिका के बाहर के खाद्य पदार्थों का समर्थन करता है?
हाँ। डेटाबेस 47 देशों के ब्रांडेड उत्पादों और 120 से अधिक व्यंजनों से सामान्य खाद्य पदार्थों को कवर करता है। विशिष्ट बाजार से परिणामों को प्राथमिकता देने के लिए खोज एंडपॉइंट्स पर country पैरामीटर का उपयोग करें। बारकोड लुकअप स्वचालित रूप से उत्पाद को सही क्षेत्रीय फॉर्मूलेशन से मेल करता है।
मैं उन खाद्य पदार्थों को कैसे संभालूँ जो डेटाबेस में नहीं हैं?
यदि एक बारकोड लुकअप 404 लौटाता है, तो आप उत्पाद नाम का उपयोग करके टेक्स्ट खोज करने के लिए वापस जा सकते हैं। यदि कोई भी दृष्टिकोण खाद्य पदार्थ को नहीं ढूंढता है, तो आप इसे डेवलपर पोर्टल के माध्यम से जोड़ने के लिए प्रस्तुत कर सकते हैं। API भागीदारों द्वारा प्रस्तुत खाद्य पदार्थों को सत्यापन के लिए प्राथमिकता दी जाती है और आमतौर पर 72 घंटों के भीतर जोड़ा जाता है। एंटरप्राइज ग्राहक बड़े उत्पाद कैटलॉग के लिए बैच जोड़ने का अनुरोध कर सकते हैं।
क्या SDK या क्लाइंट लाइब्रेरी उपलब्ध हैं?
हम Python (pip के माध्यम से: pip install nutrola), JavaScript/TypeScript (npm के माध्यम से: npm install @nutrola/api), और Swift (Swift पैकेज प्रबंधक के माध्यम से) के लिए आधिकारिक क्लाइंट लाइब्रेरी प्रदान करते हैं। ये लाइब्रेरी प्रमाणीकरण, दर सीमित करना, पुनः प्रयास करना, और प्रतिक्रिया पार्सिंग को संभालती हैं। Go, Ruby, और PHP के लिए सामुदायिक-निर्मित पुस्तकालय उपलब्ध हैं।
क्या आप अपने पोषण ट्रैकिंग को बदलने के लिए तैयार हैं?
उन हजारों में शामिल हों जिन्होंने Nutrola के साथ अपनी स्वास्थ्य यात्रा को बदल दिया!
