API başvurusu

Tüm uç noktalar: https://modelen.tr/api/v1. Anahtarlı uç noktalar Authorization: Bearer mdl_... ister; "Herkese açık" olanlar anahtarsız çağrılır ve CORS'a açıktır.

GET `/saglik`#

Sağlık denetimi · Genel · anahtarsız

Yanıtlar:

HTTP	Anlamı
200	Servis ayakta

200 yanıt alanları:

Alan	Tür	Zorunlu	Açıklama
`durum`	string
`zaman`	integer

GET `/koordinatorler`#

Onaylı koordinatörleri listele · Herkese açık · anahtarsız

Yalnızca yöneticilerin onayladığı koordinatörler. 60 sn önbelleğe alınabilir. CORS açık.

Yanıtlar:

HTTP	Anlamı
200	Liste

200 yanıt alanları:

Alan	Tür	Zorunlu	Açıklama
`surum`	integer
`guncelleme`	string
`koordinatorler`	array

GET `/koordinatorler/{slug}`#

Bir koordinatörün herkese açık ayrıntısı · Herkese açık · anahtarsız

Yol parametresi: slug

Yanıtlar:

HTTP	Anlamı
200	Koordinatör
404	Yok ya da onaylı değil

200 yanıt alanları:

Alan	Tür	Zorunlu	Açıklama
`slug`	string
`ad`	string
`aciklama`	string
`adres`	string
`adres_dogrulandi`	boolean
`hf`	string
`baglanti`	string
`nabiz`	NabizDurumu
`sayfa`	string

GET `/ben`#

Anahtar sahibi hesap · Hesap · anahtar gerekli

Yanıtlar:

HTTP	Anlamı
200	Hesap
401	Anahtar yok ya da geçersiz
429	Hız sınırı aşıldı

200 yanıt alanları:

Alan	Tür	Zorunlu	Açıklama
`id`	integer
`ad`	string
`eposta`	string
`eposta_dogrulandi`	boolean
`rol`	string
`koordinator`	object

GET `/koordinator`#

Kendi koordinatör kaydım · Koordinatör · anahtar gerekli

Yanıtlar:

HTTP	Anlamı
200	Kayıt
404	Başvuru yok
401	Anahtar yok ya da geçersiz
429	Hız sınırı aşıldı

200 yanıt alanları:

Alan	Tür	Açıklama
`slug`	string
`ad`	string	Proje / koordinatör adı en az 2 karakter, en çok 60 karakter
`kisa`	string	Listelerde görünen kısa açıklama en az 10 karakter, en çok 200 karakter
`ayrinti`	string	Herkese açık ayrıntılı açıklama (düz metin) en çok 5000 karakter
`baglanti`	string	Web sitesi ya da depo (http/https) en çok 200 karakter
`adres`	string	Koordinatör adresi (https); boş olabilir en çok 200 karakter
`hf`	string	Hugging Face bağlantısı (huggingface.co / hf.co) en çok 200 karakter
`iletisim`	string	Yalnızca yöneticilere görünen iletişim e-postası en çok 120 karakter
`durum`	string (beklemede \| onaylandi \| reddedildi \| askida)
`yonetici_notu`	string
`taslak_var`	boolean	Onaylı profilde onay bekleyen düzenleme var
`adres_dogrulandi`	boolean
`gorsel_sayisi`	integer
`sayfa`	string	Onaylıysa herkese açık sayfa
`nabiz`	NabizDurumu

POST `/koordinator`#

Koordinatör başvurusu oluştur · Koordinatör · anahtar gerekli

E-posta doğrulanmış olmalı. ad ve kisa zorunlu. Başvuru yönetici onayına düşer.

İstek gövdesi (JSON):

