Türkçe · English

Persentil API

Kendi sitenizde WHO, CDC ve Neyzi referanslarıyla persentil ve z skoru. Hesap, pediatrirutinleri.com persentil hesaplayıcısıyla aynıdır.

Başvuru yap

1. Başvuru ve anahtar

1. Pediatri Rutinleri hesabınızla giriş yapın (mobil uygulamadaki hesabınız da geçerli; yoksa ücretsiz üye olun) ve Persentil API hizmet sayfasından başvurun: kurum, web siteniz, kullanım amacınız; API için sunucu IP adresleriniz, gömülü form için alan adlarınız. Başvuru hesabınıza bağlanır, sonuç hesabınızın e-posta adresine gelir.
2. Her başvuru yönetici tarafından incelenir ve size e-postayla dönülür. Kullanım şimdilik günlük kotayla ücretsizdir.
3. Gömülü form onaylanırsa gömme kodu e-postayla gelir.
4. API onaylanırsa tek kullanımlık bir bağlantı gelir (72 saat geçerli). Anahtar, bağlantıda “Anahtarı göster” düğmesine bastığınızda üretilir ve yalnızca bir kez gösterilir. Anahtar e-postayla gönderilmez, bizde de düz metin olarak saklanmaz. Kaybederseniz yenisi verilir.

2. Gömülü form

Onay e-postasındaki kodu sayfanıza ekleyin (SITE_KIMLIGI size verilen kimliktir):

<iframe src="https://pediatrirutinleri.com/api/widget/?site=SITE_KIMLIGI"
        title="Persentil hesaplayıcı" style="width:100%;min-height:720px;border:0"
        loading="lazy" referrerpolicy="strict-origin"></iframe>
<script src="https://pediatrirutinleri.com/api/widget/gomme.js" async></script>

