Mem-proxy layanan SOAP

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X.
info

Yang akan Anda pelajari

Melalui tutorial ini, Anda akan belajar:

  • Buat proxy Edge API dari file WSDL.
  • Mengetahui perbedaan antara jenis proxy RESTful SOAP dan SOAP pass-through {i>proxy<i}.

Dalam tutorial ini, Anda akan mempelajari cara menempatkan proxy Edge API di depan web berbasis SOAP layanan.

Tutorial ini mengilustrasikan cara membuat RESTful API baru di depan database berbasis SOAP layanan. Meskipun tidak dijelaskan secara mendetail di sini, Anda juga dapat membuat yang menerima payload SOAP dan meneruskannya ke layanan backend.

Yang Anda butuhkan

Membuat proxy

Di sini, Anda akan meminta Edge menghasilkan {i>proxy<i} yang akan berada di depan layanan SOAP. Ada dua jenis proxy SOAP API:

  • Jenis proxy REST-SOAP-REST menghasilkan RESTful API baru dengan terjemahan lapisan berulang ke SOAP. Klien memanggilnya seperti yang mereka lakukan pada layanan RESTful lainnya, meneruskan kueri parameter yang diperlukan oleh layanan backend. Edge menerjemahkannya menjadi {i>payload<i} SOAP yang diharapkan oleh layanan.
  • Jenis proxy proxy pass-through memungkinkan klien untuk meneruskan payload SOAP. Ini adalah cara agar panggilan layanan SOAP mendapatkan manfaat dari fitur pengelolaan Edge.

Edge

Untuk melakukan proxy layanan SOAP menggunakan UI Edge:

  1. Login ke apigee.com/edge.
  2. Pilih Develop > Proxy API di menu navigasi sebelah kiri.
  3. Klik +Proxy.
  4. Klik Layanan SOAP.
  5. Di halaman Detail proxy, masukkan informasi berikut:

    Kolom Deskripsi
    Sumber WSDL

    Pilih: URL

    Salin dan tempel URL WSLD berikut di kolom Enter URL:

    https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?wsdl

    Klik: Validasi

    Apigee Edge mendapatkan file WSDL dan membacanya untuk menemukan daftar operasi didukung oleh layanan SOAP.

    Nama

    Biarkan apa adanya: delayedstockquote

    Ini adalah nama untuk proxy API yang Anda buat.

    Jalur dasar Biarkan apa adanya: /delayedstockquote
    Deskripsi Jika perlu, tambahkan deskripsi, seperti: Proxy WSDL API penawaran harga saham
  6. Klik Berikutnya.
  7. Di halaman Kebijakan umum, di bagian Keamanan: Otorisasi, pilih Lulus (tanpa otorisasi).
  8. Klik Berikutnya.
  9. Di halaman operasi WSDL, pilih: REST to SOAP to REST.

    Setelah Anda memilih jenis proxy, Edge akan menampilkan daftar operasi yang kode ini akan menghasilkan jalur REST API. Daftar ini memungkinkan Anda untuk pilih di antara operasi yang ditemukan di WSDL (jika Anda memiliki yang Anda cari). Perhatikan bahwa tabel juga menampilkan sumber daya yang yang dapat digunakan klien REST untuk memanggil layanan SOAP backend.

    Biarkan semua pilihan lain di halaman apa adanya.

  10. Klik Berikutnya.
  11. Terima default Host Virtual dengan mengklik Next.
  12. Di halaman Ringkasan, di bagian Deployment Opsional, klik Uji, lalu klik Buat dan deploy.

    Edge membuat proxy RESTful API dan men-deploy-nya ke lingkungan test. Dari WSDL, metode ini menentukan operasi yang didukung, parameter input, dan sebagainya. Edge menyarankan metode HTTP yang akan digunakan untuk setiap operasi. Biasanya, Edge menerjemahkan operasi menjadi permintaan GET, yang berisi keuntungannya adalah dapat di-cache. Edge juga menyiapkan endpoint target backend, yang dapat bervariasi per operasi SOAP.

    Kecuali Anda menyesuaikan proxy API baru (dan Anda tidak mengikuti tutorial ini), itu saja pasti ada. Anda dapat melanjutkan dengan menguji proxy API yang baru.

Edge Klasik (Private Cloud)

