Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

हेल्थकेयर ऐप बनाएँ

ट्यूटोरियल: Anpheros को हेल्थकेयर ऐप के मेडिकल-डेटा बैकएंड के रूप में उपयोग करें — पेशेंट, माप, स्थितियाँ, दवाएँ, दस्तावेज़, लैब, सहमति, वेबहुक और SDKs।

यह ट्यूटोरियल दिखाता है कि कोई स्वास्थ्य सेवा या मेडिकल एप्लिकेशन Anpheros Platform को अपने मेडिकल-डेटा बैकएंड के रूप में कैसे उपयोग कर सकता है: जहाँ मरीज़ों के रिकॉर्ड संग्रहीत किए जाते हैं, उन्हें कैसे पढ़ा और लिखा जाता है, अन्य सिस्टम कैसे कनेक्ट होते हैं और मरीज़ नियंत्रण में कैसे रहता है। नीचे दिया गया प्रत्येक कॉल सार्वजनिक API (संदर्भ) का हिस्सा है।

आप क्या बना रहे हैं

एक सामान्य रोगी-सामना करने वाला ऐप - एक पुरानी-स्थिति ट्रैकर, एक पारिवारिक स्वास्थ्य ऐप, एक दूरस्थ-निगरानी साथी - को निम्नलिखित की आवश्यकता होती है:

प्रति रोगी एक रिकॉर्ड रखना: माप, स्थितियाँ, दवाएँ, दस्तावेज़;
उस रिकॉर्ड को सूचियों और एक टाइमलाइन के रूप में वापस दिखाना;
अन्य स्रोतों (उपकरणों, प्रयोगशालाओं, क्लीनिकों) से डेटा स्वीकार करना;
रोगी की सहमति से रिकॉर्ड के कुछ हिस्सों को साझा करना;
जब कुछ बदलता है तो प्रतिक्रिया देना।

Anpheros के साथ आपका ऐप अपने स्वयं के उपयोगकर्ताओं, स्क्रीन और व्यावसायिक तर्क को रखता है, और चिकित्सा रिकॉर्ड को प्लेटफ़ॉर्म को सौंप देता है:

Mobile / web app ──► your backend ──► Anpheros Platform API ──► FHIR R4 record of each patient
                         ▲                                              │
                         └──────────── signed webhooks ◄────────────────┘

आपका बैकएंड API कुंजी रखता है; ऐप आपके बैकएंड से बात करता है। (ऐसे ऐप जो किसी ऐसे रोगी के लिए कार्य करते हैं जिसका पहले से ही Anpheros रिकॉर्ड है, वे इसके बजाय OAuth का उपयोग करते हैं - चरण 7 देखें।)

1. सैंडबॉक्स कुंजी प्राप्त करें

सैंडबॉक्स सेल्फ-सर्विस है: डैशबोर्ड (https://platform.anpheros.com/dashboard/) पर Google से साइन इन करें और सैंडबॉक्स कुंजी प्राप्त करें पर क्लिक करें। सैंडबॉक्स कुंजियाँ sk_test_ से शुरू होती हैं और केवल सैंडबॉक्स डेटाबेस तक पहुँच सकती हैं, जहाँ आपके प्रोजेक्ट में पहले से ही 30 सिंथेटिक रोगियों की अपनी प्रतिलिपि है।

export BASE=https://platform.anpheros.com
export KEY=sk_test_…
curl $BASE/v1/patients -H "Authorization: Bearer $KEY"

2. एक रोगी बनाएँ

आपके ऐप का प्रत्येक उपयोगकर्ता आपके प्रोजेक्ट के स्वामित्व वाला एक रोगी रिकॉर्ड प्राप्त करता है।

curl -X POST $BASE/v1/patients -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -H "Idempotency-Key: $(uuidgen)" \
     -d '{"given": "Elena", "family": "Ionescu", "birth_date": "1985-09-03", "gender": "female"}'

प्रतिक्रिया में रोगी id (इस व्यक्ति के लिए आपका अपना पहचानकर्ता — अन्य प्रोजेक्ट एक अलग पहचानकर्ता देखते हैं) और उसका fhir संदर्भ शामिल है।

3. माप, स्थितियाँ और दवाएँ लिखें

बताएँ कि डेटा author_type: patient, practitioner, device, import या ai से आ रहा है। यदि आप इसे छोड़ देते हैं, तो प्लेटफ़ॉर्म import रिकॉर्ड करता है, कभी भी patient को स्वतः नहीं मानता।

# a blood-pressure reading from a connected device (LOINC panel with two components)
curl -X POST $BASE/v1/patients/$PID/observations -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -H "Idempotency-Key: $(uuidgen)" -d '{
  "code": "85354-9", "display": "Blood pressure panel", "category": "vital-signs",
  "effective_at": "2026-09-28T08:00:00Z", "author_type": "device",
  "components": [
    {"code": "8480-6", "display": "Systolic", "value": 128, "unit": "mm[Hg]"},
    {"code": "8462-4", "display": "Diastolic", "value": 82, "unit": "mm[Hg]"}
  ]}'

