डीप लिंक ऑटोमेशन

डीप लिंक ऑटोमेशन आपको URL स्कीम का उपयोग करके REST API ऑटोमेशन प्रोग्रामेटिक रूप से बनाने देते हैं। यह ऑटोमेशन स्क्रिप्ट, कॉन्फ़िगरेशन प्रबंधन, या बाहरी सिस्टम के लिए उपयुक्त है जिन्हें स्वास्थ्य डेटा निर्यात कॉन्फ़िगर करना हो।

अवलोकन

डीप लिंक ऑटोमेशन कस्टम URL स्कीम का उपयोग करके ऐप में मैन्युअली सेटिंग दर्ज किए बिना REST API ऑटोमेशन बनाते और कॉन्फ़िगर करते हैं। जब आप डीप लिंक URL खोलते हैं, ऐप स्वचालित रूप से निर्दिष्ट कॉन्फ़िगरेशन के साथ नया ऑटोमेशन बनाता है।

उपयोग के मामले:

• स्क्रिप्ट या टूल से प्रोग्रामेटिक ऑटोमेशन सेटअप
• बल्क ऑटोमेशन कॉन्फ़िगरेशन
• कॉन्फ़िगरेशन प्रबंधन सिस्टम के साथ एकीकरण
• बाहरी ऐप्लिकेशन या वेबसाइट से त्वरित सेटअप
• परीक्षण और विकास वर्कफ़्लो

मुख्य विशेषताएँ:

• URL स्कीम के माध्यम से ऑटोमेशन बनाना
• सभी REST API ऑटोमेशन सेटिंग्स कॉन्फ़िगर करना
• प्रकार-सुरक्षित पैरामीटर सत्यापन
• व्यापक त्रुटि संदेश

सीमाएँ

• डीप लिंक केवल REST API ऑटोमेशन समर्थित करते हैं (Dropbox, Google Drive आदि नहीं)
• URL लंबाई सीमाएँ बहुत लंबी पैरामीटर सूचियों को प्रतिबंधित कर सकती हैं
• REST API ऑटोमेशन की सभी सीमाएँ लागू होती हैं (पृष्ठभूमि प्रसंस्करण, स्वास्थ्य डेटा पहुँच आदि)

URL प्रारूप

डीप लिंक URL इस संरचना का पालन करता है:

com.HealthExport://automation?parameter1=value1&parameter2=value2&...

आधार URL: com.HealthExport://automation

पैरामीटर: name और url को छोड़कर सभी वैकल्पिक हैं। पैरामीटर केस-असंवेदनशील हैं।

पैरामीटर संदर्भ

आवश्यक पैरामीटर

url (आवश्यक)

• प्रकार: स्ट्रिंग (वैध URL)
• विवरण: वह एंडपॉइंट URL जहाँ स्वास्थ्य डेटा भेजा जाएगा
• उदाहरण: https://api.example.com/health-data
• नोट: वैध HTTP/HTTPS URL होना चाहिए

name (आवश्यक)

• प्रकार: स्ट्रिंग
• विवरण: ऑटोमेशन के लिए वर्णनात्मक नाम
• उदाहरण: My%20Backend%20API (URL-एन्कोडेड: My Backend API)
• नोट: रिक्त स्थान या विशेष वर्ण हों तो URL-एन्कोडेड होना चाहिए

मूल कॉन्फ़िगरेशन

format

• प्रकार: Enum (json, csv)
• डिफ़ॉल्ट: json
• विवरण: डेटा के लिए निर्यात प्रारूप
• उदाहरण: format=json या format=csv
• नोट: CSV प्रारूप स्वचालित रूप से डेटा समेकन सक्षम करता है

enabled

• प्रकार: बूलियन (true, false, 1, 0, yes, no)
• डिफ़ॉल्ट: false
• विवरण: निर्माण के तुरंत बाद ऑटोमेशन सक्षम है या नहीं
• उदाहरण: enabled=true

datatype

