1972 active members
  189 are Online

Year

27

Day

307

Time

19:12:51

Guest
Login

Web Services v2.0 Hub » Character Resources » Character/Privilege

Fully Implemented

Fully Implemented

Property Details
URL: https://www2.swcombine.com/ws/v2.0/character/{uid}/privileges/{privilegegroup}/{privilege}[/]
Method: GET
Description: Gets a representation of the specified character's privilege
Pattern Description: uid (Mandatory): name or UID of character
privilegegroup (Mandatory): name of privilege group
privilege (Mandatory): name of privilege group
Rate Limited: Yes
Query String: faction_id (number): Optional, the id of the faction you want to view the privileges for. Defaults to the token owner's own current primary faction (required if the token owner is a freelancer)
Parameters: N/A
Requires Authentication: Yes
Permissions: character_privileges: Read character privileges
Returns: 200 OK: Returns the representation of the specified character's privilege
400 Bad Request: One or more of the provided parameters was invalid
401 Unauthorized: The client does not have the required permission to access this resource
404 Not Found: The specified character does not exist or you do not have authorisation to access character information
Examples:
GET /ws/v2.0/character/kira%20vane/privileges/members/set_infofields/
JSON
{
    "version": "2.0",
    "timestamp": 1767225600,
    "resource": "character_privilege",
    "request": "/ws/v2.0/character/kira%20vane/privileges/members/set_infofields/",
    "swcapi": {
        "privilege": {
            "attributes": {
                "uid": "set_infofields"
            },
            "value": "true"
        }
    }
}
XML
<?xml version="1.0" encoding="UTF-8"?>
<swcapi xmlns="https://www.swcombine.com/ws/swcapi-ns/" version="2.0" timestamp="1767225600" resource="character_privilege" request="/ws/v2.0/character/kira%20vane/privileges/members/set_infofields/">
  <privilege uid="set_infofields">true</privilege>
</swcapi>


Property Details
URL: https://www2.swcombine.com/ws/v2.0/character/{uid}/privileges/{privilegegroup}/{privilege}[/]
Method: POST
Description: Grants the specified user the specified priv
Pattern Description: uid (Mandatory): name or UID of character
privilegegroup (Mandatory): name of privilege group
privilege (Mandatory): name of privilege group
Rate Limited: Yes
Query String: faction_id (number): Optional, the id of the faction the privilege is granted or revoked in. Defaults to the token owner's own current primary faction (required if the token owner is a freelancer)
Parameters: revoke (string, optional): Flags that the priv is supposed to be revoked instead of granted when any non-empty value is passed
Requires Authentication: Yes
Permissions: character_privileges: Read character privileges
Returns: 200 OK: Assigning the priv failed for the provided reason
201 CREATED: Assigning the priv succeeded
400 Bad Request: One or more of the provided parameters was invalid
401 Unauthorized: There were insufficient permissions to complete this action
404 Not Found: The specified character does not exist or you do not have authorization
Examples:
POST /ws/v2.0/character/dax%20orin/privileges/members/set_infofields/
JSON
{
    "version": "2.0",
    "timestamp": 1767225600,
    "resource": "character_privilege_result",
    "request": "/ws/v2.0/character/dax%20orin/privileges/members/set_infofields/",
    "swcapi": {
        "failure": [
            "Cannot change privileges: Requires powered HQ to change privileges."
        ]
    }
}
XML
<?xml version="1.0" encoding="UTF-8"?>
<swcapi xmlns="https://www.swcombine.com/ws/swcapi-ns/" version="2.0" timestamp="1767225600" resource="character_privilege_result" request="/ws/v2.0/character/dax%20orin/privileges/members/set_infofields/">
  <failure>Cannot change privileges: Requires powered HQ to change privileges.</failure>
</swcapi>