Firearm Endpoints

The API has been deprecated and is no longer in use.

Firearm Endpoints

Raw list of firearm endpoints:

• GET /firearm/info

• GET /firearm/list

• POST /firearm/create

• PATCH /firearm/edit

• DELETE /firearm/delete

List of firearm endpoint methods

Firearm Array Structure

If you see the empty "firearm" array or firearm: [] This is simply just the placeholder for the firearm object structure, Which looks like this in all major requests: (Inside the array)

{            
   id: "ID",
   userID: "USER_ID",
   userName: "USER_NAME",
   civilianID: "CIV_ID",
   civilianName: "CIV_NAME",
   stolen: "STOLEN",
   serialNumber: "SERIAL_NUMBER",
   model: "MODEL",
   timestamp: "TIMESTAMP"
}

Firearm Information (Search)

GET https://roleplaybot.xyz/api/firearm/info

Searches for a registered firearm, Returns information if it exists.

Headers

Name	Type	Description
Authorization*	API_KEY	API Authorization Key
Guild*	GUILD_ID	Discord Guild ID

Request Body

Name	Type	Description
serialNumber*	SERIAL_NUMBER	Firearm Serial Number (String) (# ID)

200: OK Firearm Found

Firearm found and information displayed

{
    found: true,
    guildID: "GUILD_ID",
    firearm: []
}

400: Bad Request One or more fields are invalid

403: Forbidden Forbidden Guild Access

404: Not Found Firearm not found

List Firearms

GET https://roleplaybot.xyz/api/firearm/list

Provides every registered vehicle inside the guild

Headers

Name	Type	Description
Authorization*	API_KEY	API Authorization Key
Guild*	GUILD_ID	Discord Guild ID

403: Forbidden Forbidden Guild Access

Accessing a guild that is not authorized apart of your API key

{
    "error": "403 Forbidden",
    "details": "Unauthorised guild access (20058)"
}

200: OK Firearms Found

404: Not Found No Firearms Found

Create Firearm

POST https://roleplaybot.xyz/api/firearm/create

Registers a firearm to a civilian character

Headers

Name	Type	Description
Authorization*	API_KEY	API Authorization Key
Guild*	GUILD_ID	Discord Guild ID

Request Body

Name	Type	Description
name*	CIV_NAME	Civilian Name (String)
model*	MODEL	Firearm Model (String)
color*	COLOR	Firearm Color (String)

403: Forbidden Forbidden Guild Access

Accessing a guild that is not authorized apart of your API key

{
    "error": "403 Forbidden",
    "details": "Unauthorised guild access (20058)"
}

400: Bad Request One or more fields are invalid

201: Created Registered Firearm

500: Internal Server Error Unable to register firearm

Edit Firearm

PATCH https://roleplaybot.xyz/api/firearm/edit

Edits a firearm with the specified field and value Valid Fields: - color (Value: String) - stole (Value: Boolean)

Headers

Name	Type	Description
Authorization*	API_KEY	API Authorization Key
Guild*	GUILD_ID	Discord Guild ID

Request Body

Name	Type	Description
name*	CIV_NAME	Civilian Name (String)
field*	FIELD	Field to edit (Must be listed in valid fields)
value*	VALUE	Value to set (Must match allocated field)

403: Forbidden Forbidden Guild Access

Accessing a guild that is not authorized apart of your API key

{
    "error": "403 Forbidden",
    "details": "Unauthorised guild access (20058)"
}

400: Bad Request One or more fields are invalid

201: Created Firearm Edited

500: Internal Server Error Unable to edit firearm

Delete Vehicle

DELETE https://roleplaybot.xyz/api/firearm/delete

Deletes a firearm using the serial number

Headers

Name	Type	Description
Authorization*	API_KEY	API Authorization Key
Guild*	GUILD_ID	Discord Guild ID

Request Body

Name	Type	Description
serialNumber*	SERIAL_NUMBER	Firearm Serial Number (String) (# ID)

200: OK Firearm Deleted

Successfully deleted firearm

{
    guildID: "GUILD_ID",
    id: "VEHICLE_ID",
    success: 'Deleted registered firearm'
}

400: Bad Request One or more fields are invalid

500: Internal Server Error Unable to delete firearm