
Penting: integrasi pada User API akan berhenti berfungsi mulai 1 Januari 2027
Kami menonaktifkan User API — API lama FoodSoul, yang sebelumnya digunakan untuk mengubah status pesanan, memperbarui harga dan wilayah pengantaran, serta mengelola kurir. API ini sudah lama tidak diperbarui: semua fitur baru kini kami tambahkan ke CRM API.
Jika integrasi Anda berjalan melalui User API, Anda harus memindahkannya ke CRM API sebelum 1 Januari. Jika tidak, setelah tanggal tersebut FoodSoul akan membalas semua permintaan dengan pesan kesalahan. Cara mempersiapkan migrasi dijelaskan di bawah ini.
Cara memeriksa integrasi
Pengecekan apakah integrasi Anda menggunakan User API dapat dilakukan oleh pengembang. Integrasi seperti ini mengirimkan permintaan ke alamat berikut:
- https://foodsoul.ru/api/user/v1/ (juga by.) — versi pertama;
- https://foodsoul.ru/api/user/v2/ (juga by.) — versi kedua.
Jika Anda tidak yakin, tanyakan kepada pihak yang mengelola integrasi Anda, atau hubungi dukungan.
Keuntungan migrasi
CRM API memiliki kemampuan jauh lebih banyak dibandingkan User API: Anda dapat mengelola pesanan dan kartunya, menu, daftar stop dan stok, pelanggan, promosi, serta laporan.
Perlu disebutkan secara khusus tentang webhook. Dengan webhook, CRM secara otomatis memberi tahu sistem Anda tentang suatu peristiwa — misalnya, pesanan baru atau perubahan status — sehingga integrasi tidak perlu terus-menerus melakukan polling ke API.
Keunggulan lain adalah token akses terpisah. Setiap integrasi dapat diberikan token tersendiri dengan hak akses yang sesuai, dan jika perlu dapat diblokir atau dihapus kapan saja.
Cara migrasi
- Buat token API di CRM: “Integrasi” → “Token akses ke API”. Simpan token tersebut segera: token hanya ditampilkan satu kali, saat pembuatan.
- Berikan token dan tautan ke dokumentasi CRM API kepada pengembang Anda.
- Pengembang akan memindahkan integrasi ke CRM API. Mengganti alamat saja tidak cukup: aksi sekarang ditentukan dalam URL permintaan, dan daftar field yang dikirim dalam permintaan dan respons telah berubah.
Kami ingatkan, semua ini harus dilakukan sebelum 1 Januari 2027.
Dokumentasi lengkap CRM API tersedia di portal FoodSoul: docs.foodsoul.ru. Jika Anda membutuhkan bantuan dalam proses migrasi, silakan hubungi dukungan.
Hormat kami, tim FoodSoul! Kami bekerja untuk Anda!