Apidog'da Kod Yazmadan API Nasıl Mock'lanır

Ön uç ekibiniz engellendi. GET /users ve GET /orders için arka uç hazır değil, ancak kullanıcı arayüzünün listeleri oluşturmak, sayfalamak ve boş durumları ele almak için gerçekçi verilere ihtiyacı var. Eski çözüm, sahte bir JSON dosyasını elle yazıp sunmak, ardından bir alan her değiştiğinde onu yamalamaya devam etmektir. Bu iş sıkıcıdır ve gerçek API ile neredeyse anında senkronizasyonu kaybeder.

Daha hızlı bir yol var. Zaten bir API spesifikasyonunuz varsa, Apidog, hiçbir yapılandırma ve kod olmadan doğrudan uç nokta şemasından çalışan bir sahte veri oluşturabilir. Bu özelliğe Akıllı Mock denir ve gerçek görünen veriler üretmek için alan adlarınızı ve türlerinizi okur: bir name alanı makul bir ad döndürür, bir email alanı makul bir e-posta döndürür. Bu kılavuz size iki e-ticaret uç noktasını uçtan uca sahte verilerle nasıl test edeceğinizi gösterir, sahte URL'nin nerede bulunduğunu açıklar, hangi yanıtın kazanacağına karar veren öncelik sırasını açıklar ve Akıllı Mock yanlış tahmin ettiğinde ne yapacağınızı kapsar. Kavram hakkında daha geniş bir başlangıç isterseniz, API mocking'in ne olduğu ve nasıl çalıştığına dair genel bakışımız konuyu hazırlar ve JSON Schema sitesi Akıllı Mock'un saygı duyduğu kısıtlama modelini açıklar.

düğme

Akıllı Mock ne yapar ve neden size zaman kazandırır?

Apidog'un mock motoru, belgelere göre beş şey yapabilir. API spesifikasyonunuzdan otomatik olarak oluşturulmuş veriler döndürebilir, bu Akıllı Mock'tur. Spesifikasyonda tanımladığınız yanıt örneğini döndürebilir. Belirtilen özel bir yanıtı döndürebilir. İstek parametrelerine göre farklı yanıtlar döndürebilir, bu koşullu mocking'tir. Ve değerleri mock scriptleri aracılığıyla istekle ilişkili yanıtları döndürebilir.

Akıllı Mock, bu ailenin sıfır konfigürasyonlu üyesidir ve Apidog'a tasarım, hata ayıklama ve test araçlarının yanı sıra yerleşik olarak dahil edilmiştir. Örnek gövdeler tanımlamazsınız ve kurallar yazmazsınız. Bir uç noktanın belirli bir yanıt şeması olduğu sürece, Akıllı Mock bu şemayı okur ve her alanı gerçekçi değerlerle doldurur. Otomatik bir yedek görevi görür: önceden tanımlanmış bir örneği olmayan herhangi bir uç nokta yine de anlamlı bir şey döndürür, böylece hiçbir istek boş dönmez.

Engellenmiş bir ön uç için oyunun tamamı budur. API'nizi bir kez içe aktarırsınız veya tasarlarsınız ve her uç nokta aynı anda canlı bir mock haline gelir. Şema değiştiğinde, mock da onunla birlikte değişir, çünkü her ikisi de tek bir kaynaktan okunur.

Başlamadan önce: tek gereksinim

Akıllı Mock, uç noktada belirli bir yanıta ihtiyaç duyar. Bu tek ön koşuldur. API'yi Apidog'da tasarladıysanız, uç noktanın yanıt tanımının altına bir yanıt şeması ekleyin. Bir OpenAPI dosyası içe aktardıysanız, yanıt şemaları genellikle onunla birlikte gelir. Tanımlanmış bir yanıt olmadan, motorun okuyacak hiçbir şeyi yoktur ve mock hiçbir işe yarar şey döndürmez.

Local Mock kullanmayı planlıyorsanız Apidog masaüstü istemcisini de isteyeceksiniz, çünkü kendi makinenizde çalışır ve Apidog Web'de mevcut değildir. Apidog'u indirin ve takip edin. Ücretsizdir ve kredi kartı gerekmez.

Adım adım: GET /users ve GET /orders için mock oluşturma

Küçük bir mağaza API'si için bir mock oluşturalım. İki uç nokta tanımlayacak ve ikisini de çağıracağız.

