Proyek API Blueprint , yang dulunya merupakan alternatif menjanjikan untuk OpenAPI / Swagger dalam dokumentasi API, secara efektif telah dinyatakan mati oleh komunitas developer. Bahasa deskripsi API tingkat tinggi yang bertujuan membuat desain API lebih mudah diakses melalui sintaks berbasis Markdown ini tidak lagi dipelihara secara aktif.
Spesifikasi Kunci API Blueprint:
- Tipe media:
text/vnd.apiblueprint - Ekstensi file:
.apib - Lisensi: MIT
- Sintaks: Berbasis Markdown
- Dukungan GitHub: Dukungan syntax highlighting penuh
Akuisisi Oracle Membunuh Pengembangan Komunitas
Kematian proyek ini dapat ditelusuri kembali ke akuisisi Oracle terhadap perusahaan di balik API Blueprint . Setelah pembelian tersebut, semua repository publik diarsipkan oleh pemiliknya, meninggalkan komunitas open-source tanpa dukungan resmi atau arahan pengembangan. Repository GitHub kini menampilkan status archived by owner yang menjadi tanda berakhirnya pengembangan aktif.
Pola akuisisi korporat ini telah menjadi familiar di dunia teknologi, di mana proyek-proyek open-source yang menjanjikan diserap ke dalam perusahaan yang lebih besar hanya untuk diam-diam dihentikan ketika tidak selaras dengan prioritas korporat.
Komunitas Mempertanyakan Upaya Kebangkitan Proyek
Meskipun telah ditinggalkan secara resmi, beberapa developer masih menemukan API Blueprint dan memposting tentangnya di platform media sosial, yang menyebabkan kebingungan tentang status proyek saat ini. Anggota komunitas dengan cepat menunjukkan bahwa postingan-postingan ini merepresentasikan informasi yang sudah usang daripada pembaruan proyek yang sesungguhnya.
Bingung mengapa ini diposting sekarang - proyeknya sudah mati selama bertahun-tahun sepertinya.
Ketidakselarasan ini menyoroti bagaimana proyek-proyek yang ditinggalkan dapat terus beredar di komunitas developer lama setelah kegunaan praktisnya berakhir.
Keunggulan Teknis Hilang karena Alternatif yang Lebih Baik
Kekuatan inti API Blueprint terletak pada pendekatan berbasis Markdown -nya, yang membuat spesifikasi jauh lebih mudah dibaca di editor teks biasa dibandingkan dengan format YAML milik OpenAPI . Bahasa ini juga mendukung styling dokumentasi yang kaya dan diakui secara resmi oleh GitHub dengan syntax highlighting untuk file .apib.
Namun, proyek ini menghadapi keterbatasan dalam menangani skenario API yang kompleks, seperti menentukan beberapa jenis respons dengan header konten yang berbeda. Sementara itu, OpenAPI berkembang secara signifikan, menambahkan fitur-fitur canggih seperti polimorfisme melalui konstruksi oneOf, meskipun beberapa developer berargumen bahwa ini membuatnya terlalu kompleks.
TypeSpec milik Microsoft telah muncul sebagai alternatif modern, dikembangkan secara aktif dan digunakan untuk layanan Azure . Tidak seperti API Blueprint yang ditinggalkan, TypeSpec menikmati dukungan korporat dan terus berkembang dengan penggunaan enterprise di dunia nyata.
Alternatif Modern untuk API Blueprint:
- OpenAPI/Swagger: Standar industri, berbasis YAML, perangkat yang ekstensif
- Microsoft TypeSpec: Dikembangkan secara aktif, digunakan untuk layanan Azure
- JSON Schema: Untuk definisi struktur data
- AsyncAPI: Untuk API yang digerakkan oleh event
Pelajaran untuk Keberlanjutan Open Source
Kisah API Blueprint berfungsi sebagai pengingat akan kerapuhan proyek-proyek open-source yang sangat bergantung pada sponsor korporat. Meskipun proyek ini secara teknis di-open-source-kan di bawah lisensi MIT , kenyataan praktisnya adalah bahwa pengembangan komunitas tidak dapat mempertahankan momentum setelah dukungan korporat menghilang.
Untuk developer yang saat ini menggunakan API Blueprint , migrasi ke alternatif yang dipelihara secara aktif seperti OpenAPI atau TypeSpec menjadi semakin diperlukan karena ekosistem bergerak maju tanpa jaminan kompatibilitas mundur.
Referensi: api blueprint