Sumber-Sumber Teratas Bagi Para Arsitek dan Pengembang API

Kami harap Anda menikmati membaca seri artikel kami tentang arsitektur dan pengembangan API. Kami menulis tentang praktik terbaik (best practives) untuk REST API menggunakan Amazon API Gateway dan GraphQL API menggunakan AWS AppSync. Tulisan ini akan membahas sumber-sumber teratas yang harus diperhatikan oleh semua pengembang API.

Tech Talks, Webinar, dan Twitch Live Stream

Staf teknis di AWS telah menghasilkan berbagai media digital yang mencakup peluncuran layanan baru, praktik terbaik, dan pertanyaan-pertanyaan pelanggan. Pastikan untuk meninjau video ini untuk kiat dan trik membangun API:

• Happy Little APIs: Ini adalah seri multi bagian yang diproduksi oleh Advokat Pengembang kami yang mengagumkan, Eric Johnson. Dia memimpin serangkaian pembicaraan yang menunjukkan bagaimana membangun API dunia nyata.
• API Gateway’s WebSocket webinar: API Gateway sekarang mendukung API waktu nyata (realtime) dengan Websockets. Webinar ini membahas cara menggunakan fitur ini dan mengapa Anda harus menggunakan API Gateway untuk mengelola API realtime Anda.
• Best practices for building enterprise grade APIs: API Gateway mengurangi waktu yang diperlukan untuk membangun dan menggunakan pengembangan REST tetapi ada beberapa strategi yang dapat membuat pengembangan, keamanan, dan manajemen lebih mudah.
• An Intro to AWS AppSync and GraphQL: AppSync membantu Anda membangun aplikasi data yang canggih dengan kemampuan realtime dan offline.

Dapatkan Pengalaman dengan Praktek dan Contoh-Contoh

Salah satu cara termudah untuk memulai pengembangan serverless REST API adalah dengan menggunakan Serverless Application Model (SAM). SAM memungkinkan Anda menjalankan fungsi API dan Lambda secara lokal di mesin Anda untuk pengembangan dan pengujian yang mudah.

Sebagai contoh, Anda dapat mengonfigurasi API Gateway sebagai sumber sebuah Event untuk Lambda hanya dengan beberapa baris kode:

Type: Api
Properties:
Path: /photos
Method: post

Ada banyak contoh bagus di halaman GitHub kami untuk membantu Anda memulai dengan Authorization (IAM, Cognito), Request, Respons, berbagai policies, dan konfigurasi CORS untuk API Gateway.

Jika Anda bekerja dengan GraphQL, Anda harus meninjau Amplify Framework. Ini adalah proyek resmi AWS yang membantu Anda dengan cepat membangun Aplikasi Web dengan AuthN bawaan dan API backend menggunakan REST atau GraphQL. Dengan hanya beberapa baris kode, Anda dapat meminta Amplify menambahkan semua konfigurasi yang diperlukan untuk GraphQL API Anda. Anda memiliki dua opsi untuk mengintegrasikan aplikasi Anda dengan API AppSync:

1. Langsung menggunakan Amplify GraphQL Client
2. Menggunakan AWS AppSync SDK

Sebuah video penjelasan langkah demi langkah dari Amplify toolkit tersedia di sini, termasuk contoh yang menunjukkan cara membuat aplikasi web satu halaman menggunakan ReactJS didukung oleh AppSync GraphQL API.

Terakhir, jika Anda tertarik pada pengalaman penuh dalam melakukan praktik pembangunan, lihat:

• Amazon API Gateway WildRydes Workshop. Lokakarya ini mengajarkan Anda bagaimana membangun aplikasi web satu halaman (single page web app) yang fungsional dengan backend REST, didukung oleh API Gateway.
• AWS AppSync GraphQL Photo Workshop. Lokakarya ini mengajarkan Anda cara menggunakan Amplify untuk membangun dengan cepat sebuah aplikasi web berbagi Foto, didukung oleh AppSync.

Dokumentasi Lain yang Cukup Berguna

Dokumentasi resmi AWS adalah sumber terpecaya bagi para arsitek dan pengembang. Mulai dengan panduan pengembang API Gateway. API Gateway saat ini memiliki dua API (V1 dan V2) untuk mengelola layanan. Di sinilah Anda dapat melihat referensi SDK dan CLI.

Anda bisa memulai dengan panduan pengembang AppSync, dan lihat juga AppSync API Management.

Ringkasan

Sebagai seorang arsitek API, pekerjaan Anda tidak hanya merancang dan mengimplementasikan API yang baik untuk kasus Anda, tetapi pekerjaan Anda juga untuk mengetahui jenis API mana yang paling hemat biaya untuk produk Anda. Sebagai contoh, sebuah aplikasi dengan volume permintaan tinggi (“chatty“) lebih cocok mengimplementasikan GraphQL dibanding menggunakan REST.

API Gateway saat ini memungut biaya $3,50/sejuta requests dan memberikan layanan gratis (free tier) untuk tiap 1 Juta requests per bulan. Ada harga berjenjang yang akan mengurangi biaya Anda saat volume permintaan naik. AppSync saat ini mengenakan biaya $4,00/sejuta per permintaan Query dan Mutation.

Sementara harga AppSync per permintaan sedikit lebih tinggi, perlu diingat bahwa sifat GraphQL API biasanya menghasilkan angka permintaan keseluruhan yang secara signifikan jauh lebih sedikit.

Tulisan ini berasal dari artikel Top Resources for API Architects and Developers yang ditulis oleh George Mao serta diterjemahkan oleh Eryan Ariobowo.