Deregister Mobile Client
/mobile/platform/devices/deregister
Deregisters a mobile client instance that no longer needs to receive notifications.
Permissions
You can access this operation as a social user, a virtual user, an anonymous user, or a mobile user. If you access this operation as a mobile user, then you must be a member of the realm that's associated with the mobile backend.
Request
- application/json
object
A mobile client instance.
-
mobileClient:
object mobileClient
-
notificationProvider(optional):
Allowed Values:
[ "APNS", "GCM", "FCM", "WNS", "SYNIVERSE" ]
The notification service the notification token is for. If this isn't provided, then the service assumesAPNS
for iOS,GCM
for Android, andWNS
for Windows. -
notificationToken:
string
Token needed by the push notification service for sending calls. This token uniquely identifies the specific instance of a mobile application associated with a specific device, and is used to ensure that notifications are sent to the correct recipient. Encode in hexadecimal if necessary.
object
-
id(optional):
string
Identify the mobile client. This is the application ID that you registered the application with in the mobile backend's Settings tab, such as `com.mycompany.appname`.
-
platform(optional):
Allowed Values:
[ "IOS", "ANDROID", "WINDOWS", "WEB" ]
Indicates whether the mobile client is running on iOS, Android, Windows or Web.
{
"mobileClient":{
"id":"com.oracle.myapplication",
"platform":"IOS"
},
"notificationToken":"03767dea-29ac-4440-b4f6-75a755845ade",
"notificationProvider":"APNS"
}
Response
- application/json
200 Response
400 Response
The operation can't be performed due to one of the following reasons:
- The mobile client ID isn't valid or isn't registered with the mobile backend.
- The notification provider isn't valid.
- You used BASIC authorization and the
Oracle-Mobile-Backend-ID
HTTP request header wasn't specified. - The body isn't a correctly formed JSON object or a required property is missing.
-
Content-Type: string
The media type of error message, which is
application/json
.
object
Error
-
detail:
string
Message that provides the error details.
-
o:ecid:
string
Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.
-
o:errorCode:
string
Mobile Cloud Service error code.
-
o:errorDetails(optional):
array o:errorDetails
Minimum Number of Items:
0
List of the issues that cause the error. Included when the error is caused by multiple issues. -
o:errorPath:
string
The relative point in the API path where the error occurred.
-
status:
integer
HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
array
0
-
Array of:
object Error Detail
Title:
Error Detail
object
Error Detail
-
instance:
string
The URI to the link that provides more detailed information about the error.
-
o:errorCode:
string
Mobile Cloud Service error code.
-
o:errorPath:
string
The relative point in the API path where the error occurred.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
{
"title":"Cannot call API",
"detail":"Unable to use API virtualization for calls without any Mobile Backend context.",
"status":400,
"o:errorCode":"MOBILE-58060",
"o:errorPath":"/mobile/platform/devices/deregister",
"o:ecid":"cde040005cd5983e:4372d958:14c8c4c2d6c:-8000-000000000032b9d5, 0",
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1"
}
401 Response
User is unauthorized to perform this call. This can happen due to one of the following reasons:
- The user doesn't exist.
- The password is incorrect.
- The credentials weren't encoded using the RFC2045-MIME variant of Base64.
- The
Authorization
HTTP request header wasn't specified.
-
Content-Type: string
The media type of the error message, which is
application/json
.
object
Error
-
detail:
string
Message that provides the error details.
-
o:ecid:
string
Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.
-
o:errorCode:
string
Mobile Cloud Service error code.
-
o:errorDetails(optional):
array o:errorDetails
Minimum Number of Items:
0
List of the issues that cause the error. Included when the error is caused by multiple issues. -
o:errorPath:
string
The relative point in the API path where the error occurred.
-
status:
integer
HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
array
0
-
Array of:
object Error Detail
Title:
Error Detail
object
Error Detail
-
instance:
string
The URI to the link that provides more detailed information about the error.
-
o:errorCode:
string
Mobile Cloud Service error code.
-
o:errorPath:
string
The relative point in the API path where the error occurred.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
{
"title":"Unauthorized",
"detail":"401 - Unauthorized",
"status":401,
"o:errorCode":"MOBILE-15209",
"o:errorPath":"/mobile/platform/devices/deregister",
"o:ecid":"cde040005cd5983e:4372d958:14c8c4c2d6c:-8000-000000000033b51c, 0",
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1"
}
404 Response
The operation cannot be performed due to one of the following reasons:
- The active mobile backend cannot be found.
- The mobile client ID cannot be found. Either it does not exist or it was deregistered.
-
Content-Type: string
The media type of the error message, which is
application/json
.
object
Error
-
detail:
string
Message that provides the error details.
-
o:ecid:
string
Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.
-
o:errorCode:
string
Mobile Cloud Service error code.
-
o:errorDetails(optional):
array o:errorDetails
Minimum Number of Items:
0
List of the issues that cause the error. Included when the error is caused by multiple issues. -
o:errorPath:
string
The relative point in the API path where the error occurred.
-
status:
integer
HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
array
0
-
Array of:
object Error Detail
Title:
Error Detail
object
Error Detail
-
instance:
string
The URI to the link that provides more detailed information about the error.
-
o:errorCode:
string
Mobile Cloud Service error code.
-
o:errorPath:
string
The relative point in the API path where the error occurred.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
{
"title":"Mobile Backend not found",
"detail":"We cannot find the active mobile backend for the given clientId fd4cc0cf-0a72-4ed6-aab6-295133b8904e and BASIC schema. Specify a valid clientId and try again.",
"status":404,
"o:errorCode":"MOBILE-58026",
"o:errorPath":"/mobile/platform/devices/deregister",
"o:ecid":"cde040005cd5983e:4372d958:14c8c4c2d6c:-8000-000000000033b529, 0",
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1"
}
415 Response
The MIME media type isn't supported or was not specified. Only application/json
is supported.
-
Content-Type: string
The media type of error message, which is
application/json
.
object
Error
-
detail:
string
Message that provides the error details.
-
o:ecid:
string
Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.
-
o:errorCode:
string
Mobile Cloud Service error code.
-
o:errorDetails(optional):
array o:errorDetails
Minimum Number of Items:
0
List of the issues that cause the error. Included when the error is caused by multiple issues. -
o:errorPath:
string
The relative point in the API path where the error occurred.
-
status:
integer
HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
array
0
-
Array of:
object Error Detail
Title:
Error Detail
object
Error Detail
-
instance:
string
The URI to the link that provides more detailed information about the error.
-
o:errorCode:
string
Mobile Cloud Service error code.
-
o:errorPath:
string
The relative point in the API path where the error occurred.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
{
"title":"Unsupported media type",
"detail":"The MIME media type isn't supported. Only application/json is supported. Specify a media type that is supported.",
"status":415,
"o:errorCode":"MOBILE-92515",
"o:errorPath":"/mobile/platform/devices/deregister",
"o:ecid":"cde040005cd5983e:4372d958:14c8c4c2d6c:-8000-000000000033ba73, 0",
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1"
}
Examples
The following example shows how to deregister an instance of a mobile app on a mobile device by submitting a POST request on the REST resource using cURL.
curl -i \
-X POST \
-u mobile.user@example.com:password \
-d @deregister.json \
-H "Content-Type: application/json; charset=utf-8" \
-H "Oracle-Mobile-Backend-ID: ABCD9278-091f-41aa-9cb2-184bd0586fce" \
https://fif.cloud.oracle.com/mobile/platform/devices/deregister
Example of Request Body
Here's an example of the request body. The values match the values that were used when the mobile app was registered with the mobile backend.
{
"notificationToken": "b14d6dfbd9d56e09f098",
"notificationProvider": "APNS",
"mobileClient": {
"id": "my.app.id",
"platform": "IOS"
}
}
Example of Response Header
Here's an example of the response header:
200 OK
Date: Mon, 30 Apr 2018 21:18:02 GMT
Content-Length: 0