Genel Bakış

Ordo, tasarruf finansmanı şirketleri için olay kaynaklı (event-sourced) bir çekirdek sistemdir. Bu portal, platformla entegrasyon geliştiren ekipler içindir: REST API referansı, temel kavramlar ve ortam bilgileri burada yaşar. Platformun teknik kod adı TFS’dir — URL’ler, paket adları ve depo adları bu kodu taşır; ürünün adı Ordo’dur.

Hızlı başlangıç

Ortamlar

Staging API adresi, sürümleme ve istek kuralları. Ortamlara gidin

Kimlik doğrulama

Keycloak üzerinde OIDC: Authorization Code + PKCE ve izin kodları. Kimlik doğrulamayı okuyun

Hata sözleşmesi

messageCode, severity, traceId ve üç dilli mesaj kataloğu. Hata sözleşmesini okuyun

API Referansı

Taraflardan kuraya, teslimattan gün sonuna tüm uçlar. Referansa gidin

Tasarım sistemi

Token tabloları, bileşen envanteri, yerleşim desenleri, işaret ve yazı markası. Tasarım sistemine gidin

Teknik sunum

Mimariden kuruluma 33 slaytlık teknik sunum; tarayıcıdan sunulur, anahtar gerekir. Sunumu açın

API’nin şekli

Temel adres (staging): https://tfs-api.karyabilisim.com
Sürümleme: Tüm iş uçları /api/v1/... altındadır; herkese açık uçlar /api/public/... altındadır.
Biçim: JSON istek/yanıt, UTF-8. Tarihler ISO 8601 (2026-08-26), zaman damgaları RFC 3339.
Para: Tüm tutarlar minor unit (kuruş) cinsinden tam sayıdır. 1250000 = 12.500,00 TL. Ayrıntı: Para ve minor unit.
Uyumluluk: API sözleşmeleri için N-5 küçük sürüm geriye dönük uyumluluk taahhüdü verilir.

Önemli tasarım ilkeleri

Türetilen değer gönderilmez. Finansman tutarı, tahsis puanı, havuz bakiyesi gibi değerler platform tarafından hesaplanır; API bunları girdi olarak kabul etmez.
Her yanıt izlenebilir. Tüm yanıtlar bir traceId taşır; destek taleplerinde bu kimliği paylaşın.
Kurallar sürümlüdür. Bir sözleşmenin matematiği, kuruluş anında sabitlenen kural seti sürümüyle hesaplanır. Bkz. Kural setleri ve sabitlenmiş sürümler.