Adım 1: uç noktaları ve yanıt şemalarını tanımlama

GET /users'ı şöyle bir yanıt gövdesiyle oluşturun:

{
  "id": 1024,
  "name": "Amara Osei",
  "email": "amara.osei@example.com",
  "phone": "+1-415-555-0148",
  "createdAt": "2026-03-11T09:24:00Z",
  "isActive": true
}

Ardından GET /orders'ı bir liste döndürecek şekilde oluşturun:

[
  {
    "orderId": "ORD-58210",
    "userId": 1024,
    "total": 84.50,
    "currency": "USD",
    "status": "shipped",
    "createdAt": "2026-05-02T14:03:00Z"
  }
]

Her özelliğin şemada bir türe sahip olduğundan emin olun. Akıllı Mock'un iyi değerler seçmek için kullandığı şeyler türler ve adlardır.

Adım 2: mock URL'sini bulma ve kopyalama

Her uç nokta otomatik olarak bir mock URL'si alır. Nerede bulacağınız, içinde bulunduğunuz moda bağlıdır:

TASARIM modunda, mock URL'si uç noktanın altındaki API sekmesinde bulunur.
HATA AYIKLAMA modunda, Mock sekmesinde bulunur.

Kopyalamak için Kopyala'ya tıklayın. Dikkat edilmesi gereken bir şey: bu yalnızca URL'yi kopyalar. Uç noktanız GET dışında bir yöntem kullanıyorsa veya bir istek gövdesine ihtiyaç duyuyorsa, çağırırken yöntemi ve gövdeyi kendiniz eklersiniz.

Bir Yerel Mock URL'si 127.0.0.1 port 4523 üzerinde çalışır ve yol modunda şöyle görünür:

http://127.0.0.1:4523/m1/{projectID}-{versionNo}-{serverNo}/users

Apidog istemcisi açıkken Yerel Mock otomatik olarak başlar. Ayrıca bir uç noktayı kimliğine göre hedefleyen bir kimlik modu formu da vardır:

http://127.0.0.1:4523/m2/{projectID}-{versionNo}-{serverNo}/{endpointId}

Adım 3: mock'u çağırma

URL'ye curl ile istek gönderin:

curl http://127.0.0.1:4523/m1/1234567-0-0/users

Şemanızdan oluşturulan, buna benzer bir şey geri alırsınız:

{
  "id": 3187,
  "name": "Diego Marchetti",
  "email": "diego.marchetti@example.net",
  "phone": "+1-628-555-0113",
  "createdAt": "2026-01-27T18:41:22Z",
  "isActive": true
}

name'in bir ad gibi, email'in ise bir e-posta gibi okunduğunu fark edin. Bu, rastgele bir gürültü değil, çalışan Özellik Adı Eşleşmesidir. İsteği yenilediğinizde dinamik değerler yeniden üretilir, böylece her çağrı size taze veri verir. Bu, kullanıcı arayüzünüzün çeşitli içeriği nasıl ele aldığını test etmek için kullanışlıdır.

Siparişler uç noktasını aynı şekilde çağırın:

curl http://127.0.0.1:4523/m1/1234567-0-0/orders

Sipariş listesi görünümünüz için hazır, gerçekçi toplamlar, durumlar ve zaman damgalarıyla sipariş nesnelerinden oluşan bir dizi alırsınız.

Akıllı Mock her değere nasıl karar verir?

Akıllı Mock tek bir özelliği doldurduğunda, üç katmanlı bir veri oluşturma önceliğiyle çalışır. Bu sırayı anlamak, çıktıyı tam olarak nasıl yönlendireceğinizi size söyler.

Mock Alanı. Yanıt spesifikasyonunda özelliğe özel bir değer veya ifade ayarlarsanız, bu kazanır. Mock Alanı iki giriş türü alır: her seferinde döndürülen statik bir değer olan Sabit değer ve çeşitli veriler üreten dinamik bir ifade olan Faker ifadesi. Örneğin, bir status alanının Mock Alanını shipped, pending ve delivered arasından seçim yapan bir Faker ifadesine ayarlayın.
Özellik Adı Eşleştirme. Hiçbir Mock Alanı ayarlanmadığında, Akıllı Mock, özellik adını joker karakter veya düzenli ifade desenleri kullanarak yerleşik kurallarla eşleştirir, ardından uygun verileri oluşturur. Bu nedenle email ve createdAt doğru çıkar. Kurallar Mock Ayarları altında bulunur ve kendi kurallarınızı ekleyebilirsiniz.
JSON Şeması. Ad hiçbir kurala uymuyorsa, Akıllı Mock şemanız tarafından kısıtlanan türe dayalı bir varsayılana geri döner. Eşleşen adı ve kısıtlaması olmayan bir dize sadece genel bir dize alır.