• gomme.js çerçevenin yüksekliğini içeriğe göre ayarlar; eklemezseniz min-height değeri kullanılır.
• İsteğe bağlı parametreler: &ref=cdc (varsayılan seçili referans: who, cdc, neyzi), &color=2f6f5f (düğme rengi, # olmadan).
• Form yalnızca başvuruda bildirdiğiniz HTTPS alan adlarında açılır. Yeni alan adı (ör. www. ile) için bize yazın.
• Ziyaretçi başına dakikalık bir sınır ve siteniz için günlük bir hesap sınırı vardır; ihtiyacınız artarsa sınırı yükseltebiliriz.
• Sonuçlarla birlikte boy, kilo, baş çevresi ve BMI için büyüme eğrisi grafiği gösterilir.

Sitenizde Content-Security-Policy (CSP) varsa

Form görünmüyorsa büyük olasılıkla sitenizin güvenlik politikası dış çerçeveleri engelliyordur. CSP başlığınıza şunu ekleyin:

frame-src … https://pediatrirutinleri.com
script-src … https://pediatrirutinleri.com   (isteğe bağlı: yalnızca otomatik yükseklik için)

script-src eklemezseniz form yine çalışır; yalnızca gomme.js yüklenmez ve çerçeve, kodda verilen min-height ile sabit kalır. CSP'nizi değiştiremiyorsanız API ile kendi formunuzu kullanın.

3. API

POST https://pediatrirutinleri.com/api/v1/persentil.php

İstek

{
  "id": "olcum-8812",
  "ref": "who",
  "sex": 1,
  "bday": "2024-03-15",
  "tday": "2026-10-01",
  "height": 89.4,
  "measure": "h",
  "weight": 12.6,
  "hc": 47.5,
  "gaw": 34,
  "gad": 2,
  "mheight": 162,
  "dheight": 178,
  "lang": "tr"
}

Toplu: {"items": [ {…}, {…} ]} (en çok 100 ölçüm).

Sayılar JSON sayısı (89.4) ya da noktalı metin ("89.4") olabilir. Tanınmayan alanlar yok sayılır.

Yanıt

{
  "success": true,
  "result": {
    "id": "olcum-8812", "ref": "who", "sex": 1,
    "age": { "months": 29.3, "chrono": {"total_days": 930, "years": 2, "months": 6, "days": 16}, "corrected": null },
    "preterm": { "applied": false, "reason": "over_24_months", "gaw": 34, "gad": 2, "corr_days": null, "pma_days": null },
    "height": { "measured": 89.4, "used": 90.1,
                "measure_adj": {"measure": "h", "expected": "l", "diff_cm": 0.7},
                "z": 0.12, "p": 54.78, "height_age_m": 28.4, "ideal_weight": 12.9 },
    "weight": { "value": 12.6, "z": -0.05, "p": 47.9, "rel_weight": 98 },
    "hc": { "value": 47.5, "z": 0.3, "p": 61.2 },
    "bmi": { "value": 15.52, "z": …, "p": … },
    "wfh": { "z": …, "p": … },
    "target": { "cm": 163.5, "low": 156.5, "high": 170.5, "z": 0.21 }
  },
  "request_id": "9f2c…"
}

• Yalnızca gönderdiğiniz ölçümlerin bölümleri gelir; BMI ve boya göre kilo için boy ve kilo birlikte gerekir.
• Referans aralığı dışındaki yaş ya da boy için z ve p null olur (en uç değere yuvarlanmaz).
• Boya göre kilo: WHO 45–120 cm; CDC 24 ay üzeri, 77–121.5 cm. Neyzi'de yoktur.
• Toplu yanıtta results dizisi gelir; her öğede index, success ve result ya da error (hatalıysa id de) bulunur. Hatalı ölçüm diğerlerini engellemez ve kotadan düşülmez.

Büyüme eğrileri (isteğe bağlı)

Tekli istekte "graph": true gönderirseniz yanıta result.graphs eklenir: ölçülen ve referans aralığında kalan her ölçüm (height, weight, hc, bmi) için P3, P10, P25, P50, P75, P90, P97 eğrileri ve çocuğun noktası. Kendi grafiğinizi bununla çizebilirsiniz. Toplu istekte grafik dönmez.

"graphs": {
  "height": {
    "unit": "cm", "x_unit": "month", "x_range": [0, 23.984],
    "centiles": [3, 10, 25, 50, 75, 90, 97],
    "x": [0, 0.493, …],                       // yaş (ay)
    "p": { "3": [45.6, …], "50": [49.1, …], "97": [52.7, …], … },
    "point": [13.142, 76.0]                   // [hesaptaki yaş (ay), hesaptaki değer]
  }
}

Pencere çocuğun yaşına göre seçilir: 2 yaşa kadar 0–24 ay, 5 yaşa kadar 0–60 ay, üstünde 60–240 ay (referans tablosunun kapsadığı kadar). Prematürede düzeltilmiş yaş, boy ölçüm şekli düzeltmesinde düzeltilmiş boy kullanılır.

Örnek: PHP

$anahtar = getenv('PR_PERSENTIL_API_ANAHTARI'); // koda yazmayın
$ch = curl_init('https://pediatrirutinleri.com/api/v1/persentil.php');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 15,
    CURLOPT_USERAGENT      => 'OrnekKlinik/1.0',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $anahtar, 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'ref' => 'who', 'sex' => 2,
        'bday' => '2025-01-10', 'tday' => '2026-10-01',
        'height' => 82.0, 'weight' => 11.2,
    ]),
]);
$yanit = json_decode(curl_exec($ch), true);
$kod   = curl_getinfo($ch, CURLINFO_HTTP_CODE);

Örnek: Node.js (18+)