Alan	Tür	Açıklama
`ad`	string	Proje / koordinatör adı en az 2 karakter, en çok 60 karakter
`kisa`	string	Listelerde görünen kısa açıklama en az 10 karakter, en çok 200 karakter
`ayrinti`	string	Herkese açık ayrıntılı açıklama (düz metin) en çok 5000 karakter
`baglanti`	string	Web sitesi ya da depo (http/https) en çok 200 karakter
`adres`	string	Koordinatör adresi (https); boş olabilir en çok 200 karakter
`hf`	string	Hugging Face bağlantısı (huggingface.co / hf.co) en çok 200 karakter
`iletisim`	string	Yalnızca yöneticilere görünen iletişim e-postası en çok 120 karakter

Yanıtlar:

HTTP	Anlamı
201	Oluşturuldu
400	Doğrulama hatası
403	E-posta doğrulanmamış
409	Zaten başvuru var
401	Anahtar yok ya da geçersiz
429	Hız sınırı aşıldı

201 yanıt alanları:

Alan	Tür	Açıklama
`slug`	string
`ad`	string	Proje / koordinatör adı en az 2 karakter, en çok 60 karakter
`kisa`	string	Listelerde görünen kısa açıklama en az 10 karakter, en çok 200 karakter
`ayrinti`	string	Herkese açık ayrıntılı açıklama (düz metin) en çok 5000 karakter
`baglanti`	string	Web sitesi ya da depo (http/https) en çok 200 karakter
`adres`	string	Koordinatör adresi (https); boş olabilir en çok 200 karakter
`hf`	string	Hugging Face bağlantısı (huggingface.co / hf.co) en çok 200 karakter
`iletisim`	string	Yalnızca yöneticilere görünen iletişim e-postası en çok 120 karakter
`durum`	string (beklemede \| onaylandi \| reddedildi \| askida)
`yonetici_notu`	string
`taslak_var`	boolean	Onaylı profilde onay bekleyen düzenleme var
`adres_dogrulandi`	boolean
`gorsel_sayisi`	integer
`sayfa`	string	Onaylıysa herkese açık sayfa
`nabiz`	NabizDurumu

PATCH `/koordinator`#

Koordinatör bilgilerini güncelle · Koordinatör · anahtar gerekli

Yalnızca gönderilen alanlar değişir. İncelemedeki/reddedilmiş başvuruda doğrudan, onaylı profilde taslak olarak kaydedilir ve yönetici onayından sonra yayına girer (202). Adres değişirse doğrulama sıfırlanır.

İstek gövdesi (JSON):

Alan	Tür	Açıklama
`ad`	string	Proje / koordinatör adı en az 2 karakter, en çok 60 karakter
`kisa`	string	Listelerde görünen kısa açıklama en az 10 karakter, en çok 200 karakter
`ayrinti`	string	Herkese açık ayrıntılı açıklama (düz metin) en çok 5000 karakter
`baglanti`	string	Web sitesi ya da depo (http/https) en çok 200 karakter
`adres`	string	Koordinatör adresi (https); boş olabilir en çok 200 karakter
`hf`	string	Hugging Face bağlantısı (huggingface.co / hf.co) en çok 200 karakter
`iletisim`	string	Yalnızca yöneticilere görünen iletişim e-postası en çok 120 karakter

Yanıtlar:

HTTP	Anlamı
200	Güncellendi
202	Taslak olarak kaydedildi (onay bekliyor)
400	Doğrulama hatası
404	Başvuru yok
409	Askıda
401	Anahtar yok ya da geçersiz
429	Hız sınırı aşıldı

200 yanıt alanları:

Alan	Tür	Açıklama
`slug`	string
`ad`	string	Proje / koordinatör adı en az 2 karakter, en çok 60 karakter
`kisa`	string	Listelerde görünen kısa açıklama en az 10 karakter, en çok 200 karakter
`ayrinti`	string	Herkese açık ayrıntılı açıklama (düz metin) en çok 5000 karakter
`baglanti`	string	Web sitesi ya da depo (http/https) en çok 200 karakter
`adres`	string	Koordinatör adresi (https); boş olabilir en çok 200 karakter
`hf`	string	Hugging Face bağlantısı (huggingface.co / hf.co) en çok 200 karakter
`iletisim`	string	Yalnızca yöneticilere görünen iletişim e-postası en çok 120 karakter
`durum`	string (beklemede \| onaylandi \| reddedildi \| askida)
`yonetici_notu`	string
`taslak_var`	boolean	Onaylı profilde onay bekleyen düzenleme var
`adres_dogrulandi`	boolean
`gorsel_sayisi`	integer
`sayfa`	string	Onaylıysa herkese açık sayfa
`nabiz`	NabizDurumu

POST `/koordinator/nabiz`#

Nabız (çalışıyorum) bildirimi · Koordinatör · anahtar gerekli

Onaylı koordinatörler en geç 15 dakikada bir göndermelidir; herkese açık sayfada "çevrimiçi" görünürsünüz. En çok dakikada 6 istek.

İstek gövdesi (JSON):

Alan	Tür	Zorunlu	Açıklama
`durum`	string (calisiyor \| bekliyor \| bakimda \| durdu)	evet
`tur`	integer		en az 0
`toplam_tur`	integer		en az 0
`aktif_isci`	integer		en az 0
`protokol`	string		en çok 10 karakter
`surum`	string		en çok 30 karakter
`mesaj`	string		en çok 120 karakter

Yanıtlar:

HTTP	Anlamı
200	Kaydedildi
400	Geçersiz gövde
403	Onaylı koordinatör değil
401	Anahtar yok ya da geçersiz
429	Hız sınırı aşıldı

POST `/koordinator/adres-dogrula`#

Adres doğrulamasını başlat · Koordinatör · anahtar gerekli

Adresinizi kontrol ettiğinizi kanıtlamak için döndürülen içeriği /.well-known/modelen-dogrulama.txt yoluyla yayınlayın, sonra /kontrol uç noktasını çağırın.

Yanıtlar:

HTTP	Anlamı
200	Talimat
400	Adres yok ya da https değil
404	Başvuru yok
401	Anahtar yok ya da geçersiz
429	Hız sınırı aşıldı

200 yanıt alanları:

Alan	Tür	Açıklama
`adres`	string
`dosya`	string	Bu adreste yayınlanmalı
`icerik`	string	Dosyanın tek satırlık içeriği

POST `/koordinator/adres-dogrula/kontrol`#

Adres doğrulamasını kontrol et · Koordinatör · anahtar gerekli

Portal adresinizi (yalnızca genel internetteki https adreslerini) okur ve içeriği karşılaştırır. 10 dakikada en çok 10 deneme.

Yanıtlar:

HTTP	Anlamı
200	Doğrulandı
422	Dosya yok ya da içerik uyuşmuyor
400	Önce doğrulamayı başlatın
401	Anahtar yok ya da geçersiz
429	Hız sınırı aşıldı

200 yanıt alanları:

Alan	Tür	Zorunlu	Açıklama
`adres_dogrulandi`	boolean

Hata biçimi#

Tüm hatalar şu biçimdedir; kod makine okunur, hata insan okunurdur:

{"hata": "Geçerli bir API anahtarı gerekli (Authorization: Bearer mdl_...).", "kod": "yetkisiz"}

API başvurusu

GET /saglik#

GET /koordinatorler#

GET /koordinatorler/{slug}#

GET /ben#

GET /koordinator#

POST /koordinator#

PATCH /koordinator#

POST /koordinator/nabiz#

POST /koordinator/adres-dogrula#

POST /koordinator/adres-dogrula/kontrol#

Hata biçimi#

GET `/saglik`#

GET `/koordinatorler`#

GET `/koordinatorler/{slug}`#

GET `/ben`#

GET `/koordinator`#

POST `/koordinator`#

PATCH `/koordinator`#

POST `/koordinator/nabiz`#

POST `/koordinator/adres-dogrula`#

POST `/koordinator/adres-dogrula/kontrol`#