Contributors Docs
HomeDiscord ServerDocs
  • ๐Ÿ‘‹Welcome
  • ๐ŸŒŽLocalization
    • Translator infos
    • Calendar Creation
    • Manage translations
  • ๐Ÿ’พUseful links
    • Droptop Links
  • ๐Ÿ–ผ๏ธMedia Kit
    • Droptop Media Kit
  • ๐Ÿ”—Droptop API
    • Endpoints
      • Changelog endpoints
      • Community Apps endpoints
      • Community Themes endpoints
      • Droptop endpoints
Powered by GitBook
On this page

Was this helpful?

  1. Droptop API
  2. Endpoints

Community Apps endpoints

About Droptop Community Apps

PreviousChangelog endpointsNextCommunity Themes endpoints

Last updated 1 year ago

Was this helpful?

๐Ÿ”—

Get Droptop Community Apps

get

Gets all the Community Apps of Droptop

Responses
200
Successful operation
application/json
get
GET /v1/community-apps HTTP/1.1
Host: api.droptopfour.com
Accept: */*
200

Successful operation

{
  "apps": [
    {
      "App": {
        "id": 1,
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "author": "text",
        "author_id": 1,
        "author_link": "example.com",
        "desc": "text",
        "version": "text",
        "official_link": "example.com",
        "direct_download_link": "example.com",
        "secondary_link": "example.com",
        "image_url": "example.com",
        "authorised_members": [
          1
        ],
        "hidden": 1,
        "changelog": [
          {
            "version": "text",
            "changenotes": "text"
          }
        ]
      }
    }
  ]
}

Get a specific Community App

get

Gets a specific Community App by id

Path parameters
idintegerRequired

A numeric id

Responses
200
Successful operation
application/json
400
Invalid id
application/json
404
App not found
application/json
get
GET /v1/community-apps/{id} HTTP/1.1
Host: api.droptopfour.com
Accept: */*
{
  "App": {
    "id": 1,
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "author": "text",
    "author_id": 1,
    "author_link": "example.com",
    "desc": "text",
    "version": "text",
    "official_link": "example.com",
    "direct_download_link": "example.com",
    "secondary_link": "example.com",
    "image_url": "example.com",
    "authorised_members": [
      1
    ],
    "hidden": 1,
    "changelog": [
      {
        "version": "text",
        "changenotes": "text"
      }
    ]
  }
}

Downloads a specific Community App by id

get

Downloads a specific Community App by id

Path parameters
idintegerRequired

A numeric id

Responses
303
Redirects to the direct download link of the Community App
400
Invalid id
application/json
404
App not found
application/json
get
GET /v1/community-apps/{id}/download HTTP/1.1
Host: api.droptopfour.com
Accept: */*

No content

Get a specific Community App by id

get

Gets a specific Community App by id

Responses
303
Redirects to the root request if the id parameter is empty/none
get
GET /v1/community-apps/id HTTP/1.1
Host: api.droptopfour.com
Accept: */*
303

Redirects to the root request if the id parameter is empty/none

No content

Get a specific Community App by id

get

Gets a specific Community App by id

Path parameters
idintegerRequired

A numeric id

Responses
200
Successful operation
application/json
400
Invalid id
application/json
404
App not found
application/json
get
GET /v1/community-apps/id/{id} HTTP/1.1
Host: api.droptopfour.com
Accept: */*
{
  "App": {
    "id": 1,
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "author": "text",
    "author_id": 1,
    "author_link": "example.com",
    "desc": "text",
    "version": "text",
    "official_link": "example.com",
    "direct_download_link": "example.com",
    "secondary_link": "example.com",
    "image_url": "example.com",
    "authorised_members": [
      1
    ],
    "hidden": 1,
    "changelog": [
      {
        "version": "text",
        "changenotes": "text"
      }
    ]
  }
}

Downloads a specific Community App by id

get

Downloads a specific Community App by id

Path parameters
idintegerRequired

A numeric id

Responses
303
Redirects to the direct download link of the Community App
400
Invalid id
application/json
404
App not found
application/json
get
GET /v1/community-apps/id/{id}/download HTTP/1.1
Host: api.droptopfour.com
Accept: */*

No content

Get a specific Community App by name

get

Gets a specific Community App by name

