Conditional update¶
Atomically sets the value to the given updated value if the current value == the expected value.
Method:¶
PUT
Endpoint URL¶
https://xxxx.backendless.app/api/counters/<counterName>/get/compareandset?
expected=<expected>&updatedvalue=<updated>
where:
| Argument | Description |
|---|---|
<counterName> |
Name of the counter to update. |
<expected> |
The expected value of the counter. If the current value equals the expected value, the counter is set to the "updated" value. |
<updated> |
The new value to assign to the counter if the current value equals the expected value. |
Request headers¶
user-token: optional value obtained as a result of the login operation.
where:
| Argument | Description |
|---|---|
user-token |
Optional header. Contains a value returned by Backendless in a preceding user Login API call. The operation will be executed with the security policy associated currently logged in user. This means all permissions associated with the user and the roles assigned to the user will be enforced by Backendless. |
Request body¶
N/A
Response body¶
Boolean value - true if the counter has been updated, false otherwise
Example¶
Make sure to replace xxxx in the domain name in the sample request below to the one assigned to your application.
curl -X PUT \
https://xxxx.backendless.app/api/counters/mycounter/get/compareandset?expected=1000&updatedvalue=2000