TFF Süper Lig Puan Durumu API

Örnek Veri görünümü için buraya tıklayın : https://api.teknikzeka.net/tffpuandurumu/

TFF Süper Lig Puan Durumu API Kullanım Rehberi

API Genel Bakış

TFF Süper Lig Puan Durumu API'si, Türkiye Süper Lig'inin güncel puan durumunu JSON formatında sunan bir servistir. Bu API, web siteleri, mobil uygulamalar ve diğer platformlar için kolay entegrasyon sağlar.

API URL: https://api.teknikzeka.net/tffpuandurumu/api.php

Temel Kullanım

Standart İstek

En basit kullanımda, API'ye parametre olmadan istek yaparsınız ve veritabanında kayıtlı en son verileri alırsınız:

GET https://api.teknikzeka.net/tffpuandurumu/api.php

Zorla Güncelleme

Verileri zorla güncellemek isterseniz, update parametresini kullanabilirsiniz:

GET https://api.teknikzeka.net/tffpuandurumu/api.php?update=1

Bu istek, kaynaktan yeni veriler çeker ve veritabanını günceller. Güncelleme başarılı olursa, "source": "web" değerini JSON yanıtında göreceksiniz.

Yanıt Formatı

API başarılı olduğunda şu yapıda bir JSON döndürür:

json

{
  "status": "success",
  "source": "db",
  "last_updated": "2023-04-17 15:30:45",
  "season": {
    "name": "Türkiye Süper Lig 2023-2024",
    "week": 31,
    "total_weeks": 38
  },
  "standings": [
    {
      "position": 1,
      "name": "Galatasaray",
      "logo": "https://api.teknikzeka.net/tffpuandurumu/team_logos/Galatasaray.png",
      "stats": {
        "played": 31,
        "won": 25,
        "drawn": 3,
        "lost": 3,
        "goals_for": 68,
        "goals_against": 28,
        "goal_diff": 40,
        "points": 78
      }
    },
    // Diğer takımlar...
  ]
}

Yanıt Alanları

status: İşlem durumu (success veya error)
source: Veri kaynağı (db = veritabanı, web = web'den yeni çekilmiş)
last_updated: Son güncelleme tarihi (İstanbul saati, UTC+3)
season: Sezon bilgileri
- name: Sezon adı
- week: Mevcut hafta
- total_weeks: Toplam hafta sayısı
standings: Takımların puan durumu listesi
- position: Lig sıralaması
- name: Takım adı
- logo: Takım logosu URL'si
- stats: Takım istatistikleri
  - played: Oynanan maç sayısı
  - won: Galibiyet sayısı
  - drawn: Beraberlik sayısı
  - lost: Mağlubiyet sayısı
  - goals_for: Atılan gol sayısı
  - goals_against: Yenilen gol sayısı
  - goal_diff: Gol farkı
  - points: Puan

Hata Durumları

API bir sorunla karşılaştığında şu formatta yanıt döndürür:

json

{
  "status": "error",
  "message": "Hata mesajı burada görünür"
}

Olası hata mesajları:

"Veri bulunamadı ve yeni veri çekilemedi"
"Veritabanı bağlantısı kurulamadı"
"Logo klasörü oluşturulamadı"

Kod Örnekleri

JavaScript (Fetch API)

javascript

// Puan durumunu getir
fetch('https://api.teknikzeka.net/tffpuandurumu/api.php')
  .then(response => response.json())
  .then(data => {
    if (data.status === 'success') {
      console.log(`Güncel Puan Durumu (${data.last_updated})`);
      data.standings.forEach(team => {
        console.log(`${team.position}. ${team.name} - ${team.stats.points} puan`);
      });
    } else {
      console.error(`Hata: ${data.message}`);
    }
  })
  .catch(error => console.error('Bağlantı hatası:', error));

PHP

php

<?php
// Puan durumunu getir
$response = file_get_contents('https://api.teknikzeka.net/tffpuandurumu/api.php');
$data = json_decode($response, true);

if ($data['status'] === 'success') {
  echo "Güncel Puan Durumu ({$data['last_updated']})\n";
  foreach ($data['standings'] as $team) {
    echo "{$team['position']}. {$team['name']} - {$team['stats']['points']} puan\n";
  }
} else {
  echo "Hata: {$data['message']}\n";
}
?>

Python

python

import requests

# Puan durumunu getir
response = requests.get('https://api.teknikzeka.net/tffpuandurumu/api.php')
data = response.json()

if data['status'] == 'success':
    print(f"Güncel Puan Durumu ({data['last_updated']})")
    for team in data['standings']:
        print(f"{team['position']}. {team['name']} - {team['stats']['points']} puan")
else:
    print(f"Hata: {data['message']}")

Öneriler

API'yi çok sık çağırmaktan kaçının, günde birkaç kez yeterlidir
Zorla güncelleme (update=1) parametresini sadece gerektiğinde kullanın
Verileri kendi uygulamanızda önbelleğe almayı düşünün
Çektiğiniz verilerin telif haklarına saygı gösterin ve kaynağa atıfta bulunun

Bu API, Türkiye Süper Lig'inin resmi bir servisi değildir ve veriler https://api.teknikzeka.net adresinden alınmaktadır. Veriler güncelliğini yitirebilir, kontrol edilmelidir.