DiscordRep API V3
The official documentation of DiscordRep's API
To get a token, please join our discord, use the command-api genin #bot-commands
​
getReputation
get
https://discordrep.com/api/v3/rep/:id
Request
Response
Request
Path Parameters
id
required
string
User ID to look up
Headers
Authorization
required
string
API key
Response
200: OK
{"id": "538855659714641960","upvotes": 23,"downvotes": 0,"xp": 19987,"rank": "Diamond","staff": true,}
401: Unauthorized
{"code": 401,"error": "unauthorized"}
429: Too Many Requests
{"code": 429,"error": "Too Many Requests"}
getInfractions
get
https://discordrep.com/api/v3/infractions/:id
Request
Response
Request
Path Parameters
id
required
string
User ID to lookup
Headers
Authorization
required
string
API key
Response
200: OK
user successfully fetched.
{"id": "user_id","type": "WARN", // or "BAN""reason": "Sending IP logger in DM","moderator": "256974278283624451","date": 1587074377175}/* CLEAN example */{"id": "user_id","type": "CLEAN"}
401: Unauthorized
Invalid API key
{"code": 401,"error": "unauthorized"}
429: Too Many Requests
{"code": 429,"error": "Too Many Requests"}
Everything below requires a trust token
​
How do you get a trust token? Short answer. You simply don't get a trust token. This is only given to trusted users, such as staff or known developers.
postVote
post
https://discordrep.com/api/v3/vote/:action/:voter_id/:voted_id
THIS REQUIRES A SPECIAL TRUST TOKEN
Request
Response
Request
Path Parameters
action
required
string
Only:
"up" for upvote
"down" for downvote
voter_id
required
string
User ID of user voting
voted_id
required
string
User ID of user being voted
Headers
Authorization
required
string
API key
Response
200: OK
vote registered
{"code": 200, "message": "success"}
400: Bad Request
Invalid action parameter
{"code": 400, "error": "Bad Request"}
401: Unauthorized
Invalid TRUST API key
{"code": 401,"error": "unauthorized"}
403: Forbidden
voter_id is banned and can't vote
{"code": 403, "error": "the voter is banned, and cant vote"}
404: Not Found
invalid voted_id
{"code": 404, "error": "user not found"}
409: Conflict
vote with same action already exists
{"code": 409, "error": "already downvoted"}{"code": 409, "error": "already upvoted"}{"code": 409, "error":"cannot vote for yourself" }
429: Too Many Requests
ratelimit
{"code": 429, "error":"Too Many Requests, slow down!" }
postComment
post
https://discordrep.com/api/v3/comment/:commenter_id/:commentee_id
THIS REQUIRES A SPECIAL TRUST TOKEN
Request
Response
Request
Path Parameters
commenter_id
required
string
User ID of user commenting
commentee_id
required
string
User ID of user being commented
Headers
Authorization
required
string
API Key
Body Parameters
comment
required
string
The comment
Response
200: OK
{"code": 200, "message": "success"}
400: Bad Request
if comment is too short or invalid
{"code": 400, "error": "comment too short"}
401: Unauthorized
Invalid TRUST API key
{"code": 401,"error": "unauthorized"}
403: Forbidden
the commenter is banned
{"code": 403, "error": "the commenter is banned, and cannot comment"}
404: Not Found
a user is not found
{"code": 404, "error": "user not found"}
409: Conflict
cannot comment yourself
{"code":409, "error":"cannot comment for yourself" }
429: Too Many Requests
ratelimit
{"code": 429, "error":"Too Many Requests, slow down!" }
postBio
post
https://discordrep.com/api/v3/bio/:id
THIS REQUIRES A SPECIAL TRUST TOKEN
Request
Response
Request
Path Parameters
id
required
string
User ID
Headers
Authorization
required
string
API Key
Body Parameters
bio
required
string
The bio
Response
200: OK
{"code": 200,"message": "success"}
400: Bad Request
Bio too short or invalid
{"code": 400,"error": "bad request"}
401: Unauthorized
Invalid TRUST API key
{"code": 401,"error": "unauthorized"}
404: Not Found
{"code": 404, "error": "user not logged in"}
429: Too Many Requests
{"code": 429, "error":"Too Many Requests, slow down!" }
Last updated 5 months ago