Guest
Fully Implemented
| Property | Details |
|---|---|
| URL: | https://www2.swcombine.com/ws/v2.0/character[/[{uid}[/]]] |
| Method: | GET |
| Description: | Gets the representation of the specified character |
| Pattern Description: |
uid (Optional): name or UID of character. If none is provided, defaults to the character whose permission is being used to access this endpoint |
| Rate Limited: | Yes |
| Query String: | N/A |
| Parameters: | N/A |
| Requires Authentication: | Yes |
| Permissions: |
character_read: Read basic character information. If your profile is private, this will return unique ID, handle, and image. If your profile is not private, this will also return your race, gender, last login, description, and biography. |
| Returns: |
200 OK: Returns the representation for the user's character 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/
JSON{
"version": "2.0",
"timestamp": 1767225600,
"resource": "character",
"request": "/ws/v2.0/character/kira%20vane/",
"swcapi": {
"character": {
"uid": "1:1001",
"name": "Kira Vane",
"image": "https://www.swcombine.com/images/avatars/kira_vane.jpg",
"attributes": {
"isprivate": "false",
"isbasic": "false"
},
"lastlogin": {
"years": 27,
"days": 298,
"hours": 10,
"mins": 35,
"secs": 17,
"timestamp": "1767222000"
},
"gender": "Female",
"shortdescription": null,
"biography": "Corellian patrol pilot and fleet commander.",
"race": {
"attributes": {
"uid": "22:15",
"href": "https://www.swcombine.com/ws/v2.0/types/races/gungan/"
},
"value": "Gungan"
},
"force": {},
"faction": {
"attributes": {
"uid": "20:1001",
"href": "https://www.swcombine.com/ws/v2.0/faction/corellian%20engineering/"
},
"value": "Corellian Engineering"
},
"factions": [
{
"attributes": {
"uid": "20:1001",
"href": "https://www.swcombine.com/ws/v2.0/faction/corellian%20engineering/"
},
"value": "Corellian Engineering",
"primary": true
}
],
"skills": {},
"inventories": {},
"privileges": {},
"credits": {},
"creditlog": {},
"events": {}
}
}
}
XML<?xml version="1.0" encoding="UTF-8"?>
<swcapi xmlns="https://www.swcombine.com/ws/swcapi-ns/" version="2.0" timestamp="1767225600" resource="character" request="/ws/v2.0/character/kira%20vane/">
<character isprivate="false" isbasic="false">
<uid>1:1001</uid>
<name>Kira Vane</name>
<image>https://www.swcombine.com/images/avatars/kira_vane.jpg</image>
<lastlogin>
<years>27</years>
<days>298</days>
<hours>10</hours>
<mins>35</mins>
<secs>17</secs>
<timestamp>1767222000</timestamp>
</lastlogin>
<gender>Female</gender>
<shortdescription/>
<biography>Corellian patrol pilot and fleet commander.</biography>
<race uid="22:15" href="https://www.swcombine.com/ws/v2.0/types/races/gungan/">Gungan</race>
<force/>
<faction uid="20:1001" href="https://www.swcombine.com/ws/v2.0/faction/corellian%20engineering/">Corellian Engineering</faction>
<factions uid="20:1001" href="https://www.swcombine.com/ws/v2.0/faction/corellian%20engineering/">Corellian Engineering<primary>true</primary></factions>
<skills/>
<inventories/>
<privileges/>
<credits/>
<creditlog/>
<events/>
</character>
</swcapi>
force
GET /ws/v2.0/character/kira%20vane/
JSON{
"version": "2.0",
"timestamp": 1767225600,
"resource": "character",
"request": "/ws/v2.0/character/kira%20vane/",
"swcapi": {
"character": {
"uid": "1:1001",
"name": "Kira Vane",
"image": "https://www.swcombine.com/images/avatars/kira_vane.jpg",
"attributes": {
"isprivate": "false",
"isbasic": "false"
},
"lastlogin": {
"years": 27,
"days": 298,
"hours": 10,
"mins": 57,
"secs": 53,
"timestamp": "1767222000"
},
"gender": "Female",
"shortdescription": null,
"biography": "Corellian patrol pilot and fleet commander.",
"race": {
"attributes": {
"uid": "22:15",
"href": "https://www.swcombine.com/ws/v2.0/types/races/gungan/"
},
"value": "Gungan"
},
"force": {
"attributes": {
"isAware": "true"
},
"master": {
"attributes": {
"uid": "1:1004",
"href": "https://www.swcombine.com/ws/v2.0/character/dax%20orin/"
},
"value": "Dax Orin"
},
"student": {
"attributes": {
"uid": "1:1007",
"href": "https://www.swcombine.com/ws/v2.0/character/tomas%20reh/"
},
"value": "Tomas Reh"
},
"points": 52.5,
"pointsMax": 60,
"XP": 12345,
"XPlevel": 15,
"regenRate": 2,
"forceMeter": 0
},
"faction": {
"attributes": {
"uid": "20:1001",
"href": "https://www.swcombine.com/ws/v2.0/faction/corellian%20engineering/"
},
"value": "Corellian Engineering"
},
"factions": [
{
"attributes": {
"uid": "20:1001",
"href": "https://www.swcombine.com/ws/v2.0/faction/corellian%20engineering/"
},
"value": "Corellian Engineering",
"primary": true
}
],
"skills": {},
"inventories": {},
"privileges": {},
"credits": {},
"creditlog": {},
"events": {}
}
}
}
XML<?xml version="1.0" encoding="UTF-8"?>
<swcapi xmlns="https://www.swcombine.com/ws/swcapi-ns/" version="2.0" timestamp="1767225600" resource="character" request="/ws/v2.0/character/kira%20vane/">
<character isprivate="false" isbasic="false">
<uid>1:1001</uid>
<name>Kira Vane</name>
<image>https://www.swcombine.com/images/avatars/kira_vane.jpg</image>
<lastlogin>
<years>27</years>
<days>298</days>
<hours>10</hours>
<mins>57</mins>
<secs>53</secs>
<timestamp>1767222000</timestamp>
</lastlogin>
<gender>Female</gender>
<shortdescription/>
<biography>Corellian patrol pilot and fleet commander.</biography>
<race uid="22:15" href="https://www.swcombine.com/ws/v2.0/types/races/gungan/">Gungan</race>
<force isAware="true">
<master uid="1:1004" href="https://www.swcombine.com/ws/v2.0/character/dax%20orin/">Dax Orin</master>
<student uid="1:1007" href="https://www.swcombine.com/ws/v2.0/character/tomas%20reh/">Tomas Reh</student>
<points>52.5</points>
<pointsMax>60</pointsMax>
<XP>12345</XP>
<XPlevel>15</XPlevel>
<regenRate>2</regenRate>
<forceMeter>0</forceMeter>
</force>
<faction uid="20:1001" href="https://www.swcombine.com/ws/v2.0/faction/corellian%20engineering/">Corellian Engineering</faction>
<factions uid="20:1001" href="https://www.swcombine.com/ws/v2.0/faction/corellian%20engineering/">Corellian Engineering<primary>true</primary></factions>
<skills/>
<inventories/>
<privileges/>
<credits/>
<creditlog/>
<events/>
</character>
</swcapi>
freelance
GET /ws/v2.0/character/dax%20orin/
JSON{
"version": "2.0",
"timestamp": 1767225600,
"resource": "character",
"request": "/ws/v2.0/character/dax%20orin/",
"swcapi": {
"character": {
"uid": "1:1001",
"name": "Dax Orin",
"image": "https://www.swcombine.com/images/avatars/dax_orin.jpg",
"attributes": {
"isprivate": "false",
"isbasic": "false"
},
"lastlogin": {
"years": 27,
"days": 298,
"hours": 10,
"mins": 59,
"secs": 24,
"timestamp": "1767222000"
},
"gender": "Female",
"shortdescription": null,
"biography": "Independent freighter pilot working out of Corellia.",
"race": {
"attributes": {
"uid": "22:15",
"href": "https://www.swcombine.com/ws/v2.0/types/races/gungan/"
},
"value": "Gungan"
},
"force": {},
"faction": "Freelance",
"factions": [
"Freelance"
],
"skills": {},
"inventories": {},
"privileges": {},
"credits": {},
"creditlog": {},
"events": {}
}
}
}
XML<?xml version="1.0" encoding="UTF-8"?>
<swcapi xmlns="https://www.swcombine.com/ws/swcapi-ns/" version="2.0" timestamp="1767225600" resource="character" request="/ws/v2.0/character/dax%20orin/">
<character isprivate="false" isbasic="false">
<uid>1:1001</uid>
<name>Dax Orin</name>
<image>https://www.swcombine.com/images/avatars/dax_orin.jpg</image>
<lastlogin>
<years>27</years>
<days>298</days>
<hours>10</hours>
<mins>59</mins>
<secs>24</secs>
<timestamp>1767222000</timestamp>
</lastlogin>
<gender>Female</gender>
<shortdescription/>
<biography>Independent freighter pilot working out of Corellia.</biography>
<race uid="22:15" href="https://www.swcombine.com/ws/v2.0/types/races/gungan/">Gungan</race>
<force/>
<faction>Freelance</faction>
<factions>Freelance</factions>
<skills/>
<inventories/>
<privileges/>
<credits/>
<creditlog/>
<events/>
</character>
</swcapi>
|