• प्रकार: Enum (नीचे डेटा प्रकार देखें)
• डिफ़ॉल्ट: healthMetrics
• विवरण: निर्यात करने के लिए स्वास्थ्य डेटा का प्रकार
• उदाहरण: datatype=workouts
• नोट: केवल एक डेटा प्रकार चुना जा सकता है। इसे सेट करने पर उपयुक्त include फ़्लैग स्वचालित कॉन्फ़िगर होते हैं।

वैध डेटा प्रकार:

• healthMetrics — स्वास्थ्य मेट्रिक (कदम, हृदय गति, नींद आदि)
• workouts — व्यायाम और फिटनेस गतिविधियाँ
• symptoms — लक्षण और स्थितियाँ
• ecg — इलेक्ट्रोकार्डियोग्राम रीडिंग
• heartRateNotification — उच्च/निम्न हृदय गति घटनाएँ
• stateOfMind — मूड और मानसिक स्थिति (iOS 18.0+)
• cycleTracking — चक्र और प्रजनन स्वास्थ्य डेटा
• medications — दवा लॉग और अनुपालन (iOS 26.0+)

निर्यात सेटिंग्स

period

• प्रकार: Enum
• डिफ़ॉल्ट: none
• विवरण: डेटा निर्यात के लिए तिथि सीमा
• उदाहरण: period=today

वैध मान:

• none — डिफ़ॉल्ट (पिछला पूरा दिन व वर्तमान दिन)
• lastsync — अंतिम सिंक के बाद से
• today — वर्तमान दिन
• yesterday — पिछला दिन
• previous7days — पिछले 7 दिन
• realtime — वास्तविक समय अपडेट (सेकंड सिंक अंतराल आवश्यक)

interval

• प्रकार: Enum
• डिफ़ॉल्ट: none
• विवरण: समय समूहीकरण/समेकन अंतराल (केवल healthMetrics डेटा प्रकार के लिए वैध)
• उदाहरण: interval=hours

वैध मान:

• none — डिफ़ॉल्ट (कोई समेकन नहीं)
• minutes — मिनट के अनुसार समूह
• hours — घंटे के अनुसार समूह
• days — दिन के अनुसार समूह
• weeks — सप्ताह के अनुसार समूह
• months — माह के अनुसार समूह
• years — वर्ष के अनुसार समूह

नोट: यह पैरामीटर केवल तभी वैध जब datatype=healthMetrics। CSV प्रारूप हमेशा डेटा समेकित करता है।

aggregatedata

• प्रकार: बूलियन
• डिफ़ॉल्ट: true (CSV के लिए), false (JSON के लिए)
• विवरण: डेटा समेकित/सारांशित करना या नहीं (केवल JSON में healthMetrics के लिए वैध)
• उदाहरण: aggregatedata=true
• नोट: format=csv पर स्वचालित true

aggregatesleep

• प्रकार: बूलियन
• डिफ़ॉल्ट: true
• विवरण: नींद डेटा समेकित करना या नहीं
• उदाहरण: aggregatesleep=true

exportversion

• प्रकार: Enum (v1, v2, 1, 2)
• डिफ़ॉल्ट: v2
• विवरण: निर्यात प्रारूप संस्करण
• उदाहरण: exportversion=v2
• नोट: संस्करण 2 में बेहतर वर्कआउट डेटा और विस्तृत मेटाडेटा

batchrequests

• प्रकार: बूलियन
• डिफ़ॉल्ट: false
• विवरण: कई अनुरोधों में बैच में डेटा भेजें (केवल JSON में REST API के लिए वैध)
• उदाहरण: batchrequests=true
• नोट: केवल जब format=json और exportDestination=restApi

सिंक लय

syncinterval

• प्रकार: Enum
• डिफ़ॉल्ट: minutes
• विवरण: सिंक लय अंतराल
• उदाहरण: syncinterval=hours

वैध मान:

• minutes — हर N मिनट
• hours — हर N घंटे
• days — हर N दिन
• weeks — हर N सप्ताह
• seconds — केवल जब period=realtime

नोट: REST API ऑटोमेशन के लिए, वास्तविक समय निर्यात के अलावा केवल minutes, hours, days, weeks वैध।

syncquantity

