Takealot Seller API PHP SDK – Umsätze, Angebote, Transaktionen & Guthaben auslesen

Beschreibung

Takealot Marketplace API-Integrations-Toolkit ist ein framework-unabhängiges PHP-SDK, das speziell für Verkäufer auf Takealot, der größten E-Commerce-Plattform Südafrikas, entwickelt wurde. Es bietet eine klare, typsichere Schnittstelle, um Ihre Verkäuferumsätze, Angebote, Transaktionen, Guthaben, Rückgaben, Sendungen, Einrichtungen und Kontoinformationen direkt aus der Takealot Marketplace API auszulesen.

Takealot ist die führende Online-Einkaufsplattform Südafrikas mit Millionen von Produkten in 28 Kategorien und einer dominierenden Marktposition unter den lokalen E-Commerce-Plattformen. Die Plattform bietet landesweiten Versand, mehrere Zahlungsoptionen (inklusive Barzahlung bei Lieferung, SnapScan und EFT) sowie ein Verkäuferportal zur Verwaltung von Listings und Bestellungen.

Dieses SDK kapselt die öffentliche Takealot Marketplace API unter https://marketplace-api.takealot.com/v1 und basiert auf der aktuellen öffentlichen API-Dokumentation. Es ist schreibgeschützt und sicher – es greift ausschließlich auf GET-Endpunkte zu und nimmt niemals Änderungen, Aktualisierungen oder Deaktivierungen an Ihrem Verkäuferkonto vor, wodurch das Risiko versehentlicher Preisänderungen oder deaktivierter Angebote entfällt.

Wichtige Funktionen
Framework-unabhängig: Nutzt PSR-18 (HTTP-Client), PSR-17 (Fabriken) und PSR-7 (Nachrichten). Kein Laravel, kein Symfony, kein globaler Zustand – einfach in jedes moderne PHP-Projekt integrieren.

Schreibgeschützt und sicher: Greift ausschließlich auf GET-Endpunkte zu. Kein Risiko für Änderungen an Ihrem Konto.

Typsichere DTOs: Unveränderliche Antwortobjekte mit strenger Formvalidierung. Falsch formatierte Antworten scheitern lautstark, statt undefinierte Arrays zu verbreiten.

Paginierung mit Continuation-Token: Zwei Möglichkeiten zur Paginierung – Abruf einer einzelnen Seite und manuelle Verfolgung des Tokens oder Verwendung von iterate() mit einem trägen Generator, der alle Seiten transparent durchläuft.

Automatische Behandlung von Rate-Limits: HTTP-429-Antworten werden automatisch erneut versucht, wobei der Retry-After-Header mit exponentiellem Backoff als Fallback berücksichtigt wird.

Typhierarchie für Ausnahmen: 400, 401/403, 404 und 429 werden jeweils auf eine eigene Ausnahme-Unterklasse abgebildet.

Standardmäßig abgesichert: 8-MiB-Begrenzung für Antwortkörper, JSON-Tiefenlimit von 64 sowie PSR-18-Transportfehler-Kapselung, die den X-API-Key-Header aus durchgesickerten Nachrichten entfernt.

PHPStan Level 9: Strenge Typisierung durchgehend, null statische Analysefehler.

Was Sie auslesen können
Endpunkt Beschreibung
Sales Ihre Verkäuferumsatzdaten
Offers Ihre Marktplatzangebote mit Preis und Bestand
Transactions Transaktionsverlauf
Balances Kontoguthaben-Informationen
Returns Rückgabeanfragen und -status
Shipments Sendungsverfolgung und -details
Facilities Aktivierte Regionen und Einrichtungen
Seller Kontoinformationen
Anforderungen
PHP 8.2 oder neuer

Ein PSR-18-HTTP-Client (empfohlen wird Guzzle 7, das automatisch über php-http/discovery erkannt wird)

Ein Takealot-Verkäuferkonto mit einem im Verkäuferportal unter Einstellungen → API-Zugriff generierten API-Key

Enthaltene Dateien
src/ — SDK-Quelldateien

examples/ — Anwendungsbeispiele

composer.json — Composer-Konfiguration

README.md — Vollständige Dokumentation

LICENSE — Lizenzdatei

Perfekt für
Takealot-Verkäufer, E-Commerce-Entwickler, Marktplatz-Integratoren und alle, die Tools zur programmatischen Verwaltung von Takealot-Verkäuferkonten erstellen.