Skip to content

1.1.0

Choose a tag to compare

@exoszajzbuk exoszajzbuk released this 18 Oct 10:06
· 38 commits to main since this release

Below you can find explanations of breaking and otherwise notable changes in this release. For a complete list of changes please refer to 📖 CHANGELOG.md and 📚 openapi.yaml in the repository.

Notable Changes

External ID for Bids

A new string field called externalId is introduced for the submitLongTermAuctionBids and submitDayAheadOrIntraDayAuctionBids endpoints which allows Participants to tag their bids with an arbitrary external identifier of their choice. This can be used for example to identify bids made by different traders.

The value of externalId is returned on the getLongTermAuctionBids and getDayAheadOrIntraDayBids endpoints, and will be displayed on the Web Frontend in a tooltip (although only editable through the Platform API).

Additional Filters for Auction Results List

In API version 1.1.0 authenticated counterparts of the Public / Allocated Auctions endpoints are introduced under the Allocated Auctions tag serving an authenticated version of the Auction Results List.

This allowed us to add filters for cleared Auctions that a Participant has either placed bids on, or even received some capacity from.

The authenticated endpoints has two optional parameters introduced called X-Participant-Id and participantStatus which can be used with the following logic:

  • either both or none of them need to be specified
  • Participants must submit their own Participant ID in the request
  • control the filtering with the PLACED_BIDS or RECEIVED_CAPACITY values in the participantStatus parameter

Resend / Revoke User Invites

In order to ease the onboarding process, once a User has been confirmed and initially invited by BritNed and Empire Helpdesk, Participants can control resending and revoking invitations for these Users.

This means that the resendUserInvite and revokeUserInvite endpoints are now accessible with the MANAGE_OWN_USERS and MANAGE_ANY_USERS Permissions, in practice attached to the "Participant Admin" role.

This change will be reflected on the Web Frontend as well, enabling the "Resend" and "Revoke" buttons when the necessary Permissions are present.

Pre-Nomination Options

A new endpoint called getAggregatedPreNominationOptions has been added which allows the querying if pre-nominations already exist for the given X-Participant-Id for the specified deliveryDay - Participants must submit their own Participant ID.

Auction List Status Filtering

The optional status filter parameter in the getAuctions and getPublicAuctions endpoints has been previously specified with the full set of valid Auction Statuses.

As the Auction Schedule List (which is served by the above mentioned endpoints) by definition does not contain Auctions in the FINAL_RESULTS_PUBLISHED status, this value is now removed from the valid filter options to further clarification.

Fixing Python SDK date/time handling

Issues #4 and #5 has been raised about the incorrect date/time handling in the Python Client SDK which are mitigated with this release.