Oluşturulan veriler, JSON Şeması kısıtlamalarını baştan sona dikkate alır: dize uzunluğu, enum değerleri, sayı aralıkları ve dizi uzunluğu hepsi gözetilir. status'ü üç değerlikli bir enum olarak ayarlarsanız, Akıllı Mock yalnızca bu üç değerden birini döndürür. Bir dizinin minItems değerini 3 olarak ayarlarsanız, en az üç öğe geri alırsınız. Her özellik ayarı nihai mock verilerinde görünür.

Apidog ayrıca mock yerellerini de destekler, böylece farklı dillerde ve bölgesel formatlarda test verileri oluşturabilirsiniz. Mağazanız Japon pazarında hizmet veriyorsa, yereli değiştirin ve adlar ile adresler doğru formatta geri dönecektir.

Akıllı Mock ne zaman yanlış tahmin eder ve onu nasıl yönlendirirsiniz?

Akıllı Mock bir çıkarım yöntemidir, bu yüzden bazen hatalı sonuçlar verebilir. sku adlı bir özellik yerleşik hiçbir kurala uymayabilir ve genel bir dizeye geri dönebilir. Bir total alanı, iki ondalık basamaklı ve mantıklı bir aralık isterken, basit bir sayı olarak geri dönebilir. İşte bunu düzeltmenin yolları, en hafif dokunuştan en fazla kontrole doğru.

Önce şemayı sıkılaştırın. Çoğu zaman düzeltme daha iyi bir kısıtlamadır. status'e bir enum, total'a bir minimum ve maximum, veya sku'ya bir pattern ekleyin. Akıllı Mock bunların hepsine uyar, böylece çıktı hiçbir özel değer olmadan aralığa oturur.

Bir Mock Alanı ayarlayın. Şema tek başına istediğinizi ifade edemediğinde, özelliğin Mock Alanını ayarlayın. Alan her zaman aynı şeyi döndürmesi gerektiğinde Sabit bir değer kullanın, tıpkı USD para birimi gibi. Sınırlar içinde çeşitlilik istediğinizde bir Faker ifadesi kullanın. Apidog'un Faker katmanı, Mock.js kütüphanesiyle aynı fikirler üzerine kuruludur ve Apidog'da Faker kullanımına ilişkin kılavuzumuz, ifade sözdizimini ayrıntılı olarak kapsar.

Bir Özellik Adı Eşleştirme kuralı ekleyin. Aynı yanlış adlandırılmış alan birçok uç noktada görünüyorsa, Akıllı Mock'a bir kez öğretin. Ayarlar'a, ardından Genel Ayarlar'a, ardından Özellik Ayarları'na, ardından Mock Ayarları'na gidin. Yeni'ye tıklayın, alan adınızla eşleşen koşulu tanımlayın ve ona bir mock ifadesi verin. Bundan sonra, proje genelindeki her sku, genel bir dize yerine tanımladığınız deseni oluşturacaktır.

Mock öncelik sırası: aslında ne kazanır?

Sıkça kafa karıştıran bir nokta, birden fazla olası yanıt varken bir uç noktanın hangi yanıtı döndürdüğüdür. Apidog bunu, Proje Ayarları altında Mock Ayarları'nda bulunan Varsayılan mock yöntemi ayarı ile çözer. İki seçeneği vardır:

Önce Akıllı Mock (varsayılan) şu sırayı verir: Mock Beklentisi, ardından Akıllı Mock.
Önce Yanıt örneği şu sırayı verir: Mock Beklentisi, ardından Yanıt Örneği, ardından Akıllı Mock.

Soldan sağa okuyun. Varsayılan olarak, bir istek eşleşen bir Mock Beklentisi olup olmadığını kontrol eder ve hiçbiri eşleşmezse, Akıllı Mock gövdeyi oluşturur. Önce Yanıt örneğine geçildiğinde, Akıllı Mock yedeklenmeden önce tanımlı bir Yanıt Örneği kontrol edilir.

