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

Tıbbi Uygulama Arka Ucu ve Veritabanı

Bir tıbbi uygulama arka ucu ve veritabanı neleri yönetmeli, Anpheros'un yönetilen bir sağlık veritabanı olarak hangi kısımları sağladığı, sizin arka ucunuzda nelerin kaldığı, bağlanmanın üç yolu ve webhook'larla nasıl senkronize kalınacağı.

Tıbbi uygulama arka ucu, bir sağlık uygulamasının sunucu tarafıdır: hasta verilerini depolar, kimlerin görebileceğini zorlar, değişikliklerin geçmişini tutar ve laboratuvarlar, klinikler ve diğer hizmetlerle konuşur. Anpheros ile, bu arka ucun tıbbi kısmı — her hastanın kaydını, geçmişini, onayını, kaynağını, denetimini, laboratuvar ithalatını ve olaylarını tutan sağlık veritabanı — platform tarafından bir API aracılığıyla sağlanır ve kendi arka ucunuz yalnızca ürününüze özgü olanları tutar.

Bir tıbbi arka uç nelerin üstesinden gelmeli

Arka Uçta Neler Kalır

• kullanıcılarınız ve hesaplarınız ve her kullanıcının Anpheros hasta kimliğine (projenizin gördüğü ikili kimlik) eşlenmesi;
• tıbbi olmayan ürün verileri: ayarlar, abonelikler, içerik, hatırlatıcı programları;
• iş kuralları — personelinizin ürününüzdeki hangi hastayı görebileceği;
• API anahtarı, bu asla bir mobil veya web uygulamasına gönderilmemelidir.

Bağlanmanın Üç Yolu

1. API anahtarınız arka uç sunucunuzda bulunur (en yaygın yöntem). Uygulamanız arka uç sunucunuzu çağırır; arka uç sunucunuz, sk_live_ anahtarıyla Anpheros'u çağırır ve projenizin oluşturduğu hastaları görür.

import { Anpheros, apiKey } from '@anpheros/sdk';
const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });

// GET /api/me/vitals in your backend, after your own authentication
export async function myVitals(user: { anpherosPatientId: string }) {
  const page = await anpheros.observations.list(user.anpherosPatientId, { category: 'vital-signs', limit: 50 });
  return page.data;
}

2. Uygulama, hasta adına OAuth ile hareket eder. Zaten bir Anpheros kaydı olan kişiler için mobil veya web uygulaması, PKCE ile genel bir OAuth istemcisidir: kişi barındırılan sayfada onay verir ve uygulama o tek kayıt için 30 dakikalık bir erişim belirteci ve dönen bir yenileme belirteci alır. SDK'lar bu akışı uygular (OAuthFlow).

3. Sunucudan sunucuya ortaklıklar. Gizli bir istemci (sunucuda tutulan bir sır ile) yetkilendirme kodu akışını veya proje için API anahtarı gibi davranan client_credentials'i kullanabilir.

Arka Uçunuzu Senkronize Tutma

Sorgulama (polling) yerine webhook'lara abone olun. Teslimatlar imzalıdır (Anpheros-Signature, zaman damgası ve gövde üzerinde HMAC-SHA256), en az bir kez ve olası olarak sırası bozuk şekilde gelir; olay kimliğine göre yinelenenleri kaldırın ve eski sürümleri yoksayın.

import { verifyWebhookSignature } from '@anpheros/sdk';

app.post('/anpheros/hook', express.raw({ type: 'application/json' }), async (req, res) => {
  const ok = await verifyWebhookSignature({ secret: process.env.ANPHEROS_WEBHOOK_SECRET!, header: req.header('anpheros-signature'), body: req.body });
  if (!ok) return res.status(400).end();
  const event = JSON.parse(req.body.toString());   // ids and versions only — read the resource if you need it
  res.status(204).end();
});

Hataları ve Sınırları Yönetme

• 404'u, bir kaydın mevcut olmadığının kanıtı olarak değil, "size görünür değil" olarak ele alın.
• 403, kimlik bilgilerinin mevcut olduğu ancak bu işlemi yapamayabileceği anlamına gelir — eksik bir kapsam veya başka bir kuruluş tarafından yazılmış bir kaynak.
• 429, Retry-After ile birlikte gelir; SDK'lar, 5xx için yaptıkları gibi otomatik olarak bekler ve yeniden dener.
• Destek için başarısız olan çağrıların Anpheros-Request-Id'ini saklayın.

Hatalar · Sınırlar ve hız sınırları

Sıkça Sorulan Sorular

Tıbbi bir uygulama hangi veritabanını kullanmalı?

Tıbbi verileri standart, sürümlenmiş bir biçimde tutan ve hasta başına erişimi kontrol eden bir veritabanı. Anpheros, HL7 FHIR R4 üzerine kurulu yönetilen bir sağlık veritabanıdır: her hastanın kaydı sürümlenmiş ve aranabilir, her yazma işlemi köken bilgisi taşır ve bir uygulama, yalnızca kaydı oluşturduysa veya hasta onay verdiyse bir hastayı görür. Ürününüzün geri kalan verilerini (hesaplar, faturalandırma, içerik) kendi veritabanınızda saklayın. Kendi tablolarınızı tasarlamanın getireceği ödünleşimler için FHIR'a Karşı Özel Bir Tıbbi Veritabanı bölümüne bakın.

Tıbbi uygulamalar için ücretsiz bir veritabanı var mı?

Evet. Anpheros sandbox'ı ücretsizdir: Google ile oturum açın, tek tıklamayla bir anahtar alın ve projeniz kendi 30 sentetik hastasına ve günde 10.000'e kadar yazma hakkına sahip olur. Üretim, ayda 99 €'dan başlayan fiyatlarla 2.500 hasta için başlar, ilk ay ücretsizdir; üretim erişimi, imzalanmış bir veri işleme sözleşmesi olan doğrulanmış kuruluşlar içindir. Fiyatlandırma bölümüne bakın.

Ücretsiz sandbox'ta gerçek hasta verilerini saklayabilir miyim?

Hayır. Sandbox yalnızca sentetik veriler içindir: her sandbox projesi kendi sentetik hastalarına sahip olur ve sandbox anahtarları üretime erişemez. Gerçek hasta kayıtları bir üretim projesine aittir.

İlgili Kaynaklar

• FHIR ve özel bir tıbbi veritabanı arasındaki farklar: Kendi tablolarınızı ne zaman tasarlamalısınız ve FHIR'ı ne zaman kullanmalısınız?
• TypeScript ile bir sağlık API'si nasıl oluşturulur: Express ile adım adım öğretici
• Flutter ile bir sağlık uygulaması nasıl oluşturulur: Dart SDK ile adım adım öğretici
• Sağlık yazılımı geliştirme
• Bir sağlık uygulaması oluşturun
• Mimari
• Tıbbi veri API'si
• SDK'lar

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