• प्रकार: पूर्णांक (धनात्मक)
• डिफ़ॉल्ट: 5
• विवरण: सिंक के बीच अंतरालों की संख्या
• उदाहरण: syncquantity=10 (यदि syncinterval=minutes तो हर 10 मिनट)
• नोट: 0 से बड़ा होना चाहिए

HTTP कॉन्फ़िगरेशन

headers

• प्रकार: स्ट्रिंग (अल्पविराम से अलग कुंजी-मान जोड़े)
• डिफ़ॉल्ट: कोई नहीं
• विवरण: प्रमाणीकरण या मेटाडेटा के लिए HTTP हेडर
• उदाहरण: headers=Authorization,Bearer%20token123,X-API-Key,abc123
• प्रारूप: key1,value1,key2,value2,...
• नोट: मान URL-एन्कोडेड होने चाहिए। प्रत्येक हेडर के लिए कुंजी और मान दोनों।

हेडर उदाहरण:

• Authorization, Bearer your-token
• X-API-Key, your-api-key
• Content-Type, application/json

requesttimeout

• प्रकार: पूर्णांक (60-86400)
• डिफ़ॉल्ट: 60
• विवरण: अनुरोध टाइमआउट सेकंड में
• उदाहरण: requesttimeout=300
• नोट: 60 से 86400 सेकंड (1 मिनट से 24 घंटे)

डेटा प्रकार विशिष्ट सेटिंग्स

Health Metrics सेटिंग्स

metrics

• प्रकार: स्ट्रिंग (अल्पविराम से अलग MetricName rawValues)
• डिफ़ॉल्ट: सभी उपलब्ध मेट्रिक
• विवरण: शामिल करने के लिए विशिष्ट स्वास्थ्य मेट्रिक (केवल healthMetrics)
• उदाहरण: metrics=Step%20Count,Heart%20Rate,Active%20Energy
• नोट: सटीक MetricName rawValues उपयोग करें। निर्दिष्ट न हो तो सभी शामिल।

सामान्य मेट्रिक नाम:

• Step Count
• Heart Rate
• Active Energy
• Apple Exercise Time
• Sleep Analysis
• Walking + Running Distance

पूरी सूची के लिए ऐप की मेट्रिक चयन स्क्रीन देखें।

Workout सेटिंग्स

includeroutes

• प्रकार: बूलियन
• डिफ़ॉल्ट: true
• विवरण: वर्कआउट के लिए मार्ग डेटा शामिल करें (केवल workouts)
• उदाहरण: includeroutes=true

includeworkoutmetadata

• प्रकार: बूलियन
• डिफ़ॉल्ट: true
• विवरण: वर्कआउट के दौरान एकत्र मेट्रिक शामिल करें (केवल workouts)
• उदाहरण: includeworkoutmetadata=true

workoutsmetadatainterval

• प्रकार: Enum (minutes, seconds)
• डिफ़ॉल्ट: minutes
• विवरण: वर्कआउट मेट्रिक के लिए समय समूहीकरण (केवल workouts, exportVersion v2)
• उदाहरण: workoutsmetadatainterval=seconds
• नोट: केवल जब datatype=workouts और exportversion=v2

workouttypes

• प्रकार: स्ट्रिंग (अल्पविराम से अलग UInt मान)
• डिफ़ॉल्ट: खाली (सभी प्रकार)
• विवरण: शामिल करने के लिए विशिष्ट वर्कआउट प्रकार (केवल workouts)
• उदाहरण: workouttypes=1,2,3
• नोट: HealthKit वर्कआउट प्रकार पहचानकर्ता

सूचनाएँ

notifyonupdate

• प्रकार: बूलियन
• डिफ़ॉल्ट: true
• विवरण: कैश्ड डेटा अपडेट होने पर सूचना
• उदाहरण: notifyonupdate=true

notifywhenrun

• प्रकार: बूलियन
• डिफ़ॉल्ट: true
• विवरण: हर बार ऑटोमेशन चलने पर सूचना
• उदाहरण: notifywhenrun=false

उदाहरण

मूल REST API ऑटोमेशन

