Skip to content

Releases: infobip/infobip-api-java-client

4.3.1

05 Jun 11:52
@ib-tjuhasz ib-tjuhasz
4.3.1
69e10c1
Compare
Choose a tag to compare
4.3.1 Latest
Latest

[ 4.3.1 ] - 2024-06-05

Added

Changed

Assets 2
Loading

4.3.0

19 Mar 15:38
@lvukadinovic-ib lvukadinovic-ib
4.3.0
d60f1be
Compare
Choose a tag to compare
4.3.0

[ 4.3.0 ] - 2024-03-19

⚠️ IMPORTANT NOTE: This release contains compile time breaking changes.
All changes, including breaking changes, are addressed and explained in the list bellow.
If you find out that something was not addressed properly, please submit an issue.

Added

Changed

  • Removed classes and unified structures
    • Removed basic url security configuration classes (CallsBasicUrlSecurityConfig, CallRoutingBasicUrlSecurityConfig) in favor of a unified class: BasicSecurityConfig
    • Removed hmac algorithm class (CallsHmacAlgorithm) in favor of a unified class: HmacAlgorithm
    • Removed hmac url security configuration classes (CallRoutingHmacUrlSecurityConfig, CallsHmacUrlSecurityConfig) in favor of a unified class: HmacSecurityConfig
    • Removed url security configuration classes (CallRoutingUrlSecurityConfig, CallsUrlSecurityConfig) in favor of a unified class: SecurityConfig
  • Fixes and changes
  • Documentation
    • Fixed Javadoc.

Removed

  • Models for Receive WhatsApp Deleted Reports webhook since it is no longer part of Infobip's product stack.
  • Unused model classes
Assets 2
Loading

4.2.0

07 Mar 14:02
@lvukadinovic-ib lvukadinovic-ib
4.2.0
e6de9fb
Compare
Choose a tag to compare
4.2.0

[ 4.2.0 ] - 2024-03-07

⚠️ IMPORTANT NOTE: This release contains changes that are not compatible with Infobip HTTP API. Therefore, it is considered broken. We strongly advise to avoid using it. We are working on a new version.

Assets 2
Loading

4.1.2

07 Mar 13:12
@lvukadinovic-ib lvukadinovic-ib
4.1.2
664b40c
Compare
Choose a tag to compare
4.1.2

Fixed

  • Issue that caused the number of query parameters for 'bulkId' & 'messageId' to be squared when making getOutboundSmsMessageLogsDefinition call in SmsApi.
  • Issue that caused the number of query parameters for 'sender' to be squared when making getWhatsappSendersQualityDefinition call in WhatsAppApi.
Assets 2
Loading

4.1.1

03 Jan 11:43
@ib-tjuhasz ib-tjuhasz
4.1.1
690406b
Compare
Choose a tag to compare
4.1.1

Added

  • guava dependency to tag early-access endpoints with @Beta annotation.
  • Most recent Infobip WhatsApp API feature set.

Changed

  • Expanded WhatsAppTemplateDataContent model with additional field supporting WhatsAppTemplateCarouselContent that the API might return.
  • Early access endpoints in WhatsAppApi are tagged with @Beta annotation
  • Fixed Javadoc.
Assets 2
Loading

4.1.0

21 Dec 10:07
@ib-tjuhasz ib-tjuhasz
4.1.0
55507e2
Compare
Choose a tag to compare
4.1.0

[ 4.1.0 ] - 2023-12-20

⚠️ IMPORTANT NOTE: This release contains compile time breaking changes.
All changes, including breaking changes, are addressed and explained in the list bellow.
If you find out that something was not addressed properly, please submit an issue.

Added

