/v{major}
. For example, /registry/v0/supplier
.
v0
. If breaking changes are necessary, we’ll release a new major version.
We may deprecate APIs that have been replaced by a newer version. When doing so, we will expect
integrated partners to manage a transition to new resources within the deprecation timeline of old ones.
We will make the following sort of changes we do not consider to be breaking:
PaginatedListResource
which contains:
page_info
- Containing information regarding pagination cursors and the total number of entities.nodes
- Each node is a paginated entity.total_count
- The total size of the list across all pages.last
- An integer number of items to retrieve before the item represented by the cursor passed in the before
parameter. Defaults to 10 with a maximum value of 50.before
- An opaque cursor representing the first item in the previously requested page to select items ordered before it. Submit the previously requested page’s start_cursor
here when paginated backwards.first
- An integer number of items to retrieve after the item represented by the cursor passed in the after
parameter. Defaults to 10 with a maximum value of 50.after
- An opaque cursor representing the last item in the previously requested page to select items ordered after it. Submit the previously requested page’s end_cursor
here when paginated forwards./registry/v0/beneficiaries
will return a PaginatedListResource
of the first page of 10 items:
/registry/v0/beneficiaries?first=15&after=mpG5kcuoFBYtlH
will return a PaginatedListResource
of the next 15 items.
2024-01-22T11:56:48.520641Z
.
GBR
and USA
.