Administrative Services

The PowerAuth Admin API consists of several API resource groups:

The Application Services offer services for managing applications.
The Callback URL Services offer services for managing callbacks, enabling real-time notifications for your systems whenever status of a registration or an operation changes.
The Internal Services offer services that are used for invoking internal system calls.
The Push Notification Services offer services for managing push notifications.

Possible Error Codes

The API may return one of the following error codes:

HTTP Status Code	Error Code	Description
`400`	`ERROR_REGISTRATION`	Registration related error occurred.
`400`	`ERROR_REGISTRATION_NOT_FOUND`	Registration was not found during a call where registration is expected.
`400`	`ERROR_REGISTRATION_NOT_ALLOWED`	Registration was not allowed because another registration is already in progress for the user.
`400`	`ERROR_REGISTRATION_CHANGE`	Invalid registration change was attempted.
`400`	`ERROR_OPERATION_NOT_FOUND`	Operation was not found during a call where operation is expected.
`400`	`ERROR_OPERATION_STATE_CHANGE`	Invalid operation change was attempted.
`400`	`ERROR_OTP_INVALID`	Offline certification - OTP format is invalid.
`400`	`ERROR_AUDIT`	Error occurred while fetching the audit log.
`400`	`ERROR_REQUEST`	Request did not pass validation (mandatory property missing, null/invalid value).
`401`	`ERROR_UNAUTHORIZED`	Returned in the case authentication fails (invalid application credentials).
`404`	`ERROR_NOT_FOUND`	Returned in the case URL is not present (calling wrong API).
`500`	`ERROR_GENERIC`	Unknown error occurred while processing request.
`500`	`ERROR_INTERNAL_API`	Communication with internal service failed.

Please ensure your application handles these errors appropriately, displaying user-friendly messages or taking corrective actions as needed.

Application Services

post /admin/applications Create Application

Create a new app with provided ID.

Request

{
  "id": "MY_APP_01",
  "roles": [
    "ROLE1",
    "ROLE2"
  ]
}

Response

{
  "id": "MY_APP_01",
  "serviceBaseUrl": "https://api.example.com/",
  "appKey": "b34...==",
  "appSecret": "aef...==",
  "masterServerPublicKey": "MIIB...==",
  "roles": [
    "ROLE1",
    "ROLE2"
  ]
}

Attribute	Type	Description
`id`*	String	Name of the application.
`serviceBaseUrl`*	URL	Base URL of the PowerAuth Standard RESTful API.
`appKey`*	String	App Key (value for the mobile app configuration).
`appSecret`*	String	App Secret (value for the mobile app configuration).
`masterServerPublicKey`*	String	Master Server Public Key (value for the mobile app configuration).
`roles`*	String[]	Collection of application roles.

Unable to return application because of the invalid application name or version.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "No enabled application version was found"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

get /admin/applications Get Application List

Obtain a list of all the applications in the system.

Request

Empty Request

Response

{
  "applications": [
    {
      "id": "demo-app1"
    },
    {
      "id": "demo-app2"
    }
  ]
}

Attribute	Type	Description
`applications`*	String	Root element for the application list.
`applications[].id`	String	Unique identifier of the application

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

get /admin/applications/detail/{id} Get App Details

Obtain the configuration for an app with provided ID.

Request

Path Params

Param	Type	Description
`id`	`String`	ID of the application.

Response

{
  "id": "MY_APP_01",
  "serviceBaseUrl": "https://api.example.com/",
  "appKey": "b34...==",
  "appSecret": "aef...==",
  "masterServerPublicKey": "MIIB...==",
  "roles": [
    "ROLE1",
    "ROLE2"
  ]
}

Attribute	Type	Description
`id`*	String	Name of the application.
`serviceBaseUrl`*	URL	Base URL of the PowerAuth Standard RESTful API.
`appKey`*	String	App Key (value for the mobile app configuration).
`appSecret`*	String	App Secret (value for the mobile app configuration).
`masterServerPublicKey`*	String	Master Server Public Key (value for the mobile app configuration).
`roles`*	String[]	Collection of application roles.

Unable to return application because of the invalid application name or version.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "No enabled application version was found"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

post /admin/applications/roles Add Roles To Application

Add roles to an app with provided ID. The call ignores duplicities on application roles.

