डीप लिंक ऑटोमेशन
अपने iPhone या iPad पर URL खोलकर REST API ऑटोमेशन बनाएँ।
अंतिम अपडेट: 31 अक्टूबर 2026
इस पृष्ठ पर
अपने iPhone या iPad पर URL खोलकर REST API ऑटोमेशन बनाएँ। डीप लिंक अन्य गंतव्य कॉन्फ़िगर नहीं करते।
URL प्रारूप
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export
url आवश्यक है। वर्णनात्मक name दें; यदि छोड़ा जाए तो डिफ़ॉल्ट Automation है। पैरामीटर नाम केस-असंवेदी हैं। रिक्त स्थान या आरक्षित वर्ण वाले पैरामीटर मान URL-एन्कोड करें।
डिवाइस पर URL खोलें, या शॉर्टकट में URL खोलें उपयोग करें। सक्षम करने से पहले Health Auto Export में बनाए गए ऑटोमेशन की समीक्षा करें।
पैरामीटर संदर्भ
बूलियन true/false, 1/0, या yes/no स्वीकार करते हैं। डेटा-विशिष्ट विकल्पों से पहले datatype सेट करें, और format को aggregatedata से पहले सेट करें, ताकि बाद के चयन पहले की सेटिंग्स न बदलें।
मूल सेटिंग्स
| पैरामीटर | मान या अर्थ | डिफ़ॉल्ट |
|---|---|---|
url |
आपके डिवाइस से पहुँच योग्य एंडपॉइंट URL | आवश्यक |
name |
खाली न होने वाला ऑटोमेशन नाम | Automation |
enabled |
स्वचालित रन सक्षम करें | false |
datatype |
नीचे सूचीबद्ध डेटा प्रकार | healthMetrics |
format |
json, csv, markdown, या md |
json |
exportversion |
v1, v2, 1, या 2 |
v2 |
period |
none, lastsync, today, yesterday, previous7days |
none |
requesttimeout |
पूर्णांक सेकंड, 60–86400 | 60 |
headers |
अल्पविराम-पृथक कुंजी/मान युग्म | कोई नहीं |
batchrequests |
बूलियन; केवल JSON | false |
वैध डेटा प्रकार healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking, और medications हैं। मन की स्थिति के लिए iOS 18 या बाद का आवश्यक है; दवा निर्यात के लिए iOS 26 या बाद का आवश्यक है।
तिथि-सीमा अर्थ के लिए तिथि सीमा देखें। सभी डीप लिंक REST API ऑटोमेशन बनाते हैं; कोई exportDestination पैरामीटर नहीं है।
स्वास्थ्य मेट्रिक
| पैरामीटर | मान या अर्थ | डिफ़ॉल्ट |
|---|---|---|
metrics |
अल्पविराम-पृथक सटीक मेट्रिक नाम, जैसे Step Count,Heart Rate |
सभी उपलब्ध मेट्रिक |
aggregatedata |
बूलियन; जहाँ समर्थित हो व्यक्तिगत रीडिंग के लिए false उपयोग करें |
true |
interval |
none, minutes, hours, days, weeks, months, years |
none |
aggregatesleep |
नींद सारांशीकरण नियंत्रित करने वाला बूलियन | true |
metrics, aggregatedata, और interval स्वास्थ्य मेट्रिक पर लागू होते हैं। CSV चयन सारांशीकरण चालू करता है; व्यक्तिगत रीडिंग के लिए JSON उपयोग करें। लिंक जेनरेट करते समय वांछित सारांशीकरण स्पष्ट रूप से निर्दिष्ट करें।
वर्कआउट
| पैरामीटर | मान या अर्थ | datatype=workouts होने पर डिफ़ॉल्ट |
|---|---|---|
includeroutes |
बूलियन | true |
includeworkoutmetadata |
बूलियन | true |
workoutsmetadatainterval |
minutes या seconds; संस्करण 2 |
minutes |
workouttypes |
अल्पविराम-पृथक अचिह्नित Apple वर्कआउट-प्रकार पहचानकर्ता | सभी प्रकार |
वर्कआउट लिंक में स्वास्थ्य-मेट्रिक एकत्रीकरण विकल्प शामिल न करें।
लय और सूचनाएँ
| पैरामीटर | मान या अर्थ | डिफ़ॉल्ट |
|---|---|---|
syncinterval |
minutes, hours, days, weeks |
minutes |
syncquantity |
अंतरालों की धनात्मक पूर्णांक संख्या | 5 |
notifyonupdate |
बूलियन; डेटा तैयारी के बाद सूचित करें | true |
notifywhenrun |
बूलियन; सफल गंतव्य कार्रवाई के बाद सूचित करें | true |
लय पृष्ठभूमि और स्वास्थ्य-डेटा सीमाओं के अधीन रहती है; यह सटीक शेड्यूल नहीं है।
प्रमाणीकरण और एन्कोडिंग
headers मान बारी-बारी कुंजियों और मानों से बना होता है:
headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY
प्रत्येक कुंजी के लिए मान आवश्यक है। अल्पविराम युग्मों को अलग करते हैं, इसलिए इस लिंक प्रारूप में अल्पविराम वाले हेडर मान से बचें। रिक्त स्थान %20, प्लस चिह्न %2B, और ऐम्परसैंड %26 के रूप में एन्कोड करें। जब एंडपॉइंट URL के अपने क्वेरी पैरामीटर हों तो पूरा एंडपॉइंट URL एन्कोड करें।
उदाहरण
चयनित मेट्रिक, प्रति घंटा सारांशित
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fmetrics&name=Steps%20and%20Heart%20Rate&datatype=healthMetrics&format=json&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours
मार्गों वाले वर्कआउट
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fworkouts&name=Workout%20Export&datatype=workouts&format=json&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes
दोनों उदाहरण स्वचालित रन अक्षम छोड़ते हैं जब तक आप ऑटोमेशन की समीक्षा करके सक्षम न करें।
समस्या निवारण
- URL या पैरामीटर त्रुटि: न्यूनतम URL से शुरू करें, वर्तनी और एन्कोडिंग जाँचें, फिर विकल्प व्यक्तिगत रूप से जोड़ें।
- अमान्य मेट्रिक: सटीक मेट्रिक नाम उपयोग करें, रिक्त स्थान और पूंजीकरण सहित।
- एकत्रीकरण त्रुटि: स्वास्थ्य-मेट्रिक विकल्प केवल
datatype=healthMetricsके साथ उपयोग करें। - वर्कआउट सेटिंग्स त्रुटि: वर्कआउट विकल्प
datatype=workoutsके साथ उपयोग करें; सेकंड समूहन के लिए संस्करण 2 आवश्यक है। - बैचिंग त्रुटि:
format=jsonसेट करें याbatchrequestsअक्षम करें। - अमान्य लय/टाइमआउट: समर्थित अंतराल, धनात्मक मात्रा, और 60 से 86400 सेकंड का टाइमआउट उपयोग करें।
- URL बहुत लंबा: मेट्रिक/हेडर सूची घटाएँ या शेष सेटिंग्स ऐप में कॉन्फ़िगर करें।
बनाने के बाद, चयनित सीमा अपलोड करने या सेटअप जाँचने के लिए REST API — ऐतिहासिक या छूटा डेटा निर्यात करें उपयोग करें।