Home

GRACTWO API DOCS

V1 Endpoints

Path: gractwo.pl/api/v1/[endpoint]

enpoint	active?	description
/splash	✅	returns a random splashtext
/persons-of-note	✅	returns a list of data about persons of note
/index-images	✅	returns a list of gallery images for gractwo.pl
/quotes	❌	returns a list of quotes
/badges/{id}	✅	returns a list of badges per user

/splash

Response:

{
  "Id": string;               // ID
  "Splash": string;           // text content (eg: "decymalizacja człowieka")
}

/persons-of-note

Response:

[
  {
    "Id": string;             // ID
    "Name": string;           // user name
    "Desc": string;           // user description (short)
    "Img": string;            // direct url to an image
    "IsAdmin": bool;          // whether user is part of the admin team
    "DevBadge": bool;         // whether user should have a dev badge visible
    "AssignedUser": string;   // discord snowflake
  }, {...}
]

/index-images

Response:

[
  {
    "Id": string;             // ID
    "Title": string;          // title of a given image
    "Description": string;    // description of a given image
    "Date": string;           // datetime w/ timezone (eg: "2022-02-25T10:23:54Z")
    "Place": string;          // place of photo capture (eg: "Poznań")
    "Link": string;           // direct url to an image
  }, {...}
]

/badges/{id}

Response:

[
  {
    "Id": string;             // ID
    "Name": string;           // badge name
    "Desc": string;           // badge description (short)
    "Expl": string;           // badge explenation (long)
    "Img" : string;           // direct url to an image
    "Date": string;           // datetime w/ timezone (eg: "2022-02-25T10:23:54Z")
  }, {...}
]