आपके स्पोर्ट्स ऐप में एक व्यायाम ID है और आपको अभी ठोस प्रशिक्षण डेटा खींचने की आवश्यकता है: वैकल्पिक आंदोलनों, आज के सेट और एक कार्यक्रम के लिए प्रतिनिधि, या आपके UI को चलाने के लिए एक त्वरित शरीर-भाग सूची। इस गाइड के अंत तक, आप ID द्वारा व्यायाम विकल्पों को खींचने, एक अनुकूलित कार्यक्रम शुरू करने और Zyla API Hub पर व्यायाम डेटाबेस API का उपयोग करके आज का वर्कआउट प्राप्त करने में सक्षम होंगे।
यह API आपको क्या देती है (और यह स्पोर्ट्स ऐप में कहाँ फिट होती है)
व्यायाम डेटाबेस API प्रदान करती है:
- ID द्वारा व्यायाम विकल्प, जब आवश्यक हो तो उपकरण के लिए फ़िल्टर किया गया (जब कुछ गियर उपलब्ध नहीं होता है तो प्रतिस्थापन तर्क के लिए महान)।
- कार्यक्रम निर्माण जो आज के सत्र को लौटाता है: व्यायाम, सेट, प्रतिनिधि, विश्राम, और सुझाए गए वजन के क्षेत्र।
- एक मौजूदा कार्यक्रम के लिए आज का वर्कआउट खींचना।
- शरीर के भागों की एक सरल सूची जो फ़िल्टर या ऐप में नेविगेशन को स्कैफोल्ड करती है।
ये एंडपॉइंट्स प्रतिस्थापन कार्यप्रवाहों को जल्दी से बनाने, दैनिक प्रशिक्षण सत्रों को उत्पन्न या ताज़ा करने और तार्किक कैटलॉग समूहों (शरीर के भाग द्वारा) को प्रस्तुत करने में सक्षम बनाते हैं - स्पोर्ट्स प्रशिक्षण ऐप्स, कोचिंग डैशबोर्ड और उपकरण उपलब्धता से जुड़े फिटनेस ईकॉमर्स अनुभवों में मुख्य प्रवाह।
Zyla API Hub पर शुरू करना
API पृष्ठ खोलें, सब्सक्राइब पर क्लिक करें (या यदि उपलब्ध हो तो मुफ्त परीक्षण शुरू करें), और अपनी कुंजी प्राप्त करें। प्रमाणीकरण हेडर Authorization: Bearer YOUR_API_KEY के माध्यम से है। बिलिंग सब्सक्रिप्शन + कोटा है (पे-पर-कॉल नहीं)। इस API के लिए, आप लिस्टिंग पृष्ठ से 7-दिन के परीक्षण के साथ शुरू कर सकते हैं। अपनी कुंजी को सुरक्षित रखें; इसे स्रोत नियंत्रण में न डालें।
आप Zyla API Hub पर हजारों प्रोडक्शन-रेडी स्पोर्ट्स और स्वास्थ्य इंटीग्रेशन का अन्वेषण कर सकते हैं, सभी एक खाते, एक API कुंजी, और श्रेणियों में एक सुसंगत सब्सक्रिप्शन मॉडल के तहत। जब आप इस इंटीग्रेशन के लिए तैयार हों, तो नीचे दिए गए सीधे लिस्टिंग लिंक का उपयोग करके एक खाता बनाएं और अपनी API कुंजी प्राप्त करें।
व्यायाम डेटाबेस API पर 7-दिन का परीक्षण शुरू करें
आप जिन एंडपॉइंट्स का उपयोग करेंगे
1) व्यायाम विकल्प (GET)
उसी आंदोलन के साथ 10 व्यायाम तक जो प्रदान की गई व्यायाम ID के रूप में हैं। यदि उस व्यायाम में कोई आंदोलन नहीं है, तो API उसी लक्षित मांसपेशी पर वापस जाती है। आप वैकल्पिक रूप से परिणामों को एक उपकरण के लिए सीमित कर सकते हैं।
- विधि: GET
- URL: https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives
- आवश्यक क्वेरी पैरामीटर: id (संख्या)
- वैकल्पिक क्वेरी पैरामीटर: equipment (स्ट्रिंग)
कॉपी-पेस्ट करने योग्य कर्ल (Authorization हेडर आवश्यक):
curl -s -X GET "https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts" \
-H "Authorization: Bearer YOUR_API_KEY"आधिकारिक उदाहरण प्रतिक्रिया (शब्दशः):
[{"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: संबंधित व्यायाम की ID (इसे अपने ऐप में गहरे लिंक या विवरण प्राप्त करने के लिए उपयोग करें)।
- name, bodyPart, target: UI कार्ड या फ़िल्टरिंग चिप्स के लिए लेबल।
- equipment: जिम या घर में उपलब्ध गियर के लिए विकल्पों को गेट करें।
- gifUrl और videos: रूप और तकनीक को मार्गदर्शित करने के लिए मीडिया।
2) कार्यक्रम बनाएं (POST)
एक कार्यक्रम शुरू करें और तुरंत आज का सत्र प्राप्त करें। आप एक पूर्वनिर्धारित दिनचर्या सेट कर सकते हैं (जैसे, muscle_gain_4 या weight_loss_3)। अपने ग्राहक की पहचान को client_id में प्रदान करें ताकि सत्रों को आपके उपयोगकर्ता ऑब्जेक्ट से मैप किया जा सके।
- विधि: POST
- URL: https://zylalabs.com/api/392/exercise-database-api/34185/create-program
- आवश्यक बॉडी फ़ील्ड: request_body (स्ट्रिंगिफाइड JSON)
कॉपी-पेस्ट करने योग्य कर्ल (ध्यान दें कि JSON को request_body के अंदर एक स्ट्रिंग के रूप में पास किया गया है):
आधिकारिक उदाहरण प्रतिक्रिया (शब्दशः):
[
"waist",
"upper legs",
"back",
"lower legs",
"chest",
"upper arms",
"cardio",
"shoulders",
"lower arms",
"neck"
]क्या उपयोग करें:
- program_id और program_key: भविष्य के सत्रों को प्राप्त करने के लिए इन्हें बनाए रखें।
- session.exercises[] फ़ील्ड: आज की योजना को प्रदर्शित करें, जिसमें सेट, reps_min/reps_max, rest_seconds, और weight_kg (किलोग्राम; प्रारंभ में null हो सकता है) शामिल हैं।
- progression और why: कोचिंग प्रॉम्प्ट दिखाएं (जैसे, क्या समायोजित करना है या अगला लॉग करना है)।
3) आज का वर्कआउट (GET)
एक संग्रहीत कार्यक्रम के लिए आज का सत्र प्राप्त करें। Create Program से प्राप्त program_id और program_key का उपयोग करें।
- विधि: GET
- URL: https://zylalabs.com/api/392/exercise-database-api/34186/today-s-workout
- आवश्यक क्वेरी पैरामीटर: program (संख्या), program_key (स्ट्रिंग)
कॉपी-पेस्ट करने योग्य कर्ल:
आधिकारिक उदाहरण प्रतिक्रिया (शब्दशः):
क्या उपयोग करें:
- week, deload, comeback: प्रशिक्षण संदर्भ प्रदर्शित करें (जैसे, कम मात्रा वाले सप्ताह)।
- exercises[] के साथ सेट/reps/rest: आपके सत्र UI और ट्रैकिंग को चलाएं।
- weight_kg और estimated_1rm_kg: उपलब्ध होने पर लोड सिफारिशों या चार्ट का समर्थन करें।
4) शरीर के भागों की सूची (GET)
आपके स्पोर्ट्स प्रशिक्षण UI में फ़िल्टर और नेविगेशन को सीड करने के लिए एक छोटा उपयोगिता एंडपॉइंट।
- विधि: GET
- URL: https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts
आधिकारिक नमूना (शब्दशः):
उपयोग मामला: एक फ़ैसेट मेनू या ड्रॉपडाउन को प्रदर्शित करें जो यह दर्शाता है कि API व्यायामों को कैसे वर्गीकृत करता है, ताकि उपयोगकर्ता प्रासंगिक स्पोर्ट्स प्रशिक्षण सामग्री के लिए जल्दी से फ़िल्टर कर सकें।
“ID द्वारा व्यायाम” विकल्पों के लिए एक कार्यशील कोड नमूना (Python)
यह स्क्रिप्ट एक व्यायाम ID और वैकल्पिक उपकरण फ़िल्टर का उपयोग करके व्यायाम विकल्पों को कॉल करती है, फिर एक संक्षिप्त सूची प्रिंट करती है जिसे आपका UI उपभोग कर सकता है। यह ऊपर दिखाए गए सटीक एंडपॉइंट और फ़ील्ड का उपयोग करता है।
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
BASE_URL = "https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives"
def get_alternatives(exercise_id, equipment=None):
params = {"id": exercise_id}
if equipment:
params["equipment"] = equipment
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.get(BASE_URL, headers=headers, params=params, timeout=20)
r.raise_for_status()
return r.json()
if __name__ == "__main__":
# उदाहरण: व्यायाम id=1 के लिए विकल्प, बारबेल के लिए फ़िल्टर किया गया
data = get_alternatives(1, equipment="barbell")
# प्रत्येक व्यायाम के लिए न्यूनतम कार्ड सारांश प्रदर्शित करें
for ex in data:
print(f"[{ex.get('id')}] {ex.get('name')} - {ex.get('target')} ({ex.get('equipment')})")
vids = ex.get("videos", [])[:2]
for v in vids:
print(f" - {v.get('title')}: {v.get('link')}")
print()नोट्स:
- प्रमाणीकरण केवल हेडर के माध्यम से है: Authorization: Bearer YOUR_API_KEY।
- इस एंडपॉइंट के लिए कोई पेजिंग निर्दिष्ट नहीं की गई है; यह 10 आइटम तक लौटाता है।
- gifUrl और videos वैकल्पिक मीडिया फ़ील्ड हैं जो आपके कोचिंग UI में प्रदर्शित करने के लिए उपयुक्त हैं।
समय बचाने वाले व्यावहारिक इंटीग्रेशन विवरण
- प्रमाणीकरण: सभी कॉल्स के लिए Authorization: Bearer YOUR_API_KEY की आवश्यकता होती है। यदि संभव हो तो इसे क्लाइंट-साइड कोड से बाहर रखें।
- इकाइयाँ: weight_kg फ़ील्ड किलोग्राम में हैं; rest_seconds सेकंड में हैं; reps पूर्णांक हैं जिनमें min/max फ़ील्ड हैं।
- कैशिंग: स्थिर सूचियाँ (जैसे शरीर के भाग) दैनिक कैशिंग के लिए अच्छे उम्मीदवार हैं। विकल्पों का निर्भरता बीज व्यायाम और उपकरण पर होती है; यदि आपका ऐप इसे एक वर्कआउट सत्र के दौरान बार-बार लोड करता है तो (id, equipment) जोड़ी के लिए एक छोटे TTL के लिए कैश करें।
- मीडिया: gifUrl और videos[].link क्लाइंट डिस्प्ले के लिए उपयुक्त हैं। नए कार्यक्रम में जल्दी से weight_kg और estimated_1rm_kg null होने की संभावना को संभालें।
- कार्यक्रम: दोनों program_id और program_key को बनाए रखें। आपको आज के वर्कआउट को विश्वसनीय रूप से प्राप्त करने के लिए दोनों की आवश्यकता होगी।
- कोटा: हब सब्सक्रिप्शन + कोटा (पे-पर-कॉल नहीं) पर चलता है। पहले API के लिए, आप 7-दिन के परीक्षण या 50 अनुरोधों का उपयोग कर सकते हैं। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए लिस्टिंग की जांच करें।
वास्तविक दुनिया के स्पोर्ट्स ऐप उपयोग के मामले
- फ्लाई पर प्रतिस्थापन: यदि एक रैक लिया गया है, तो मूल व्यायाम की ID और उपलब्ध उपकरण के साथ व्यायाम विकल्पों को कॉल करें ताकि समान आंदोलन या लक्षित मांसपेशी के साथ 3-5 व्यवहार्य स्वैप दिखा सकें।
- कार्यक्रमित सत्र: Create Program के साथ एक नए एथलीट की योजना शुरू करें और लौटाए गए सत्र को तुरंत प्रदर्शित करें, जिसमें सेट, प्रतिनिधि और विश्राम शामिल हैं।
- दैनिक योजना स्क्रीन: प्रत्येक दिन, आज का वर्कआउट प्राप्त करें ताकि अगले सत्र को प्रदर्शित किया जा सके, संदर्भ के लिए deload या comeback फ्लैग का सम्मान करते हुए।
- कैटलॉग फ़िल्टर: शरीर के भागों की सूची का उपयोग करें ताकि ब्राउज़िंग फ़िल्टर लागू किए जा सकें जो API की वर्गीकरण के साथ मेल खाते हैं, खोज को अंतर्निहित डेटा के साथ समन्वयित रखते हुए।
AI एजेंट (MCP) से व्यायाम डेटाबेस API को कॉल करना
आप किसी भी MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) से इन एंडपॉइंट्स को चला सकते हैं, क्लाइंट को MCP एंडपॉइंट की ओर इंगित करके और अपनी कुंजी प्रदान करके।
- MCP एंडपॉइंट: MCP
- कुंजी: apikey=YOUR_API_KEY
अपने एजेंट से, आप इसे व्यायाम विकल्पों के URL पर GET करने के लिए निर्देशित कर सकते हैं जिसमें id=1 और equipment=barbell है, या Create Program पर POST करने के लिए stringified request_body पेलोड के साथ। यह कोचिंग कार्यप्रवाहों को अर्ध-स्वचालित करने के लिए उपयोगी है, जैसे "आज का पुश दिन बनाएं और किसी भी बारबेल-केवल लिफ्ट को डंबेल विकल्पों के साथ बदलें।"
कार्यप्रवाह उदाहरण: प्रतिस्थापन-जानकारी सत्र बनाना
- Create Program के माध्यम से एक कार्यक्रम बनाएं और program_id और program_key को अपने उपयोगकर्ता तालिका में संग्रहीत करें।
- हर दिन Today’s Workout को कॉल करें ताकि सेट/reps/rest के साथ व्यायामों की सूची बनाई जा सके।
- जब उपयोगकर्ता "वैकल्पिक खोजें" पर टैप करता है, तो स्रोत व्यायाम की ID और उपयोगकर्ता के वर्तमान उपकरण (जैसे, "बारबेल" या "शरीर का वजन") के साथ व्यायाम विकल्पों को कॉल करें।
- सत्र UI में कार्ड को स्वैप करें, निर्धारित सेट/reps/rest को बनाए रखते हुए, और एथलीट को मार्गदर्शित करने के लिए gifUrl या videos को प्रदर्शित करें।
एक और त्वरित संदर्भ: शरीर के भागों की वर्गीकरण
आपको स्पोर्ट्स प्रशिक्षण फ़िल्टर के लिए एक सरल, स्थिर वर्गीकरण की आवश्यकता हो सकती है। अपने UI को चलाने के लिए आधिकारिक "शरीर के भागों की सूची" एंडपॉइंट का उपयोग करें, जैसा कि ऊपर दिखाया गया है। आपके फ़िल्टर विकल्पों को API की सूची के समान रखना खोज इनपुट और व्यायाम मेटाडेटा के बीच असंगतियों से बचने में मदद करता है।
आधिकारिक उदाहरण: शरीर के भागों के लिए कर्ल और JSON
पूर्णता के लिए, यहाँ सेटअप के दौरान तेजी से कॉपी करने के लिए एक ही स्थान पर आधिकारिक नमूना फिर से है:
अक्सर पूछे जाने वाले प्रश्न
मैं प्रमाणीकरण कैसे करूं?
प्रत्येक अनुरोध पर Authorization: Bearer YOUR_API_KEY भेजें।
क्या मैं एक विशिष्ट ID के समान व्यायाम प्राप्त कर सकता हूँ?
हाँ। id क्वेरी पैरामीटर के साथ व्यायाम विकल्पों का उपयोग करें, और वैकल्पिक रूप से परिणामों को सीमित करने के लिए उपकरण का उपयोग करें।
मैं एक उपयोगकर्ता के लिए आज का वर्कआउट कैसे प्राप्त करूं?
Create Program के साथ एक कार्यक्रम बनाएं ताकि program_id और program_key प्राप्त किया जा सके। फिर वर्तमान सत्र प्राप्त करने के लिए दोनों पैरामीटर के साथ Today’s Workout को कॉल करें।
वजन और विश्राम के लिए कौन सी इकाइयाँ उपयोग की जाती हैं?
वजन किलोग्राम (weight_kg) में होते हैं। विश्राम सेकंड (rest_seconds) में होता है।
क्या कोई मुफ्त योजना है?
यह API सब्सक्रिप्शन + कोटा पर चलती है जिसमें लिस्टिंग से 7-दिन का परीक्षण उपलब्ध है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
क्या आप अपने स्पोर्ट्स ऐप में "ID द्वारा व्यायाम" प्रवाह को वायर करने के लिए तैयार हैं? अपना खाता बनाएं और लिस्टिंग पृष्ठ पर 7-दिन का परीक्षण शुरू करें: व्यायाम डेटाबेस API। आप कुछ ही मिनटों में प्रतिस्थापनों, कार्यक्रमों और दैनिक सत्रों के साथ चालू हो जाएंगे।
