Merancang integrasi SMM API yang bertahan dari kegagalan

Versi pertama dari setiap integrasi API mengasumsikan happy path: Anda mengirim permintaan, Anda mendapat respons, pesanan dibuat. Produksi mengajarkan hal lain kepada Anda. Jaringan terputus, endpoint kehabisan waktu, dan kegagalan paling berbahaya adalah kegagalan yang ambigu: permintaan yang mungkin berhasil atau mungkin tidak sebelum koneksi mati. Merancang untuk ambiguitas itulah keseluruhan pekerjaannya.

Idempotensi adalah pertahanan inti. Lampirkan key unik pada setiap permintaan pesanan dan biarkan server memperlakukan pengulangan key tersebut sebagai operasi yang sama, bukan operasi baru. Kini retry setelah timeout menjadi aman: jika yang asli berhasil terkirim, Anda mendapatkan kembali pesanan yang sudah ada alih-alih penagihan ganda. Tanpa ini, setiap retry adalah taruhan dengan saldo Anda.

Lapisi retry dengan backoff di atasnya. Error sementara (rate limit 429, 503, reset jaringan) harus dicoba ulang dengan penundaan yang meningkat dan batas atas, bukan dibombardir secara instan. Error permanen (bad request 400, respons saldo tidak cukup) harus gagal dengan cepat dan muncul ke manusia, karena mencoba ulangnya hanya membuang waktu dan mengaburkan masalah yang sebenarnya.

Terakhir, rekonsiliasi. Catat setiap permintaan dan respons beserta idempotency key dan order ID-nya, lalu jalankan tugas berkala yang membandingkan catatan Anda dengan status pesanan di panel. Rekonsiliasi adalah yang menangkap pesanan yang berhasil di panel tetapi gagal tercatat di sisi Anda. API SocialGO mengembalikan order ID dan status yang konsisten secara khusus agar loop ini mudah dibangun: perbedaan antara otomatisasi yang Anda percaya dan otomatisasi yang harus Anda awasi terus.