const yanit = await fetch('https://pediatrirutinleri.com/api/v1/persentil.php', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.PR_PERSENTIL_API_ANAHTARI}`,
    'Content-Type': 'application/json',
    'User-Agent': 'OrnekKlinik/1.0',
  },
  body: JSON.stringify({ ref: 'cdc', sex: 1, agedays: 1500, height: 101.2, weight: 15.8 }),
});
const veri = await yanit.json();

4. Ziyaretçilerin girdiği form için aracı dosya

Ölçümleri sitenizin ziyaretçileri giriyorsa, tarayıcı API'ye doğrudan bağlanamaz (anahtar sayfa kaynağında görünür ve çalınır). Akış şöyle olmalı:

Ziyaretçinin tarayıcısı  →  sizin sunucunuz (aracı dosya)  →  pediatrirutinleri.com API

Önemli: Aracı dosyanız herkese açıktır. Koruma koymazsanız biri onu döngüyle çağırıp sizin günlük kotanızı tüketebilir. En az şu üç önlemi alın: yalnızca kendi sayfanızdan gelen isteği kabul edin, ziyaretçi başına sınır koyun, yalnızca tek ölçüme izin verin. Formunuz herkese açıksa CAPTCHA da eklemenizi öneririz.

Örnek aracı dosya (PHP, APCu ile; APCu yoksa sınırı veritabanı ya da Redis ile tutun):

<?php
// https://sizin-siteniz.com/persentil-hesapla.php
const SITE_KOKENI = 'https://sizin-siteniz.com';
const DAKIKA_SINIRI = 20; // ziyaretçi IP'si başına

header('Content-Type: application/json; charset=utf-8');
header('Cache-Control: no-store');

if ($_SERVER['REQUEST_METHOD'] !== 'POST') { http_response_code(405); exit; }

// 1) Yalnızca kendi sayfanızdan
if (($_SERVER['HTTP_ORIGIN'] ?? '') !== SITE_KOKENI) { http_response_code(403); exit; }

// 2) Ziyaretçi başına dakikalık sınır
$sayac = 'prp_' . hash('sha256', $_SERVER['REMOTE_ADDR']);
apcu_add($sayac, 0, 60);
if (apcu_inc($sayac) > DAKIKA_SINIRI) { http_response_code(429); exit; }

// 3) Yalnızca tek ölçüm ve bilinen alanlar (toplu "items" geçmez)
$girdi  = json_decode(file_get_contents('php://input', false, null, 0, 4096), true);
$izinli = ['ref', 'sex', 'bday', 'tday', 'agedays', 'height', 'weight', 'hc',
           'measure', 'gaw', 'gad', 'mheight', 'dheight', 'lang'];
$olcum  = is_array($girdi) ? array_intersect_key($girdi, array_flip($izinli)) : [];

// 4) API'ye sunucunuzdan, anahtar ortam değişkeninden
$ch = curl_init('https://pediatrirutinleri.com/api/v1/persentil.php');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 15,
    CURLOPT_USERAGENT      => 'SizinSiteniz/1.0',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('PR_PERSENTIL_API_ANAHTARI'),
                               'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode($olcum ?: new stdClass()),
]);
$yanit = curl_exec($ch);
$kod   = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($yanit === false || $kod >= 500) {
    http_response_code(502);
    echo json_encode(['success' => false, 'error' => ['code' => 'server_error', 'message' => 'Hesap şu an yapılamıyor.']]);
    exit;
}
http_response_code($kod);
echo $yanit; // API yanıtı olduğu gibi

Sayfanızdaki JavaScript bu dosyaya fetch('/persentil-hesapla.php', {method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify(olcum)}) ile istek gönderir. Kod yazmak istemiyorsanız gömülü formu kullanın.

5. Hatalar ve sınırlar

{ "success": false, "error": { "code": "invalid_input", "message": "…", "field": "height" }, "request_id": "…" }

code ve field dilden bağımsızdır, programınızda bunlara göre davranın; message lang diline göre Türkçe ya da İngilizcedir.

IP başına genel sınır aşıldığında 429 gövdesi {"success": false, "error": "…"} biçimindedir; HTTP koduna göre davranın.

Yanıt başlıkları: X-RateLimit-Limit, X-RateLimit-Remaining (dakikalık istek), X-Quota-Limit, X-Quota-Remaining (günlük ölçüm), X-Request-Id (destek isterken bildirin).

6. Güvenlik ve kişisel veri

• Kişisel veri göndermeyin. Hesap için ad, kimlik numarası ya da dosya numarası gerekmez. Ölçümler saklanmaz ve kayda yazılmaz; yalnızca günlük istek ve ölçüm sayısı tutulur.
• Anahtarı yalnızca sunucuda tutun (ortam değişkeni ya da yapılandırma dosyası). Tarayıcı koduna, mobil uygulamaya ya da herkese açık depoya koymayın.
• Anahtarınızı sunucu IP adreslerinize kısıtlatın; anahtar sızsa bile başka yerden kullanılamaz.
• Anahtar sızdıysa hemen bize bildirin; iptal edip yenisini veririz.

Sonuçlar klinik karar desteği içindir; tanı ve tedavi kararı hekime aittir.

Pediatri Rutinleri · Gizlilik · Kullanım koşulları