Takealot Seller API PHP SDK – Baca Penjualan, Penawaran, Transaksi & Saldo

Deskripsi

Takealot Marketplace API Integration Toolkit adalah kerangka kerja PHP yang tidak terikat framework, dirancang untuk penjual di Takealot, platform e-commerce terbesar di Afrika Selatan. Ini menyediakan antarmuka yang bersih dan aman jenis untuk membaca data penjualan, penawaran, transaksi, saldo, pengembalian, pengiriman, fasilitas, dan informasi akun Anda langsung dari Takealot Marketplace API.

Takealot adalah platform belanja online terkemuka di Afrika Selatan, dengan jutaan produk di 28 departemen dan posisi pasar dominan di antara platform e-commerce lokal. Platform ini menawarkan pengiriman ke seluruh negeri, berbagai pilihan pembayaran (termasuk bayar di tempat, SnapScan, dan EFT), serta portal penjual untuk mengelola daftar dan pesanan.

SDK ini membungkus Takealot Marketplace API publik di https://marketplace-api.takealot.com/v1 dan dibangun berdasarkan dokumentasi API publik saat ini. Ini bersifat baca-saja dan aman — hanya mengakses endpoint GET dan tidak pernah membuat, memperbarui, atau menonaktifkan apa pun di akun penjual Anda, sehingga menghilangkan risiko perubahan harga yang tidak disengaja atau penawaran yang dinonaktifkan.

Fitur Utama
Tidak terikat framework: Menggunakan PSR-18 (HTTP client), PSR-17 (pabrik), dan PSR-7 (pesan). Tanpa Laravel, tanpa Symfony, tanpa status global — cukup masukkan ke dalam proyek PHP modern mana pun.

Baca-saja dan aman: Hanya membungkus endpoint GET. Tidak ada risiko memodifikasi akun Anda.

DTO aman jenis: Objek respons read-only dengan validasi bentuk yang ketat. Payload upstream yang tidak terstruktur akan gagal dengan keras daripada membocorkan array yang tidak bertipe.

Paginasian token lanjutan: Dua cara untuk melakukan paginasi — ambil satu halaman dan ikuti token sendiri, atau gunakan iterate() dengan Generator malas yang menjelajahi setiap halaman secara transparan.

Penanganan otomatis batas laju: Respons HTTP 429 akan dicoba ulang secara otomatis, menghormati header Retry-After dengan backoff eksponensial sebagai cadangan.

Hierarki pengecualian bertipe: 400, 401/403, 404, dan 429 masing-masing dipetakan ke subclass pengecualian yang berbeda.

Dikeraskan secara default: Batas badan respons 8 MiB, batas kedalaman JSON 64, dan pembungkus kesalahan transportasi PSR-18 yang menghapus header X-API-Key dari pesan bocor.

PHPStan level 9: Tipe ketat di seluruhnya, nol kesalahan analisis statis.

Yang Dapat Anda Baca
Endpoint Deskripsi
Sales Data penjualan Anda
Offers Daftar pasar Anda dengan harga dan stok
Transactions Riwayat transaksi
Balances Informasi saldo akun
Returns Permintaan pengembalian dan status
Shipments Pelacakan pengiriman dan detail
Facilities Wilayah dan fasilitas yang diaktifkan
Seller Informasi akun
Persyaratan
PHP 8.2 atau lebih baru

HTTP client PSR-18 (Guzzle 7 direkomendasikan dan secara otomatis ditemukan melalui php-http/discovery)

Akun Penjual Takealot dengan kunci API yang dihasilkan di Portal Penjual di bawah Pengaturan → Akses API

File yang Disertakan
src/ — Berkas sumber SDK

examples/ — Contoh penggunaan

composer.json — Konfigurasi Composer

README.md — Dokumentasi lengkap

LICENSE — Berkas lisensi

Sempurna Untuk
Penjual Takealot, pengembang e-commerce, integrator pasar, dan siapa pun yang membangun alat untuk mengelola akun penjual Takealot secara terprogram.