January 2022 SP-API Release
On January 19 2022 Amazon launched a consolidated SP‑API documentation hub at developer‑docs.amazon.com. The portal centralizes all manuals, SDK downloads and interactive cURL examples, adds a version selector and a request‑builder tool, and provides one‑click Java, Python and C# client libraries.
Overview
On January 19 2022 Amazon introduced a consolidated documentation hub for its Selling Partner API (SP‑API) at developer‑docs.amazon.com. The new portal gathers every reference guide, SDK download, and interactive example into one searchable site. Sellers and developers who rely on SP‑API for inventory, order, or advertising automation must learn the layout to keep their integrations running without interruption.
Key Points
- Single‑source portal — All SP‑API manuals, code snippets, and SDK links now live under one domain, eliminating the need to hop between scattered Amazon sub‑sites.
- Domain‑oriented menu — A left‑hand navigation panel groups endpoints by business area such as Orders, Listings, Feeds, and Advertising, allowing a developer to locate the “GetOrder” call in seconds.
- Live, copy‑ready examples — Interactive code blocks provide ready‑to‑paste cURL or SDK snippets for common tasks like fetching a product’s price, reducing manual transcription errors.
- Explicit version stamps — Every endpoint page shows a “last updated” date and version selector, so sellers can instantly verify they are using the current schema for operations such as inventory feed uploads.
- One‑click SDK access — Pre‑compiled client libraries for Java, Python, and C# appear on each reference page, cutting the setup time for a new development environment by minutes.
- Search‑first experience — A top‑right search bar ranks results by relevance; typing “order acknowledgments” returns the exact endpoint documentation within a couple of clicks.
How the New Documentation Works
- Landing dashboard — The home page presents cards for each SP‑API product family; a seller building a price‑update bot can click the “Listings Items” card and be taken directly to that API’s overview.
- Side‑panel navigation — Selecting a product family expands a vertical menu with sections like “Endpoints,” “Schemas,” and “Error handling.” For example, a developer needing the “CreateFeedDocument” call expands the “Feeds” panel and lands on a page that lists required parameters, response samples, and a copy‑ready cURL command.
Analysis & Recommendations
Why This Matters
The single‑source portal lets sellers generate accurate requests instantly, reducing transcription errors and cutting SDK setup time by minutes. Version stamps and change‑log panels help prevent mismatched schemas, so integrations stay compliant with new headers like sellerId for UpdateInventory.
Key Takeaways
- Launch date: January 19 2022, new hub at developer‑docs.amazon.com.
- All SP‑API reference guides, SDKs and interactive examples now live under one domain.
- Interactive request builder creates ready‑to‑paste cURL or SDK snippets and supports sandbox testing.
- Version selector shows "last updated" dates and lets users switch between v0, v1 and beta releases.
Recommended Actions
- →Audit existing API calls on developer‑docs.amazon.com > SP‑API > each product family and verify required headers (e.g., sellerId for UpdateInventory).
- →Download the latest Java, Python or C# SDKs from the portal’s download buttons and replace older libraries in your codebase.
- →Use the request‑builder on endpoint pages to generate sample requests, paste them into Postman, and update your integration to match the current sc...
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!