Request

{
  "id": "MY_APP_01",
  "roles": [
    "ROLE1",
    "ROLE2"
  ]
}

Response

{
  "status": "OK"
}

When formal request validation fails, i.e., due to missing application ID.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Invalid method parameter value",
    "violations": [
      {
        "fieldName": "id",
        "hint": "must not be empty"
      }
    ]
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

post /admin/applications/{id}/roles/remove Remove Roles From Application

Remove roles from an app with provided ID. The call ignores missing roles to be removed from an application.

Request

{
  "roles": [
    "ROLE1",
    "ROLE2"
  ]
}

Path Params

Attribute	Type	Description
`id`*	`String`	ID of the application, whose role should be removed.

Request Params

Attribute	Type	Description
`roles`*	`String[]`	Collection of roles to be removed.

Response

{
  "status": "OK"
}

When formal request validation fails, i.e., due to missing application ID.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Invalid method parameter value",
    "violations": [
      {
        "fieldName": "id",
        "hint": "must not be empty"
      }
    ]
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

Callback URL Services

PowerAuth Cloud can notify your systems via a callback (sometimes called “webhooks”) whenever status of a registration or an operation changes. This API provides a convenient way to manage callbacks associated with an existing application.

There are two callback types:

Registration callbacks are called whenever registration status changes.
Operation callbacks are called whenever operation status changes.

post /v2/admin/applications/{appId}/callbacks Create New Callback

Request

{
  "name": "$CALLBACK_NAME",
  "type": "$(REGISTRATION_STATUS_CHANGE|OPERATION_STATUS_CHANGE)",
  "callbackUrl": "$CALLBACK_URL",
  "attributes": [
    "$ATTRIBUTE1",
    "$ATTRIBUTE2"
  ],
  "authentication": {
    "httpBasic": {
      "enabled": true,
      "username": "$USERNAME",
      "password": "$PASSWORD"
    }
  }
}

Path Params

Attribute	Type	Description
`appId`*	`String`	ID of the application to which the callback is registered.

Request Params

Attribute	Type	Description
`name`*	`String`	Name of the callback to identify the callback purpose.
`type`*	`String`	Type of the callback. Either `REGISTRATION_STATUS_CHANGE` or `OPERATION_STATUS_CHANGE`.
`callbackUrl`*	`String`	Callback URL that is able to receive update callbacks.
`attributes`	`String[]`	Attributes to include into the callback.
`authentication.httpBasic.enabled`	`Boolean`	Whether to enable the HTTP basic authentication.
`authentication.httpBasic.username`	`String`	Username for the HTTP basic authentication.
`authentication.httpBasic.password`	`String`	Password for the HTTP basic authentication.

The attributes list can contain following values:

activationId
userId
activationName
deviceInfo
platform
activationFlags
activationStatus
blockedReason
applicationId

Response

{
  "applicationId": "$APPLICATION_ID",
  "callbackId": "$CALLBACK_ID",
  "name": "$CALLBACK_NAME",
  "callbackUrl": "$CALLBACK_URL",
  "attributes": [
    "$ATTRIBUTE1",
    "$ATTRIBUTE2"
  ],
  "authentication": {
    "httpBasic": {
      "enabled": true,
      "username": "$USERNAME",
      "passwordSet": true
    }
  }
}

Request validation failed.

Application with specified applicationId does not exist.
Passed callbackUrl is not valid.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "$ERROR_MESSAGE"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

get /v2/admin/applications/{appId}/callbacks Get Callback List

List all callbacks associated with a given application.

Request

Path Params

Attribute	Type	Description
`appId`*	`String`	ID of the application whose callbacks are to be listed.

Response

{
  "callbacks": [
    {
      "applicationId": "$APPLICATION_ID",
      "callbackId": "$CALLBACK_ID",
      "name": "$CALLBACK_NAME",
      "type": "$(REGISTRATION_STATUS_CHANGE|OPERATION_STATUS_CHANGE)",
      "callbackUrl": "$CALLBACK_URL",
      "attributes": [
        "$ATTRIBUTE1",
        "$ATTRIBUTE2"
      ],
      "authentication": {
        "httpBasic": {
          "enabled": true,
          "username": "$USERNAME",
          "passwordSet": true
        }
      }
    }
  ]
}

