Skip to content

Releases: camaraproject/WebRTC

r2.2

23 Sep 14:44
@stroncoso-quobis stroncoso-quobis
r2.2
7d9f8af
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
r2.2 Latest
Latest

Release Notes

This public release contains the definition and documentation of

  • webrtc-registration v0.3.0
  • webrtc-call-handling v0.3.0
  • webrtc-events v0.2.0

The API definition(s) are based on

  • Commonalities r3.3
  • Identity and Consent Management r3.3

Changelog since latest public v1.2

  • Full Changelog with the list of PRs and contributors: r1.2...r2.2

webrtc-registration v0.3.0

Added

  • Support registration expiry updates and termination event notifications at PR #83
  • Introduced regSessionUpdate schema with optional registrationExpireTime field to allow clients to request a new expiry time.
  • Added 200 OK response definition for PUT /sessions/{registrationId} to acknowledge successful updates.

Changed

  • fix: Updated deviceId format, examples and tests at #91
  • fix: registrationId became mandatory on registration response at #93
  • Commonalities aligment 0.6 at PR #90
    • fix: Remove AUTHENTICATION_REQUIRED error code
    • doc: Update types (multiple) property of Subscription schema
    • feat: Error 422 MULTIEVENT_COMBINATION_TEMPORARILY_NOT_SUPPORTED added
    • fix: Remove IDENTIFIER_MISMATCH error
    • fix: x-correlator format update, along test and schema update
  • Extended regSessionResponse schema to include expiresAt, indicating the assigned expiry time of the registration session at PR #83
  • fix: Description for date-time review at #101
  • fix: ErrorInfo updated descriptions at #113

webrtc-call-handling v0.3.0

Changes

  • fix: Added 400 error response at #91
  • Commonalities aligment 0.6 at PR #90
    • fix: Remove AUTHENTICATION_REQUIRED error code
    • doc: Update types (multiple) property of Subscription schema
    • feat: Error 422 MULTIEVENT_COMBINATION_TEMPORARILY_NOT_SUPPORTED added
    • fix: Remove IDENTIFIER_MISMATCH error
    • fix: x-correlator format update, along test and schema update
  • fix: Removed too wide insecure pattern .+ from address fields at #103
  • fix: ErrorInfo updated descriptions at #113

webrtc-events v0.2.0

Added

  • Added new event type webrtc-events:org.camaraproject.webrtc-events.v0.registration-ends to notify subscribers when a registration ends at PR #83
  • Provided a concrete example for the registration-ends event subscription.

Changes

  • fix: Updated deviceId format, examples and tests at #91
  • fix: Updated mandatory fields per specific event data callback at #94
  • Commonalities aligment 0.6 at PR #90
    • fix: Remove AUTHENTICATION_REQUIRED error code
    • doc: Update types (multiple) property of Subscription schema
    • feat: Error 422 MULTIEVENT_COMBINATION_TEMPORARILY_NOT_SUPPORTED added
    • fix: Remove IDENTIFIER_MISMATCH error
    • fix: x-correlator format update, along test and schema update
  • Extended TerminationReason enumeration to include REGISTRATION_EXPIRED, allowing precise classification of expiry-based terminations at PR #83
  • fix: Description for date-time review at #101
  • fix: Updated mandatory fields for EventSessionInvitation at #102
  • fix: Removed too wide insecure pattern .+ from address fields #103
  • fix: ErrorInfo updated descriptions at #113
Assets 3
Loading

r2.1

30 Jul 08:02
@stroncoso-quobis stroncoso-quobis
r2.1
c8bd612
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
r2.1 Pre-release
Pre-release

Release Notes

This pre-release contains the definition and documentation of

  • webrtc-registration v0.3.0-rc.1
  • webrtc-call-handling v0.3.0-rc.1
  • webrtc-events v0.2.0-rc.1

The API definition(s) are based on

  • Commonalities r3.2
  • Identity and Consent Management r3.2