Responses
303
Redirects to the root request if the name parameter is empty/none
get
GET /v1/community-apps/name HTTP/1.1
Host: api.droptopfour.com
Accept: */*
303

Redirects to the root request if the name parameter is empty/none

No content

Get a specific Community App by name

get

Gets a specific Community App by name

Path parameters
namestringRequired

A string

Responses
200
Successful operation
application/json
404
App not found
application/json
get
GET /v1/community-apps/name/{name} HTTP/1.1
Host: api.droptopfour.com
Accept: */*
{
  "App": {
    "id": 1,
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "author": "text",
    "author_id": 1,
    "author_link": "example.com",
    "desc": "text",
    "version": "text",
    "official_link": "example.com",
    "direct_download_link": "example.com",
    "secondary_link": "example.com",
    "image_url": "example.com",
    "authorised_members": [
      1
    ],
    "hidden": 1,
    "changelog": [
      {
        "version": "text",
        "changenotes": "text"
      }
    ]
  }
}

Downloads a specific Community App by name

get

Downloads a specific Community App by name

Path parameters
namestringRequired

A string

Responses
303
Redirects to the direct download link of the Community App
404
App not found
application/json
get
GET /v1/community-apps/name/{name}/download HTTP/1.1
Host: api.droptopfour.com
Accept: */*

No content

Get a specific Community App by uuid

get

Gets a specific Community App by uuid

Responses
303
Redirects to the root request if the uuid parameter is empty/none
get
GET /v1/community-apps/uuid HTTP/1.1
Host: api.droptopfour.com
Accept: */*
303

Redirects to the root request if the uuid parameter is empty/none

No content

Get a specific Community App by uuid

get

Gets a specific Community App by uuid

Path parameters
uuidstring ยท uuidRequired

An uuid

Responses
200
Successful operation
application/json
404
App not found
application/json
get
GET /v1/community-apps/uuid/{uuid} HTTP/1.1
Host: api.droptopfour.com
Accept: */*
{
  "App": {
    "id": 1,
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "author": "text",
    "author_id": 1,
    "author_link": "example.com",
    "desc": "text",
    "version": "text",
    "official_link": "example.com",
    "direct_download_link": "example.com",
    "secondary_link": "example.com",
    "image_url": "example.com",
    "authorised_members": [
      1
    ],
    "hidden": 1,
    "changelog": [
      {
        "version": "text",
        "changenotes": "text"
      }
    ]
  }
}

Downloads a specific Community App by uuid

get

Downloads a specific Community App by uuid

Path parameters
uuidstring ยท uuidRequired

An uuid

Responses
303
Redirects to the direct download link of the Community App
404
App not found
application/json
get
GET /v1/community-apps/uuid/{uuid}/download HTTP/1.1
Host: api.droptopfour.com
Accept: */*

No content

Gets the number of downloads of a Community App

get

Gets the number of downloads of a Community App

Path parameters
uuidstring ยท uuidRequired

An uuid

Responses
200
Successful operation
application/json
404
The app with the specified uuid doesn't exist.
application/json
500
Error
application/json
get
GET /v1/downloads/community-apps/{uuid} HTTP/1.1
Host: api.droptopfour.com
Accept: */*
{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "downloads": 1
}

Adds one to the number of downloads of a Community App

post

Adds one to the number of downloads of a Community App

Authorizations
Path parameters
uuidstring ยท uuidRequired

An uuid

Responses
200
Successful operation
application/json
500
Error
application/json
post
POST /v1/downloads/community-apps/{uuid} HTTP/1.1
Host: api.droptopfour.com
Authentication: YOUR_API_KEY
Accept: */*
{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "downloads": 1
}
  • GETGet Droptop Community Apps
  • GETGet a specific Community App
  • GETDownloads a specific Community App by id
  • GETGet a specific Community App by id
  • GETGet a specific Community App by id
  • GETDownloads a specific Community App by id
  • GETGet a specific Community App by name
  • GETGet a specific Community App by name
  • GETDownloads a specific Community App by name
  • GETGet a specific Community App by uuid
  • GETGet a specific Community App by uuid
  • GETDownloads a specific Community App by uuid
  • GETGets the number of downloads of a Community App
  • POSTAdds one to the number of downloads of a Community App