Overzicht
Amazon's Selling Partner API (SP-API) is de REST API die de verouderde Amazon MWS (Marketplace Web Service) vervangt voor programmatische toegang tot Amazon verkoper en leverancier data. Het dekt het volledige bereik van Amazon marktplaatsoperaties — lijstingbeheer, ophalen en uitvoering van orders, voorraadbeheer, prijsstelling, rapporten, financiële data, adverteren en de merkanalytics die geregistreerde merken benaderen.
De SP-API is één van de meer complexe derde-partij API-integraties om correct te bouwen. Authenticatie gebruikt AWS Signature Versie 4 met Login with Amazon (LWA) OAuth-tokens — een twee-laags authenticatiesysteem waarbij LWA de verkopersautorisatie biedt en AWS SigV4 elk individueel verzoek ondertekent.
Wij bouwen Amazon SP-API integraties voor Amazon-verkopers, multi-channel retailers, Amazon-serviceproviders en softwareplatforms die hun operaties moeten verbinden met Amazon-marktplaatsdata.
Wat Amazon SP-API Integratie Dekt
Authenticatie en autorisatie. SP-API authenticatie is het meest technisch veeleisende aspect van de integratie — een twee-laags systeem dat Amazon's Login with Amazon (LWA) OAuth-stroom combineert met AWS Signature Versie 4 voor verzoekondertekening.
LWA tokenbeheer: het OAuth 2.0 toegangstoken uitgegeven door Login with Amazon dat de applicatie autoriseert om namens een specifieke verkoper te handelen. LWA-tokens verlopen na één uur en moeten worden vernieuwd met het vernieuwingstoken verkregen tijdens de OAuth-autorisatiestroom. Tokenvernieuwen beheer — een nieuw toegangstoken aanvragen voor het huidige verloopt, vernieuwingsfouten afhandelen en tokens veilig opslaan.
AWS Signature Versie 4: het verzoekondertekeningsalgoritme dat Amazon vereist voor SP-API aanroepen. Elk SP-API verzoek moet een Authorization header bevatten berekend van de verzoekmethode, URL, headers en body met HMAC-SHA256 met AWS-credentials. Het SigV4-ondertekeningsproces: het canonieke verzoek aanmaken, de te ondertekenen string aanmaken, de handtekening berekenen, de autorisatieheader samenstellen.
Autorisatieverleningsstroom: de OAuth-autorisatiestroom die verkopers gebruiken om een applicatie toegang te verlenen tot hun Amazon-data. De autorisatie-URL met de applicatie client-ID, de redirect-URI en de vereiste scopes.
Orders API. De SP-API Orders sectie voor het ophalen en beheren van klantorders.
Order ophalen: het getOrders eindpunt dat orders retourneert die voldoen aan gespecificeerde criteria — aangemaakt na een specifieke datum, met specifieke orderstatussen, voor specifieke marktplaatsen. Gepagineerd ophalen van orders met het volgende token. Order detail ophalen met getOrder en getOrderItems voor de volledige orderinformatie inclusief regelitems, afleveradres en koperinformatie.
Orderstatus tracking: orders monitoren naarmate ze vorderen door Amazon's uitvoeringsworkflow.
Uitvoeringsbevestiging: voor Fulfilled by Merchant (FBM) verkopers, de createShipment indiening die bevestigt dat een order is verzonden en het trackingnummer verstrekt.
Listings API. Productlijstingen beheren op Amazon — aanmaken, bijwerken en beheren van de catalogusdata die Amazon aan klanten weergeeft.
Listing ophalen: het getListingsItem eindpunt. Listing aanmaken en updates: het putListingsItem eindpunt en het patchListingsItem eindpunt. Problemen en onderdrukking: de listingproblemen die Amazon rapporteert. Aanbieding beheer: de prijs- en beschikbaarheidsdata.
Feeds API. Bulkoperaties via Amazon's feedindieningssysteem — het mechanisme voor het verwerken van grote aantallen listing-updates, voorraadwijzigingen en prijswijzigingen.
Feed indiening: het createFeed eindpunt dat een feeddocument indient bij Amazon voor verwerking. De feed type die specificeert welk soort data de feed bevat. Het feeddocument uploaden naar de vooraf ondertekende S3 URL.
Feed verwerkingsstatus: het getFeed eindpunt dat de huidige verwerkingsstatus retourneert van een ingediende feed. Het feedverwerkingsrapport opgehaald na voltooiing.
Inventory API. FBA en FBM voorraadniveaus beheren zichtbaar voor Amazon-klanten.
FBA-voorraad: het getInventorySummaries eindpunt dat FBA-voorraadniveaus retourneert — de verkoopbare, niet-verkoopbare, gereserveerde en inkomende voorraadaantallen voor elk ASIN.
Voorraad updates voor FBM: het putListingsItem eindpunt met bijgewerkt kwantiteitsattribuut voor FBM-voorraadniveauwijzigingen.
Pricing API. Amazon productprijzen lezen en beheren.
Competitieve prijsstelling: het getCompetitivePricing eindpunt dat de huidige buy box prijs retourneert. Prijsupdates: het patchListingsItem eindpunt voor individuele prijsupdates en de prijsfeed voor bulkprijsupdates.
Reports API. Amazon's geplande en op-aanvraag rapporten voor operationele data.
Rapport types: de financiële rapporten, de voorraad rapporten, de orderrapporten, de prestatierapporten. Rapport aanvraag en ophalen: het createReport eindpunt, getReport polling, rapport document download. Geplande rapporten: het createReportSchedule eindpunt.
Financial API. Amazon financiële events voor boekhouding en reconciliatie.
Financiële eventgroepen: het listFinancialEventGroups eindpunt dat afwikkelingsperioden retourneert. Financiële events: het listFinancialEvents eindpunt. Vergoeding reconciliatie.
Notifications API. Realtime event-notificaties via Amazon's notificatiesysteem.
Notificatie abonnementen: het createSubscription eindpunt. Notificatie types: ORDER_CHANGE, LISTINGS_ITEM_STATUS_CHANGE, REPORT_PROCESSING_FINISHED, FBA_OUTBOUND_SHIPMENT_STATUS. SQS wachtrij verwerking.
Snelheidslimieten Beheer
Amazon handhaaft strikte snelheidslimieten op SP-API eindpunten, met verschillende limieten voor elke API-sectie.
Snelheidsplan bewustzijn. Elk SP-API eindpunt heeft een gedocumenteerde snelheid en burst limiet. Het begrijpen van het snelheidsplan voor elk eindpunt dat door de integratie wordt gebruikt is de vereiste voor het ontwerpen van verzoekplanning die de limieten respecteert.
Token bucket implementatie. Het token bucket algoritme dat Amazon's snelheidsbeperking modelleert — tokens accumuleren met de snelheidslimieten tot de burst limiet, en elk verzoek verbruikt één token.
Herproberen met backoff. De herproberenlogica die 429-reacties afhandelt — exponentiële backoff met jitter die gethrottelde verzoeken herprobeert na een progressief toenemende vertraging.
Multi-Marktplaats Ondersteuning
Amazon SP-API opereert over meerdere marktplaatsen — Amazon.com, Amazon.co.uk, Amazon.de, Amazon.fr, Amazon.nl, Amazon.es en anderen.
Marktplaats-ID's: de MarketplaceIds parameter geaccepteerd door de meeste SP-API eindpunten die het verzoek scopeert naar specifieke marktplaatsen. De marktplaats-ID voor Amazon.nl (A1805IZSGTT6HS).
Regionale eindpunten: de SP-API eindpunt basis-URL's die verschillen per regio — sellingpartnerapi-eu.amazon.com voor Europese marktplaatsen.
Cross-marktplaats rapportage: data aggregeren over meerdere marktplaatsen voor verkopers actief op meerdere markten.
Gebruikte Technologieën
- C# / ASP.NET Core — primaire SP-API integratie implementatie met de .NET HTTP-client, AWS SDK voor SigV4-ondertekening en JSON-verwerking
- Rust / Axum — hoge-prestatie orderverwerking en voorraadbeheer voor hoge-volume Amazon-verkopers
- Python — SP-API scripting, rapportverwerking en data-analysepijplijnen
- AWS SDK — SigV4 verzoekondertekening en STS roltoewijzing voor SP-API authenticatie
- AWS SQS — notificatieverwerking wachtrij voor realtime Amazon eventlevering
- AWS EventBridge — alternatieve notificatielevering voor complexe eventroutering
- SQL (PostgreSQL / MySQL) — orderdata opslag, voorraadtracking, financiële reconciliatiedata
- Redis — snelheidsbeperking token bucket status, caching van Amazon referentiedata, taakcoördinatie
- Hangfire / geplande taken — geplande synchronisatie voor orders, voorraad en rapporten
- Docker — gecontaineriseerde integratiedienst implementatie
- GitHub Actions — CI/CD pijplijn voor integratiedienst implementatie
Amazon SP-API in Multi-Channel Operaties
Voor bedrijven die via meerdere kanalen verkopen — Amazon naast hun eigen website, andere marktplaatsen en fysieke detailhandel — is de SP-API integratie één component van de multi-channel voorraad- en orderbeheerarchitectuur. Amazon-orders synchroniseren in het centrale orderbeheer systeem naast orders van andere kanalen. Voorraad updates van het centrale voorraadsysteem pushen naar Amazon's beschikbare hoeveelheid.
Amazon Operaties, Verbonden met Uw Systemen
Amazon SP-API integraties gebouwd voor de operationele schaal die Amazon-verkopen vereist — correcte authenticatie, snelheidslimieten-respecterende verzoekbeheer, uitgebreide order en voorraadsynchronisatie, financiële data voor reconciliatie en de realtime notificaties die uw systemen uitgelijnd houden met Amazon's eventstroom.