Her iki sıranın da üzerinde bir kural bulunur: Mock Beklentileri, yapılandırıldıklarında ve koşulları eşleştiğinde, hangi sırayı seçmiş olursanız olun her zaman ilk önceliğe sahiptir. Yani, userId 9999 olduğunda 404 döndüren koşullu bir yanıt ayarlarsanız, bu beklenti Varsayılan mock yönteminden bağımsız olarak tetiklenir. Parametre odaklı yanıtların tam bir açıklamasını görmek için, Apidog'da koşullu API yanıtlarını mocklama kılavuzumuza bakın.

Pratik özet: özel Mock Beklentileri her şeyi yener, ardından ayarınıza bağlı olarak Akıllı Mock veya Yanıt Örneği gelir. Akıllı Mock her zaman son çare yedeklemesidir, bu yüzden her istek bir yanıt alır.

Yerel, Bulut ve Çalıştırıcı Mock: mock nerede çalışır?

Akıllı Mock ve Özel Mock, bir yanıtın nasıl oluşturulduğunu açıklar. Bu mock'un nerede barındırıldığı ayrı bir seçimdir ve Apidog size üç seçenek sunar:

Yerel Mock Apidog istemcisi aracılığıyla bilgisayarınızda çalışır. Otomatik olarak başlar ve yalnızca istemci açıkken erişilebilir. 127.0.0.1:4523 üzerinde dinler, bu nedenle ağınızdaki başka bir cihaz için makinenizin LAN IP'sine ihtiyacınız vardır. Apidog Web'de mevcut değildir.
Bulut Mock Apidog sunucularında barındırılır ve 7/24 erişilebilir. Varsayılan olarak kapalıdır, bu nedenle bir ekip arkadaşınızın veya dağıtılmış bir önizlemenin mock'a erişmesini istediğinizde ortam yönetiminde açın. URL'leri https://mock.apidog.com ile aynı m1/m2 yol yapısını kullanır ve üretim trafiği için değil, test için tasarlanmıştır.
Çalıştırıcı Mock kendi ekip altyapınızda barındırılır ve ekip genelinde paylaşılır, bu da mock'un kendi ağınızın arkasında yaşaması gereken dahili bir ortam için uygundur.

Yalnız ön uç çalışmaları için Yerel Mock'u, başkalarının erişmesi gerektiğinde Bulut Mock'u ve mock kendi sunucularınızda olması gerektiğinde Çalıştırıcı Mock'u seçin. Barındırılan seçenekleri diğer hizmetlerle karşılaştırıyorsanız, çevrimiçi API mock araçları karşılaştırmamız onları yan yana koyar ve Apidog Bulut Mock kılavuzu barındırma kurulumunu ayrıntılı olarak kapsar.

Bilmeye değer birkaç yönlendirme tuzağı

Mock yönlendirmesinin insanları şaşırtan birkaç kuralı vardır.

Uç nokta yolları `/` ile başlamalıdır. `/orders` gibi bir yol, mock ortamı üzerinden doğru şekilde yönlendirilir. `/` ile başlamayan tam bir URL, mock ortamını hiç kullanmaz ve baştaki eğik çizgi olmayan bir yol yalnızca kimlik modunda çalışır.

İki API aynı yöntemi ve yolu paylaşıyorsa, yol modu bunları kendi başına ayırt edemez. Tam olarak kastettiğiniz uç noktayı işaret etmek için bir ?apidogApiId={endpointId} sorgu parametresi ekleyin.

Ve yenileme davranışını unutmayın: isteği yenilediğinizde mock verileri güncellenir. Her yenileme dinamik değerleri yeniden oluşturur, bu nedenle aynı yanıtı iki kez görürseniz, muhtemelen yeni bir çağrı yerine önbelleğe alınmış bir görünüme bakıyorsunuzdur.

İş akışını Apidog CLI ile otomatikleştirin

Mock oluşturma, Apidog'da bir GUI ve bulut yeteneğidir. Mock motoru, Yerel, Bulut veya Çalıştırıcı olsun, yanıtları sunar; Apidog CLI bir mock sunucusu barındırmaz veya terminalden başlatmaz. CLI'ın eklediği şey, proje geliştikçe mock'larınızın arkasındaki şemayı doğru tutmanın bir yoludur.