com.HealthExport://automation?url=https://api.example.com/health&name=My%20Automation&format=json&enabled=true

निर्दिष्ट एंडपॉइंट पर JSON डेटा भेजने वाला मूल ऑटोमेशन बनाता है।

प्रमाणीकरण हेडर के साथ

com.HealthExport://automation?url=https://api.example.com/health&name=Authenticated%20API&format=json&headers=Authorization,Bearer%20your-token-here,X-API-Key,abc123&enabled=true

कस्टम प्रमाणीकरण हेडर के साथ ऑटोमेशन बनाता है।

विशिष्ट मेट्रिक के साथ Health Metrics

com.HealthExport://automation?url=https://api.example.com/metrics&name=Steps%20and%20Heart%20Rate&format=json&datatype=healthMetrics&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours&enabled=true

केवल कदम और हृदय गति, घंटे के अनुसार समेकित निर्यात करता है।

मार्ग डेटा के साथ Workouts

com.HealthExport://automation?url=https://api.example.com/workouts&name=Workout%20Export&format=json&datatype=workouts&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes&enabled=true

मार्ग और वर्कआउट मेट्रिक, निर्यात संस्करण 2 के साथ।

पूर्ण कॉन्फ़िगरेशन उदाहरण

com.HealthExport://automation?url=https://api.example.com/health-data&name=Complete%20Configuration&format=json&datatype=healthMetrics&period=today&interval=hours&aggregatedata=true&aggregatesleep=true&exportversion=v2&syncinterval=hours&syncquantity=2&headers=Authorization,Bearer%20token123&requesttimeout=300&batchrequests=true&notifyonupdate=true&notifywhenrun=false&enabled=true

सभी प्रमुख पैरामीटर के साथ व्यापक उदाहरण।

CSV प्रारूप उदाहरण

com.HealthExport://automation?url=https://api.example.com/csv&name=CSV%20Export&format=csv&datatype=healthMetrics&period=yesterday&enabled=true

CSV निर्यात ऑटोमेशन। CSV स्वचालित रूप से डेटा समेकन सक्षम करता है।

URL एन्कोडिंग

पैरामीटर मानों में विशेष वर्ण URL-एन्कोडेड होने चाहिए। सामान्य:

• Space: %20
• Comma: %2C
• Colon: %3A
• Semicolon: %3B
• Equals: %3D
• Ampersand: %26
• Plus: %2B

उदाहरण:

• मूल: My Automation Name
• एन्कोडेड: My%20Automation%20Name

Headers उदाहरण:

• मूल: Authorization, Bearer token123
• एन्कोडेड: Authorization,Bearer%20token123

अधिकांश भाषाएँ URL एन्कोडिंग फ़ंक्शन प्रदान करती हैं:

• Swift: addingPercentEncoding(withAllowedCharacters:)
• JavaScript: encodeURIComponent()
• Python: urllib.parse.quote()

डीप लिंक परीक्षण

Safari से (iOS)

1. अपने iOS डिवाइस पर Safari खोलें
2. पता पट्टी में डीप लिंक URL दर्ज करें
3. Go पर टैप करें
4. ऐप खुलना चाहिए और ऑटोमेशन बनाना चाहिए

टर्मिनल से (macOS/iOS Simulator)

xcrun simctl openurl booted "com.HealthExport://automation?url=https://api.example.com/health&name=Test&enabled=true"

Xcode से

ब्रेकपॉइंट लगाएँ या डीबगर कंसोल:

let url = URL(string: "com.HealthExport://automation?url=https://api.example.com/health&name=Test&enabled=true")!
try DataModel.shared.handleAPIDeepLink(url)

Shortcuts ऐप से

1. नया शॉर्टकट बनाएँ
2. "Open URLs" क्रिया जोड़ें
3. अपना डीप लिंक URL दर्ज करें
4. शॉर्टकट चलाएँ

समस्या निवारण

सामान्य समस्याएँ

"Could not parse the URL"

• URL स्कीम सही है: com.HealthExport://automation
• सभी मान सही URL-एन्कोडेड हैं
• पैरामीटर नाम सही वर्तनी (केस असंवेदनशील)