Request validation failed.

Application with specified applicationId does not exist.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "$ERROR_MESSAGE"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

put /v2/admin/applications/{appId}/callbacks/{callbackId} Update Callback

Edit an existing callback url.

Request

{
  "name": "$CALLBACK_NAME",
  "callbackUrl": "$CALLBACK_URL",
  "attributes": [
    "$ATTRIBUTE1",
    "$ATTRIBUTE2"
  ],
  "authentication": {
    "httpBasic": {
      "enabled": true,
      "username": "$USERNAME",
      "password": "$PASSWORD"
    }
  }
}

Path Params

Attribute	Type	Description
`appId`*	`String`	ID of the application whose callback is to be edited.
`callbackId`*	`String`	ID of the callback to edit.

Request Params

Attribute	Type	Description
`name`*	`String`	Name of the callback to identify the callback purpose.
`callbackUrl`*	`String`	Callback URL that is able to receive update callbacks.
`attributes`	`String[]`	Attributes to include into the callback.
`authentication.httpBasic.enabled`	`Boolean`	Whether to enable the HTTP basic authentication.
`authentication.httpBasic.username`	`String`	Username for the HTTP basic authentication.
`authentication.httpBasic.password`	`String`	Password for the HTTP basic authentication.

The attributes list can contain following values:

activationId
userId
activationName
deviceInfo
platform
activationFlags
activationStatus
blockedReason
applicationId

Response

{
  "applicationId": "$APPLICATION_ID",
  "callbackId": "$CALLBACK_ID",
  "name": "$CALLBACK_NAME",
  "type": "$(REGISTRATION_STATUS_CHANGE|OPERATION_STATUS_CHANGE)",
  "callbackUrl": "$CALLBACK_URL",
  "attributes": [
    "$ATTRIBUTE1",
    "$ATTRIBUTE2"
  ],
  "authentication": {
    "httpBasic": {
      "enabled": true,
      "username": "$USERNAME",
      "passwordSet": true
    }
  }
}

Request validation failed.

Application with specified appId does not exist.
Callback with specified callbackId does not exist.
Passed callbackUrl is not valid.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "$ERROR_MESSAGE"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

delete /v2/admin/applications/{appId}/callbacks/{callbackId} Remove Callback

Remove a callback url from an application’s callback list.

Request

Path Params

Attribute	Type	Description
`appId`*	`String`	ID of the application whose callback is to be removed.
`callbackId`*	`String`	ID of the callback to remove.

Response

{
  "status": "OK"
}

Attribute	Type	Description
`status`*	`String`	Fixed value `OK`.

Request validation failed.

Application with specified appId does not exist.
Callback with specified callbackId does not exist.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_ADMIN",
    "message": "$ERROR_MESSAGE"
  }
}

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

Internal Services

Internal callbacks are not supposed to be directly called by the app developer. They are intended for internal systems, as a means to notify the cloud component about various internal changes.

post /internal/callback/operation Operation Callback

Operation status changed internally, i.e., operation expired.

Request

{
  "operationId": "$OPERATION_ID"
}

Attribute	Type	Description
`operationId`*	`UUID`	ID of an operation check the status on callback in order to obtain the current status.

Response

{
  "status": "OK"
}

Attribute	Type	Description
`status`*	`String`	Fixed value `OK`.

Request validation failed.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Required String parameter 'operationId' is not present"
  }
}

ERROR_REQUEST - Request did not pass a structural validation (mandatory field is null, invalid field type, etc.).

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

Push Notification Services

get admin/applications/{id}/push Fetch Push Configuration

Fetch push notification configuration for specified application.

Request

Path Params

Param	Type	Description
`id`*	`String`	ID of the application.

Response

{
  "id": "config123",
  "apns": {
    "topic": "com.example.MyApp",
    "keyId": "ABCD1234",
    "teamId": "EFGH5678",
    "environment": "DEVELOPMENT"
  },
  "fcm": {
    "projectId": "my-fcm-project-123"
  },
  "hms": {
    "projectId": "my-hms-project-456"
  }
}

