Download OpenAPI specification:Download
This guide describes list of API services that are provided by OT Rainbow Application portal. This portal is dedicated to app features.
REST interface is used for sending/receiving OT rainbow API messages. HTTP requests GET, DELETE, POST, UPDATE are used. Standard HTTP responses are used to provide requested information or error status. There is no session notion in OT Rainbow system, so requests could be issued according stateless model, without transport conservation between them. Additional data could be provided in message body. JSON is used as a main format for data encoding in message body part. Each request is started with the following pattern /{module}/{version}/ where {module} is a portal module name to address and {version} is a version of used API, par example, “v1.0”.
Each request should contain some credential information to authenticate itself. Standard HTTP authentication with basic/bearer modes is used. JSON Web Token mechanism is used to provide authentication information. JWT has a expire timeout that is controlled by OT Rainbow portal to prevent very long token usage. Also authentication with application token is used. The token must be provided in the request HTTP header, using a custom header: APIKey. At server side, token is verified, and if it doesn’t match, 403 Not Allowed response is sent. TLS is used as a transport protocol to support message exchanges between OT Rainbow portal and an application.
For accessing the API a valid JWT token or a valid OAuth has to be provided access token must be passed in all the queries in the 'Authorization' header.
Security Scheme Type | API Key |
---|---|
Header parameter name: | Authorization |
This API can be used to retrieve the list of applications created by the user.
User with only bp_finance
role can only retrieve applications:
app_admin
belonging to his BP companykpi
=appconnect
env
=deployed
name | string Allows to filter applications by name. |
env | string Allows to filter applications by environment (Allowed values: not_deployed, in_deployment, deployed). |
state | string Allows to filter applications by state. (Allowed values: new, active, blocked, deleted, stopped). Can be a comma separated string. |
types | string Allows to filter applications by type (Allowed values: web, mobile, desktop, server, bot, iot, admin).Can be a comma separated string. By default all of the types are taken |
activities | string Allows to filter applications by activity (Allowed values: A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U). Can be a comma separated string. By default all of the activities are taken |
ownerId | string Allows to filter applications by ownerId.
|
subscriptionStatus | string Allows to filter applications by subscription status. (Allowed values: creating, active, alerting, hold, terminating, terminated, failed, unknown). Can be a comma separated string. |
fromDate | string <date> Allows to filter applications from provided date. |
toDate | string <date> Allows to filter applications until provided date. |
dateType | string Default: "dateOfCreation" Enum: "dateOfCreation" "dateOfDeploymentRequest" "dateOfDeployment" Allows to filter applications from provided dateType. |
kpi | string Allows to filter applications by kpi (Allowed values: internal, business, payasyougo). |
format | string Default: "small" Enum: "small" "medium" "full" Allows to retrieve more or less application details in response.
|
limit | number Default: 100 Allow to specify the number of applications to retrieve. |
offset | number Allow to specify the position of first application to retrieve (first app if not specified). Warning: if offset > total, no results are returned. |
sortField | string Default: "name" Sort applications list based on the given field. |
sortOrder | number Default: 1 Enum: -1 1 Specify order when sorting applications list. |
{- "data": [
- {
- "id": "78e98ee09bad11e8b8edebb50d679df6",
- "name": "App_Rainbow_1",
- "state": "active",
- "type": "mobile",
- "ownerId": "573f189f774e0a428ee813a3"
}, - {
- "id": "a34bd1b09bae11e89edb479709eed0b6",
- "name": "App_Rainbow_2",
- "state": "new",
- "type": "web",
- "ownerId": "573f189f774e0a428ee813a3"
}
], - "limit": 100,
- "offset": 0,
- "total": 2
}
Rainbow users can create their own applications.
activity required | string Enum: "A" "B" "C" "D" "E" "F" "G" "H" "I" "J" "K" "L" "M" "N" "O" "P" "Q" "R" "S" "T" "U" Application activity domain.
|
allowSendingSms | boolean Indicates if application could send sms. Only superadmin and app_superadmin can set this field. |
appSecret | string app_superadmin is allowed to set application appSecret, otherwise it is automatically generated |
appSuperadminComment | string [ 0 .. 1024 ] characters Comment regarding the application (free data).
|
appSuperadminStatus | string [ 0 .. 64 ] characters Application status (free data).
|
backchannelAuthenticationRedirectUrl | string URL which can be used by the application (especially Desktop applications) as callback URL for backchannel authentication mechanism (currently implemented only for Single Sign On (OIDC, SAML)).
Used when |
description | string application description |
disableOAuthConsentScreen | boolean Default: false If set to true, the consent screen will not be presented to the users during the OAuth 2.0 authentication
for this application.
|
enableOAuthAllowSeveralRefreshTokens | boolean Default: true If set to true, allow to generate several OAuth 2.0 refresh_token per user for this application.
|
enableOAuthImplicitGrant | boolean Default: false If set to true, allow the application to use OAuth 2.0 implicit grant.
|
enableOAuthRefreshTokenRotation | boolean Default: true If set to true, enable the OAuth 2.0 refresh_token rotation for this application.
|
kpi | string Enum: "business" "payasyougo" "rainbowstore" "appconnect" superadmin/app_superadmin is allowed to set application kpi |
name required | string [ 1 .. 255 ] characters Application title |
oauthRedirectUris | Array of strings URI(s) used by the application as callback URL for OAuth 2.0.
|
origin | string [ 0 .. 255 ] characters Origin |
ownerId | string Owner unique identifier (like 578bb08dc0d8c107725ef8c4).
|
privacyPoliciesUrl | Array of strings URL of the application's website explaining the application's privacy policy for the end user.
|
ssoAuthenticationRedirectUrl | string URL which can be used by the application as callback URL for authentication using Single Sign On (OIDC, SAML).
|
termsOfServiceUrl | Array of strings URL of the application's website explaining the application's terms of services for the end user.
|
type required | string Enum: "web" "mobile" "desktop" "server" "bot" "iot" "admin" Application type. |
{- "activity": "A",
- "allowSendingSms": true,
- "appSecret": "string",
- "appSuperadminComment": "string",
- "appSuperadminStatus": "string",
- "backchannelAuthenticationRedirectUrl": "string",
- "description": "string",
- "disableOAuthConsentScreen": false,
- "enableOAuthAllowSeveralRefreshTokens": true,
- "enableOAuthImplicitGrant": false,
- "enableOAuthRefreshTokenRotation": true,
- "kpi": "business",
- "name": "string",
- "oauthRedirectUris": [
- "string"
], - "origin": "string",
- "ownerId": "string",
- "privacyPoliciesUrl": [
- "string"
], - "ssoAuthenticationRedirectUrl": "string",
- "termsOfServiceUrl": [
- "string"
], - "type": "web"
}
{- "data": {
- "id": "78e98ee09bad11e8b8edebb50d679df6",
- "appSecret": "2UrOcs3agk34zaV3Jsf01vM54iLyqwBEpnv5vJr72D9cE5wMVQeEe3BM7IxzyyJD",
- "backchannelAuthenticationRedirectUrl": "myapp://backchannel/callback",
- "enableOAuthImplicitGrant": false,
- "enableOAuthAllowSeveralRefreshTokens": true,
- "enableOAuthRefreshTokenRotation": true,
- "disableOAuthConsentScreen": false,
- "origin": "....",
- "name": "App_Rainbow_1",
- "latin_name": "app_rainbow_1",
- "ownerId": "573f189f774e0a428ee813a3",
- "dateOfCreation": ".....",
- "state": "new",
- "type": "mobile",
- "activity": "F",
- "env": "in_deployment",
- "description": "My wonderful app",
- "allowSendingSms": false
}
}
Rainbow developers can restart their own applications.
If application's kpi is "rainbowstore", then "restart" should use rainbowstore APIs.
appId required | string Application unique identifier (like 78e98ee09bad11e8b8edebb50d679df6) |
{- "data": {
- "id": "78e98ee09bad11e8b8edebb50d679df6",
- "appSecret": "2UrOcs3agk34zaV3Jsf01vM54iLyqwBEpnv5vJr72D9cE5wMVQeEe3BM7IxzyyJD",
- "backchannelAuthenticationRedirectUrl": "myapp://backchannel/callback",
- "enableOAuthImplicitGrant": false,
- "enableOAuthAllowSeveralRefreshTokens": true,
- "enableOAuthRefreshTokenRotation": true,
- "disableOAuthConsentScreen": false,
- "origin": "....",
- "name": "App_Rainbow_1",
- "latin_name": "app_rainbow_1",
- "ownerId": "573f189f774e0a428ee813a3",
- "dateOfCreation": ".....",
- "state": "new",
- "type": "mobile",
- "activity": "F",
- "env": "in_deployment",
- "description": "My wonderful app",
- "allowSendingSms": false
}
}
Rainbow users can stop their own applications.
If application's kpi is "rainbowstore", then "stop" should use rainbowstore APIs.
appId required | string Application unique identifier (like 78e98ee09bad11e8b8edebb50d679df6) |
{- "data": {
- "id": "78e98ee09bad11e8b8edebb50d679df6",
- "appSecret": "2UrOcs3agk34zaV3Jsf01vM54iLyqwBEpnv5vJr72D9cE5wMVQeEe3BM7IxzyyJD",
- "backchannelAuthenticationRedirectUrl": "myapp://backchannel/callback",
- "enableOAuthImplicitGrant": false,
- "enableOAuthAllowSeveralRefreshTokens": true,
- "enableOAuthRefreshTokenRotation": true,
- "disableOAuthConsentScreen": false,
- "origin": "....",
- "name": "App_Rainbow_1",
- "latin_name": "app_rainbow_1",
- "ownerId": "573f189f774e0a428ee813a3",
- "dateOfCreation": ".....",
- "state": "new",
- "type": "mobile",
- "activity": "F",
- "env": "in_deployment",
- "description": "My wonderful app",
- "allowSendingSms": false
}
}
Rainbow developers can delete their own applications.
If application's kpi is "rainbowstore", then deletion should use rainbowstore APIs.
appId required | string Application unique identifier (like 78e98ee09bad11e8b8edebb50d679df6) |
{- "status": "Application (with id : 78e98ee09bad11e8b8edebb50d679df6) successfully deleted",
- "data": [ ]
}
app_admin can see their own applications and applications belonging to other developers of their company.
appId required | string Application unique identifier (like 78e98ee09bad11e8b8edebb50d679df6) |
{- "data": {
- "id": "78e98ee09bad11e8b8edebb50d679df6",
- "appSecret": "2UrOcs3agk34zaV3Jsf01vM54iLyqwBEpnv5vJr72D9cE5wMVQeEe3BM7IxzyyJD",
- "backchannelAuthenticationRedirectUrl": "myapp://backchannel/callback",
- "enableOAuthImplicitGrant": false,
- "enableOAuthAllowSeveralRefreshTokens": true,
- "enableOAuthRefreshTokenRotation": true,
- "disableOAuthConsentScreen": false,
- "origin": "....",
- "name": "App_Rainbow_1",
- "latin_name": "app_rainbow_1",
- "ownerId": "573f189f774e0a428ee813a3",
- "dateOfCreation": ".....",
- "state": "new",
- "type": "mobile",
- "activity": "F",
- "env": "in_deployment",
- "pushNotificationSettings": [
- {
- "type": "apns",
- "certificateType": "im",
- "certificateFingerprint": "4F:8F:7D:C5:FE:C5:F3:25:BA:4C:B8:88:F5:17:6A:2C:C6:F2:92:50",
- "certificateExpirationTime": "2021-11-04T14:46:16.000Z",
- "dateOfCreation": "2018-01-24T13:47:14.119Z",
- "id": "5a688e6288e1dc5cd0d81d97",
- "isEnabled": true
}, - {
- "type": "apns",
- "certificateType": "voip",
- "certificateFingerprint": "4F:8F:7D:C5:FE:C5:F3:25:BA:4C:B8:88:F5:17:6A:2C:C6:F2:92:50",
- "certificateExpirationTime": "2021-11-04T14:46:16.000Z",
- "dateOfCreation": "2018-01-24T13:47:14.119Z",
- "lastUpdateDate": "2018-01-25T12:10:49.318Z",
- "id": "5a688e6288e1dc5cd0d81d98",
- "isEnabled": true
}, - {
- "appId": "a7c99c70c91a11e7b5c6732f5816ea89",
- "type": "fcm_xmpp",
- "authorizationKey": "AIzaSyZ-1u...0GBYzPu7Udno5aA",
- "senderId": "123456789102",
- "dateOfCreation": "2018-01-24T12:37:11.356Z",
- "id": "5a687df74619c35adbf095e7",
- "isEnabled": true
}
], - "allowSendingSms": false
}
}
Rainbow users can update their own applications.
appId required | string Application unique identifier (like 78e98ee09bad11e8b8edebb50d679df6) |
activity | string Enum: "A" "B" "C" "D" "E" "F" "G" "H" "I" "J" "K" "L" "M" "N" "O" "P" "Q" "R" "S" "T" "U" Application activity domain.
|
allowSendingSms | boolean Indicates if application could send sms. Only superadmin and app_superadmin can set this field. |
appSuperadminComment | string [ 0 .. 1024 ] characters Comment regarding the application (free data).
|
appSuperadminStatus | string [ 0 .. 64 ] characters Application status (free data).
|
backchannelAuthenticationRedirectUrl | string URL which can be used by the application (especially Desktop applications) as callback URL for backchannel authentication mechanism (currently implemented only for Single Sign On (OIDC, SAML)).
Used when |
deployReason | string [ 1 .. 255 ] characters Reason of deployment
|
description | string application description |
disableOAuthConsentScreen | boolean Default: false If set to true, the consent screen will not be presented to the users during the OAuth 2.0 authentication
for this application.
|
enableOAuthAllowSeveralRefreshTokens | boolean Default: true If set to true, allow to generate several OAuth 2.0 refresh_token per user for this application.
|
enableOAuthImplicitGrant | boolean Default: false If set to true, allow the application to use OAuth 2.0 implicit grant.
|
enableOAuthRefreshTokenRotation | boolean Default: true If set to true, enable the OAuth 2.0 refresh_token rotation for this application.
|
kpi | string Enum: "business" "payasyougo" "rainbowstore" "appconnect" superadmin/app_superadmin is allowed to set application kpi |
name | string [ 1 .. 255 ] characters Application title |
oauthRedirectUris | Array of strings URI(s) used by the application as callback URL for OAuth 2.0.
|
origin | string [ 0 .. 255 ] characters Origin |
ownerId | string Change application's owner unique identifier (like 578bb08dc0d8c107725ef8c4).
|
privacyPoliciesUrl | Array of strings URL of the application's website explaining the application's privacy policy for the end user.
|
refreshAppSecret | boolean If set to true, refresh appSecret by setting a new random value |
ssoAuthenticationRedirectUrl | string URL which can be used by the application as callback URL for authentication using Single Sign On (OIDC, SAML).
|
termsOfServiceUrl | Array of strings URL of the application's website explaining the application's terms of services for the end user.
|
type | string Enum: "web" "mobile" "desktop" "server" "bot" "iot" "admin" Application type. |
{- "activity": "A",
- "allowSendingSms": true,
- "appSuperadminComment": "string",
- "appSuperadminStatus": "string",
- "backchannelAuthenticationRedirectUrl": "string",
- "deployReason": "string",
- "description": "string",
- "disableOAuthConsentScreen": false,
- "enableOAuthAllowSeveralRefreshTokens": true,
- "enableOAuthImplicitGrant": false,
- "enableOAuthRefreshTokenRotation": true,
- "kpi": "business",
- "name": "string",
- "oauthRedirectUris": [
- "string"
], - "origin": "string",
- "ownerId": "string",
- "privacyPoliciesUrl": [
- "string"
], - "refreshAppSecret": true,
- "ssoAuthenticationRedirectUrl": "string",
- "termsOfServiceUrl": [
- "string"
], - "type": "web"
}
{- "data": {
- "id": "78e98ee09bad11e8b8edebb50d679df6",
- "appSecret": "2UrOcs3agk34zaV3Jsf01vM54iLyqwBEpnv5vJr72D9cE5wMVQeEe3BM7IxzyyJD",
- "backchannelAuthenticationRedirectUrl": "myapp://backchannel/callback",
- "enableOAuthImplicitGrant": false,
- "enableOAuthAllowSeveralRefreshTokens": true,
- "enableOAuthRefreshTokenRotation": true,
- "disableOAuthConsentScreen": false,
- "origin": "....",
- "name": "App_Rainbow_1",
- "latin_name": "app_rainbow_1",
- "ownerId": "573f189f774e0a428ee813a3",
- "dateOfCreation": ".....",
- "state": "new",
- "type": "mobile",
- "activity": "F",
- "env": "in_deployment",
- "description": "My wonderful app",
- "allowSendingSms": false
}
}
Rainbow users can update their own applications.
If application's kpi is "rainbowstore", then the deployment should use rainbowstore APIs.
If application's kpi is "appconnect", then description should be filled on application.
appId required | string Application unique identifier (like 78e98ee09bad11e8b8edebb50d679df6) |
{- "data": {
- "id": "78e98ee09bad11e8b8edebb50d679df6",
- "appSecret": "2UrOcs3agk34zaV3Jsf01vM54iLyqwBEpnv5vJr72D9cE5wMVQeEe3BM7IxzyyJD",
- "backchannelAuthenticationRedirectUrl": "myapp://backchannel/callback",
- "enableOAuthImplicitGrant": false,
- "enableOAuthAllowSeveralRefreshTokens": true,
- "enableOAuthRefreshTokenRotation": true,
- "disableOAuthConsentScreen": false,
- "origin": "....",
- "name": "App_Rainbow_1",
- "latin_name": "app_rainbow_1",
- "ownerId": "573f189f774e0a428ee813a3",
- "dateOfCreation": ".....",
- "state": "new",
- "type": "mobile",
- "activity": "F",
- "env": "in_deployment",
- "description": "My wonderful app",
- "allowSendingSms": false
}
}
This API allows to create application push notification settings.
appId required | string Application unique identifier (like a7c99c70c91a11e7b5c6732f5816ea89) |
apiKey | string [ 1 .. 255 ] characters String containing your Android App apiKey as defined in https://push.baidu.com/doc/guide/manufacturer, , this field is required if 'type' is |
appBundleId | string [ 1 .. 255 ] characters String containing your Apple App Bundle ID as defined in https://developer.apple.com/documentation/appstoreconnectapi/bundle_ids, , this field is required if 'type' is |
authorizationKey | string [ 1 .. 255 ] characters String containing a authorization key, this field is required if 'type' is |
certificateFile | string String containing APNS certificate in a PEM format, this field is required if 'type' is |
certificateType | string Enum: "im" "voip" Certificate type, this field is required if 'type' is |
client_email | string String containing client_email of your Application available in firebase (See https://console.firebase.google.com/u/0/project/[Your project]/settings/serviceaccounts/adminsdk for explanation), this field is required if 'type' is |
isEnabled | boolean Default: false Boolean indicating if setting is enabled/disabled |
private_key | string String containing private_key of your Application available in firebase (See https://console.firebase.google.com/u/0/project/[Your project]/settings/serviceaccounts/adminsdk for explanation), this field is required if 'type' is |
private_key_id | string String containing private_key_id of your Application available in firebase (See https://console.firebase.google.com/u/0/project/[Your project]/settings/serviceaccounts/adminsdk for explanation), this field is required if 'type' is |
project_id | string String containing project_id of your Application available in firebase (See https://console.firebase.google.com/u/0/project/[Your project]/settings/serviceaccounts/adminsdk for explanation), this field is required if 'type' is |
secretKey | string [ 1 .. 255 ] characters String containing your Android App secretKey as defined in https://push.baidu.com/doc/guide/manufacturer, this field is required if 'type' is |
senderId | string [ 1 .. 255 ] characters String containing senderId of your Application available in firebase ( available in https://console.firebase.google.com/u/0/project/[Your project]/settings/cloudmessaging/) , this field is required if 'type' is |
token_uri | string String containing token_uri of your Application available in firebase (See https://console.firebase.google.com/u/0/project/[Your project]/settings/serviceaccounts/adminsdk for explanation), this field is required if 'type' is |
type required | string Enum: "apns" "apns_v2fcm" "fcm_xmpp" "baidu" "fcm_v1" Push notification type |
{- "apiKey": "string",
- "appBundleId": "string",
- "authorizationKey": "string",
- "certificateFile": "string",
- "certificateType": "im",
- "client_email": "string",
- "isEnabled": false,
- "private_key": "string",
- "private_key_id": "string",
- "project_id": "string",
- "secretKey": "string",
- "senderId": "string",
- "token_uri": "string",
- "type": "apns"
}
{- "data": {
- "type": "fcm_v1",
- "appId": "b48dca10080511e8a9b3cd506a250e76",
- "project_id": "YourProject-....",
- "private_key_id": "f35a...d",
- "private_key": "-----BEGIN PRIVATE KEY-----\\...-----END PRIVATE KEY-----\\\\",
- "client_email": "firebase-adminsdk-.....iam.gserviceaccount.com",
- "isEnabled": true
}
}
This API allows to get all application push notification settings.
appId required | string Application unique identifier (like a7c99c70c91a11e7b5c6732f5816ea89) |
type | string Enum: "apns" "fcm" "apns_v2" "fcm_xmpp" "baidu" "fcm_v1" Allows to filter application push certificates list of the type(s) provided in this option. |
{- "data": [
- {
- "appId": "a7c99c70c91a11e7b5c6732f5816ea89",
- "type": "apns",
- "certificateType": "im",
- "certificateFingerprint": "4F:8F:7D:C5:FE:C5:F3:25:BA:4C:B8:88:F5:17:6A:2C:C6:F2:92:50",
- "certificateExpirationTime": "2021-11-04T14:46:16.000Z",
- "dateOfCreation": "2018-01-24T16:25:54.020Z",
- "id": "5a68b3927a03f860a0d9b4f7",
- "isEnabled": true
}, - {
- "appId": "a7c99c70c91a11e7b5c6732f5816ea89",
- "type": "apns",
- "certificateType": "voip",
- "certificateFingerprint": "4F:8F:7D:C5:FE:C5:F3:25:BA:4C:B8:88:F5:17:6A:2C:C6:F2:92:50",
- "certificateExpirationTime": "2021-11-04T14:46:16.000Z",
- "dateOfCreation": "2018-01-24T13:59:32.055Z",
- "lastUpdateDate": "2018-01-25T12:13:43.777Z",
- "id": "5a68914488e1dc5cd0d81d98",
- "isEnabled": true
}, - {
- "appId": "a7c99c70c91a11e7b5c6732f5816ea89",
- "type": "fcm",
- "authorizationKey": "authorization key 5",
- "dateOfCreation": "2018-01-24T12:37:11.356Z",
- "lastUpdateDate": "2018-01-25T12:10:49.318Z",
- "id": "5a687df74619c35adbf095e7",
- "isEnabled": true
}, - {
- "appId": "a7c99c70c91a11e7b5c6732f5816ea89",
- "type": "apns_v2",
- "authorizationKey": "authorization key 5",
- "certificateExpirationTime": "2021-11-04T14:46:16.000Z",
- "dateOfCreation": "2018-01-24T12:37:11.356Z",
- "lastUpdateDate": "2018-01-25T12:10:49.318Z",
- "id": "5a687df74619c35adbf095e7",
- "isEnabled": true
}, - {
- "appId": "a7c99c70c91a11e7b5c6732f5816ea89",
- "type": "fcm_xmpp",
- "authorizationKey": "AIzaSyZ-1u...0GBYzPu7Udno5aA",
- "senderId": "123456789102",
- "dateOfCreation": "2018-01-24T12:37:11.356Z",
- "lastUpdateDate": "2018-01-25T12:10:49.318Z",
- "id": "5a687df74619c35adbf095e7",
- "isEnabled": true
}, - {
- "appId": "a7c99c70c91a11e7b5c6732f5816ea89",
- "type": "baidu",
- "secretKey": "AAAAW390chM...4L17N37qz",
- "apiKey": "KOakEfWs....I6WEuQiGCj",
- "dateOfCreation": "2018-01-24T12:37:11.356Z",
- "lastUpdateDate": "2018-01-25T12:10:49.318Z",
- "id": "5a687df74619c35adbf095e7",
- "isEnabled": true
}, - {
- "type": "fcm_v1",
- "appId": "a7c99c70c91a11e7b5c6732f5816ea89",
- "project_id": "YourProject-....",
- "private_key_id": "f35a...d",
- "private_key": "-----BEGIN PRIVATE KEY-----\\...-----END PRIVATE KEY-----\\\\",
- "client_email": "firebase-adminsdk-.....iam.gserviceaccount.com",
- "isEnabled": true
}
], - "total": 7
}
This API allows to delete an application push notification settings.
appId required | string Application unique identifier (like a7c99c70c91a11e7b5c6732f5816ea89) |
id required | string Push notification settings unique identifier (like 5a686144554d365925db8796) |
{- "errorCode": 500,
- "errorMsg": "Internal Server Error",
- "errorDetails": "",
- "errorDetailsCode": -1,
- "errorDetailsData": {
- "x-rainbow-request-id": "di7OsLkYM"
}
}
This API allows to get an application push notification settings.
appId required | string Application unique identifier (like a7c99c70c91a11e7b5c6732f5816ea89) |
id required | string Push notification settings unique identifier (like 5a686144554d365925db8796) |
{- "data": {
- "type": "fcm_v1",
- "appId": "a7c99c70c91a11e7b5c6732f5816ea89",
- "project_id": "YourProject-....",
- "private_key_id": "f35a...d",
- "private_key": "-----BEGIN PRIVATE KEY-----\\...-----END PRIVATE KEY-----\\\\",
- "client_email": "firebase-adminsdk-.....iam.gserviceaccount.com",
- "isEnabled": true
}
}
This API allows to update an application push notification settings.
appId required | string Application unique identifier (like a7c99c70c91a11e7b5c6732f5816ea89) |
id required | string Push notification settings unique identifier (like 5a686144554d365925db8796) |
apiKey | string [ 1 .. 255 ] characters String containing your Android App apiKey as defined in https://push.baidu.com/doc/guide/manufacturer, , this field is required if 'type' is |
authorizationKey | string [ 1 .. 255 ] characters String containing a authorization key, this field is required if updated push notification settings type is |
certificateFile | string String containing APNS certificates in a PEM format, this field is required if updated push notification settings type is |
client_email | string String containing client_email of your Application available in firebase (See https://console.firebase.google.com/u/0/project/[Your project]/settings/serviceaccounts/adminsdk for explanation), this field is required if 'type' is |
isEnabled | boolean Default: false Boolean indicating if setting is enabled/disabled |
private_key | string String containing private_key of your Application available in firebase (See https://console.firebase.google.com/u/0/project/[Your project]/settings/serviceaccounts/adminsdk for explanation), this field is required if 'type' is |
private_key_id | string String containing private_key_id of your Application available in firebase (See https://console.firebase.google.com/u/0/project/[Your project]/settings/serviceaccounts/adminsdk for explanation), this field is required if 'type' is |
project_id | string String containing project_id of your Application available in firebase (See https://console.firebase.google.com/u/0/project/[Your project]/settings/serviceaccounts/adminsdk for explanation), this field is required if 'type' is |
secretKey | string [ 1 .. 255 ] characters String containing your Android App secretKey as defined in https://push.baidu.com/doc/guide/manufacturer, , this field is required if 'type' is |
token_uri | string String containing token_uri of your Application available in firebase (See https://console.firebase.google.com/u/0/project/[Your project]/settings/serviceaccounts/adminsdk for explanation), this field is required if 'type' is |
{- "apiKey": "string",
- "authorizationKey": "string",
- "certificateFile": "string",
- "client_email": "string",
- "isEnabled": false,
- "private_key": "string",
- "private_key_id": "string",
- "project_id": "string",
- "secretKey": "string",
- "token_uri": "string"
}
{- "data": {
- "type": "fcm_v1",
- "appId": "a7c99c70c91a11e7b5c6732f5816ea89",
- "project_id": "YourProject-....",
- "private_key_id": "f35a...d",
- "private_key": "-----BEGIN PRIVATE KEY-----\\...-----END PRIVATE KEY-----\\\\",
- "client_email": "firebase-adminsdk-.....iam.gserviceaccount.com",
- "isEnabled": true
}
}
This API can be used to confirm that a user has requested a developer account creation. Used only in the 2 steps onboarding scenario. See (#applications/developers:applications/developers/PostRegister). To confirm the user has the role app_admin, an email is sent to the user. The email contains this url, and the user must used it to confirm it's registration.
token | string Confirmation token (Token provided in confirmation email). |
{- "token": "string"
}
{- "status": "Email successfully sent",
- "data": {
- "email": "user@company.com"
}
}
This API allows a developer to send a feedback.
x-rainbow-app-auth | string Application authentication It has to be computed as follow: <base64encode(appId:sha256(appSecretchallenge))> (concatenation of appSecret and challenge, hashed with sha256). The challenge used to compute the Application authentication is mandatory. In the case the parameter x-rainbow-app-auth could not be provided in the headers, it can be provided in the query string parameters. |
challenge required | string challenge for application authentication. Should be randomly generated by the application (the challenge should be unique for each request for security reasons). |
content-length required | string <calculated> |
x-rainbow-app-auth | string Application authentication Basic <base64encode( Application authentication is mandatory, if x-rainbow-app-auth can't be set set in header it must be set in query parameters. |
Attachment of the feedback (binary format)
{- "errorCode": 401,
- "errorMsg": "Unauthorized",
- "errorDetails": "Unknown application or wrong token for application id 56adef25296bdca7652",
- "errorDetailsCode": 401500
}
This API allows a developer to choose.
subject required | string [ 1 .. 255 ] characters Subject of the offer mail |
body required | string [ 1 .. 4096 ] characters Body of the offer mail |
offer required | string Enum: "demo" "business" "appconnect" Offer chosen |
{- "status": "Offer successfully sent"
}