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?
- Kurumsal BT ekipleri
- İş ortağı ekosistemi olan firmalar
- Yazılım şirketleri
- Platform kuran girişimler
07İşletim ve bakım ipuçları
- Hata oranı ve yanıt süresi uç nokta bazında izlenir.
- Eski API sürümleri için kullanım dışı bırakma takvimi duyurulur.
- Anahtarların sızıntıya karşı taranması ve yenilenmesi planlanır.
08Kapsamı ve maliyeti etkileyenler
- beklenen trafik ve ölçekleme ihtiyacı
- izleme ve destek düzeyi
- kota, faturalama ve kullanım ölçümü
- dokümantasyon ve geliştirici portalı kapsamı
09Yomra'da planlama
PTT kayıtlarında Yomra ilçesine bağlı 25 yerleşim bulunur. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için API dokümantasyonu tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.
Mesafe yazılım işinin önünde engel değildir: Yomra'daki 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.
Trabzon genelinde Maçka, Ortahisar ve Tonya gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.
Yomra bölgesinden API dokümantasyonu talebiniz için 0540 003 19 81 numarasını arayabilir veya teklif formunu doldurabilirsiniz.
SSSSık sorulan sorular
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.
Sadece Trabzon için mi çalışıyorsunuz?
Evet. Askadar Yazılım, Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışır; gerektiğinde yerinde çalışma ayrıca planlanı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.
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.
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.
Yedeği kim alır?
Erişim verildiyse yedeği biz alırız; mevcut hosting yedeği varsa ayrıca doğrulanır.
Yomra'da yüz yüze görüşebilir miyiz?
Analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; donanım kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.
→İlgili sayfalar
API Dokümantasyonu hakkında diğer konular
- API dokümantasyonu sorunları ve belirtileriHangi belirti neyi gösterir
- API dokümantasyonu kontrol listesiAdım adım kontrol listesi
- API dokümantasyonu tespit ve analizSorunun nasıl tespit edildiği
- API dokümantasyonu: kendin yap mı, uzman mı?Kendi yapılabilenler ve uzman gerektirenler
- API dokümantasyonu sık yapılan hatalarKaçınılması gerekenler
Yomra'da ilgili hizmetler
Trabzon içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- OpenAPI şeması
- örnek istekler
- kılavuz
- API anahtarı
- geliştirici portalı
- SSO
- rate limit
- OpenAPI
- webhook
- Trabzon
- Yomra