Geliştiriciler & Meslek Liseleri

Açık API ile entegre edin

OKULBİS'in açık ve dokümante REST API'si ile okulunuzun ürettiği turnike, kart okuyucu ve IoT projelerini gerçek bir okul yönetim platformuyla konuşturun. Meslek liseleri öğrencilerinin kendi geliştirdikleri sistemleri canlı bir altyapıya bağlayarak öğrenmesi için ideal bir alan.

API Anahtarı Talep Et Dokümana Git

REST / JSON X-Api-Key güvenliği Webhook desteği

terminal — geçiş gönder

curl -X POST https://okul.okulbis.com/api/v1/gecis \
  -H "X-Api-Key: okb_live_••••" \
  -H "Content-Type: application/json" \
  -d '{
    "kart_no": "04A2B9C1",
    "yon": "giris",
    "cihaz_kodu": "TURNIKE-A1",
    "zaman": "2026-06-20T08:14:00"
  }'

# 200 OK
{ "durum": "kabul", "ogrenci": "Ayşe Demir", "sinif": "11-A" }

Yetenekler

API ile neler yapabilirsiniz?

Donanımınızdan gelen veriyi OKULBİS'e yazın, platformdaki bilgiyi sorgulayın, olaylara anlık tepki verin.

Geçiş / Yoklama Verisi Gönder

Turnike, kapı veya kart okuyucularınızdan gelen giriş-çıkış kayıtlarını gerçek zamanlı olarak sisteme aktarın.

Öğrenci / Personel Sorgula

Kart numarasıyla öğrenci veya personel bilgisini anında çözün; cihazınızda ad, sınıf ve yetki gösterin.

Webhook ile Olay Al

Devamsızlık, geç giriş veya yetkisiz erişim gibi olaylar gerçekleştiğinde sistem sizi anında bilgilendirsin.

Cihaz Kaydı

Her turnike, okuyucu ya da panel için ayrı cihaz kodu tanımlayın; veriyi kaynağına göre izleyin.

Devamsızlık Entegrasyonu

Geçiş kayıtları otomatik olarak yoklamaya dönüşsün; devamsızlık süreçleri elle giriş gerektirmesin.

Test Ortamı

Canlı veriye dokunmadan deneyin: okb_test_ anahtarıyla ayrı test ortamında geliştirin.

Kimlik Doğrulama

X-Api-Key ile basit ve güvenli

Tüm isteklerinizi X-Api-Key başlığı ile imzalarsınız. Anahtarınız okulunuza özeldir; yalnızca kendi kurumunuzun verisine erişir ve istediğiniz zaman panelden yenilenebilir.

Anahtar başına yetki ve hız sınırı tanımlanabilir
Canlı (okb_live_) ve test (okb_test_) ayrımı
Tüm trafik TLS ile şifrelenir
Şüpheli durumda anahtar tek tıkla iptal edilir

 İstek başlıkları
                    

GET /api/v1/ogrenci/04A2B9C1 HTTP/1.1
Host: okul.okulbis.com
X-Api-Key: okb_live_3f8c2a9b4e1d
Accept: application/json

Anahtarınızı istemci tarafına gömmeyin; cihaz yazılımında güvenli depolama kullanın.

Referans

API uçları

Çekirdek uçlar; tüm istekler https://okul.okulbis.com tabanı üzerinden çağrılır.

Metod	Yol	Açıklama
POST	/api/v1/gecis	Turnike/kapı geçiş kaydı oluşturur; öğrenci doğrulaması ile geri döner.
GET	/api/v1/ogrenci/{kartNo}	Kart numarasından öğrenci bilgisini (ad, sınıf, durum) sorgular.
POST	/api/v1/yoklama	Toplu yoklama kaydı gönderir; ders saatine göre devamsızlığı işler.
POST	/api/v1/webhook-kayit	Olay bildirimleri için webhook adresi ve dinlenecek olayları kaydeder.

JSON

İstek ve yanıt gövdeleri standart JSON; tüm zamanlar ISO 8601.

REST

HTTP metodları ve durum kodları beklendiği gibi davranır.

Sürümlenmiş uçlar; geriye dönük uyumluluk korunur.

Örnek

İstek ve yanıt

Toplu yoklama gönderimi ve sistemin döndürdüğü örnek yanıt.

 İstek — POST /api/v1/yoklama
                

{
  "ders_saati": "2026-06-20T09:00:00",
  "sube": "11-A",
  "kayitlar": [
    { "kart_no": "04A2B9C1", "durum": "var" },
    { "kart_no": "04C7E0F2", "durum": "yok" }
  ]
}

 Yanıt — 200 OK
                

{
  "durum": "basarili",
  "islenen": 2,
  "devamsiz": 1,
  "sonuclar": [
    { "kart_no": "04A2B9C1", "ad": "Ayşe Demir" },
    { "kart_no": "04C7E0F2", "ad": "Mert Kaya" }
  ]
}

Uygulamalı Eğitim

Öğrenci turnike projesini geliştirir

Atölyede kart okuyucu ve mikrodenetleyici ile kendi geçiş sistemini kurar.

API anahtarı alınır

Okul, panelden test anahtarı üretir; öğrenci canlı veriye dokunmadan dener.

Cihaz OKULBİS'e bağlanır

Geçişler gerçek yoklamaya dönüşür; öğrenci entegrasyonu uçtan uca öğrenir.

Meslek Lisesi Senaryosu

Öğrenciler kendi projelerini gerçek platforma bağlar

Bilişim, elektrik-elektronik ve mekatronik alanlarındaki öğrenciler; geliştirdikleri turnike, kart okuyucu ve güvenlik sistemlerini OKULBİS'in açık API'si üzerinden gerçek bir okul yönetim platformuna bağlayabilir. Bu sayede yalnızca donanım değil; kimlik doğrulama, veri sözleşmesi ve canlı sistem entegrasyonu gibi profesyonel becerileri de uygulayarak öğrenirler.

Test ortamı ile risksiz deneme
Gerçek yoklama ve devamsızlık akışına bağlanma
Bitirme projeleri için somut, sunulabilir çıktı

Başlayın

API erişimi okul lisansınıza dahil

OKULBİS kullanan okullar ek ücret ödemeden API erişimi alır. Aşağıdaki formu doldurun; ekibimiz okulunuza özel test ve canlı anahtarlarınızı oluşturup teknik dokümanla birlikte iletsin.

Test ve canlı anahtar birlikte verilir
Örnek istek koleksiyonu ve doküman paylaşılır
Entegrasyon sürecinde teknik destek sağlanır

API anahtarı talep edin

Okulunuz ve projeniz hakkında kısa bilgi bırakın; sizi arayalım.

API erişimi okul lisansınıza dahildir

Anahtarınızı talep edin; turnike, yoklama ve cihaz entegrasyonlarınızı bugün geliştirmeye başlayın.

API Anahtarı Talep Et Uçları İncele