Aracılığıyla paylaş

API'yi el ile ekleme

UYGULANANLAR: Tüm API Management katmanları

Bu makalede, Azure API Management'a api'nin el ile nasıl ekleneceği gösterilmektedir. API'den sahte yanıtlar oluşturmak istediğinizde boş bir API oluşturabilirsiniz. Sahte API yanıtları oluşturma hakkında bilgi için bkz . Sahte API yanıtları.

Mevcut bir API'yi içeri aktarmak istiyorsanız, bu makalenin İlgili içerik bölümüne bakın.

Bu makalede, boş bir API oluşturmayı öğreneceksiniz. Arka uç API'si olarak httpbin.org (genel test hizmeti) belirteceksiniz.

Önkoşullar

API Management örneğinize gidin

  1. Azureportalında API Management hizmetleriniarayıp seçin:

    Arama sonuçlarında API Management hizmetlerini gösteren ekran görüntüsü.

  2. API Management hizmetleri sayfasında API Management örneğinizi seçin:

    API Yönetimi hizmetleri sayfasında bir API Yönetimi örneğini gösteren ekran görüntüsü.

API oluşturma

  1. Soldaki menüde API'ler'in altında API'ler'i seçin.

  2. + API Ekle'yi seçin.

  3. HTTP kutucuğunu seçin:

    Azure portalındaki HTTP kutucuğunu gösteren ekran görüntüsü.

  4. Arka uç Web hizmeti URL'sini (örneğin, https://httpbin.org) ve API'nin diğer ayarlarını girin. Ayarlar, İlk API'nizi içeri aktarma ve yayımlama öğreticisinde açıklanmıştır.

  5. Oluştur'u belirleyin.

Bu noktada, API Management'ta arka uç API'nizdeki işlemlere eşleyen hiçbir işleminiz yoktur. Arka uç üzerinden kullanıma sunulan ancak API Management aracılığıyla sunulmayan bir işlemi çağırırsanız 404 hatası alırsınız.

Not

Varsayılan olarak, bir arka uç hizmetine bağlı olsa bile bir API eklediğinizde, API Management siz izin verene kadar hiçbir işlemi kullanıma sunmaz. Arka uç hizmetinizin bir işlemine izin vermek için arka uç işlemine eşleyen bir API Management işlemi oluşturun.

İşlem ekleme ve test etme

Bu bölümde, arka uç /get işlemiyle eşlemek için bir http://httpbin.org/get işlemin nasıl ekleneceği gösterilmektedir.

İşlem ekleme

  1. Önceki adımda oluşturduğunuz API’yi seçin.
  2. + İşlem ekle'yi seçin.
  3. URL'deGET'i seçin ve metin kutusuna /get yazın.
  4. Görünen ad alanına FetchData girin.
  5. Kaydet'i seçin.

İşlemi test etme

Azure portalında işlemi test edin. (Geliştirici portalında da test edebilirsiniz.)

  1. Test sekmesini seçin.
  2. FetchData seçeneğini belirleyin.
  3. Gönder'i seçin.

İşlemin http://httpbin.org/get oluşturduğu yanıt HTTP yanıtı bölümünde görünür. İşlemlerinizi dönüştürmek istiyorsanız bkz. API'nizi dönüştürme ve koruma.

Parametreli işlem ekleme ve test etme

Bu bölümde, nasıl parametre alan bir işlem ekleneceği gösterilir. Bu örnekte, işlemi http://httpbin.org/status/200 ile eşlersiniz.

İşlem ekleme

  1. Daha önce oluşturduğunuz API'yi seçin.
  2. Tasarım sekmesinde + İşlem ekle'yi seçin.
  3. URL'deGET'i seçin ve metin kutusuna /status/{code} yazın.
  4. Görünen ad alanına GetStatus yazın.
  5. Kaydet'i seçin.

İşlemi test etme

Azure portalında işlemi test edin. (Geliştirici portalında da test edebilirsiniz.)

  1. Test sekmesini seçin.

  2. GetStatus seçeneğini belirleyin. Kodu200 girin.

  3. Gönder'i seçin.

    İşlemin http://httpbin.org/status/200 oluşturduğu yanıt HTTP yanıtı bölümünde görünür. İşlemlerinizi dönüştürmek istiyorsanız bkz. API'nizi dönüştürme ve koruma.

Joker karakter işlemi ekleme ve test edin

Bu bölümde joker karakter işleminin nasıl ekleneceği gösterilmektedir. Joker karakter işlemi, API isteğiyle rastgele bir değer geçirmenizi sağlar. Önceki bölümlerde gösterildiği gibi ayrı GET işlemleri oluşturmak yerine bir joker karakter GET işlemi oluşturabilirsiniz.

Dikkat

Joker karakterle ilgili işlemi yapılandırırken dikkatli olun. Bu yapılandırma, bir API'yi belirli API güvenlik tehditlerine karşı daha savunmasız hale getirebilir.

İşlem ekleme

  1. Daha önce oluşturduğunuz API'yi seçin.
  2. Tasarım sekmesinde + İşlem ekle'yi seçin.
  3. URL'de GET'i seçin ve / metin kutusuna * girin.
  4. Görünen ad alanına WildcardGet girin.
  5. Kaydet'i seçin.

İşlemi test etme

Azure portalında işlemi test edin. (Geliştirici portalında da test edebilirsiniz.)

  1. Test sekmesini seçin.

  2. Joker KarakterAl'ı seçin. Önceki bölümlerde test ettiğiniz GET işlemlerini deneyin veya desteklenen farklı bir GET işlemini deneyin.

    Örneğin, Şablon parametreleri'nde joker karakter (*) adının yanındaki değeri üst bilgi olarak değiştirin. İşlem, gelen isteğin HTTP üst bilgilerini döndürür.

  3. Gönder'i seçin.

    İşlemin http://httpbin.org/headers oluşturduğu yanıt HTTP yanıtı bölümünde görünür. İşlemlerinizi dönüştürmek istiyorsanız bkz. API'nizi dönüştürme ve koruma.

Not

Tümleştirdiğiniz arka uç API'sinin konağın bir işlem URL'sinde sondaki eğik çizgileri nasıl işlediğini anlamak önemli olabilir. Daha fazla bilgi için bu API Management SSS bölümüne bakın.

Diğer API'leri ekleme

Farklı hizmetler tarafından kullanıma sunulan API'ler dışında bir API oluşturabilirsiniz, örneğin:

  • OpenAPI belirtimi
  • SOAP API'si
  • GraphQL API'si
  • Azure App Service'te barındırılan bir Web Uygulaması
  • Azure İşlevleri
  • Azure Logic Apps
  • Azure Service Fabric

Not

Bir API'yi içeri aktardığınızda, işlemler geçerli API'nize eklenir.

Api'yi var olan bir API'ye eklemek için:

  1. Azure portalında Azure API Management örneğine gidin:

    API Management hizmetleri sayfasını gösteren ekran görüntüsü.

  2. Genel Bakış sayfasında API'leri seçin veya soldaki menüden API'ler seçin.

    Genel Bakış sayfasındaki API'lerin seçimini gösteren ekran görüntüsü.

  3. Eklemek istediğiniz başka bir API'nin yanındaki üç noktayı (...) seçin.

  4. Açılır menüden İçeri Aktar seçeneğini seçin.

    İçeri Aktar komutunu gösteren ekran görüntüsü.

  5. API'nin içeri aktarılacağı hizmeti seçin.

İlgili içerik

  • Last updated on