Changed

  • Removed classes and unified structures
    • Removed pagination classes (CallsPageInfo, WebRtcPageInfo) in favor of a unified class: PageInfo
    • Removed status-defining classes for messages by products (EmailStatus, MmsStatus, SmsStatus) and introduced a unified class: MessageStatus
    • Removed price-defining classes for messages by products (EmailPrice, MmsPrice, SmsPrice, EmailWebhookPrice) and replaced with a unified class: MessagePrice
    • Removed error-defining classes for query execution by different products (EmailReportError, MmsError, SmsError) and introduced a unified class: MessageError
  • Fixes and changes
    • Expanded ApiExceptionDetails model with additional fields supporting enriched error responses that the API might return.
    • Changed templateId field type from Integer to Long in EmailApi's SendEmailRequest class because of reported issue.
    • Updated WhatsAppCategory enumeration values based on report and reported issue.
    • Updated CallsErrorCode enumeration values to reflect changes on Hangup endpoint.
    • Updated ViberValidityPeriodTimeUnit enumeration values since 'DAYS' is no longer supported, use 'HOURS' instead.
    • Changed 'context' field name in CallsApplicationTransferRequest to 'customData'.
    • Changed 'days' field type in CallsDeliveryTimeWindow from List to Set to avoid duplicates.
    • Removed 'type' field in CallsDtmfTermination since it is not supported on the API side.
    • Removed 'stopOn' field in CallsSayRequest since it is not supported on the API side.
    • Removed 'sipTrunkGroupId' field in CallsSipEndpoint since it is not supported on the API side.
    • Removed 'notifyContentType' field in MmsAdvancedMessage since it is not supported on the API side.
    • Removed 'sendingSpeedLimit' field in MmsAdvancedRequest since it is not supported on the API side.
    • Fixed Viber webhook report models.
    • Changed 'results' field name in ViberWebhookReportResponse to reports.
    • Replaced 'ios' and 'android' fields in WebRtcPushConfigurationResponse with 'androidConfigured' and 'iosConfigured' since they didn't correspond to the state of the endpoint.
    • Changed 'structure' field type in WhatsAppTemplateApiResponse from 'WhatsAppTemplateStructureApiData' and 'WhatsAppDefaultTemplateStructureApiData'.
    • Changed WhatsAppTemplatePublicApiRequest by making it an abstract class, serving as a base for WhatsAppAuthenticationTemplatePublicApiRequest, WhatsAppDefaultMarketingTemplatePublicApiRequest, WhatsAppDefaultUtilityTemplatePublicApiRequest.
  • Documentation
    • Fixed Javadoc.
  • Dependencies
    • Bumped slf4j-api version to 2.0.9
    • Bumped jackson version to 2.15.2
    • Bumped okhttp version to 4.12.0

Removed

  • Unused model classes

Deprecated

Assets 2
Loading

4.0.0

02 Mar 12:01
@ib-fsrnec ib-fsrnec
4.0.0
1d8c5d7
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
4.0.0

[ 4.0.0 ] - 2023-03-02

🎉 NEW Major Version of infobip-api-java-client.

⚠️ IMPORTANT NOTE: This release contains breaking changes.
All changes, including breaking changes, are addressed and explained in the list bellow.
If you find out that something was not addressed properly, please submit an issue.

Added

  • Support for Infobip MMS API.
  • Support for Infobip Voice API.
  • Support for Infobip WebRTC API.
  • Support for Infobip Viber API.
  • Most recent Infobip SMS API feature set.
  • Most recent Email feature set.
  • Most recent WhatsApp feature set.
  • Tests for the static parts of the auto-generated code.
    There are multiple tests phases implemented in our auto-generation pipeline.
    A part of the tests is now included as a library source code.
  • Base URL abstraction.
  • Api Key abstraction.
  • Deprecation notice log if deprecated or gone endpoints are used (slf4j-api dependency).
  • Snyk and Java version badges to README.

