Akses API dan Otentikasi

SPREEAI menyediakan referensi API publik untuk alur kerja mitra yang disetujui: https://docs.spreeai.com/swagger/public/.

Model akses

Cakupan API, lingkungan, kredensial, dan operasi yang diizinkan disepakati selama proses orientasi mitra. Jangan berasumsi bahwa endpoint internal, pengembangan, atau historis tersedia di lingkungan produksi.

Aturan kredensial

• Simpan rahasia klien dan token akses hanya di penyimpanan rahasia sisi server yang aman.
• Jangan pernah memberikan kredensial ke Git, dokumentasi, pelacak masalah, tangkapan layar, atau aplikasi contoh.
• Jangan pernah mengirimkan kredensial ke platform analitik atau pencatatan log.
• Gunakan kredensial khusus lingkungan hanya dengan lingkungan tempat kredensial tersebut diterbitkan.
• Segera ganti kredensial jika kredensial tersebut terekspos.
• Hapus header otorisasi dan token dari permintaan dukungan.

Browser versus server

Web SDK menggunakan konfigurasi browser yang dikeluarkan oleh mitra. Rahasia klien tidak boleh disertakan dalam browser.

Integrasi sisi server harus mengikuti alur autentikasi dan definisi endpoint dalam referensi API yang disetujui saat ini. Jika operasi yang dibutuhkan tidak tersedia, mintalah melalui Partner Engineering alih-alih membuat rute yang tidak terdokumentasi.

Webhooks

Webhook server-push bukan bagian dari dokumentasi Web SDK yang diterbitkan saat ini. Konfirmasikan persyaratan webhook apa pun sebelum merancang dependensi yang bergantung padanya.

Daftar periksa lingkungan

• [ ] Nama lingkungan didokumentasikan.
• [ ] URL dasar berasal dari referensi yang disetujui atau serah terima orientasi.
• [ ] Kredensial dikeluarkan untuk lingkungan tersebut.
• [ ] Rahasia disimpan di sisi server.
• [ ] Log menyunting token dan gambar pelanggan.
• [ ] Batas waktu, percobaan ulang, dan perilaku idempotensi telah disepakati untuk operasi penulisan.
• [ ] Pengujian non-produksi berhasil sebelum akses produksi digunakan.