Akıllı Mock çıktısını uç nokta şemasından oluşturduğu için, mock yalnızca spesifikasyon kadar iyidir. Apidog CLI ve Cursor, Claude Code, Trae ve Codex gibi AI kodlama aracıları, projenizdeki uç noktaları ve şemaları oluşturabilir ve güncelleyebilir. Bu, sözleşme değiştiğinde mock çıktısını doğru tutar, kimsenin uygulamayı açıp alanları elle düzenlemesine gerek kalmaz.

Ardından, mock ön uç çalışmasının önünü açtıktan sonra, aynı projenin test senaryoları, mock'un tanımladığı aynı sözleşmeye karşı gerçek arka ucu kontrol etmek için CI'da başsız bir şekilde çalışır. Bu tek bir komuttur:

apidog run -t <scenario_id> -e <env_id> -r html,cli

npm install -g apidog-cli (Node.js v16 veya üzeri) ile yükleyin, apidog login --with-token <your-token> ile kimlik doğrulaması yapın ve bunu herhangi bir boru hattına bağlayabilirsiniz. Apidog'u bir CI/CD boru hattında çalıştırma kılavuzumuz kurulumu ayrıntılı olarak açıklar. Mock ön ucu hareket halinde tutar; CLI, arka ucu aynı doğruluk kaynağına karşı dürüst tutar.

Sıkça Sorulan Sorular

Akıllı Mock kullanmak için herhangi bir kod yazmam gerekiyor mu? Hayır. Bir uç noktanın belirli bir yanıt şeması olduğu sürece, Akıllı Mock otomatik olarak gerçekçi veriler üretir. Yalnızca belirli bir alanı geçersiz kılmak istediğinizde kod, bir Faker ifadesi veya bir mock betiği kullanırsınız. Kavramlar için mock API'ye genel bakışa bakın.
Mock URL'im neden hiçbir şey döndürmüyor? En yaygın neden, uç noktada eksik bir yanıt tanımıdır. Akıllı Mock yanıt şemasını okur, bu nedenle önce bir tane ekleyin. Ayrıca yolunuzun `/` ile başladığından ve Yerel Mock kullanıyorsanız Apidog istemcisinin açık olduğundan emin olun.
Akıllı Mock'un rastgele bir değer yerine belirli bir değer döndürmesini nasıl sağlarım? Özelliğin Mock Alanını ayarlayın. Sabit bir değer her zaman aynı şeyi döndürür; bir Faker ifadesi çeşitli ancak kontrol edilmiş veriler döndürür. Mock Alanı, Akıllı Mock'un üç katmanlı önceliğinin en üstünde yer alır, bu nedenle her zaman ad eşleştirmesi ve şema varsayılanları üzerinde kazanır.
Ekip arkadaşları dizüstü bilgisayarımda çalışan bir mock'a erişebilir mi? Yalnızca yerel ağınız üzerinden ve yalnızca Apidog istemcisi açıkken, çünkü Yerel Mock 127.0.0.1:4523 üzerinde dinler. Her zaman erişim için, varsayılan olarak kapalı olan ve https://mock.apidog.com adresinde barındırılan Bulut Mock'u açın.
Hem bir örneğim hem de Akıllı Mock'um varsa hangi yanıt kazanır? Varsayılan mock yöntemine bağlıdır. Önce Akıllı Mock altında, Akıllı Mock gövdeyi oluşturur. Önce Yanıt örneği altında, Akıllı Mock'tan önce Yanıt Örneğiniz kullanılır. Her iki durumda da, eşleşen bir Mock Beklentisi ikisini de geçersiz kılar.

Sonuç

Akıllı Mock, bir API şemasını hiçbir kod ve yapılandırma olmadan çalışan bir mock'a dönüştürür, bu da engellenmiş bir ön ucun tam olarak ihtiyacı olan şeydir. Yanıtınızı tanımlayın, mock URL'sini API sekmesinden veya Mock sekmesinden kopyalayın ve çağırın; tahminlerin yönlendirilmesi gerektiğinde, şemayı sıkılaştırın veya bir Mock Alanı ayarlayın ve Mock Beklentilerinin her zaman kazandığını unutmayın. Apidog'u indirin ve bu cümleyi okuma süresince ilk uç noktanızı mock'layın.

düğme