Merancang API yang berpusat pada pengguna — sebuah studi kasus
Informasi sensitif telah ditinggalkan dari studi kasus ini.
Konteks
Saya bekerja sebagai desainer UX senior di Kaluza , tempat kami membangun perkakas cerdas untuk pengecer energi. Ini termasuk dasbor dan layanan back-end. Satu penawaran penting adalah API kami, yang memberdayakan pelanggan untuk membuat produk mereka sendiri.
Sebagai bagian dari penawaran yang lebih luas kepada klien baru, kami ditugaskan merancang API untuk membantu menunjukkan status energi konsumen mereka untuk konfigurasi meteran pintar bernuansa. Karena organisasi berada di luar Inggris Raya, kebutuhan mereka sedikit berbeda dari yang biasa kami lakukan dengan klien domestik.
Kami bekerja di bawah batasan waktu yang ketat. Tidak banyak waktu yang dihabiskan untuk tahap apa pun dari karya ini. Dan kami memiliki sedikit akses ke klien untuk mengajukan pertanyaan.
Tujuan
Desain diminta untuk membantu tim:
- mengklarifikasi kebutuhan pengguna dari persyaratan pemangku kepentingan
- merancang bersama varian skema API kami yang ada, untuk memenuhi persyaratan ini dengan cara yang berpusat pada pengguna
- memvisualisasikan API ini kepada klien dengan cara yang dapat diakses, untuk validasi dan diskusi
Saya bekerja bersama manajer produk, pakar materi pelajaran dengan pengalaman industri yang relevan, dan tim pengembang. Kami hanya punya waktu beberapa minggu untuk menyelesaikan ini.
Orientasi
Kami memiliki skema (besar) untuk dijelajahi. Setiap bidang harus divalidasi sehingga saya sepenuhnya memahami apa yang dapat (dan tidak dapat) dilakukannya. Saya membuat kuesioner untuk tim pengembang untuk berkolaborasi secara asinkron, memvalidasi asumsi kami tentang setiap bidang.

Persyaratan klien
Kami perlu bekerja mundur dari brief klien yang singkat dan spesifik. Klien telah memberi kami tangkapan layar dari perangkat lunak energi yang ada yang ingin mereka buat ulang. Mereka meminta kami memberikan data tertentu untuk mengaktifkannya, menggunakan API yang sudah kami tawarkan kepada pelanggan di Inggris.
Saya mulai dengan mengorientasikan diri saya sendiri tentang cara kerja konfigurasi pengukur pintar pasar khusus ini, memetakan semuanya dengan pakar materi pelajaran kami. Kemudian saya memecah persyaratan klien menjadi hasil pengguna dan menyempurnakannya dengan kebutuhan pengguna dari penelitian sebelumnya.

Sebagai sebuah tim, kami memetakan perilaku pengguna yang diketahui yang mendukung setiap hasil yang teridentifikasi (masuk, membuka layar, meminta data, dll). Bekerja sama dengan pengembang, kami mengasumsikan perilaku backend bersama tindakan pengguna dan mencatat bagaimana API kami akan mendukung ini dengan baik.

Kemudian kami mengatur skema kami berdasarkan jenis hasil dan menandai bidang yang hilang yang akan diperlukan.
Berkomunikasi dengan klien
Kami menganotasi tangkapan layar UI klien dengan hasil, tindakan pengguna, apa yang mungkin dilakukan perangkat lunak mereka, dan bagaimana API kami akan mendukung ini. Tentunya kami juga menambahkan asumsi dan pertanyaan untuk didiskusikan.

Hasil
Klien senang dengan ilustrasi dan API yang kami usulkan. Mereka menindaklanjuti apa yang kami bagikan dan bagian aliran kerja perusahaan ini ditayangkan lebih cepat dari jadwal.
Kami sepakat untuk menindaklanjuti implementasi API ini dengan memfokuskan penelitian pada pengguna. Kami telah memulai inisiatif untuk meningkatkan keterampilan desainer, PM, dan peneliti tentang cara mendesain API secara efisien. Dan kami membuat template dan pelatihan untuk mendesainnya dengan cara yang berpusat pada manusia.
Bacaan yang disarankan
Dasar-dasar API: Merancang API Web oleh Brenda Jin, Saurabh Sahni, Amir Shevat
Fast UX Design: Lean UX: Menerapkan Prinsip Lean untuk Meningkatkan Pengalaman Pengguna oleh Jeff Gothelf, Josh Seiden