Key differences between API Version 1 and API Version 2

The BlackBerry AtHoc API V2 makes establishing new integrations easier for developers. It follows the popular REST pattern with HTTP methods and JSON-formatted payloads. The authentication and authorization are OpenID Connect and OAuth 2.

The following table summarizes the differences between the API V1 and V2:

API Version 1API Version 2

Payload format

XML over HTTP

JSON over HTTP

Authorization

Inline username and password

OpenID Connect with OAuth2 JWT Access Tokens

Calling pattern

HTTP POST of Custom XML Payload Definitions

REST with HTTP methods GET, PUT, POST, DELETE

Scenarios covered
  • User Sync
  • Distribution List
  • Sync Alert
  • Publishing Get Content
  • User Sync
  • Distribution List Sync
  • Get Content
  • Accountability Officer

Unique identifier for users

MID (mapping ID)

LOGIN_ID (username)