"Invalid URL parameter value"

• URL वैध HTTP/HTTPS है
• URL एन्कोडिंग सही है
• अमान्य वर्ण नहीं

"Invalid data type"

• सटीक मान: healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking, medications
• वर्तनी जाँचें (केस असंवेदनशील मिलान)

"Invalid sync cadence interval"

• REST API के लिए केवल: minutes, hours, days, weeks
• seconds केवल period=realtime पर

"Aggregation settings are only valid for healthMetrics data type"

• aggregatedata और interval केवल datatype=healthMetrics पर
• हटाएँ या डेटा प्रकार बदलें

"Batch requests are only valid for REST API with JSON format"

• batchrequests केवल format=json पर
• JSON करें या पैरामीटर हटाएँ

"Workout settings are only valid for workouts data type"

• includeroutes, includeworkoutmetadata, workoutsmetadatainterval केवल datatype=workouts
• डेटा प्रकार बदलें या पैरामीटर हटाएँ

"Metrics parameter is only valid for healthMetrics data type"

• metrics केवल datatype=healthMetrics
• डेटा प्रकार बदलें या हटाएँ

"Invalid metric name"

• सटीक MetricName rawValues (उदा. "Step Count", "Heart Rate")
• वर्तनी और कैपिटलाइज़ेशन
• वैध नामों के लिए ऐप की मेट्रिक स्क्रीन

"Invalid request timeout"

• 60 से 86400 सेकंड के बीच

"A name is required for the automation"

• name पैरामीटर शामिल है
• URL डिकोडिंग के बाद मान खाली नहीं

URL लंबाई सीमाएँ

बहुत लंबे URL (कई मेट्रिक या हेडर) सिस्टम सीमा पार कर सकते हैं:

• metrics में कम मेट्रिक
• कम हेडर
• जहाँ संभव छोटे मान
• जटिल कॉन्फ़िगरेशन को कई सरल ऑटोमेशन में विभाजित करें

पैरामीटर प्राथमिकता

संघर्ष पर:

1. datatype चयन स्वचालित रूप से include फ़्लैग रीसेट करता है
2. format=csv स्वचालित aggregatedata=true
3. period=realtime के लिए syncinterval=seconds आवश्यक
4. असंगत संयोजनों पर सत्यापन त्रुटि

सर्वोत्तम अभ्यास

1. स्वचालित सिंकिंग (डीप लिंक से ट्रिगर होने पर):

   • डिवाइस चार्ज करें और iPhone Mirroring का उपयोग करें
     • चार्ज पर iOS प्रदर्शन पर कम प्रतिबंध, अधिक बार सिंक
     • Mirroring से डिवाइस अनलॉक जैसा व्यवहार; Health Auto Export को स्वास्थ्य डेटा पहुँच

2. विशेष वर्ण वाले मान हमेशा URL-एन्कोड करें

3. पहले सरल URL से परीक्षण, फिर जटिलता

4. पहचान के लिए वर्णनात्मक नाम

5. प्रोग्रामेटिक बनाने से पहले URL सत्यापित करें

6. डीप लिंक पार्स करते समय त्रुटियाँ सुगम रूप से संभालें

7. यदि टूल बनाते हैं तो प्रारूप दस्तावेज़ करें

8. कई मेट्रिक/हेडर पर URL लंबाई पर विचार करें

9. सिमुलेटर के साथ वास्तविक डिवाइस पर भी परीक्षण

संबंधित दस्तावेज़

• REST API ऑटोमेशन गाइड — REST API ऑटोमेशन विस्तार
• ऑटोमेशन अवलोकन — सामान्य अवधारणाएँ
• मैन्युअल निर्यात गाइड — मैन्युअल निर्यात

सहायता

यदि इस गाइड में न कवर समस्याएँ हों:

1. पैरामीटर समस्याओं के लिए त्रुटि संदेश देखें
2. URL एन्कोडिंग सही है सत्यापित करें
3. पहले न्यूनतम URL से परीक्षण करें
4. सहायता के लिए ऐप में Chat Support बटन का उपयोग करें