member data
API Support | Available since | Last updated | Output |
---|---|---|---|
5.9900 | 5.9900 | xml, json, * |
Description
The behaviour and URL of this service is not consistent with other services, please read the description carefully.
Deletes personal member data and can be accessed through the following URL:
/ps/api/member-data/{memberid}/data/{name}
Or
/ps/servlet/members/{memberid}/data/{name}
Where name
can contain lowercase letters, numbers, hyphen or underscore and can have an optional alphanumeric extension after a dot which is ignored, for example public-picture.png
.
Detecting collisions
Since member data are requested and/or updated frequently, this service relies on precondition header fields to detect and prevent collisions. If the preconditions fail, this service returns an HTTP 412 Precondition Failed error, otherwise the deletion proceeds.
The recommended approach is to send the entity tag returned by the GET request or PUT request in the If-Match
HTTP header. This service supports If-Match
, If-None-Match
, andIf-Unmodified-since
HTTP headers to check whether the update is possible.
Parameters
No parameters required.
We recommend that you always use entity tags when making a request to this service using If-Match HTTP
header.
Permission
Only the member themselves or an administrator can use this service.
Response
If the deletion is successful, this service returns an empty response with a 204 No content HTTP status.
Error handling
Code | Cause / Description |
---|---|
0x102D | No member data found |
0x1031 | Member data has been modified since update attempt |