Releases: dropstream/amazon_sp_clients
Releases · dropstream/amazon_sp_clients
Release list
v2.1.0
Added
client.orders_2026, the Orders API v2026-01-01, in V2 only.
search_ordersreplacesget_orders;get_orderreturns the items
and, throughincluded_data:, the buyer, recipient and other blocks
that v0 served from separate operations. The API takes no restricted
data token, so the methods have nordt:keyword. The body has no
payloadwrapper: readpayload[:orders]and
payload.dig(:pagination, :nextToken). README, "Orders API
v2026-01-01", lists the differences; Amazon's migration guide maps
the fields.rdt: falseincodegen-config.ymldrops therdt:keyword from a
module whose API never uses restricted data tokens.get_feed_documentandget_report_documenttake
enable_content_encoding_url_header:(V2), or the same key inopts
(v1), new in Amazon's specs.
Changed
- The Amazon models pin moves from 2025-02-26 to 2026-08-26. Apart from
the parameter above, the regenerated code differs only in comments.
Amazon marks every Orders v0 operation deprecated;orders_v0stays
in v1 and V2 until v1 is removed.
v2.0.1
Added
examples/auth_check.rb, a standalone script that shows which
credentials SP-API accepts. It calls the Orders API with a made-up
token and with a real access token, then asks LWA for a refresh with
and without the app credentials, and prints what each answer means.
It depends on nothing but this gem, or on Net::HTTP when the gem is
not in the bundle.examples/is not part of the built gem.rake release:prepare[X.Y.Z]prepares a release on a laptop: it
runs the suite, sets the version, dates the CHANGELOG entry, relocks
the lockfiles, commits and tags. Pushing the tag still publishes.
Changed
- The README and the spec comments no longer name any particular
consumer of the gem.lib/andvendor/are unchanged; for a
consumer, 2.0.1 is 2.0.0 with a new README.
v2.0.0
Added
- The
AmazonSpClients::V2namespace (require 'amazon_sp_clients/v2'):
a per-merchantClientwith an explicit, frozenConfiginstead of
the thread-local global; a thread-safe token source (a callback, or
LWA refresh with one exchange per expiry); restricted data tokens as
anrdt:argument with per-resource caching; typed errors under
V2::Error; and one generated class per API module, for the same 14
modules. Responses are the sameApiResponse. The README has the
usage and the v1 to V2 migration table. - Feed upload, feed result download and report download on the V2
client. Report documents come back gunzipped and UTF-8 tagged when
Amazon gzipped them. RDT.report_document(id), the resource list for a restricted report
document, next to theORDERSandORDERS_AND_ITEMSpresets.rake yard:verifyand a CI job that fail when a public V2 object
has no doc comment.- A second template set in the generator. Each
codegen-config.yml
entry lists its template sets. Generation now refuses to run while
tracked generated files belong to no configured module, and fails on
names that Ruby or the V2 method signature already use. - A release workflow. Pushing a
v*tag publishes the gem to
rubygems.org through Trusted Publishing and opens a GitHub Release
with the CHANGELOG entry.rake releaseis disabled.
Changed
- The gem is named
sp_api_clientson rubygems.org; the old name
started with a company name that is not ours. TheAmazonSpClients
namespace and theamazon_sp_clients/...require paths are
unchanged, andrequire 'sp_api_clients'loads the v1 entry point.
A host that still installsamazon_sp_clientsfrom git must drop
that line when it takes this gem: Bundler treats them as two gems,
and both ship the same files. The V2 default User-Agent names the
gem, so it changes too. - The built gem ships only
lib/,vendor/, the gemspec and the
top-level docs. Tests, the generator, CI config and dev tooling stay
out of it. - The deprecated AWS IAM and logger settings stay as no-ops. They were
announced for removal in 2.0, but every consumer still sets them, so
they leave together with the v1 API in a later major. - The Faraday requirement is unchanged (
>= 1.10, < 3). The major
version marks the new namespace, not a dependency change. v1 is
unchanged.
v1.7.0
v1.6.1
v1.6.0
What's Changed
Full Changelog: v1.5.2...v1.6.0