01İstenecek erişimler
- Kaynak kod deposu
- Sunucu ve veritabanı erişimi
- Varsa mevcut dokümanlar ve hata kayıtları
- Uygulamanın kritik iş akışlarının listesi
02Tam yedek
İşe başlamadan önce dosya ve veritabanının tam yedeği alınır ve yedeğin açıldığı doğrulanır. Yedek, çalışılan sunucudan farklı bir yerde saklanır.
03Belirti, neden ve çözüm
| Belirti | Olası neden | Çözüm |
|---|---|---|
| İş ortakları API'yi yanlış kullanıyor | Dokümantasyon eksik veya güncel değil | OpenAPI şeması, örnek istekler ve sürüm notları |
| API yoğunlukta yavaşlıyor | Kota ve önbellek yok, sorgular optimize değil | Oran sınırı, önbellek ve sorgu iyileştirme |
| Webhook bildirimleri kayboluyor | Yeniden deneme ve teslim kaydı yok | İmzalı webhook, kuyruk ve teslim logu |
| Eski sürümü kullananlar bozuluyor | Sürümleme ve geçiş takvimi yok | Sürümlü uç noktalar ve duyurulu kullanım dışı bırakma |
04Bakım penceresi
Canlı ortamı etkileyecek adımlar, kullanımın en düşük olduğu saatlere planlanır ve önceden duyurulur; gerekirse ziyaretçilere bakım sayfası gösterilir.
05Hazırlık kontrol listesi
- Erişim bilgileri tek bir güvenli listede
- Son değişikliklerin tarihi ve açıklaması
- Kritik sayfa ve işlemlerin listesi
- Sorumlu kişinin iletişim bilgisi
06API dokümantasyonu hangi işletmelerde kullanılır?
- Platform kuran girişimler
- Yazılım şirketleri
- İş ortağı ekosistemi olan firmalar
- Kurumsal BT ekipleri
07Hangi durumlarda gündeme gelir?
Kılavuz gerektiğinde
Kılavuz, API dokümantasyonu projesinde kapsamın başında konuşulan başlıklardandır; analizde kimin kullanacağı ve nasıl çalışacağı netleştirilir.
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.
08Planlama notları
- kimlik doğrulama (API anahtarı, OAuth 2.0)
- oran sınırı ve kota
- webhook imza doğrulaması
09Bitlis'te planlama
Bitlis, Doğu Anadolu Bölgesi'nde yer alan, plaka kodu 13 olan bir ildir; PTT verisine göre 7 ilçe ve 744 mahalle ve köy kaydından oluşur.
Mesafe yazılım işinin önünde engel değildir: Bitlis'teki ekiplerle görüntülü görüşme, ekran paylaşımı ve test ortamı bağlantısıyla çalışılır; cihaz kurulumu veya saha keşfi gerekirse yerinde ziyaret planlanır.
Doğu Anadolu Bölgesi'ndeki Muş, Erzurum ve Elazığ gibi illerdeki işletmelerle de toplantılar uzaktan yapılır.
Bitlis bölgesinden API dokümantasyonu talebiniz için 0540 003 19 81 numarasını arayabilir veya teklif formunu doldurabilirsiniz.
SSSSık sorulan sorular
Bitlis dışındaki işletmelere de hizmet veriyor musunuz?
Evet. Askadar Yazılım, Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışır; gerektiğinde yerinde çalışma ayrıca planlanır.
Yedeği kim alır?
Erişim verildiyse yedeği biz alırız; mevcut hosting yedeği varsa ayrıca doğrulanır.
API dokümantasyonu öncesinde neleri hazırlamalıyım?
Kaynak kod deposu, sunucu ve veritabanı erişimi ve varsa mevcut dokümanlar ve hata kayıtları işi hızlandırır.
API'yi kimlerin kullandığını nasıl izleriz?
Her istemciye ayrı anahtar veya OAuth istemcisi verilir; kullanım, hata ve kota tüketimi istemci bazında raporlanır.
Erişim bilgilerini nasıl paylaşmalıyım?
Parolaları açık metin olarak e-postayla göndermek yerine geçici kullanıcı açmak veya güvenli bir parola paylaşım aracı kullanmak önerilir; iş bitince erişim kapatılır.
Bitlis'te bulunuyorum, yerinde görüşme mümkün mü?
İşin büyük bölümü uzaktan yürür: ilk görüşme telefonla, sonraki toplantılar görüntülü yapılır. Kurulum ya da eğitim gerekiyorsa yerinde çalışma takvime eklenir.
API dokümantasyonu sırasında site veya uygulama kapanır mı?
Hazırlık test ortamında yapılır; canlı ortamdaki değişiklik önceden haber verilen kısa bir bakım penceresinde uygulanır.
→İlgili sayfalar
API Dokümantasyonu hakkında diğer konular
- API dokümantasyonu tespit ve analizSorunun nasıl tespit edildiği
- API dokümantasyonuTespit, uygulama ve teslim
- API dokümantasyonu: kendin yap mı, uzman mı?Kendi yapılabilenler ve uzman gerektirenler
- API dokümantasyonu fiyatlarıMaliyeti belirleyenler
- API dokümantasyonu kontrol listesiAdım adım kontrol listesi
Bitlis'te ilgili hizmetler
Doğu Anadolu Bölgesi'ndeki diğer iller
Bu sayfada geçen kavramlar
- OpenAPI şeması
- örnek istekler
- kılavuz
- API anahtarı
- geliştirici portalı
- SSO
- Swagger
- OAuth 2.0
- OpenAPI
- Bitlis