Attribute	Type	Description
`id`*	`String`	The unique identifier of the push configuration.
`apns`	`Object`	Contains the Apple Push Notification service (APNs) configuration.
`apns.topic`*	`String`	The application bundle ID for APNs.
`apns.keyId`*	`String`	The identifier of the key used for APNs authentication.
`apns.teamId`*	`String`	The identifier of the team or developer account in the Apple Developer Program.
`apns.environment`*	`String`	Indicates the APNs environment, can be either `DEVELOPMENT` or `PRODUCTION`.
`fcm`	`Object`	Contains the Firebase Cloud Messaging (FCM) configuration.
`fcm.projectId`*	`String`	The identifier of the Firebase project for FCM.
`hms`	`Object`	Contains the Huawei Mobile Services (HMS) configuration.
`hms.projectId`*	`String`	The identifier of the HMS project.

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

post admin/applications/{id}/push/apns Update Apple Push Notification Service Configuration

Update Apple push notification service configuration for specified application.

Request

{
  "topic": "com.wultra.apns.topic",
  "keyId": "ABC123DEFG",
  "teamId": "DEF123GHIJ",
  "environment": "PRODUCTION",
  "privateKeyBase64": "QmFzZT...ZmlsZSAoKi5wOCk="
}

Attribute	Type	Description
`topic`*	String	The topic of the APNs request.
`keyId`*	String	The key ID for the APNs request.
`teamId`*	String	The team ID for the APNs request.
`environment`*	ApnsEnvironment	The environment for the APNs request, indicating either development or production.
`privateKeyBase64`*	String	Base64 encoded content of the private key file.

Path Params

Param	Type	Description
`id` *	`String`	ID of the application.

Response

{
  "id": "config123",
  "apns": {
    "topic": "com.example.MyApp",
    "keyId": "ABCD1234",
    "teamId": "EFGH5678",
    "environment": "DEVELOPMENT"
  },
  "fcm": {
    "projectId": "my-fcm-project-123"
  },
  "hms": {
    "projectId": "my-hms-project-456"
  }
}

Attribute	Type	Description
`id`*	`String`	The unique identifier of the push configuration.
`apns`	`Object`	Contains the Apple Push Notification service (APNs) configuration.
`apns.topic`*	`String`	The application bundle ID for APNs.
`apns.keyId`*	`String`	The identifier of the key used for APNs authentication.
`apns.teamId`*	`String`	The identifier of the team or developer account in the Apple Developer Program.
`apns.environment`*	`String`	Indicates the APNs environment, can be either `DEVELOPMENT` or `PRODUCTION`.
`fcm`	`Object`	Contains the Firebase Cloud Messaging (FCM) configuration.
`fcm.projectId`*	`String`	The identifier of the Firebase project for FCM.
`hms`	`Object`	Contains the Huawei Mobile Services (HMS) configuration.
`hms.projectId`*	`String`	The identifier of the HMS project.

Request validation failed.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Required String parameter 'topic' is not present"
  }
}

ERROR_REQUEST - Request did not pass a structural validation (mandatory field is null, invalid field type, etc.).

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

delete admin/applications/{id}/push/apns Delete Apple Push Notification Service Configuration

Delete Apple push notification configuration for specified application.

Request

Path Params

Param	Type	Description
`id` *	`String`	ID of the application.

Response

{
  "status": "OK"
}

Attribute	Type	Description
`status`*	`String`	Fixed value `OK`.

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

post admin/applications/{id}/push/fcm Update Firebase Cloud Messaging Configuration

Update Firebase cloud messaging configuration for specified application.

Request

{
  "projectId": "fcm-project-id",
  "privateKeyBase64": "QmFzZT...ZmlsZSAoKi5wOCk="
}

Attribute	Type	Description
`projectId`	String	The project id of the FCM request.
`privateKeyBase64`*	String	Base64 encoded content of the private key file.

Path Params

Param	Type	Description
`id` *	`String`	ID of the application.

Response

{
  "id": "config123",
  "apns": {
    "topic": "com.example.MyApp",
    "keyId": "ABCD1234",
    "teamId": "EFGH5678",
    "environment": "DEVELOPMENT"
  },
  "fcm": {
    "projectId": "my-fcm-project-123"
  },
  "hms": {
    "projectId": "my-hms-project-456"
  }
}