Changelog since latest public r1.2

  • Full Changelog with the list of PRs and contributors: r1.2...r2.1

WebRTC Registration v0.3.0-rc.1

Added

  • Support registration expiry updates and termination event notifications at PR #83
  • Introduced regSessionUpdate schema with optional registrationExpireTime field to allow clients to request a new expiry time.
  • Added 200 OK response definition for PUT /sessions/{registrationId} to acknowledge successful updates.

Changed

  • fix: Updated deviceId format, examples and tests at #91
  • fix: registrationId became mandatory on registration response at #93
  • Commonalities aligment 0.6 at PR #88
    • fix: Remove AUTHENTICATION_REQUIRED error code
    • doc: Update types (multiple) property of Subscription schema
    • feat: Error 422 MULTIEVENT_COMBINATION_TEMPORARILY_NOT_SUPPORTED added
    • fix: Remove IDENTIFIER_MISMATCH error
    • fix: x-correlator format update, along test and schema update
  • Extended regSessionResponse schema to include expiresAt, indicating the assigned expiry time of the registration session at PR #83

webrtc-call-handling v0.3.0-rc.1

Changes

  • fix: Added 400 error response at #91
  • Commonalities aligment 0.6 at PR #88
    • fix: Remove AUTHENTICATION_REQUIRED error code
    • doc: Update types (multiple) property of Subscription schema
    • feat: Error 422 MULTIEVENT_COMBINATION_TEMPORARILY_NOT_SUPPORTED added
    • fix: Remove IDENTIFIER_MISMATCH error
    • fix: x-correlator format update, along test and schema update

WebRTC Events v0.2.0-rc.1

Added

  • Added new event type webrtc-events:org.camaraproject.webrtc-events.v0.registration-ends to notify subscribers when a registration ends at PR #83
  • Provided a concrete example for the registration-ends event subscription.

Changes

  • fix: Updated deviceId format, examples and tests at #91
  • fix: Updated mandatory fields per specific event data callback at #94
  • Commonalities aligment 0.6 at PR #88
    • fix: Remove AUTHENTICATION_REQUIRED error code
    • doc: Update types (multiple) property of Subscription schema
    • feat: Error 422 MULTIEVENT_COMBINATION_TEMPORARILY_NOT_SUPPORTED added
    • fix: Remove IDENTIFIER_MISMATCH error
    • fix: x-correlator format update, along test and schema update
  • Extended TerminationReason enumeration to include REGISTRATION_EXPIRED, allowing precise classification of expiry-based terminations at PR #83
Loading

r1.2

18 Mar 12:39
@stroncoso-quobis stroncoso-quobis
r1.2
c195b84
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
r1.2

WebRTC APIs - Release r1.2

Release Notes

This public release contains the definition and documentation of

  • webrtc-registration v0.2.0
  • webrtc-call-handling v0.2.0
  • webrtc-events v0.1.0

The API definition(s) are based on

  • Commonalities r2.3
  • Identity and Consent Management r2.3

Repository changelog since latest public v0.1.1

  • Full Changelog with the list of PRs and contributors: v0.1.1...r1.2

List of PRs and their owners

WebRTC Registration v0.2.0

There are breaking changes compared to v0.1.2.: the API use has been simplified for API consumers using a three-legged access token to invoke the API. In these cases the optional device parameter MUST NOT be provided, as the subject will be uniquely identified from the access token. In this context also some error response codes have been renamed or replaced to comply with latests Commonalities.

Added

  • YAML inline documentation at PR #67
  • Commonalites aligment 0.5 at PR #65
  • Included base testing scenarios at PR #69
  • Included basic error testing at PR #71

