Tufanbeyli'de API dokümantasyonu

01Hangi durumlarda gerekir?

Entegrasyon talepleri tek tek karşılandığında

Standart bir API ve dokümantasyon, her iş ortağı için ayrı geliştirme yapma ihtiyacını azaltır.

Verinizi iş ortaklarına açmak istediğinizde

API dokümantasyonu ile veri, yetki ve kota kontrolüyle güvenli biçimde dış sistemlere sunulur.

Olaylar anlık bildirilmesi gerektiğinde

Webhook altyapısı imza doğrulama ve yeniden deneme ile kurulur.

02Belirtiler

• Kodu yazan kişiye veya firmaya ulaşılamaması
• Küçük bir değişikliğin başka yerleri bozması
• Dokümantasyon ve kurulum bilgisinin olmaması
• Hataların tekrar tekrar ortaya çıkması

03Hangi sistemlerde uygulanır?

• Yazılım şirketleri
• Veri sağlayıcıları
• Platform kuran girişimler
• Kurumsal BT ekipleri
• İş ortağı ekosistemi olan firmalar

04İş nasıl ilerler?

1. Kod, erişimler ve ortamlar üzerinde durum tespiti yapmak
2. Riskleri ve öncelikleri listelemek
3. Test ortamı ve sürüm kontrolünü düzene sokmak
4. Kritik hataları ve güvenlik açıklarını gidermek
5. Testleri ve dokümantasyonu tamamlamak
6. Düzenli bakım ve geliştirme planına geçmek

05Kapsam

• OpenAPI şeması
• örnek istekler
• kılavuz

Bu projeler çoğu zaman raporlama apı'si, bildirim servisi ve dosya ve medya servisi gibi işlerle birlikte ele alınır.

06Tufanbeyli'de API dokümantasyonu

Tufanbeyli'nin PTT verisindeki 33 yerleşim kaydı 2 farklı posta koduna dağılır. Birden fazla ilçede ekibi veya şubesi olan işletmelerde API dokümantasyonu için kullanıcı rolleri, şube bazlı görünürlük ve merkezi raporlar birlikte planlanır.

Tufanbeyli'de bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.

Adana genelinde Yüreğir, Karataş ve Sarıçam gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

07Çalışma düzenimiz

Projeler tasarım, yazılım geliştirme, test ve yayın adımlarını kapsayan bir ekiple yürütülür. Sürüm kontrolü (Git), otomatik testler (Playwright), konteyner tabanlı yayın (Docker), sürekli entegrasyon ve izleme araçları standart çalışma düzenimizin parçasıdır.

• Kaynak kod ve veri işletmeye teslim edilir.
• Yayın sonrası bakım ve destek planlanır.
• Kapsam ve teslim kriterleri yazılı olur.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Adana da bunlardan biri.

08Örnek hesap

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• OpenAPI şeması
• örnek istekler
• kılavuz
• API anahtarı
• geliştirici portalı
• SSO
• webhook
• Swagger
• OpenAPI
• OAuth 2.0
• Adana
• Tufanbeyli