Geliştirici Belgeleri

👋 Tanıtım

Rehber Plus API; öğrenci, danışman, kurum, soru bankası, BEP ve mesajlaşma verilerine programatik erişim sağlar. Tüm endpoint’ler HTTPS üzerinden yayındır; JSON gövde formatı kullanılır.

Base URL: https://api.rehberplus.com/v1
Format: application/json; charset=utf-8
Rate Limit: 60 istek/dakika (token başına)
Zaman Damgaları: ISO-8601, UTC

🧱 Teknoloji Yığını

Rehber Plus’ın altyapısında kullanılan başlıca teknolojiler:

📱

İstemci

Flutter

🔥

Backend

Firebase

🐘

Web API

PHP 8.2

🗄️

Veritabanı

MySQL 8

🎥

RTC

Jitsi Meet

⚡

Önbellek

Redis

🔐 Kimlik Doğrulama

Tüm istekler Authorization: Bearer <token> başlığı gerektirir. Token, geliştirici panelinden 60 dakika geçerli kısa ömürlü ya da 12 ay geçerli uzun ömürlü (kurum) olarak oluşturulabilir.

# Token alma
POST /v1/auth/token
Content-Type: application/json

{
  "client_id": "rp_xxxxxxxx",
  "client_secret": "sk_xxxxxxxxxxxx",
  "grant_type": "client_credentials"
}

client_secret değerini asla istemci tarafı kodda saklamayın; backend’den proxy edin.

📡 Endpoint Listesi

En çok kullanılan endpoint’ler:

GET

/api/v1/students — Öğrenci listesi

GET

/api/v1/students/{id} — Tek öğrenci detayı

POST

/api/v1/students — Yeni öğrenci oluştur

PUT

/api/v1/students/{id} — Öğrenci güncelle

DELETE

/api/v1/students/{id} — Öğrenci sil

POST

/api/v1/bep/generate — BEP otomatik üret

GET

/api/v1/questions — Soru bankası filtrele

POST

/api/v1/messages — Mesaj gönder

POST

/api/v1/webhooks — Webhook kaydet

💡 Örnek İstekler

Aşağıda en yaygın senaryolar için örnek cURL ve JSON yanıtları yer alır.

Öğrenci listesi al

curl -X GET "https://api.rehberplus.com/v1/students?limit=20" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Başarılı yanıt (200)

{
  "data": [
    {
      "id": 10421,
      "name": "Ahmet Yılmaz",
      "grade": "12-SAY",
      "consultant_id": 42,
      "created_at": "2026-05-14T08:42:11Z"
    }
  ],
  "meta": { "total": 128, "page": 1 }
}

⚠️ Hata Kodları

API yanıtları standart HTTP durum kodlarını kullanır.

Kod	Anlamı	Açıklama
`400`	Bad Request	Geçersiz istek gövdesi veya eksik alan
`401`	Unauthorized	Token eksik, hatalı veya süresi dolmuş
`403`	Forbidden	İlgili kaynak için rol yetkiniz yok
`404`	Not Found	Belirtilen kaynak bulunamadı
`429`	Too Many Requests	Rate limit aşıldı (60 ist./dk)
`500`	Server Error	Beklenmedik sunucu hatası

🪝 Webhooks

Sisteminizdeki belirli olaylarda Rehber Plus’ın belirttiğiniz URL’ye POST isteği göndermesini sağlayabilirsiniz. Olay listesinden seçtiklerinize abone olun.

student.created — Yeni öğrenci kaydı
bep.completed — BEP dönem sonu raporu hazır
payment.received — Tahsilat alındı
message.received — Mesaj alındı

# Örnek webhook payload
{
  "event": "student.created",
  "id": "evt_01H...",
  "created_at": "2026-05-18T14:02:31Z",
  "data": { "student_id": 10522 }
}

📦 SDK & Kütüphaneler

Resmi SDK’larımızı kullanarak entegrasyonu hızlandırabilirsiniz:

PH

PHP

v1.4.0

NO

Node.js

v1.3.2

PY

Python

v1.2.0

DA

Dart / Flutter

v0.9.1

📋 Sürüm Notları

Son güncellemeler ve geriye dönük uyumluluk notları.

v1.4.0 — 12 Mayıs 2026

BEP otomatik üretim endpoint’i eklendi: POST /api/v1/bep/generate
Webhook hata yeniden deneme stratejisi (3 deneme, exponential backoff)
Rate limit başlıkları yanıtlara eklendi (X-RateLimit-*)

v1.3.0 — 18 Mart 2026

Soru bankası filtreleme: konu, zorluk, kaynak parametreleri
Yeni mesajlaşma endpoint’i: POST /api/v1/messages