Dr. Ezgi Söylemez Medikal Estetik — Agent ve veri dokümantasyonu

Kapsam

Bu site, kliniğin herkese açık kimlik, konum, iletişim ve yayımlanmış bilgilendirme konularını salt okunur olarak sunar. Uç noktalar kimlik doğrulama gerektirmez; kişisel sağlık verisi kabul etmez ve randevu oluşturmaz.

WebMCP: salt okunur tarayıcı araçları

WebMCP destekleyen tarayıcılarda ana sayfa ve bu sayfa iki isteğe bağlı araç sunar: get_clinic_profile yayımlanmış klinik profilini, list_information_topics mevcut yedi konu adını ve bağlantısını döndürür. Araçlar parametre almaz; veri kaydetmez, tıbbi öneri vermez ve randevu oluşturmaz. Desteklemeyen tarayıcılarda sayfalar ve public API normal şekilde kullanılabilir.

Uç noktalar

Örnek

Klinik profilini okumak için GET https://drezgisoylemez.com/api/public/profile isteği gönderin. Başarılı yanıt application/json türündedir. Bu yüzeyde yazma metodu, erişim anahtarı veya kullanıcı hesabı yoktur.

Yanıtlar ve hatalar

Başarılı istekler 200 döndürür. Bulunmayan bir public API yolu 404, desteklenmeyen bir metot 405 döndürür. API hataları application/problem+json biçimindedir ve hata kodu ile dokümantasyon bağlantısını içerir. HEAD, GET ile aynı başlıkları gövdesiz döndürür.

Örnek yanıtlar


GET /api/public/profile
HTTP/1.1 200 OK
Content-Type: application/json
{"name":"Dr. Ezgi Söylemez Medikal Estetik Kliniği","url":"https://drezgisoylemez.com/tr/","telephone":"+90 535 966 91 96","location":{"streetAddress":"Caddebostan, Selin Sk. Soley Apt, No:2/1 Kat:3 D:5","addressLocality":"Kadıköy","addressRegion":"İstanbul","addressCountry":"TR"},"medicalAdvice":false,"acceptsPatientData":false}

GET /api/public/not-found
HTTP/1.1 404 Not Found
Content-Type: application/problem+json
{"type":"about:blank","title":"Not Found","status":404,"code":"not_found","detail":"The requested public information endpoint does not exist.","documentation":"https://drezgisoylemez.com/docs"}


GET /api/public/profile
API-Version: 2
HTTP/1.1 400 Bad Request
Content-Type: application/problem+json
{"type":"about:blank","title":"Bad Request","status":400,"code":"unsupported_api_version","detail":"Supported API-Version values: 1.","documentation":"https://drezgisoylemez.com/docs"}

API sürümleme ve kullanımdan kaldırma politikası

Geçerli public API sürümü 1 değeridir. İstemci API-Version: 1 başlığını gönderebilir; başlık yoksa sürüm 1 seçilir. Sürüm 1 aktiftir ve kullanımdan kaldırılmamıştır; bu nedenle aktif yanıtlarda Deprecation veya Sunset başlığı yayımlanmaz.

Geriye uyumlu alan eklemeleri sürüm 1 içinde yapılabilir. Geriye uyumsuz bir değişiklik yeni sürüm gerektirir. Bir sürüm kullanımdan kaldırılmadan önce bildirim ve geçiş hedefi /docs ile /docs.md üzerinde yayımlanır; ilgili sürüm yanıtları Deprecation: true ve RFC 8594 biçiminde Sunset tarihi taşır. Güvenlik nedeniyle sürdürmenin güvenli olmadığı istisnalar dışında kapanış tarihi, herkese açık bildirimden en az 180 gün sonrası olur.

Desteklenmeyen sürüm değerleri 400 application/problem+json ve code: unsupported_api_version ile reddedilir.

Quick start

Scope

These two public endpoints are a read-only clinic information surface for international machine and developer readers. They expose verified clinic identity, contact location, and published general information topics.

Authentication: none

These two public endpoints require no API key, user account, session, or authentication header. Send ordinary HTTPS GET requests.

Authentication and public API access: requests, permissions and errors.

API endpoints

Example requests

curl --fail https://drezgisoylemez.com/api/public/profile
curl --fail https://drezgisoylemez.com/api/public/topics

Field reference

Profile: name, url, telephone, location, medicalAdvice (always false), and acceptsPatientData (always false).

Location: streetAddress, addressLocality, addressRegion, and addressCountry.

Topics: topics is an array of objects; each object contains name and url.

Response schemas and content types

Successful profile and topics responses are 200 OK with application/json. Shapes are defined by OpenAPI 3.1: ClinicProfile, ClinicLocation, PublishedTopicList, and PublishedTopic.

Error responses

Unknown public API paths return 404 Not Found with application/problem+json. Unsupported methods return 405 Method Not Allowed with the same content type. Each problem response includes a documentation link to /docs; use it to resolve the endpoint and method boundary.

Public information API policy: 300 requests per 60 seconds, shared by these two endpoints for the same client IP in each Cloudflare location. Counts are approximate; shared networks share the allowance. RateLimit-Policy, X-RateLimit-Limit and X-RateLimit-Window describe the configured policy, not a remaining balance. On an HTTP 429 limit rejection, wait for Retry-After: 60 before retrying. If enforcement is temporarily unavailable, public information stays accessible and rate-limit policy headers are omitted.

Version lifecycle and deprecation

Version 1 is the active public API version. Send API-Version: 1, or omit the header to select version 1. It is not currently deprecated, so active responses do not include Deprecation or Sunset headers. Backward-compatible additions remain in version 1; incompatible changes require a new version. Before retirement, notice and a migration target are published on /docs and /docs.md. Future deprecated responses will carry Deprecation: true and an RFC 8594 Sunset date, at least 180 days after public notice except for an immediate security need. Unsupported values return 400 application/problem+json with unsupported_api_version.

Limitations

These two public endpoints support read-only GET and HEAD requests only. They do not provide write methods, user accounts, patient-data handling, medical-advice responses, appointment operations, or payment operations.

Güvenlik ve kullanım sınırları

Bu uç noktalar yalnız yayımlanmış kurumsal bilgilerin keşfi içindir. Tıbbi tavsiye, tanı, kişiye özel uygunluk, acil sağlık değerlendirmesi, ödeme veya randevu işlemi sunmaz. İletişim ve randevu için resmî iletişim ve randevu sayfalarını kullanın.