Ana içeriğe atla
Bir test konumu bulmak, bir hasta profili için randevu oluşturmak ve uygulanacak test panellerini eklemek için bu kılavuzu kullan. Hasta kan alma için gelmeden önce bu adımları tamamla.
1

Uygun konumlara göz at

/api/v1/locations adresine bir GET isteği göndererek hesabında kullanılabilir olan test konumlarının listesini al.
Yanıt, konum nesnelerinden oluşan bir dizidir:
scheduled_at zaman damganı oluştururken konum nesnesindeki timezone alanını kullan. Randevu saatini konumun yerel saat dilimine dönüştürmek, çalışma saatleri dışında randevu planlamanı önlemeye yardımcı olur.
Randevu alınabilecek saatleri yalnızca open_hours alanından çıkarma. Uygunluğu al uç noktasını çağır ve döndürdüğü bir zaman dilimi başlangıcına randevu al — bu çizelge mevcut randevuları, tarihe özel istisnaları ve minimum bildirim süresini de hesaba katar.
2

Randevuyu oluştur

Profil ID’si, konum ID’si ve istediğin randevu saatiyle /api/v1/appointments adresine bir POST isteği gönder. Saat, Uygunluğu al yanıtından dönen bir zaman dilimi başlangıcı olmalıdır.
scheduled_at, ISO 8601 formatında gelecekteki bir tarih ve saat olmalıdır; örneğin 2026-05-12T07:30:00Z. Geçmişteki zaman damgaları ve Aniva tarafından işletilen konumlardaki 12 saatlik minimum bildirim süresi içindeki saatler 400 hatasıyla reddedilir.
Bu isteği tekrarlamak güvenlidir. Bir profil aynı konum ve saat için yalnızca bir randevu alabilir; bu nedenle yeniden veya iki kez gönderilen oluşturma isteği hastaya iki kez randevu vermek yerine mevcut appointment_id ile 409 döndürür.
Başarılı bir istek, randevu nesnesiyle birlikte 201 Created döndürür:
Randevu id değerini kaydet — panel eklemek ve kan almayı onaylamak için buna ihtiyacın olacak.
3

Test panellerini ekle

/api/v1/appointments/{id}/panels adresine bir POST isteği göndererek kan örneği üzerinde çalıştırmak istediğin test panellerini ekle.Panel ID’leri UUID formatındadır. API anahtarının sipariş edebileceği panelleri almak için Panelleri listele uç noktasını çağır.
Kan alma onaylandıktan sonra panel eklenemez. Gerekli tüm panelleri onaydan önce ekle — ayrıntılar için Kan almayı onayla kılavuzuna bak.
Başarılı bir istek, panellerin eklendiğini onaylayarak 200 OK döndürür:

Yeniden planlama veya iptal etme

Bir randevu oluşturduktan sonra, kan alma onaylanmadan önce randevuyu hâlâ değiştirebilirsin:
  • Yeniden planla veya konumu değiştir — Güncellenecek alanlarla /api/v1/appointments/{id} adresine bir PATCH isteği gönder. Randevuyu güncelle sayfasına bak.
  • İptal et — /api/v1/appointments/{id} adresine bir DELETE isteği gönder. Randevuyu iptal et sayfasına bak.
Her iki işlem de yalnızca kan almadan önce — yani randevu pending veya confirmed durumundayken kullanılabilir. Randevu blood_drawn durumuna geçtikten sonra başka değişiklik yapılamaz.

Hata yönetimi