Frontend ekibiniz tıkandı. Tasarım onaylandı, ekranlar yarıda kaldı ve önünüzdeki tek engel henüz var olmayan bir API. Backend henüz bir sprint uzakta, bu yüzden UI'ın çağıracak gerçek bir şeyi yok. Olağan geçici çözüm yerel bir taklittir ve dizüstü bilgisayarınızı kapatana kadar doğru çalışır. Sonra başka bir saat dilimindeki ekip arkadaşınızın kullandığı uç nokta karanlığa gömülür.
Bu boşluğu Apidog, Cloud Mock ile kapatıyor. Tek bir makinede yaşayıp ölen bir taklit yerine, mock.apidog.com adresinde 7/24 aktif kalan herkese açık bir URL alırsınız. Frontend, QA ve iş ortağı geliştiriciler, tek bir satır backend kodu yayınlanmadan önce gerçekçi uç noktalara erişebilirler. Bir ekibe taklit kullanımının ne kazandırdığına dair daha geniş bir bakış açısı isterseniz, API taklitinin ne olduğu ve ne zaman kullanılacağına dair başlangıç rehberimiz size yol gösterecektir. Herkese açık bir taklit URL'sinin istek işleme sürecine nasıl uyduğunun mekaniği için ise, HTTP istek/yanıt modeli üzerine MDN referansı sağlam bir tazeleyici olacaktır.
Cloud Mock Nedir ve Yerel Taklitler Neden Yetersiz Kalır?
Apidog, tasarladığınız her API için bir taklit uç nokta oluşturur. Varsayılan olarak bu taklit yerel bir taklittir: Apidog örneğiniz üzerinden çalışır ve makineniz açıkken yanıt verir. Kapatır kapatmaz, uç nokta yanıt vermeyi durdurur. Bu, tek başına hata ayıklama için sorun değildir. Ancak başkası URL'ye bağımlı olduğunda anında çöker.
Cloud Mock çözüm budur. Herhangi bir kişisel makineden bağımsız olarak sürekli erişilebilir bir taklit uç noktadır. Ekip arkadaşlarınızın bilgisayarları kapalı olabilir, dizüstü bilgisayarınız çantada olabilir ve bulut taklidi 7/24 isteklere yanıt vermeye devam eder. Uç nokta Apidog'un barındırılan hizmetinde bulunur, bu nedenle kullanılabilirlik kimin çevrimiçi olduğuna bağlı değildir.
Pratik getirisi temiz bir devirdir. Sözleşmeyi tasarlar, Cloud Mock'u açar ve tek bir URL paylaşırsınız. Frontend gerçekçi verilere göre geliştirme yapar, QA gerçek yanıt şekillerine göre test senaryoları yazar ve sizinle entegre olan bir iş ortağı istemcisini hemen bağlamaya başlayabilir. Kimse backend'i beklemez ve kimse sizin bir süreci çalışır halde tutmanızı beklemez. Bunu bölgeler arası koordine ediyorsanız, küresel ekiplerle taklit sunucuları ve ortamları paylaşma konulu makaledeki desenler iş akışını daha derinlemesine ele almaktadır.
Cloud Mock'u Etkinleştirin ve Herkese Açık URL'nizi Alın
Bunu gerçekçi bir API ile inceleyelim. Diyelim ki müşteri kayıtlarının bir listesini döndüren GET /users uç noktasına sahip bir users hizmeti oluşturuyorsunuz. Bunu paylaşılabilir bir bulut uç noktasına nasıl dönüştüreceğiniz aşağıda açıklanmıştır.
Adım 1: Cloud Mock'u açın
Projenizi açın ve Proje Ayarları > Özellik Ayarları > Taklit Ayarları'na gidin. Cloud Mock'u açın. Bu, Apidog'a taklitlerinizi yalnızca yerel olarak sunmak yerine her zaman açık hizmetinde barındırmasını söyleyen anahtardır.
Bunu her proje için yalnızca bir kez yaparsınız. Açıldıktan sonra, projedeki her uç nokta yerel URL'sinin yanında bir bulut taklit URL'si alır.
Adım 2: Bulut taklit URL'sini kopyalayın
Paylaşmak istediğiniz uç noktayı açın, bu durumda GET /users. Taklit sekmesine gidin ve Bulut Taklit URL'sini kopyalayın. Şuna benzer bir şey alacaksınız:
https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi
Yol yapısı belirli bir deseni izler: mock.apidog.com/m1/<projectId>-<num>-<env>/<path>. Apidog bunu sizin için oluşturur, bu yüzden elle derlemeniz gerekmez. Belgelerin bunu sabit bir şablon yayınlamak yerine örnekle gösterdiğini unutmayın, bu nedenle kendiniz bir URL oluşturmaya çalışmak yerine kopyalanan URL'yi doğruluk kaynağı olarak kabul edin.
Adım 3: Takliti Apidog içinde anında test edin
URL'yi kimseye vermeden önce, beklediğiniz şeyi döndürdüğünü doğrulayın. Aynı Taklit sekmesinde, taklit URL'sine karşı bir test isteği gönderin. Apidog isteği ateşler ve yanıtı size hemen orada gösterir. Oluşturulan verilerin doğru görünüp görünmediğine dair anında bir okuma alırsınız.
Bir GET /users taklidi şöyle dönebilir:
[
{
"id": 1,
"name": "Amelia Turner",
"email": "amelia.turner@example.com",
"city": "Portland"
},
{
"id": 2,
"name": "Marcus Bell",
"email": "marcus.bell@example.com",
"city": "Austin"
}
]
Bu değerler sabit kodlu değildir. Apidog, şemanızın alan adlarını ve türlerini okur ve eşleşecek makul veriler üretir; bu da takliti gerçek görünümlü bir tablo oluşturan bir frontend için faydalı kılar.
Adım 4: URL'yi bir tarayıcıda açın
Bir GET isteği için bulut taklit URL'si doğrudan bir web tarayıcısında çalışır. Adres çubuğuna yapıştırın ve JSON yanıtını göreceksiniz. Bu, teknik olmayan bir paydaşa verebileceğiniz en hızlı sağlamlık kontrolüdür: istemci yok, curl yok, yalnızca veri döndüren bir bağlantı.
Hızlı bir göz atmanın ötesinde her şey için, frontend'iniz bunu diğer tüm uç noktalar gibi çağırır:
curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
Döngünün tamamı bu. Uç noktayı tasarlayın, Cloud Mock'u etkinleştirin, URL'yi kopyalayın ve ekibinizin engeli kalksın.
Takliti token kimlik doğrulamasıyla kilitleyin
Herkese açık bir URL kullanışlıdır ve bazen fazlasıyla kullanışlıdır. Taklitiniz yayınlanmamış bir özelliği veya ifşa etmek istemediğiniz bir iş ortağı entegrasyonunu yansıtıyorsa, onu kısıtlayabilirsiniz.
Proje Ayarları > Özellik Ayarları > Taklit Ayarları'na gidin ve erişim iznini Token Kimlik Doğrulaması olarak ayarlayın. Bu ayar açıldıktan sonra, her istek geçerli bir apidogToken taşımalıdır ve token içermeyen istekler reddedilecektir. Token'ı üç şekilde sağlayabilirsiniz:
Kopyalanan URL'nin zaten kullandığı gibi, bir URL sorgu dizesi parametresi olarak:
curl "https://mock.apidog.com/m1/2689726-0-default/users?apidogToken=GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
Token'ı URL'den ve sunucu günlüklerinden uzak tutan bir istek başlığı olarak:
curl "https://mock.apidog.com/m1/2689726-0-default/users" \
-H "apidogToken: GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi"
Veya form-data veya x-www-form-urlencoded isteğinde apidogToken adında bir gövde parametresi olarak, bu form gövdeleri gönderen istemcilere uygundur.
Frontend kodu için başlık yaklaşımı genellikle en temizidir. Token'ı tam URL'leri günlüğe kaydeden her şeyden uzak tutar ve kimlik bilgisini kaynak yolundan ayırır:
const res = await fetch(
"https://mock.apidog.com/m1/2689726-0-default/users",
{ headers: { apidogToken: "GdfNrEm6lxM9nDGGIMCWC1OPSiZ6hGOi" } }
);
const users = await res.json();
Planlamanız gereken bir şey: Düz bir URL'yi zaten paylaştıktan sonra Token Kimlik Doğrulamasını etkinleştirirseniz, her tüketicinin token'ı eklemesi gerekir, aksi takdirde çağrıları başarısız olmaya başlar. QA ve iş ortaklarının reddedilen isteklerle baş başa kalmaması için geçişi koordine edin.
Yerel Ayarlarla Gerçekçi, Bölgesel Duyarlı Veriler Oluşturun
Her kayıt için "name": "string" döndüren bir taklit, kullanıcı arayüzünüze hiçbir şey öğretmez. Gerçekçi görünen adlar, adresler ve telefon numaraları döndüren bir taklit, gerçek veriler gelmeden önce frontend'in düzen hatalarını, metin taşmasını ve biçimlendirme sorunlarını yakalamasını sağlar. Apidog bunu arka planda Faker.js ile halleder ve uluslararası ürünler için gerçekten faydalı olduğu yer yerel ayar kontrolleridir.
Varsayılan Yerel Ayar Nasıl Çalışır?
Varsayılan olarak, Faker projenizin dil ayarını takip eder. Bu, Proje Ayarları > Temel Ayarlar'da yapılandırılır ve orada seçtiğiniz dil, tüm oluşturulan taklit değerler için varsayılan yerel ayar olur. Projeyi Fransızca olarak ayarlarsanız, taklit adlarınız ve adresleriniz alan bazında herhangi bir çalışma yapmadan Fransızca olarak geri döner.
Tüm proje için yerel ayarı geçersiz kılın
Proje dilinden farklı, belirli bir yerel ayarda taklit verisi istiyorsanız, bunu geçersiz kılabilirsiniz. Proje Ayarları > Özellik Ayarları > Taklit Ayarları'na gidin ve açılır menüden bir Faker yerel ayarı seçin. Bu geçersiz kılma, projedeki her alan için Temel Ayarlar'daki varsayılan dilin yerine geçer.
Bu, uluslararasılaştırmayı test ederken kullanışlıdır. Proje yerel ayarını Japonya'ya yönlendirin; böylece oluşturulan her adres, ad ve telefon numarası o bölgeyi yansıtır ve UI'ınızın Latin olmayan yazıtlara ve farklı adres biçimlerine karşı nasıl durduğunu görebilirsiniz. Bu tür şema tabanlı verileri otomatik olarak oluşturmak başlı başına bir konudur ve Apidog'un akıllı taklidi ve şemanızı nasıl okuduğuna dair rehber, oluşturma tarafını ayrıntılı olarak ele almaktadır.
Yerel ayarı alan bazında geçersiz kılın
Bazen geri kalanından farklı bir yerel ayarda, örneğin bölgeleri karışık bir müşteri listesi gibi tek bir alana ihtiyacınız olabilir. Yerel ayarı taklit ifadesinin içinde locale parameter kullanarak doğrudan ayarlayabilirsiniz:
{{$person.fullName(locale='ja')}}
Bu, yalnızca o alan için 田中 太郎 gibi Japonca adlar üretirken, yanıtın geri kalanı proje yerel ayarını takip eder. Öncelik üç katmanda çalışır: alan düzeyindeki bir yerel ayar, proje düzeyindeki yerel ayarı geçersiz kılar ve bu da Temel Ayarlar'daki varsayılan dili geçersiz kılar. Yani makul bir proje varsayılanı belirlersiniz ve yalnızca istisnaya gerçekten ihtiyacınız olduğunda alan düzeyindeki geçersiz kılmaları kullanırsınız.
Kapsam hakkında kısa ve dürüst bir not: Belgeler ja'yı örnek olarak gösterir ve desteklenen yerel ayarların tam listesini yayınlamaz, bu nedenle buna güvenmeden önce hedef bölgenizin tam kodunu Apidog taklit belgelerinde doğrulayın. Faker'ın kendi kuralları Faker.js yerel ayar referansında belgelenmiştir.
Saat dilimini de eşleştirin
Zaman için paralel bir kontrol bulunmaktadır. Proje düzeyindeki varsayılan ayar Proje Ayarları > Özellik Ayarları > Taklit Ayarları'nda bulunur ve taklit ifadesi içindeki timeZone parametresi ile alan bazında geçersiz kılabilirsiniz. Kullanıcı arayüzünüz zaman damgalarını işliyorsa, bu, oluşturulan createdAt değerlerini sunucunuzun bulunduğu yere varsayılan olarak ayarlamak yerine simüle ettiğiniz bölgeyle tutarlı tutar.
Yerel ayar ve saat dilimi kontrolleri arasında, Japonya'daki, Almanya'daki veya karışık uluslararası bir kullanıcı tabanını ikna edici bir şekilde taklit eden bir taklit oluşturabilirsiniz, hepsi aynı uç nokta şemasından. Bu durumun açtığı daha geniş senaryo yelpazesi için, pratik API taklit kullanım durumları özeti incelenmeye değerdir.
Cloud Mock ile Kendi Barındırılan Taklit Karşılaştırması
Cloud Mock, Apidog'un barındırılan seçeneğidir ve çoğu ekibi kapsar. Kuruluşunuzun veri yerleşimi kuralları veya test trafiğini bir satıcının bulutu üzerinden yönlendirmeye karşı bir politikası varsa, Apidog taklit hizmetini kendi altyapınızda çalıştırmayı da destekler. Takas basittir: bulut seçeneği sıfır kurulum gerektirir ve her zaman açıktır, kendi kendine barındırma ise hizmeti kendiniz çalıştırma maliyetiyle size kontrol sağlar. Durumunuz buysa, Apidog taklit sunucusunu kendi kendine barındırma rehberi bu konuyu ayrıntılı olarak ele alır. Barındırılan seçenekleri yan yana değerlendiren ekipler için, çevrimiçi API taklit araçlarının karşılaştırması genel görünümü sunar.
Plan kısıtlamasıyla ilgili doğrudan bir yanıt: burada belgelenen Cloud Mock ve yerel ayar özellikleri belirli bir plan gereksinimi belirtmemektedir, bu nedenle dürüstçe yapılması gereken, bir blog yazısından bir rakam almak yerine kendi hesabınızdaki mevcut durumu kontrol etmektir. Apidog'u İndirebilir ve çalışma alanınızın tam olarak neleri içerdiğini görmek için akışı baştan sona deneyebilirsiniz.
İş Akışını Apidog CLI ile Otomatikleştirin
Apidog'daki taklit oluşturma, bir GUI ve bulut yeteneğidir. Taklit yanıtları, uç nokta şemanızdan otomatik olarak oluşturulur ve bir terminalde çalıştırdığınız herhangi bir şey tarafından değil, Apidog'un barındırılan motoru tarafından sunulur. Dolayısıyla dürüst çerçeve şudur: Apidog CLI bir taklit sunucusunu başlatmaz veya sunmaz. Yaptığı şey, taklitinizin girdilerini doğru tutmaktır.
CLI ve Cursor veya Claude Code gibi yapay zeka kodlama ajanları, projenizdeki uç noktaları ve şemaları oluşturabilir ve güncelleyebilir. Bulut taklidi, veri oluşturmak için bu şemaları okuduğundan, belirtimi güncel tutmak, API geliştikçe taklit çıktısının doğruluğunu korur. Bir aracı araç kullanarak bir alan eklediğinizde, taklit, manuel bir düzenleme olmadan bunu yansıtır.
Ardından, taklit frontend çalışmasının önünü açtıktan ve gerçek backend devreye girdikten sonra, aynı projenin test senaryoları buna karşı başsız (headless) olarak çalışır. CLI'nın yürütme komutu, canlı backend'i taklitin tanımladığı aynı sözleşmeye göre doğrular:
apidog run -t <scenario_id> -e <env_id> -r cli
Bu tek komut, kaydedilmiş bir test senaryosunu bir ortama karşı çalıştırır ve sonuçları raporlar, böylece kullanıcı arayüzünün önünü açan taklit ve backend'i doğrulayan testler tek bir doğruluk kaynağına izlenir. Senaryonuzu Apidog'da açın ve bayrakları elle birleştirmek yerine -t senaryo kimliği ve -e ortam kimliği zaten doldurulmuş olarak oluşturulan komutu kopyalayın. Bunu bir pipeline'a bağlama, Apidog'u bir CI/CD pipeline'ında çalıştırma rehberinde ele alınmıştır.
Sıkça Sorulan Sorular
Apidog'u kapattığımda bulut taklit URL'si çalışmaya devam eder mi?
Evet, Cloud Mock'un asıl amacı budur. Barındırıcı makine kapandığında yanıt vermeyi durduran yerel bir taklitin aksine, bulut taklidi Apidog'un altyapısından sunulur ve 7/24 erişilebilir kalır. Bilgisayarınız açık olsun ya da olmasın, ekip arkadaşlarınız ona erişebilir.
Bulut taklit URL'sini doğrudan bir tarayıcıda kullanabilir miyim?
GET istekleri için evet. Tam URL'yi, apidogToken sorgu parametresi dahil, adres çubuğunuza yapıştırın ve JSON yanıtını göreceksiniz. Diğer yöntemler veya token'ı URL geçmişinizden uzak tutmak için, curl gibi bir araçla veya frontend istemcinizle çağırın ve token'ı bunun yerine bir başlık olarak iletin.
Token içermeyen isteklere ne olur?
Erişim iznini Token Kimlik Doğrulaması olarak ayarladıysanız, geçerli bir apidogToken içermeyen her istek reddedilir. Bunu bir sorgu dizesi parametresi, bir istek başlığı veya bir form isteğinde bir gövde parametresi olarak sağlayın. Düz bir URL paylaştıktan sonra token kimlik doğrulamasını etkinleştirirseniz, tüketicilerinize bildirin ki çağrıları başarısız olmadan önce token'ı ekleyebilsinler.
Belirli bir ülkeye uyan taklit verilerini nasıl alırım?
Proje yerel ayarınızı Temel Ayarlar'da ayarlayın veya Özellik Ayarları > Taklit Ayarları altında tüm proje için geçersiz kılın ya da taklit ifadesindeki locale parametresiyle tek bir alanı geçersiz kılın, örneğin {{$person.fullName(locale='ja')}}. Alan düzeyindeki ayar proje düzeyindeki ayarı, proje düzeyindeki ayar ise Temel Ayarlar'daki varsayılanı geçersiz kılar. Akıllı taklit rehberi, şema tabanlı üretimin bununla nasıl ilişkili olduğunu gösterir.
Cloud Mock mu yoksa başsız bir taklit aracı mı kullanmalıyım?
Cloud Mock, API tasarımlarına bağlı, barındırılan, sıfır bakım gerektiren bir uç nokta isteyen ekiplere uygundur. Eğer hiçbir GUI'si olmayan otomatik bir derlemeye gömülü taklitlere ihtiyacınız varsa, başsız taklit araçlarına genel bakış seçenekleri ve her birinin nereye uyduğunu karşılaştırır. OpenAPI Girişimi spesifikasyonu bu araçların çoğunun temelini oluşturur, bu nedenle hangi yolu seçerseniz seçin temiz bir spesifikasyon karşılığını verir.
Özetle
Yalnızca dizüstü bilgisayarınızda yaşayan bir taklit, tam olarak bir kişinin engelini kaldırır. Cloud Mock, onu tüm ekibinizin üzerinde geliştirebileceği herkese açık bir mock.apidog.com URL'sine dönüştürür; gerektiğinde token kimlik doğrulamasıyla kısıtlayabilir ve verilerinizin belirli bir bölge için gerçek görünmesi gerektiğinde yerel ayar kontrollerini kullanabilirsiniz. Uç noktayı tasarlayın, düğmeyi açın, bağlantıyı paylaşın ve frontend artık backend'i beklemez. İlk paylaşılabilir bulut taklitinizi kurmak için Apidog'u indirin, ücretsizdir ve kredi kartı gerekmez.