API rehberi

1. Başlangıç

1. Ücretsiz hesap açın (e-posta ya da Google ile).
2. Panelde Yeni anahtar ile API anahtarı oluşturun. Anahtar va_ ile başlar ve yalnızca bir kez gösterilir.
3. İlk isteği gönderin:

curl -H "X-API-Key: ANAHTARINIZ" "https://api.veriapi.pro/v1/namaz?il=duzce&ilce=akcakoca&gun=1"

2. Kimlik doğrulama

Anahtarı her istekte X-API-Key başlığında gönderin. Başlık eklenemeyen ortamlarda ?anahtar=… parametresi de kabul edilir, ama adres loglara düşebileceği için başlık önerilir.

• Anahtar size özeldir. Herkese açık JavaScript'e ya da mobil uygulama paketine yazmayın; tarayıcıda göstermek için widget'ları kullanın.
• Alan adı kısıtı: anahtara alan adı yazarsanız, tarayıcıdan gelen ve Origin başlığı başka bir alan adı olan istekler reddedilir. Alt alan adları da geçerlidir.
• Sızan anahtarı panelden iptal edip yenisini oluşturun.

3. Yanıt biçimi

Başarılı yanıtlar aynı zarfla döner:

{
  "veri": { … },
  "kaynak": [{"kod": "met", "ad": "MET Norway", "lisans": "CC BY 4.0 / NLOD 2.0",
              "atif": "Data from MET Norway", "url": "https://api.met.no/"}],
  "guncelleme": "2026-11-01T12:05:00",
  "bayat": false
}

• guncelleme: verinin kaynaktan son alındığı an (Türkiye saati).
• bayat: true: kaynak şu an güncellenemiyor, son başarılı veri dönüyor. Gösterebilirsiniz, ama yanına “güncel olmayabilir” notu düşmeniz iyi olur.
• Tarih ve saatler ISO 8601 biçiminde, Türkiye saatiyle (UTC+3) gelir.

4. Konum parametreleri

Namaz, güneş ve hava uçları konumu dört yoldan biriyle alır:

5. Kota ve hız sınırı

Kota anahtar başınadır. Günlük kota istek birimiyle düşer: uçların çoğu 1 birim, anlık / lisanslı veri ve ağır uçlar daha fazla (tablo aşağıda). Dakikalık sınır istek sayısıdır. Kalan haklar ve isteğin maliyeti her yanıtın başlıklarında gelir (hata yanıtlarında da):

X-RateLimit-Limit-Day: 500
X-RateLimit-Remaining-Day: 482
X-RateLimit-Limit-Minute: 20
X-RateLimit-Remaining-Minute: 19
X-Istek-Maliyeti: 1

Sınır aşılınca 429 döner, Retry-After başlığında kaç saniye bekleneceği yazar. Günlük sayaç Türkiye saatiyle gece yarısı sıfırlanır. Öneri: veriyi kendi tarafınızda önbelleğe alın. Hava 5 dakikada, döviz günde birkaç kez, namaz vakti günde bir kez değişir. Her sayfa gösteriminde API'ye gitmeyin.

6. Hata kodları

Hatalar {"hata": {"kod": 404, "mesaj": "…"}} biçiminde döner. Mesajlar Türkçedir ve kullanıcıya gösterilebilir.

7. Atıf kuralları

• Kaynak atfı (her pakette): yanıttaki kaynak[].atif metnini veriyi gösterdiğiniz yerde görünür yazın (ör. “Data from MET Norway”). Bu, verinin asıl sahiplerinin lisans şartıdır.
• VeriApi.Pro bağlantısı (Ücretsiz pakette): sitenizde VeriApi.Pro'ye görünür bir bağlantı olmalı. Hazır örnekler ve kurallar

8. Kod örnekleri

Sunucu tarafında çağırıp sonucu önbelleğe alma örnekleri (Düzce için bugünün namaz vakitleri):

<?php
// 1 saat dosya önbelleği; anahtar ortam değişkeninde
$cache = sys_get_temp_dir() . '/veriapi_namaz_duzce.json';
if (!is_file($cache) || filemtime($cache) < time() - 3600) {
    $ch = curl_init('https://api.veriapi.pro/v1/namaz?il=duzce');
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 10,
        CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('VERIAPI_KEY')],
    ]);
    $body = curl_exec($ch);
    if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200) {
        file_put_contents($cache, $body);
    }
    curl_close($ch);
}
$data = json_decode(@file_get_contents($cache) ?: '{}', true);
$gun = $data['veri']['gunler'][0] ?? null;
if ($gun) {
    echo 'İmsak ' . $gun['imsak'] . ' · İftar ' . $gun['iftar'];
}

// Sunucu tarafı (Node 18+, Deno, Bun, Cloudflare Workers): anahtarı tarayıcıya göndermeyin
let cache = { at: 0, data: null };

export async function namazVakitleri() {
  if (Date.now() - cache.at < 3600_000 && cache.data) return cache.data;
  const res = await fetch("https://api.veriapi.pro/v1/namaz?il=duzce", {
    headers: { "X-API-Key": process.env.VERIAPI_KEY },
  });
  if (!res.ok) {
    const { hata } = await res.json();
    throw new Error(`${hata.kod}: ${hata.mesaj}`);
  }
  const body = await res.json();
  cache = { at: Date.now(), data: body.veri.gunler[0] };
  return cache.data;
}

import os, time
import httpx  # pip install httpx

_cache = {"at": 0.0, "data": None}

def namaz_vakitleri() -> dict:
    if _cache["data"] and time.time() - _cache["at"] < 3600:
        return _cache["data"]
    r = httpx.get(
        "https://api.veriapi.pro/v1/namaz",
        params={"il": "duzce"},
        headers={"X-API-Key": os.environ["VERIAPI_KEY"]},
        timeout=10,
    )
    if r.status_code != 200:
        hata = r.json()["hata"]
        raise RuntimeError(f"{hata['kod']}: {hata['mesaj']}")
    _cache.update(at=time.time(), data=r.json()["veri"]["gunler"][0])
    return _cache["data"]

9. Widget'lar

Kod yazmadan sitenize namaz vakti / iftar sayacı, hava, döviz, deprem ve takvim kutusu ekleyebilirsiniz. Panelde Widget sayfasında görünümü seçin, kodu kopyalayıp sayfanıza yapıştırın. Widget kodu API anahtarınızı içermez. Herkese açık bir widget kimliği kullanır, istekleri anahtarınızın kotasından düşer.

• Script ile: sitenizin CSP'si varsa script-src ve connect-src'ye veriapi.pro eklenmelidir. Stil kutunun içinde kalır, sitenizi etkilemez.
• iframe ile: CSP'ye dokunamıyorsanız frame-src veriapi.pro yeterlidir.

10. Uçlar

Tüm uçlar, parametreler ve yanıt şemaları (OpenAPI) →