आपको एक API की आवश्यकता है जो आपके ऐप द्वारा समर्थित शरीर के भागों की सूची प्रदान करे ताकि उपयोगकर्ता क्षेत्र (छाती, पीठ, कंधे, आदि) के अनुसार व्यायाम ब्राउज़ कर सकें। इस गाइड के अंत तक, आप एक कॉल में उस सूची को प्राप्त करेंगे, इसे अपने UI में वायर करेंगे, और देखेंगे कि कैसे संबंधित व्यायाम और पूर्ण वर्कआउट सत्र को उसी स्रोत से खींचा जा सकता है।
यह API आपको क्या देती है
Zyla API Hub पर एक्सरसाइज डेटाबेस API संरचित फिटनेस डेटा लौटाती है जिसे आप जल्दी से शिप कर सकते हैं। इसमें शामिल हैं:
- फिल्टर और नेविगेशन को शक्ति देने के लिए शरीर के भागों की एक मानक सूची।
- एक ही गति या लक्षित मांसपेशी के साथ व्यायाम विकल्प।
- प्रोग्राम निर्माण जो एक तैयार-से-चलाने वाला सत्र (सेट, रेप, आराम, लक्षित मांसपेशियां, और मीडिया लिंक) प्रदान करता है।
- एक मौजूदा प्रोग्राम के लिए आज के वर्कआउट की खोज।
इसे वर्कआउट बिल्डर्स, फिटनेस ऑनबोर्डिंग फ्लोज़, कोचिंग डैशबोर्ड, और व्यायाम खोज UI के लिए सामान्यतः उपयोग किया जाता है।
Zyla API Hub पर शुरुआत करना
Zyla API Hub एक खाते, एक API कुंजी, और एक सदस्यता + कोटा मॉडल (पे-पर-कॉल नहीं) के साथ 10,000 से अधिक सार्वजनिक APIs को केंद्रीकृत करता है। एक्सरसाइज डेटाबेस API के लिए, आप मूल्यांकन के लिए 7-दिन का परीक्षण या सीमित अनुरोध कोटा शुरू कर सकते हैं। कोई मुफ्त योजना नहीं है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
शुरू करने के लिए:
- एक्सरसाइज डेटाबेस API पृष्ठ खोलें और सदस्यता लें: एक्सरसाइज डेटाबेस API पर 7-दिन का परीक्षण शुरू करें.
- अपनी API कुंजी कॉपी करें।
- Authorization: Bearer YOUR_API_KEY का उपयोग करके एंडपॉइंट्स कॉल करें।
एंडपॉइंट: शरीर के भागों की सूची
ड्रॉपडाउन, टैब, या नेविगेशन को भरने के लिए शरीर के भागों का मानक सेट प्राप्त करें। कोई पैरामीटर आवश्यक नहीं है।
HTTP विधि: GET
अनुरोध URL: https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts
curl उदाहरण
curl -s -X GET "https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts" \
-H "Authorization: Bearer YOUR_API_KEY"वास्तविक प्रतिक्रिया
[
"waist",
"upper legs",
"back",
"lower legs",
"chest",
"upper arms",
"cardio",
"shoulders",
"lower arms",
"neck"
]आप आमतौर पर इन स्ट्रिंग्स को अपने ऐप में स्थानीयकृत लेबल के लिए मैप करेंगे और इन्हें व्यायाम खोज के लिए फ़िल्टरिंग या विवरण दृश्य के लिए कुंजी के रूप में उपयोग करेंगे।
Python उदाहरण
यह स्निपेट सूची को प्राप्त करता है और इसे UI प्रदर्शन के लिए तैयार करता है। चलाने से पहले YOUR_API_KEY को बदलें।
import requests
API_KEY = "YOUR_API_KEY"
URL = "https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts"
resp = requests.get(URL, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=20)
resp.raise_for_status()
body_parts = resp.json() # list[str]
# उदाहरण: प्रदर्शित करने के लिए सामान्यीकृत और क्रमबद्ध करें
ui_items = [{"key": bp, "label": bp.title()} for bp in body_parts]
ui_items.sort(key=lambda x: x["label"])
print("उपलब्ध शरीर के भाग:")
for item in ui_items:
print(f"- {item['label']}")एंडपॉइंट: व्यायाम विकल्प
एक ही गति से मेल खाने वाले 10 व्यायाम तक लौटाएं; यदि कोई नहीं है, तो वे समान लक्षित मांसपेशी साझा करते हैं। वर्कआउट बिल्डर में स्वैप सुझावों के लिए उपयोगी।
HTTP विधि: GET
अनुरोध URL: https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives
पैरामीटर:
- id (संख्या, आवश्यक): 1
- उपकरण (स्ट्रिंग, वैकल्पिक): बारबेल
curl उदाहरण
उदाहरण प्रतिक्रिया
[{"bodyPart":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_2.gif","id":2,"name":"45\u00b0 side bend","target":"abs","videos":[{"title":"45 degree side bends","link":"https://youtu.be/pUXu_7H0y_o"},{"title":"Side Bend on 45-degree Hyper Extension - Bodyweight or Weighted","link":"https://youtu.be/IyCX-a9Lm_U"},{"title":"Dumbbell Side Bend - Core / Abs - Bodybuilding.com","link":"https://youtu.be/UUQHeBRE_Wo"}]},{"bodyPart":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_3.gif","id":3,"name":"air bike","target":"abs","videos":[{"title":"Air Bike - Ab Exercises - Bodybuilding.com","link":"https://youtu.be/i6mPCVUrtNk"},{"title":"Air Bike Crunches","link":"https://youtu.be/3K9hMlalr60"},{"title":"Air cycling","link":"https://youtu.be/oyXoWU8j310"}]},{"bodyPart":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_5.gif","id":5,"name":"alternate heel touchers","target":"abs","videos":[{"title":"Alternating Heel Touch | Bodyweight Home Workout Exercise","link":"https://youtu.be/5JyOU0smtMo"},{"title":"How To Do…आप जिन प्रमुख क्षेत्रों का उपयोग करेंगे:
- id, name: आपके DB या UI के लिए प्राथमिक पहचानकर्ता।
- bodyPart, target: वर्गीकरण और मांसपेशी टैगिंग को चलाना।
- उपकरण: उपलब्ध गियर के आधार पर प्रतिस्थापन के लिए गेट।
- gifUrl, videos: दृश्य मार्गदर्शन के साथ UX को बढ़ाना।
एंडपॉइंट: प्रोग्राम बनाना
एक प्रोग्राम शुरू करें और आज का सत्र तुरंत प्राप्त करें। एक पूर्वनिर्धारित दिनचर्या या लक्ष्य प्रदान करें। प्रतिक्रिया में सत्र मेटाडेटा और सेट/रेप के साथ व्यायाम शामिल हैं।
HTTP विधि: POST
अनुरोध URL: https://zylalabs.com/api/392/exercise-database-api/34185/create-program
पैरामीटर:
- request_body (स्ट्रिंग, आवश्यक): {"client_id":"member-1","routine":"muscle_gain_4"}
curl उदाहरण
उदाहरण प्रतिक्रिया
सदस्य के लिए program_id और program_key को स्थायी बनाएं। आज की योजना को बिना किसी अन्य अनुरोध के रेंडर करने के लिए एम्बेडेड सत्र का उपयोग करें।
एंडपॉइंट: आज का वर्कआउट
एक मौजूदा प्रोग्राम के लिए आज का सत्र प्राप्त करें। सेट, रेप रेंज, और आराम मार्गदर्शन के साथ व्यायाम लौटाता है। प्रारंभिक प्रोग्राम निर्माण के बाद वेब या मोबाइल पर प्रशिक्षण फिर से शुरू करने के लिए इसका उपयोग करें।
HTTP विधि: GET
अनुरोध URL: https://zylalabs.com/api/392/exercise-database-api/34186/today-s-workout
पैरामीटर:
- program (संख्या, आवश्यक): 1
- program_key (स्ट्रिंग, आवश्यक): aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
curl उदाहरण
उदाहरण प्रतिक्रिया
महत्वपूर्ण क्षेत्र:
- week, day_name: सत्र के लिए प्रदर्शन संदर्भ।
- exercises[].sets, reps_min, reps_max, rest_seconds: प्रशिक्षण मात्रा और गति के लिए मुख्य नुस्खा।
- exercises[].weight_kg प्रारंभ में null हो सकता है; उपयोगकर्ता लॉगिंग के बाद सेट करें।
वास्तविक दुनिया के पैटर्न जो तेजी से शिप होते हैं
- ऑनबोर्डिंग: चयन योग्य चिप्स को रेंडर करने के लिए शरीर के भागों की सूची कॉल करें। व्यायाम सुझावों को व्यक्तिगत बनाने के लिए उपयोगकर्ता के फोकस क्षेत्रों को स्थायी बनाएं।
- स्वैप UI: जब एक उपयोगकर्ता "स्वैप" पर टैप करता है, तो वर्तमान व्यायाम id के साथ व्यायाम विकल्पों को कॉल करें और वैकल्पिक रूप से उपलब्ध उपकरण को सुनिश्चित करने के लिए फ़िल्टर करें।
- तत्काल प्रोग्राम: ऑनबोर्डिंग के बाद प्रोग्राम बनाने के लिए POST करें, फिर तुरंत लौटाए गए सत्र को दिखाएं। उपयोगकर्ता प्रोफ़ाइल में program_id/program_key कैश करें।
- दैनिक वापसी: ऐप खोलने पर, प्रोग्राम और program_key के साथ आज के वर्कआउट को कॉल करें ताकि वे जहां से रुके थे वहां से जारी रह सकें।
- दृश्य सहायता: प्रत्येक व्यायाम के बगल में gifUrl या पहले वीडियो लिंक को प्रदर्शित करें ताकि भ्रम को कम किया जा सके और उचित रूप का समर्थन किया जा सके।
व्यावहारिक कार्यान्वयन नोट्स
- प्रमाणीकरण: हर अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
- कैशिंग: शरीर के भागों की सूची स्थिर है। विलंबता को कम करने और अतिरिक्त कॉल से बचने के लिए घंटों या दिनों के लिए कैश करें।
- Null वजन: कई ताकत क्षेत्रों की शुरुआत null होती है जब तक कि उपयोगकर्ता लोड लॉग नहीं करता; इसे सुचारू रूप से संभालें और मार्गदर्शन स्ट्रिंग्स जैसे "एक वजन चुनें जो रेप रेंज में आता है" दिखाएं।
- मीडिया: gifUrl और वीडियो त्वरित दृश्य संदर्भ प्रदान करते हैं; चिकनी UX के लिए Wi‑Fi पर GIFs को प्रीलोड करें।
- सदस्यता: बिलिंग सदस्यता + कोटा है। पहले API एक्सेस में आमतौर पर 7-दिन का परीक्षण या मूल्यांकन के लिए 50 अनुरोध शामिल होते हैं; लोड परीक्षण से पहले लिस्टिंग पृष्ठ पर विशिष्टताओं की पुष्टि करें।
MCP के माध्यम से AI एजेंट से कॉल करना
यदि आप एक AI कोडिंग एजेंट के साथ कार्यों का आयोजन कर रहे हैं, तो आप Zyla के MCP एंडपॉइंट के माध्यम से इस API को उजागर कर सकते हैं। MCP सर्वर https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर उपलब्ध है और क्लॉड कोड, कर्सर, और विंडसर्फ जैसे MCP-संगत क्लाइंट के साथ काम करता है। MCP पर दस्तावेज़ देखें। एक बार कनेक्ट होने के बाद, आपका एजेंट सुरक्षित रूप से MCP परत द्वारा प्रबंधित आपकी API कुंजी के साथ समान एक्सरसाइज डेटाबेस API एंडपॉइंट्स को कॉल कर सकता है।
त्रुटि हैंडलिंग और लचीलापन
- इनपुट मान्यता: व्यायाम विकल्पों के लिए, सुनिश्चित करें कि id एक मान्य संख्यात्मक पहचानकर्ता है और केवल तभी उपकरण पास करें जब आप वास्तव में इसे फ़िल्टर करने का इरादा रखते हों।
- टाइमआउट: अस्थायी नेटवर्क त्रुटियों के लिए क्लाइंट-साइड टाइमआउट (जैसे, 10–20s) और पुनः प्रयासों का उपयोग करें।
- सुचारू फॉलबैक: यदि आज का वर्कआउट उपलब्ध नहीं है (गायब प्रोग्राम/program_key), तो उपयोगकर्ताओं को प्रोग्राम बनाने के लिए रूट करें और फिर लौटाए गए सत्र के साथ आगे बढ़ें।
एंड-टू-एंड वायरिंग उदाहरण
प्रवाह
- एक बार शरीर के भागों को प्राप्त करें और टैब के रूप में रेंडर करें: कमर, ऊपरी पैर, पीठ, निचले पैर, छाती, ऊपरी भुजाएं, कार्डियो, कंधे, निचली भुजाएं, गर्दन।
- उपयोगकर्ता चयन पर, उन्हें एक प्रोग्राम बनाने दें (जैसे, muscle_gain_4)। program_id और program_key को स्टोर करें।
- आज का सत्र लोड करें और नुस्खे प्रदर्शित करें: सेट, रेप रेंज, और आराम।
- "स्वैप व्यायाम" की पेशकश करें। जब टैप किया जाए, तो व्यायाम विकल्प दिखाने के लिए व्यायाम विकल्पों को कॉल करें, यदि लागू हो तो उपलब्ध उपकरण द्वारा फ़िल्टर करें।
सुरक्षा, कुंजी, और वातावरण
- कभी भी क्लाइंट ऐप्स में YOUR_API_KEY को हार्डकोड न करें; अपने बैकएंड के माध्यम से प्रॉक्सी कॉल करें या मोबाइल बिल्ड में सुरक्षित वातावरण इंजेक्शन का उपयोग करें।
- पर्यावरण (dev/staging/prod) द्वारा स्कोप कॉन्फ़िगरेशन करें ताकि आपकी टीम यदि आवश्यक हो तो एक अलग सदस्यता कोटा के खिलाफ परीक्षण कर सके।
अक्सर पूछे जाने वाले प्रश्न
-
क्या मैं बिना किसी फ़िल्टर के शरीर के भागों की सूची प्राप्त कर सकता हूँ?
हाँ। अपने Authorization हेडर के साथ GET https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts कॉल करें। यह स्ट्रिंग्स का एक एरे लौटाता है।
-
मैं किसी दिए गए व्यायाम के लिए विकल्प कैसे खोजूं?
GET https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives का उपयोग करें जिसमें आवश्यक id पैरामीटर और वैकल्पिक रूप से उपकरण परिणामों को परिष्कृत करने के लिए हो।
-
मैं एक उपयोगकर्ता के लिए वर्कआउट योजना कैसे उत्पन्न करूं?
POST करें https://zylalabs.com/api/392/exercise-database-api/34185/create-program पर जिसमें request_body स्ट्रिंग हो जिसमें कम से कम client_id और दिनचर्या हो। लौटाए गए program_id और program_key को स्थायी बनाएं।
-
मैं मौजूदा प्रोग्राम के लिए वर्तमान दिन का वर्कआउट कैसे लोड करूं?
program और program_key के साथ GET https://zylalabs.com/api/392/exercise-database-api/34186/today-s-workout कॉल करें। आपको व्यायाम, सेट, रेप रेंज, आराम, और मीडिया प्राप्त होगा।
-
मूल्य निर्धारण और परीक्षण शर्तें क्या हैं?
एक्सरसाइज डेटाबेस API एक सदस्यता + कोटा मॉडल का उपयोग करता है। पहले API में आमतौर पर 7-दिन का परीक्षण या मूल्यांकन के लिए 50 अनुरोध शामिल होते हैं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
क्या आप इस सप्ताह अपने UI को शरीर के भागों की एक विश्वसनीय सूची से वायर करने और व्यायाम समृद्ध सुविधाओं को शिप करने के लिए तैयार हैं? अभी सदस्यता लें और मार्केटप्लेस लिस्टिंग पर अपनी कुंजी प्राप्त करें: एक्सरसाइज डेटाबेस API पर 7-दिन का परीक्षण शुरू करें.