Attribute	Type	Description
`id`*	`String`	The unique identifier of the push configuration.
`apns`	`Object`	Contains the Apple Push Notification service (APNs) configuration.
`apns.topic`*	`String`	The application bundle ID for APNs.
`apns.keyId`*	`String`	The identifier of the key used for APNs authentication.
`apns.teamId`*	`String`	The identifier of the team or developer account in the Apple Developer Program.
`apns.environment`*	`String`	Indicates the APNs environment, can be either `DEVELOPMENT` or `PRODUCTION`.
`fcm`	`Object`	Contains the Firebase Cloud Messaging (FCM) configuration.
`fcm.projectId`*	`String`	The identifier of the Firebase project for FCM.
`hms`	`Object`	Contains the Huawei Mobile Services (HMS) configuration.
`hms.projectId`*	`String`	The identifier of the HMS project.

Request validation failed.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Required String parameter 'privateKeyBase64' is not present"
  }
}

ERROR_REQUEST - Request did not pass a structural validation (mandatory field is null, invalid field type, etc.).

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

delete admin/applications/{id}/push/fcm Delete Firebase Cloud Messaging Configuration

Delete Firebase cloud messaging configuration for specified application.

Request

Path Params

Param	Type	Description
`id` *	`String`	ID of the application.

Response

{
  "status": "OK"
}

Attribute	Type	Description
`status`*	`String`	Fixed value `OK`.

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

post admin/applications/{id}/push/hms Update Huawei Mobile Services Configuration

Update Huawei mobile services configuration for specified application.

Request

{
  "projectId": "hms-project-id",
  "appId": "my-app-id",
  "clientId": "my-client-id",
  "clientSecret": "my-client-secret"
}

Attribute	Type	Description
`projectId`*	String	The project ID for the HMS request. Example: “hms-project-id”.
`appId`*	String	Application ID for the HMS request.
`clientId`*	String	Huawei OAuth 2.0 client ID.
`clientSecret`*	String	Huawei OAuth 2.0 client secret.

Path Params

Param	Type	Description
`id` *	`String`	ID of the application.

Response

{
  "id": "config123",
  "apns": {
    "topic": "com.example.MyApp",
    "keyId": "ABCD1234",
    "teamId": "EFGH5678",
    "environment": "DEVELOPMENT"
  },
  "fcm": {
    "projectId": "my-fcm-project-123"
  },
  "hms": {
    "projectId": "my-hms-project-456"
  }
}

Attribute	Type	Description
`id`*	`String`	The unique identifier of the push configuration.
`apns`	`Object`	Contains the Apple Push Notification service (APNs) configuration.
`apns.topic`*	`String`	The application bundle ID for APNs.
`apns.keyId`*	`String`	The identifier of the key used for APNs authentication.
`apns.teamId`*	`String`	The identifier of the team or developer account in the Apple Developer Program.
`apns.environment`*	`String`	Indicates the APNs environment, can be either `DEVELOPMENT` or `PRODUCTION`.
`fcm`	`Object`	Contains the Firebase Cloud Messaging (FCM) configuration.
`fcm.projectId`*	`String`	The identifier of the Firebase project for FCM.
`hms`	`Object`	Contains the Huawei Mobile Services (HMS) configuration.
`hms.projectId`*	`String`	The identifier of the HMS project.

Request validation failed.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_REQUEST",
    "message": "Required String parameter 'projectId' is not present"
  }
}

ERROR_REQUEST - Request did not pass a structural validation (mandatory field is null, invalid field type, etc.).

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

delete admin/applications/{id}/push/hms Delete Huawei Mobile Service Configuration

Delete Huawei mobile service configuration for specified application.

Request

Path Params

Param	Type	Description
`id` *	`String`	ID of the application.

Response

{
  "status": "OK"
}

Attribute	Type	Description
`status`*	`String`	Fixed value `OK`.

Invalid username or password was provided while calling the service.

{
  "status": "ERROR",
  "responseObject": {
    "code": "HTTP_401",
    "message": "Unauthorized"
  }
}

Error occurred while calling the internal service. This can happen only as a result of misconfiguration. Check your deployment configuration for errors.

{
  "status": "ERROR",
  "responseObject": {
    "code": "ERROR_INTERNAL_API",
    "message": "Unable to call upstream service"
  }
}

Last updated on Apr 30, 2024 (09:55) View product