Etro API
If you use Discord login, you will need to use Token authentication below. You can get the token by opening DevTools (default F12) and refreshing Etro, then examine any network request's authorization header.
auth
discord > login > create
Discord OAuth2 Login
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
access_token | |
code | |
id_token |
login > create
Check the credentials and return the REST Token if the credentials are valid and authenticated. Calls Django Auth login method to register User ID in Django session framework Accept the following POST parameters: username, password Return the REST Framework Token Object's key.
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
username | |
email | |
password required |
logout > list
Calls Django logout method and delete the Token object assigned to the current User object. Accepts/Returns nothing.
logout > create
Calls Django logout method and delete the Token object assigned to the current User object. Accepts/Returns nothing.
password > change > create
Calls Django Auth SetPasswordForm save method. Accepts the following POST parameters: new_password1, new_password2 Returns the success/fail message.
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
new_password1 required | |
new_password2 required |
password > reset > create
Calls Django Auth PasswordResetForm save method. Accepts the following POST parameters: email Returns the success/fail message.
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
email required |
password > reset > confirm > create
Password reset e-mail link is confirmed, therefore this resets the user's password. Accepts the following POST parameters: token, uid, new_password1, new_password2 Returns the success/fail message.
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
new_password1 required | |
new_password2 required | |
uid required | |
token required |
password > reset > confirm > read
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
uidb64 required | |
token required |
registration > create
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
username required | |
email required | |
password1 required | |
password2 required |
registration > verify-email > create
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
key required |
token > refresh > create
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
refresh | WIll override cookie. |
token > verify > create
Takes a token and indicates if it is valid. This view provides no information about a token's fitness for a particular use.
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
token required |
user > read
Reads and updates UserModel fields Accepts GET, PUT, PATCH methods. Default accepted fields: username, first_name, last_name Default display fields: pk, username, email, first_name, last_name Read-only fields: pk, email Returns UserModel fields.
user > update
Reads and updates UserModel fields Accepts GET, PUT, PATCH methods. Default accepted fields: username, first_name, last_name Default display fields: pk, username, email, first_name, last_name Read-only fields: pk, email Returns UserModel fields.
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
defaultClan | |
defaultItemLevelRange | |
defaultPartyBonus | |
username required | Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only. |
user > partial_update
Reads and updates UserModel fields Accepts GET, PUT, PATCH methods. Default accepted fields: username, first_name, last_name Default display fields: pk, username, email, first_name, last_name Read-only fields: pk, email Returns UserModel fields.
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
defaultClan | |
defaultItemLevelRange | |
defaultPartyBonus | |
username | Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only. |
clans
read
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique value identifying this clan. |
equipment
list
List + Get endpoints for Equipment model
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
AST | |
BLM | |
BLU | |
BRD | |
DNC | |
DRG | |
DRK | |
GNB | |
MCH | |
MNK | |
NIN | |
PCT | |
PLD | |
RDM | |
RPR | |
SAM | |
SCH | |
SGE | |
SMN | |
VPR | |
WAR | |
WHM | |
ALC | |
ARM | |
BSM | |
BTN | |
CRP | |
CUL | |
FSH | |
GSM | |
LTW | |
MIN | |
WVR | |
weapon | |
head | |
body | |
hands | |
legs | |
feet | |
offHand | |
ears | |
neck | |
wrists | |
fingerL | |
fingerR | |
canCustomize | |
minItemLevel | |
maxItemLevel | |
minLevel | |
maxLevel | |
jobAbbrev | |
itemLevelSync |
read
List + Get endpoints for Equipment model
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique value identifying this equipment. |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
AST | |
BLM | |
BLU | |
BRD | |
DNC | |
DRG | |
DRK | |
GNB | |
MCH | |
MNK | |
NIN | |
PCT | |
PLD | |
RDM | |
RPR | |
SAM | |
SCH | |
SGE | |
SMN | |
VPR | |
WAR | |
WHM | |
ALC | |
ARM | |
BSM | |
BTN | |
CRP | |
CUL | |
FSH | |
GSM | |
LTW | |
MIN | |
WVR | |
weapon | |
head | |
body | |
hands | |
legs | |
feet | |
offHand | |
ears | |
neck | |
wrists | |
fingerL | |
fingerR | |
canCustomize | |
minItemLevel | |
maxItemLevel | |
minLevel | |
maxLevel | |
jobAbbrev | |
itemLevelSync |
food
list
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
minItemLevel | |
maxItemLevel |
read
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique value identifying this food. |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
minItemLevel | |
maxItemLevel |
gearsets
create
Create a new gearset.
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
name required | |
minItemLevel required | |
maxItemLevel required | |
minMateriaTier | |
maxMateriaTier | |
materia | |
totalParams | |
buffs | |
relics | |
patch | |
notes | |
level | |
itemLevelSync | |
partyBonus | |
job required | |
clan | |
weapon | |
head | |
body | |
hands | |
legs | |
feet | |
offHand | |
ears | |
neck | |
wrists | |
fingerL | |
fingerR | |
food | |
medicine |
read
Return a specific gearset.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required |
update
Update a specific gearset.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required |
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
name required | |
minItemLevel required | |
maxItemLevel required | |
minMateriaTier | |
maxMateriaTier | |
materia | |
totalParams | |
buffs | |
relics | |
patch | |
notes | |
level | |
itemLevelSync | |
partyBonus | |
job required | |
clan | |
weapon | |
head | |
body | |
hands | |
legs | |
feet | |
offHand | |
ears | |
neck | |
wrists | |
fingerL | |
fingerR | |
food | |
medicine |
partial_update
Partial update a specific gearset. WARNING: Untested.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required |
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
name | |
minItemLevel | |
maxItemLevel | |
minMateriaTier | |
maxMateriaTier | |
materia | |
totalParams | |
buffs | |
relics | |
patch | |
notes | |
level | |
itemLevelSync | |
partyBonus | |
job | |
clan | |
weapon | |
head | |
body | |
hands | |
legs | |
feet | |
offHand | |
ears | |
neck | |
wrists | |
fingerL | |
fingerR | |
food | |
medicine |
delete
Delete a specific gearset.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required |
clone
Clone a specific gearset.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required |
import
ariyala
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
name required | |
ariyalaID required |
lodestone
Import a gearset from a Lodestone character via XIVAPI. Either lodestoneID or gearset is required.
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
name required | |
lodestoneID | |
gearset |
xivgear
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
xivgearURL required |
jobs
read
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique value identifying this job. |
materia
read
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique value identifying this materia. |
medicine
list
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
minItemLevel | |
maxItemLevel |
read
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required | A unique value identifying this food. |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
minItemLevel | |
maxItemLevel |
relic
list
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
baseItemId__itemLevel | |
itemLevelSync |
create
Create a new piece of relic.
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
itemLevelSync | |
name required | |
param0Value | |
param1Value | |
param2Value | |
param3Value | |
param4Value | |
param5Value | |
baseItemId required | |
param0 | |
param1 | |
param2 | |
param3 | |
param4 | |
param5 |
read
Return a specific relic.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
baseItemId__itemLevel | |
itemLevelSync |
update
Update a specific relic.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
baseItemId__itemLevel | |
itemLevelSync |
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
itemLevelSync | |
name required | |
param0Value | |
param1Value | |
param2Value | |
param3Value | |
param4Value | |
param5Value | |
baseItemId required | |
param0 | |
param1 | |
param2 | |
param3 | |
param4 | |
param5 |
partial_update
Partial update a specific relic. WARNING: Untested.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
baseItemId__itemLevel | |
itemLevelSync |
Request Body
The request body should be a "application/json"
encoded object, containing the following items.
Parameter | Description |
---|---|
itemLevelSync | |
name | |
param0Value | |
param1Value | |
param2Value | |
param3Value | |
param4Value | |
param5Value | |
baseItemId | |
param0 | |
param1 | |
param2 | |
param3 | |
param4 | |
param5 |
delete
Delete a specific relic.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required |
Query Parameters
The following parameters should be included as part of a URL query string.
Parameter | Description |
---|---|
baseItemId__itemLevel | |
itemLevelSync |
clone
Clone a specific relic.
Path Parameters
The following parameters should be included in the URL path.
Parameter | Description |
---|---|
id required |