Mengapa strategi versi API itu penting

Azure API Management

Fiodar Sazanavets

Senior Software Engineer at Microsoft

Pengantar versioning API

Pengantar versi

Azure API Management

Dasar-dasar versioning API

Analogi versioning

  • Dipakai saat perubahan breaking membingungkan penumpang

  • Saat jalur baru dibangun, penumpang tetap pakai jalur lama

  • Revisi seperti perawatan pada jalur yang sama

    • Memperbaiki rel, menambah rambu, memperhalus perjalanan

  • Di APIM:

    • Versi hidup dalam version set
    • Revisi memungkinkan edit, uji, dan menandai satu sebagai current
Azure API Management

Penanda versi

  • Tiga strategi penanda versi didukung:
    • Versi dinyatakan di path URL
    • Versi ditentukan di header permintaan
    • Versi ditentukan di query string URL
  • Strategi versioning harus konsisten

Versioning path URL

Versioning header

Versioning query string

Azure API Management

Versi vs revisi

Versi vs revisi

Azure API Management

Rilis canary

Rilis canary

  • Hasil:
    • Jika umpan balik baik -> tandai revisi sebagai current
    • Jika buruk -> kembalikan ke revisi sebelumnya

  • Seperti uji dapur: sajikan resep baru ke beberapa meja dulu

  • Di APIM:

    • Buat revisi baru dan uji secara privat
    • Buka ke audiens terbatas (produk pilot atau subset pemanggil)
    • Arahkan ke revisi tertentu via URL khusus dengan nomor revisi

  • Metafora rel: penguji naik "jalur perawatan" tanpa mengganggu jalur utama

Azure API Management

Konsep kunci untuk diingat

  • Kapan memakai versi vs revisi
  • Mengonfigurasi skema versi
  • Menerapkan perubahan maju dan mundur

Manajemen API

Azure API Management

Ayo berlatih!

Azure API Management

Preparing Video For Download...