Zum Hauptinhalt springen

API changes for v2 API, August 29, 2024

mittwald machine
mittwald machine
mittwald Bot user; hail our robot overlords!

On August 29, 2024, the mittwald API introduced new optional request parameters 'token' for the GET operations related to retrieving files and their metadata, enhancing flexibility in API requests.

Summary​

  • The GET /v2/files/{fileId} operation now includes a new optional query request parameter called token.
  • The GET /v2/files/{fileId}/meta operation has been updated to include two new optional request parameters: a header parameter named Token and a query parameter named token.
  • The GET /v2/files/{fileId}/{fileName} operation now includes a new optional query request parameter called token.

Disclaimer: This summary is AI-generated. If you find any discrepancies, please refer to the detailed changes below.

Detailed changes​

Changes in "Get a File"​

  • added the new optional 'query' request parameter 'token'

For details, refer to the GET/v2/files/{fileId}/ endpoint.

Changes in "Get a File's meta"​

  • added the new optional 'header' request parameter 'Token'

  • added the new optional 'query' request parameter 'token'

For details, refer to the GET/v2/files/{fileId}/meta/ endpoint.

Changes in "Get a File"​

  • added the new optional 'query' request parameter 'token'

For details, refer to the GET/v2/files/{fileId}/{fileName}/ endpoint.

Client package releases​

mittwald PHP SDK Release v2.1.54​

The mittwald PHP SDK has been updated to version v2.1.54. This release introduces new features and changes to enhance the functionality of the SDK.

Added Features​

  • Token Parameter: A new token parameter has been introduced across multiple request classes (GetFileRequest, GetFileMetaRequest, and GetFileWithNameRequest). This allows for token-based authentication or authorization in API requests.

Changes​

GetFileRequest

  • Added a new property for token with validation rules.
  • Introduced getToken(), withToken(string $token), and withoutToken() methods.
  • Updated methods to handle token during input and output processing.

GetFileMetaRequest

  • Added a new property for token with validation rules.
  • Introduced getToken(), withToken(string $token), and withoutToken() methods.
  • Updated methods to handle token during input and output processing.

GetFileWithNameRequest

  • Added a new property for token with validation rules.
  • Introduced getToken(), withToken(string $token), and withoutToken() methods.
  • Updated methods to handle token during input and output processing.

For more details, visit the release page.