Skip to content

feat: regenerate with the catalog and webhook routes and expose them - #8

Merged
nathanfallet merged 4 commits into
mainfrom
feature/catalogs-and-webhooks
Oct 24, 2026
Merged

nathanfallet merged 4 commits into
mainfrom
feature/catalogs-and-webhooks

Conversation

@nathanfallet

@nathanfallet nathanfallet commented Oct 24, 2026 •

Copy link
Copy Markdown
Member

What

  • .spec-sha256 and the generated client regenerated by scripts/generate.sh from the OpenAPI document of the API, with every route of /api/public/v1: the catalog (/catalogs/...) and the webhooks (/webhook-endpoints/..., /events, /webhook-event-types) are now included. No manual edit of generated code.
  • catalogs(): categories (list, get, fields of a category), brands (q prefix), sizes, colors, conditions, package sizes, materials, each list with its …All iterable. Needs items:read.
  • webhooks(): endpoints, endpoint, createEndpoint (returns the signing secret), updateEndpoint (merge patch, setDescription(null) sends an explicit null), deleteEndpoint, secret, rotateSecret, test, deliveries / deliveriesAll, retryDelivery, recover, events / eventsAll (types joined by commas), eventTypes. Every POST carries an Idempotency-Key, the same across retries.
  • An event's data is a free-form Map<String, Object>: its fields depend on the event type.
  • README: catalog and webhooks examples. Tests against a local stub server for the catalog, endpoint creation, merge patch null, event iteration, deliveries, retry, delete and test.
  • favorites() (list / listAll, listItem / listAllItem) for GET /favorites and GET /items/{id}/favorites, and a conversations().list / listAll overload with buyerId, itemId and offerStatus (the former signatures stay). Needs items:read. Regenerated from the production document of api 2.122.0 (adds the Favorite, FavoriteItem and FavoritePage models and the buyerId of a conversation).

Validation

mvn verify: 34 tests, 0 failures.

Not done

Nothing is published (no tag, no release, nothing on Maven Central).

Supersedes #7.

The client is regenerated from the OpenAPI document of the API with every route, the
catalog and the webhooks included. catalogs() reads the identifiers an item is written
with; webhooks() manages the endpoints, their secrets and deliveries, and reads the
events of the last 7 days.
@nathanfallet
nathanfallet marked this pull request as ready for review October 24, 2026 03:15
@nathanfallet
nathanfallet merged commit 0b9e85a into main Oct 24, 2026
3 checks passed
@nathanfallet
nathanfallet deleted the feature/catalogs-and-webhooks branch October 24, 2026 09:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant