February 2012 Technical Achievements

by OMA | Wednesday, February 1, 2012

The following list of mobile service enablers was ratified by the OMA Board of Directors in February 2012.

Service Access Interfaces

OMA Guidelines for RESTful Network APIs V1_0 CRR

OMA Guidelines for RESTful Network APIs (REST_NetAPI_Guidelines) enabler is intended to assist OMA API designers to define RESTful Network API specifications by providing design recommendations and good design practices. This Reference Release includes a number of recommendations and examples on how to solve certain API design issues.
http://www.openmobilealliance.org/Technical/release_program/GuidelinesREST.aspx

OMA RESTful Network for API Address Book V1_0 CER

OMA RESTful Network API for Address Book (REST_NetAPI_AddressBook) is a re-publication of the ParlayREST Address List Management API V1.0 and is included in the suite of OMA RESTful Network APIs. Changes include ‘bug’ fixes and structural adjustments to support this suite.

Version 1.0 of the RESTful Network API for Address Book continues to support the following operations:

  • Manage attributes related to a list
  • Manage attributes related to a contact or a member in a list
  • Manage contacts
  • Manage lists
  • Manage members in a list
  • Manage nested lists related to a list
  • Manage shared contacts or lists
  • Manage subscriptions to contact or list changes
  • Send notifications about contact or list changes

The following new functionalities have been introduced:

Transfer a member from one list to another

  • Support “vCard 2.1” and “vCard 3.0” as contact attributes [RFC2426]
  • Support for scope values used with authorization framework defined in [Autho4API_10]
  • Support for Anonymous Customer Reference (ACR) as an end user identifier
  • Support for “acr:Authorization” as a reserved keyword in a resource URL variable that identifies an end user
  • Resources, data types and element names have been changed to allow future extensions and reflect the API re- naming from Address List Management to Address Book

http://www.openmobilealliance.org/Technical/release_program/AddressBookREST_v1_0.aspx

OMA RESTful Network API for Payment V1_0 CER

OMA RESTful Network API for Payment V1.0 (REST_NetAPI_Payement) is a re-publication of the ParlayREST Payment API V1.1 and is included in the suite of OMA RESTful Network APIs. Changes include ‘bug’ fixes and structural adjustments to support this suite.

Version 1.0 of the RESTful Network API for Payment continues to support the following operations:

  • Charging an amount, split amount, volume or split volume to an end user’s account
  • Refunding an amount or volume to an end user’ account
  • Reserving an amount or volume for an end user’s account
  • Adding an amount or volume to an existing reservation
  • Charging to a previously made reservation
  • Releasing funds left in a previously made reservation

The following new functionalities have been introduced:

  • Support for scope values used with authorization framework defined in [Autho4API_10]
  • Support for Anonymous Customer Reference (ACR) as an end user identifier
  • Support for “acr:Authorization” as a reserved keyword in a resource URL variable that identifies an end user
  • Support for asynchronous transactions (new transactionOperationStatus value “Processing”)
  • Implicit subscription to notifications about the status change of a transaction
  • Notifications about the status change of a transaction

http://www.openmobilealliance.org/Technical/release_program/PaymentREST_v1_0.aspx

OMA RESTful Network API for Messaging V1_0 CER

OMA RESTful Network API for Messaging (REST_NetAPI_Messaging) is a re-publication of the ParlayREST MultiMediaMessaging API V1.1 and is included in the suite of OMA RESTful Network APIs. Changes include ‘bug’ fixes and structural adjustments to support this suite.

Version 1.0 of the RESTful Network API for Messaging continues to support the following operations:

  • Send message to a terminal
  • Check delivery status of the outgoing message
  • Check incoming messages (polling mode)
  • Create subscriptions for notifications for inbound messages based on given criteria (online)
  • Delete subscriptions for notifications for inbound messages (online)
  • Create subscriptions for notification for outbound messages based on given criteria (online)
  • Delete subscriptions for notification for outbound messages (online)
  • Retrieve message content
  • Confirm message retrieval by deleting message (execute DELETE method)

The following new functionalities have been introduced:

  • Support for scope values used with authorization framework defined in [Autho4API_10]
  • Support for Anonymous Customer Reference (ACR) as an end user identifier
  • Support for “acr:Authorization” as a reserved keyword in a resource URL variable that identifies an end user
  • Support for the sub-structure “AttachmentInfo” within the structure “InboundMMSMessage”

All changes are backwards-compatible with ParlayREST MultiMediaMessaging V 1.1, with the following exception: Introduction of the sub-structure “AttachmentInfo” within the structure “InboundMMSMessage” is not backwards-compatible.

http://www.openmobilealliance.org/Technical/release_program/MessagingREST_v1_0.aspx

OMA RESTful Network API for Terminal Location V1_0 CER

OMA RESTful Network API for Terminal Location V1.0 ( REST_NetAPI_TerminalLocation) is a re-publication of the ParlayREST Terminal Location API V1.0 and is included in the suite of OMA RESTful Network APIs. Changes include ‘bug’ fixes and structural adjustments to support this suite.

Version 1.0 of OMA RESTful Network API for Terminal Location continues to support the following operations:

  • Obtain the current terminal location
  • Obtain the terminal distance from a given location
  • Obtain the distance between two terminals
  • Manage client-specific subscriptions to periodic notifications Manage client-specific subscriptions to area (circle) notifications
  • Manage client-specific subscriptions to distance notificationsnotifications
  • Manage client-specific subscriptions to distance notifications

The following new functionalities have been introduced:

  • Support for scope values used with authorization framework defined in [Autho4API_10]
  • Support for Anonymous Customer Reference (ACR) as an end user identifier
  • Support for “acr:Authorization” as a reserved keyword in a resource URL variable that identifies an end user

http://www.openmobilealliance.org/Technical/release_program/TerminalLocationREST_v1_0.aspx

OMA RESTful Network API for Terminal Status V1_0 CER

OMA RESTful Network API for Terminal Status (REST_NetAPI_TerminalStatus) is a re-publication of the ParlayREST Terminal Status API V1.0 and is included in the suite of OMA RESTful Network APIs. Changes include ‘bug’ fixes and structural adjustments to support this suite.

Version 1.0 of the RESTful Network API for Terminal Status continues to support the following operations:

  • Retrieve the current terminal status collection
  • Retrieve the current terminal accessibility status, roaming status and connection type respectively
  • Manage client-specific subscriptions to status collection change notifications
  • Manage client-specific subscriptions to accessibility status, roaming status and connection type change notifications respectively

The following new functionalities have been introduced:

  • Support for scope values used with authorization framework defined in [Autho4API_10]
  • Support for Anonymous Customer Reference (ACR) as an end user identifier
  • Support for “acr:Authorization” as a reserved keyword in a resource URL variable that identifies an end user

http://www.openmobilealliance.org/Technical/release_program/TerminalStatusREST_v1_0.aspx