Changed

  • API naming to WebRTC Registarion and filename webrtc-registration.yaml PR #59
  • Server url based on Commonalities 0.5 at PR #59
  • Security schema openId based on Commonalities 0.5 at PR #65
  • Response code based on Commonalities 0.5 at PR #65
  • Term RACM is replaced by Registration or reg suffix
  • TransactionId header (required) was replaced by x-correlator header (optional)
  • msisdn response is now phoneNumber
  • racmSessionId becomes now regsitrationId

Fixed

  • Descriptions and relevant information for all documentation and schemas
  • Descriptions updates and references
  • Commonalities alignment with r2.3 (Responses and documentation)
  • Responses review : 400, 401, 403 included
  • PUT registration responds with 204 No content instead of 200

Removed

  • BYON terminology and API naming
  • notificationChannel API related parameter channelId at PR #67
  • BearerAuth in favor of openId as security schema at PR #65
  • Removed generic 5xx reponses
  • clientId header is removed

WebRTC Call Handling v0.2.0

There are breaking changes compared to v0.1.2.: the API use has been simplified for API consumers using a three-legged access token to invoke the API. In these cases the optional device parameter MUST NOT be provided, as the subject will be uniquely identified from the access token. In this context also some error response codes have been renamed or replaced to comply with Commonalities 0.5.

Added

  • YAML inline documentation at PR #68
  • Commonalites aligment 0.5 at PR #65
  • Included base testing scenarios at PR #69
  • Included basic error testing

Changed

  • API naming to WebRTC Call Handling and filename webrtc-call-handling.yaml PR #59
  • Server url based on Commonalities 0.5 at PR #59
  • Security schema openId based on Commonalities 0.5 at PR #65
  • Response code based on Commonalities 0.5 at PR #65
  • MediaSessionInformation schema expanded, to include all fields used related to a single voice-video session at PR #56
  • SessionNotification schema updated at PR #56
    • It aligns this API with the WebRTC Event notification service. So SessionNotification schema, now, its just a wrapper for MediaSessionInformation schema. This way, the developer only need to use one object for notification and voice-video session updates (POST / PUT operations).
  • Term RACM is replaced by Registration or reg suffix
  • Suffix vvoip is replaced by media to identify media sessions, like calls, video-calls or any media session
  • TransactionId header (required) was replaced by x-correlator header (optional)

Fixed

  • Descriptions and relevant information for all documentation and schemas
  • Descriptions updates and references
  • Commonalities alignment with r2.3 (Responses and documentation)
  • Responses review : 400, 401, 403 included

Removed

  • BYON terminology and API naming
  • BearerAuth in favor of openId as security schema at PR #65
  • SessionNotification schema updated at PR #56
    • SessionInvitationNotification - Became part of SessionNotification
    • SessionStatusNotification - Became part of SessionNotification
  • Removed generic 5xx reponses
  • clientId header is removed

WebRTC Events v0.1.0

This version defines a new API:

Initial version covering the following functionality and related endpoints:

  • API to subscribe to call events. Bringing server-side updates about a voice video session in progress or during negotiation.

Added

  • YAML inline documentation at PR #53
  • Commonalites aligment 0.5 at PR #66
  • Included subscriptions endpoint to create CloudEvents subscrition at PR #53
    • Endpoints can now define a callback and receive server-side events using CloudEvents
    • Endpoints can now receive callback events regarding new available audio-video sessions (call incomming)
    • Endpoints can now receive callback events regarding session establishment updates like network changes and remote session termination (call progress and call hangup)
  • Included base testing scenarios at PR #69
  • Included basic error testing

Changed

  • Term RACM is replaced by Registration or reg suffix
  • Suffix vvoip is replaced by media to identify media sessions, like calls, video-calls or any media session

Fixed

  • Commonalities alignment with r2.3 (Responses and documentation)

Contributors

stroncoso-quobis, rartych, and 2 other contributors
Loading

r1.1

17 Feb 11:57
@stroncoso-quobis stroncoso-quobis
r1.1
45cba7b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
r1.1 Pre-release
Pre-release

WebRTC APIs - Release 0.1.1

