Skip to content

4.0.0. - 2026-04-16

Choose a tag to compare

View all tags
@Fivell Fivell released this 24 Apr 09:05
· 26 commits to main since this release
4.0.0
0361907
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

What's Changed

API Version: 2026-04-16 (previously 2022-05-10)

This is a major release that upgrades the SDK to target DIDWW API version 2026-04-16. It includes breaking changes, new resources, new attributes, and emergency services support.

For the previous API version, use the https://github.com/didww/didww-api-3-java-sdk/tree/2022-05-10 branch (v3.x).

Breaking Changes

Renamed Resources

  • RequirementValidation → AddressRequirementValidation
  • Requirement → AddressRequirement
  • AddressRequirementValidation#requirement relation → address_requirement
  • DidGroup#requirement relation → address_requirement

Renamed Attributes

  • DidReservation#expireAt → expiresAt

  • EncryptedFile#expireAt → expiresAt

  • isCancelled() → isCanceled() (wire-format consistency)

    Changed Types

  • AddressVerification#rejectReasons is now a List (was a single string)

    Removed

  • sms_out removed from DidGroup features enum

Changed Behavior

  • Default API version is now 2026-04-16 (header X-DIDWW-API-Version)

  • Encrypted files: POST now accepts a single file per request (was array)

  • Exports: year/month filters replaced with from/to datetime range

  • VoiceInTrunk: added diversionRelayPolicy to SIP configuration

  • VoiceOutTrunk: flat credential fields replaced with polymorphic authenticationMethod (types: credentials_and_ip, twilio, ip_only)

  • Attribute values standardized to lowercase snake_case

    New Resources

  • DidHistory — /v3/did_history (list, read)

  • EmergencyRequirement — /v3/emergency_requirements (list, read) — with resource-level meta (setupPrice, monthlyPrice)

  • EmergencyRequirementValidation — /v3/emergency_requirement_validations (create)

  • EmergencyCallingService — /v3/emergency_calling_services (list, read, create, update, delete) — with resource-level meta (setupPrice, monthlyPrice)

  • EmergencyVerification — /v3/emergency_verifications (list, read, create, update)

New Attributes

Did

  • emergencyEnabled
  • Relationships: emergencyCallingService, emergencyVerification, identity

VoiceOutTrunk

  • emergencyEnableAll, rtpTimeout

  • Relationship: emergencyDids

    DidGroup

  • New features: p2p, a2p, emergency, cnam_out

  • serviceRestrictions attribute

Identity

  • Relationship: birthCountry

    Other

  • externalReferenceId added to: Address, AddressVerification, Export, Order, PermanentSupportingDocument, Proof, SharedCapacityGroup, VoiceInTrunk, VoiceInTrunkGroup, VoiceOutTrunk

  • AddressVerification: rejectComment

  • Export: STATUS_PENDING and STATUS_PROCESSING constants

  • EmergencyOrderItem complex object for Order support

New PATCH Endpoints

  • PATCH /v3/address_verifications/:id — update externalReferenceId
  • PATCH /v3/exports/:id — update externalReferenceId
  • PATCH /v3/emergency_verifications/:id — update externalReferenceId

Status Predicate Helpers

New is*() methods on:

  • VoiceOutTrunk — isActive(), isBlocked(), etc.
  • EmergencyCallingService — isActive(), isPending(), etc.
  • AddressVerification, EmergencyVerification, Order

Other Improvements

  • Fixed Javadoc warnings
  • Comprehensive examples for all new resources including emergency scenario
  • Added "Releasing a New Version" section to README

Full Changelog: 3.0.0...4.0.0

Assets 2
Loading