Changed

  • The library now requires Java 11 or above.
  • OkHttp dependency was bumped to version 4.10.0.
  • From this version, an ApiClient instance must be constructed and configured using the Builder pattern: 
        ApiClient apiClient = ApiClient.forApiKey(givenApiKey)
          .withBaseUrl(givenBaseUrl)
          .withHttpClient(givenHttpClient)
          .withReadTimeout(givenReadTimeoutInSeconds)
          .withTempDirectoryPath(givenTempDirPath)
          .build();
    The additional OkHttp client configuration was removed from the library.
    Please check the Removed section for details.
  • API classes were refactored in a way that all functionalities are grouped under the same product.
    For example, SendSmsApi, ScheduledSmsApi and ReceiveSmsApi classes are replaced with a single SmsApi class.
  • API class methods that trigger an API call were rewritten using a fluent style where all required parameters
    must be passed to a request builder factory method.
    On the other hand, optional parameters may be passed using a separate request builder methods.
    The result can be fetched using execute or executeAsync methods.
    That allows us to add optional parameters without introducing a breaking change to the library.
    For example, in the previous version, to send a TFA pin code, we could use something like this: 
        TfaStartAuthenticationResponse response = tfaApi.sendTfaPinCodeOverSms(false, request);
    In the new version, the following pattern applies: 
        TfaStartAuthenticationResponse sendCodeResponse = tfaApi
          .sendTfaPinCodeOverSms(request)
          .ncNeeded(false)
          .execute();
  • Jackson (version 2.14.2) serialization library is used instead of Gson.
    The JSON serialization utility now uses a preconfigured Jackson's ObjectMapper.
    Also, the support for InputStream serialization was added.
  • All maven plugins were bumped to the most recent version.
    Both unneeded plugins and the obsolete configuration were removed.
  • The API request and response processing was rewritten to increase maintainability and usability.
  • The ApiException class was refactored to have fluent getters and a single accessible Builder.
  • From this version, the error response body is deserialized and stored in details property of the ApiException class.
  • The palantir-java-format is now used instead of google-java-format to have the formatting closer to our internal coding style.
    See the Spotless README for details.
  • Some products like Email and WhatsApp contain a few breaking changes since a new version of a few of the API endpoints was released.
    If you have issues when migrating the existing implementation, please check the official API documentation or submit an issue.

Removed

  • Basic, IBSSO Token Header and client credentials grant type OAuth2 authentication methods.
    Use API Key Header authentication method instead.
    The API Key should be injected into the ApiClient instance through the newly introduced forApiKey factory method.
    Examples can be found in the README.
  • Configuration utility class.
    Having static default configuration is error-prone and provides an unnecessary overhead.
    An ApiClient instance should always be injected in the given API class.
  • SSL settings configuration methods from the ApiClient.
    If you need to configure custom SSL related settings (custom client keys, disabled CA certificate and hostname verification, etc.),
    configure them on the OkHttpClient instance directly and pass the instance to the ApiClient using withHttpClient builder method.
  • Date format customization methods from the ApiClient.
    Only the default Infobip date format should be used.
    The date formatter instance to be used is available through the JSON class.
  • Header and cookie manipulation through ApiClient public interface.
    However, it can still be achieved using OkHttp interceptors if needed.
    Feel free to configure an OkHttpClient instance with appropriate interceptors and pass the instance to the ApiClient using withHttpClient builder method.
  • Explicit debugging option for ApiClient.
    HttpLoggingInterceptor can always be included by providing a preconfigured HTTP client as described above.
  • Explicit gzip support for requests.
    The support should be provided by the client itself like explained here.
  • Unused generated classes.
  • Default network interceptor used for tracking upload and download progress.
    The functionality can be re-added by using the official OkHttp recipe.
  • ...WithHttpInfo methods from API client classes.
    If an additional info like response headers or the response code is needed, the executeAsync method should be
    used.
    The required information is injected in the callback.
  • ...buildCall methods from API client classes.
    The OkHttp Call abstraction can be obtained by using the executeAsync method.
    We don't allow calling the API without processing the response internally anymore.
Assets 2
Loading

3.2.0

20 Jan 15:01
@ivan-letenko ivan-letenko
3.2.0
ca41a6a
Compare
Choose a tag to compare
3.2.0

[ 3.2.0 ] - 2022-01-19

Added

Changed

  • Email sending API to match the latest version of the API.
    • Signature changed: getEmailLogs()
  • Renamed some email API models to be consistent across multiple products
    • EmailError -> EmailReportError
    • EmailLogsResult -> EmailLogsResponse

Fixed

  • Minor SMS API changes (some fields became read-only)
  • Improved Javadoc comments
Assets 2
Loading

3.1.0

18 Jun 08:19
@ivan-letenko ivan-letenko
3.1.0
7797ea4
Compare
Choose a tag to compare
3.1.0

[ 3.1.0 ] - 2021-06-16

Added

  • Support for Infobip Email API
  • email.md which contains basic example of Email API usage
Assets 2
Loading

3.0.1

16 Feb 12:07
@josipk-ib josipk-ib
3.0.1
0c36649
Compare
Choose a tag to compare
3.0.1

[ 3.0.1 ] - 2021-02-16

Changed

  • README.md which now contains more details about supported authentication methods & updated examples of library usage for webhooks

Removed

  • Unused model classes, utility classes, and dependencies

Fixed

Assets 2
Loading