Untuk melakukan proxy layanan SOAP menggunakan UI Klasik Edge:

  1. Login ke http://ms-ip:9000, dengan ms-ip sebagai Alamat IP atau nama DNS node Server Pengelolaan.
  2. Pilih API > Proxy API di menu navigasi atas.
  3. Klik + API Proxy.
  4. Klik Layanan SOAP.
  5. Di halaman Detail proxy, masukkan informasi berikut:

    Kolom Deskripsi
    WSDL

    Pilih: Contoh URL

    Lalu pilih:
    ...delayedstockquote.asmx?WSDL

    Klik: Validasi

    Apigee Edge mendapatkan file WSDL dan membacanya untuk menemukan daftar operasi didukung oleh layanan SOAP.

    Nama Proxy

    Masukkan: delayedstockquote

    Ini adalah nama untuk proxy yang Anda buat.

    Jalur Dasar Proxy dan Deskripsi Biarkan apa adanya.
  6. Klik Berikutnya.
  7. Di halaman WSDL, buat pilihan berikut:
    Di kolom ini lakukan ini
    Jenis Proxy API

    Pilih: REST ke SOAP ke REST

    Setelah Anda memilih jenis proxy, Edge akan menampilkan daftar operasi yang akan menghasilkan jalur REST API, seperti yang ditunjukkan di sini. Daftar ini memberi Anda kesempatan untuk pilih di antara operasi yang ditemukan di WSDL (jika Anda memiliki yang Anda cari). Perhatikan bahwa tabel juga menampilkan sumber daya yang yang dapat digunakan klien REST untuk memanggil layanan SOAP backend.

    Untuk saat ini, biarkan kumpulan operasi pertama dipilih.

    Jenis Port: TertundaStockKutipanSoap Pilih ketiga operasi WSDL. Biarkan setelan lain apa adanya.

  8. Klik Berikutnya.
  9. Di halaman Keamanan, pilih Lewati (tidak ada).
  10. Klik Berikutnya.
  11. Terima default Host Virtual, lalu klik Next.
  12. Di halaman Build, terima setelan default lalu klik Build and Deploy untuk menyetel Edge agar mulai menghasilkan proxy.

    Edge menghasilkan proxy RESTful API. Dari WSDL, metode ini menentukan operasi yang didukung, parameter input, dan sebagainya. Edge menyarankan metode HTTP yang akan digunakan untuk setiap operasi. Biasanya, Edge menerjemahkan operasi menjadi permintaan GET, yang berisi keuntungannya adalah dapat di-cache. Edge juga menyiapkan endpoint target backend, yang dapat bervariasi per operasi SOAP.

    Kecuali Anda menyesuaikan {i>proxy<i} baru (dan Anda tidak ada dalam tutorial ini), itu saja pasti ada. Anda dapat melanjutkan dengan menguji proxy baru.

Menguji proxy

Untuk mencoba proxy yang telah Anda buat, buka command prompt dan gunakan cURL. Ketikkan perintah di bawah, dengan:

  • ORG adalah nama organisasi Edge tempat Anda membuat proxy.
  • ENV adalah lingkungan tempat proxy di-deploy.
  • DOMAIN sesuai dengan instance Edge yang Anda gunakan.
curl "https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

Misalnya, jika organisasi Anda adalah docfood, lingkungan adalah test, dan Anda menggunakan cloud perusahaan Edge, Anda akan menjalankan perintah seperti ini:

curl "https://docfood-test.apigee.net/delayedstockquote/quote?StockSymbol=GOOG&LicenseKey=0"

Jika Anda memasukkan GOOG untuk parameter kueri StockSymbol, Anda akan mendapatkan harga saat ini untuk saham Alphabet Inc. Kelas C. Contoh:

{  
   "GetQuoteResponse":{  
      "GetQuoteResult":{  
         "StockSymbol":"GOOG",
         "LastTradeAmount":819.55,
         "LastTradeDateTime":"2017-02-13T14:33:00",
         "StockChange":5.88,
         "OpenAmount":816.0,
         "DayHigh":820.96,
         "DayLow":815.49,
         "StockVolume":785064,
         "PrevCls":813.67,
         "ChangePercent":"+0.72%",
         "FiftyTwoWeekRange":"663.28 - 841.95",
         "EarnPerShare":27.88,
         "PE":29.4,
         "CompanyName":"Alphabet Inc.",
         "QuoteError":false
      }
   }
}

Mendapatkan OpenAPI yang dibuat secara otomatis Spesifikasi

Saat Anda melakukan {i>proxy<i} layanan SOAP menggunakan "REST to SOAP to REST," Edge secara otomatis membuat Spesifikasi OpenAPI. Anda dapat menggunakan Spesifikasi OpenAPI untuk menghasilkan dokumentasi API untuk API.

Untuk mendapatkan Spesifikasi OpenAPI, cukup kunjungi URL ini:

curl https://{ORG}-{ENV}.{DOMAIN}/delayedstockquote/openapi.json

Kredit tambahan: Cara apakah Anda mengetahui sumber daya, kata kerja, dan parameter kueri mana yang harus digunakan?

Dalam panggilan API pengujian, Anda menggunakan resource dan parameter kueri tertentu dalam panggilan cURL ke layanan SOAP backend. Tetapi bagaimana Anda mengetahuinya sendiri?

Resource dan verba

Di wizard proxy API saat Anda membuat proxy, Anda melihat bagaimana operasi SOAP akan dipetakan ke kata kerja dan resource API. Tetapi jika Anda tidak mencatatnya, berikut ini cara Anda cari tahu setelah {i>proxy<i} dibuat.

Pada tab Develop proxy API, di panel Navigator sebelah kiri, Anda akan melihat daftar alur di bawah Proxy Endpoints. Klik alur yang Anda minati. Misalnya, alur GetQuote adalah kandidat yang baik. Kemudian lihat XML di panel Code, yang menunjukkan jalur resource dan kata kerja untuk flow di <Condition> : /quote dan GET.

Parameter kueri

Dengan alur GetQuote yang dipilih, klik kebijakan pertama di elemen tampilan alur. Seharusnya itu adalah kebijakan Ekstrak Variabel yang merekam parameter kueri yang diharapkan lulus: StockSymbol dan LicenseKey. (Jika Anda melakukan mencari layanan SOAP, hal itu akan memberi tahu Anda apa yang harus diteruskan untuk LicenseKey.)

Parameter kueri yang diambil disimpan sebagai variabel dan digunakan oleh kebijakan berikutnya untuk membangun pesan SOAP.