Releases: mittwald/api-client-php
v2.1.197
Breaking Changes
- The
VerificationVerifyAddressBadRequestResponseclass has been removed from the codebase.
Enhancements
- The documentation for the
countryfield inVerificationVerifyAddressRequestandVerificationVerifyAddressRequestBodyhas been updated. It now specifies that the input can be the full English or German name in addition to the ISO 3166-2 country codes.
v2.1.196
New Features
Backup Client
- Replace Project Backup Expiration Time
- A new method has been added to update a backup's expiration time. This feature allows users to specify when a backup should expire, providing more control over backup management.
Container Client
- List Self Stacks
- Introduced functionality to list stacks belonging to the executing user, allowing better management and organization of user-specific stacks.
Enhancements
Backup Client
- Improved the error handling for the new "Replace Project Backup Expiration Time" method by introducing responses for bad requests, forbidden access, not found errors, and rate limiting.
Container Client
- Enhanced error responses for the "List Self Stacks" method to handle various client errors including bad requests, forbidden access, and internal server errors.
Key Class in AI Hosting
- Deprecated the models field from the Key class and updated documentation to redirect users to the appropriate route for model information.
Bug Fixes
- Addressed various minor issues and improved validation schemas across different requests and responses, ensuring better compliance with specifications and smoother interactions with the API.
v2.1.195
Features
- Introduced a new schema for the verify address response that enhances the response structure and refines the handling of request bodies.
Changed
-
VerificationVerifyAddressOKResponse:
- Updated the response body to use
VerificationVerifyAddressOKResponseBodyinstead of the previousVerifyAddressResponse. - The
bodyproperty now explicitly defines its structure, requiring theexistsfield of type boolean. - The cloning mechanism for the
bodyproperty has been updated to clone the body object properly, ensuring deep copies are maintained.
- Updated the response body to use
-
VerificationVerifyAddressOKResponseBody:
- Renamed from
VerifyAddressResponse. - Adjusted methods to create instances and retrieve data according to the new response format and naming conventions.
- Renamed from
-
VerificationVerifyAddressRequest:
- Updated the description for the
countryfield to clarify that it should use the ISO 3166-2 Alpha 2 country code format.
- Updated the description for the
-
VerificationVerifyAddressRequestBody:
- Consistently updated the
countryfield description to reflect the ISO 3166-2 Alpha 2 country code requirement.
- Consistently updated the
Removed
- The
VerifyAddressConfidenceenum has been entirely removed from the codebase, simplifying the verification process without this classification.
v2.1.194
Added
- Introduced a
refreshTokenfield in theChangePasswordOKResponseandChangePasswordOKResponseBodyclasses.- Purpose: This token allows users to refresh their access token even after it has expired.
Updated
- The required fields for the responses have been updated to include the new
refreshToken. - The constructor for
ChangePasswordOKResponseBodynow accepts arefreshTokenas an argument. - Added a
getRefreshTokenmethod to retrieve therefreshToken. - Included a
withRefreshTokenmethod to facilitate fluent interface usage while updating therefreshToken. - Updated the hydration method to correctly process the new
refreshTokenfrom input data. - The output serialization method now includes the
refreshTokenin the response output.
v2.1.193
Added Features
- Order List Orders Request Enhancements: Introduced new
typesproperty in theOrderListOrdersRequestclass, allowing clients to filter orders by specific types. This feature enhances the flexibility of order retrieval based on varying classifications of orders.
Changes
OrderListOrdersRequest.php
- Added
OrderTypeto the class, enabling classification of orders by types. - Introduced the
typesproperty as an array in the request schema, allowing multiple order types to be specified. - Added methods to get, set, and unset the
typesproperty within theOrderListOrdersRequestclass.
DeprecatedMailProjectsettingUpdateBlacklistRequest.php
- Updated the email validation format to a regex pattern instead of using
idn-email.
DeprecatedMailProjectsettingUpdateBlacklistRequestBody.php
- Similar update from
idn-emailformat to regex pattern for blacklist items.
DeprecatedMailProjectsettingUpdateWhitelistRequest.php
- Updated email validation to use regex pattern instead of
idn-emailfor whitelist items.
DeprecatedMailProjectsettingUpdateWhitelistRequestBody.php
- Updated the validation format to regex pattern for whitelist items.
DeprecatedMailUpdateProjectMailSettingRequest.php
- Changed validation format from
idn-emailto regex pattern for blacklist and whitelist items.
ListProjectMailSettingsOKResponse.php
- Adjusted email validation to regex patterns for blacklist and whitelist properties.
ListProjectMailSettingsOKResponseBody.php
- Updated email validation from
idn-emailto a regex pattern for blacklist and whitelist properties.
UpdateProjectMailSettingRequest.php
- Email validation updated to regex patterns for both blacklist and whitelist item formats.
UpdateProjectMailSettingRequestBodyAlternative1.php
- Revised email validation from
idn-emailformat to regex pattern for blacklist items.
UpdateProjectMailSettingRequestBodyAlternative2.php
- Updated email validation to utilize a regex pattern instead of
idn-emailfor whitelist items.
v2.1.192
Features
Set Stack Update Schedule
- New API endpoint to set an update schedule for a stack, allowing users to define a cron-based schedule for updates. This includes detailed request and response handling for different HTTP status codes.
Improvements and Updates
- Updated descriptions in existing API request and response schemas for better clarity, including information about command, entrypoint, environment variables, image handling, and more.
- Added context-rich descriptions for properties related to resource specifications such as CPU and memory limits.
Documentation Enhancements
- Enhanced schema documentation across various models to provide clarity on expected formats and examples, helping developers integrate more effectively with the API.
API Changes
New Methods
setStackUpdateSchedule: Added to theContainerClientinterface, allowing the setting of a scheduled update for containers.
Updated Method Descriptions
- The method documentation for pulling images and recreating services has been updated for clarity.
New Response Classes
- Created various response classes for error handling in the
setStackUpdateSchedulemethod, including:SetStackUpdateScheduleBadRequestResponseSetStackUpdateScheduleForbiddenResponseSetStackUpdateScheduleNotFoundResponseSetStackUpdateScheduleInternalServerErrorResponseSetStackUpdateScheduleTooManyRequestsResponse
Schema Updates
- Resource Specification Updates: Detailed descriptions for CPU and memory usage in the
ResourceSpecschema. - New fields added in the
StackResponseschema to accommodate scheduling updates, enhancing the overall responsiveness of service management.
Consistency Improvements
- Improved naming and structuring in the request schemas for better semantic understanding when configuring containers and services, making it easier for clients to manage them programmatically.
v2.1.191
Added
License API
-
Introduced a new
LicenseClientand its implementation, providing functionality for managing licenses including:- Fetching a Single License:
getLicense(GetLicenseRequest $request) - Listing Licenses for a Project:
listLicensesForProject(ListLicensesForProjectRequest $request) - Rotating License Keys:
rotateLicenseKey(RotateLicenseKeyRequest $request) - Validating License Keys for a Project:
validateLicenseKeyForProject(ValidateLicenseKeyForProjectRequest $request)
- Fetching a Single License:
-
New response classes for
GetLicenseoperation:GetLicenseOKResponseGetLicenseBadRequestResponseGetLicenseForbiddenResponseGetLicenseTooManyRequestsResponseGetLicenseInternalServerErrorResponseGetLicenseDefaultResponse
-
New response classes for
ListLicensesForProjectoperation:ListLicensesForProjectOKResponseListLicensesForProjectBadRequestResponseListLicensesForProjectForbiddenResponseListLicensesForProjectInternalServerErrorResponseListLicensesForProjectDefaultResponseListLicensesForProjectTooManyRequestsResponse
-
New response classes for
RotateLicenseKeyoperation:RotateLicenseKeyOKResponseRotateLicenseKeyBadRequestResponseRotateLicenseKeyForbiddenResponseRotateLicenseKeyNotFoundResponseRotateLicenseKeyInternalServerErrorResponseRotateLicenseKeyDefaultResponseRotateLicenseKeyPreconditionFailedResponseRotateLicenseKeyTooManyRequestsResponse
-
New request classes for
ListLicensesForProjectandValidateLicenseKeyForProjectoperations.
Data Models
- Added data models for managing licenses including
License,Key,ExternalKey,KeyResponse,Meta,Reference, and their respective enums and request/response classes.
Enhancements
-
New schema definitions for various operations in the License API, providing structure for input validation and response handling.
-
New functionality for validating and processing license keys related to projects.
License Order Support
- Integrations for creating and managing aspects of TYPO3 ELTS license orders including key management and version handling were established.
This update introduces significant capability to manage licenses accurately, ensuring robust API interactions for license validations, actions, listing, and details management.
v2.1.190
Breaking Changes
- Removed the deprecated method
deprecatedCronjobAbortExecutionand its associated classes and functionality within theCronjobClientinterface. This feature is no longer supported.
Features
- Added a new boolean property
avoidEmailConfirmationto theUpdateDomainContactRequestandUpdateDomainContactRequestBodyclasses. This property allows users to indicate whether to avoid the email confirmation during updates, which might result in the application of a 60-day transfer lock on the domain.
Improvements
- Improved the
UpdateDomainContactRequestBodyclass by providing methods to set and unset theavoidEmailConfirmationparameter, alongside validation during input processing.
Bug Fixes
- No bug fixes were explicitly mentioned in this release; the focus was primarily on removing deprecated features and introducing new functionality.
v2.1.189
Added Features
Get Detail of Contract by License
- Introduced a new method
getDetailOfContractByLicenseto theContractClientinterface and its implementation, allowing retrieval of contracts based on License ID. - The new method enhances querying capabilities for contracts, improving the overall API usability for clients managing contracts.
New Request and Response Classes
- Added
GetDetailOfContractByLicenseRequestto construct requests for fetching contract details using a License ID. - Introduced new response classes to handle the result of the
getDetailOfContractByLicensemethod:GetDetailOfContractByLicenseOKResponse: for successful responses.GetDetailOfContractByLicenseBadRequestResponse: for handling bad requests.GetDetailOfContractByLicenseNotFoundResponse: for scenarios where no contract is found for the given License ID.GetDetailOfContractByLicenseDefaultResponse: for handling any other issues.GetDetailOfContractByLicenseTooManyRequestsResponse: to manage rate limiting scenarios.GetDetailOfContractByLicenseTooManyRequestsResponseBody: to encapsulate the response body for too many requests.
Internal Validation
- Each new response and request class includes a schema for input validation to ensure data integrity when interacting with the API.
v2.1.188
Features Added
- Verification Address Confidence Enum: Introduced a new enum
VerifyAddressConfidenceto categorize the confidence levels of address verification. This enhancement allows users to understand the certainty of an address's existence more clearly.
Changes
-
Refactor Verification Response Handling:
- The class
VerificationVerifyAddressOKResponsenow utilizes theVerifyAddressResponseschema instead of the previously definedVerificationVerifyAddressOKResponseBody. This change improves the clarity and structure of the response handling. - Updated constructor and method signatures in
VerificationVerifyAddressOKResponseto utilize the newVerifyAddressResponseclass.
- The class
-
New
VerifyAddressResponseClass:- Renamed
VerificationVerifyAddressOKResponseBodytoVerifyAddressResponse. - Enhanced docstrings and adjusted method signatures to reflect the renaming and structural changes.
- Renamed
-
Removed Cloning of Body: Simplified handling of the body in the
__clonemethod by removing unnecessary cloning, which enhances performance and memory management.