# a diagnosis (ICD-10 by default)
curl -X POST $BASE/v1/patients/$PID/conditions -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"code": "I10", "display": "Essential hypertension", "onset": "2024-03-01", "author_type": "practitioner"}'

# a medication (ATC by default)
curl -X POST $BASE/v1/patients/$PID/medications -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"display": "Amlodipine 5 mg", "code": "C08CA01", "dosage": "1 tablet in the morning", "start": "2024-03-01", "author_type": "patient"}'

अवलोकन श्रेणियाँ: vital-signs, laboratory, symptom, activity, survey, exam, imaging, social-history। प्रत्येक राइट को FHIR संसाधन के रूप में संग्रहीत किया जाता है और स्वचालित रूप से एक Provenance प्रविष्टि प्राप्त करता है।

4. दस्तावेज़ संग्रहीत करें

# create the document, then upload the bytes
curl -X POST $BASE/v1/patients/$PID/documents -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"title": "Blood tests 2026-09-14", "kind": "lab_report", "content_type": "application/pdf", "date": "2026-09-14"}'
curl -X PUT $BASE/v1/documents/$DOC/content -H "Authorization: Bearer $KEY" -H 'content-type: application/pdf' --data-binary @report.pdf

अपलोड के बाद मूल अपरिवर्तनीय होता है; आप इससे जो मान निकालते हैं, वे derived_from के साथ उस पर वापस इंगित कर सकते हैं।

5. रिकॉर्ड वापस पढ़ें

curl "$BASE/v1/patients/$PID/observations?category=vital-signs&limit=20" -H "Authorization: Bearer $KEY"
curl "$BASE/v1/patients/$PID/medications?status=active" -H "Authorization: Bearer $KEY"
curl "$BASE/v1/patients/$PID/timeline?from=2026-06-01" -H "Authorization: Bearer $KEY"   # everything, chronologically

जब आपको पूर्ण FHIR मॉडल की आवश्यकता होती है, तो वही डेटा /fhir/R4 पर समान आईडी के साथ उपलब्ध होता है (FHIR R4 API)।

6. लैब और डिवाइस कनेक्ट करें

लैब रिपोर्ट: POST /v1/patients/{id}/labs/import को CSV, HL7 v2 ORU^R01 या JSON के साथ एक पूरी रिपोर्ट को प्रयोगशाला अवलोकनों (Observations) में बदला जा सकता है, जिसमें LOINC कोड शामिल हैं (लैब कनेक्टर)।
डिवाइस और वियरेबल्स: अवलोकनों (Observations) को author_type: device और माप के LOINC कोड के साथ लिखें (हृदय गति, SpO₂, कदम, नींद की अवधि और अन्य FHIR कोड सिस्टम में सूचीबद्ध हैं)।

7. उस रिकॉर्ड तक पहुँचें जो मरीज़ के पास पहले से है (OAuth)

यदि व्यक्ति के पास पहले से ही Anpheros में एक रिकॉर्ड है (उदाहरण के लिए Anpheros Daily के माध्यम से), तो आपका ऐप नया मरीज़ बनाने के बजाय पहुँच का अनुरोध कर सकता है: एक एप्लिकेशन पंजीकृत करें, व्यक्ति को आपकी आवश्यकता वाले स्कोप के साथ सहमति पृष्ठ पर भेजें, कोड को टोकन के लिए एक्सचेंज करें और एक्सेस टोकन के साथ API को कॉल करें। मरीज़ अवधि चुन सकता है और किसी भी समय पहुँच रद्द कर सकता है। विवरण: Authentication and OAuth।

8. वेबहुक के साथ परिवर्तनों पर प्रतिक्रिया करें

curl -X POST $BASE/v1/webhooks -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
     -d '{"url": "https://your.app/anpheros/hook", "events": ["resource.created", "consent.revoked"]}'

हर डिलीवरी के Anpheros-Signature हेडर को सत्यापित करें (वेबहुक)।

9. SDK का उपयोग करें

वही प्रवाह TypeScript में:

import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
const { data: patients } = await anpheros.patients.list();
const vitals = await anpheros.observations.list(patients[0].id, { category: 'vital-signs', limit: 20 });

इसी तरह का एक Dart / Flutter क्लाइंट anpheros_sdk (SDKs) के रूप में उपलब्ध है।

उत्पादन में जाने से पहले

उत्पादन कुंजियाँ (sk_live_) हस्ताक्षरित डेटा प्रोसेसिंग समझौते के साथ सत्यापित संगठनों को जारी की जाती हैं।
सुरक्षा, गोपनीयता और डेटा निवास पृष्ठ और सीमाओं को पढ़ें।
त्रुटियों को उनके प्रकार के अनुसार संभालें और समर्थन से संपर्क करते समय Anpheros-Request-Id हेडर का उल्लेख करें (त्रुटियाँ)।