This release includes:

  • webrtc-registration v0.2
  • webrtc-call-handling v0.2
  • webrtc-events v0.1

Documentation

Please note

This is a pre-release version, and should be considered as a draft for further development
There are bug fixes and breaking changes to be expected in later versions
The release is suitable for test implementations, but it is not recommended for use in production environments

Added

  • webrtc-events API: To handle server-side communications based on CloudEvents at PR #53
    • Included subscriptions endpoint to create CloudEvents subscrition
    • Device endpoints can now define a callback and receive server-side events using CloudEvents
    • Device endpoints can now receive callback events regarding new available audio-video sessions (call incomming)
    • Device endpoints can now receive callback events regarding session establishment updates like network changes and remote session termination (call progress and call hangup)
  • Included base testing scenarios for all APIs at PR #69
  • Inline documentation extended #67 #68
  • YAML inline documentation at PR #67
  • Commonalites aligment 0.5 at PR #65 #66

Changed

  • Renamed APIs to be more meaningful and according CAMARA API naming rules
  • Server url based on Commonalities 0.5 at PR #59
  • Security schema openId based on Commonalities 0.5 at PR #65 #66
  • Response code based on Commonalities 0.5 at PR #65
  • SessionNotification schema updated at PR #56
    • It aligns this API with the WebRTC Event notification service. So SessionNotification schema, now, its just a wrapper for VvoipSessionInformation schema. This way, the developer only need to use one object for notification and voice-video session updates (POST / PUT operations).

Fixed

  • Descriptions and relevant information for all documentation and schemas

Removed

  • notification-channel API removed.
    • Its functionlity is removed from scope, CAMARA API includes CloudEvents as main source of incoming connections from the network. This API is removed in benefit of webrtc-events. webrtc-call-handling (call establishment) and webrtc-register (incoming call reception) can benefit from webrtc-events API along with other possible use cases regarding vislibility.
  • channelId parameter removed #67 #68
    • This parameter was tied to notification-channel API and considered now obsolete #67 #68
  • BYON terminology and API naming
  • BearerAuth in favor of openId as security schema at PR #65
  • SessionInvitationNotification and SessionStatusNotification at WebRTC Call handling, that became part of SessionNotification at PR #56

Merge PR summary:

Full Changelog: v0.1.1...r1.1

Contributors

stroncoso-quobis, rartych, and 2 other contributors
Loading

CAMARA BYON API v0.1.1

23 Jul 19:45
@TEF-RicardoSerr TEF-RicardoSerr
v0.1.1
847716b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
CAMARA BYON API v0.1.1

BYON API v0.1.1 is a pre-relese version

Please note

This is a pre-release version, and should be considered as a draft for further development
There are bug fixes and breaking changes to be expected in later versions
The release is suitable for test implementations, but it is not recommended for use in production environments

Added

  • Update BYON-CallHandling-Service.yaml - 201 session created, 200 session updated, 204 session updated & examples (check PR44)

Changed

  • Update BYON-Calling, BYON-RACM, BYON-Notification: resourceURL to sessionId/channelId (check PR29)
  • Documentation is extended and flows diagrams are added (check PR42)

Fixed

NA.

Removed

NA.

Loading

CAMARA BYON API v0.1.0

12 Dec 11:51
@TEF-RicardoSerr TEF-RicardoSerr
v0.1.0
3a05c71
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
CAMARA BYON API v0.1.0

This is the first pre-release of the CAMARA WebRTC API

Please note:

This is a pre-release version, and should be considered as a draft for further development
There are bug fixes and breaking changes to be expected in later versions
The release is suitable for test implementations, but it is not recommended for use in production environments

Added

Initial contribution of API spec WebRTC BYON including:

  • Registration and Authentication Management
  • Notification Handling
  • One to One Calling

Changed

This is the first pre-release

Fixed

This is the first pre-release

Removed

This is the first pre-release

Loading