feat: initial distroid documentation

This commit is contained in:
Jozef Steinhübl 2024-08-18 15:16:44 +02:00
parent 644dc989d4
commit 840c017c1d
No known key found for this signature in database
GPG key ID: E6BC90C91973B08F
4 changed files with 91 additions and 0 deletions

View file

@ -57,6 +57,19 @@ export const docs: Docs = {
}, },
], ],
}, },
{
text: "Distroid",
items: [
{
text: "Introduction",
link: "/docs/distroid/introduction",
},
{
text: "Current",
link: "/docs/distroid/current",
},
],
},
{ {
text: "Peddler's Pocket", text: "Peddler's Pocket",
items: [ items: [

54
docs/distroid/current.md Normal file
View file

@ -0,0 +1,54 @@
---
title: Current
description: How to get latest version of the discord's android app
---
## Get The Latest Android Version
This section explains how to retrieve the latest version of the Discord Android app using our API.
**Endpoint:** [https://distroid.xhyrom.dev/v1/current](https://distroid.xhyrom.dev/v1/current)
### Channel Type
### Channel Object
This object describes the current release channel for the Discord Android app.
**Properties:**
| Field Name | Type | Description |
| -------------- | ------------------------------------ | ------------------------------------------------------------------------ |
| version_code | integer | Internal version code used for downloading specific APKs. (e.g., 244205) |
| version_string | string | Human-readable version number of the release. (e.g., "244.5") |
| files \* | array of [file object](#file-object) | An array containing details about the available APK splits. |
\* Only included if you're using `with_file_metadata=true` query parameter.
### File Object
This object details a specific APK split for the Discord Android app.
**Properties:**
| Field Name | Type | Description |
| --------------- | ------- | -------------------------------------------------------- |
| compressed_size | integer | Size of the downloaded file in bytes (compressed). |
| size | integer | Size of the installed APK in bytes (uncompressed). |
| split_id | string | Unique identifier for the split. Empty for the base APK. |
### Fetching Latest Version Information
To retrieve the latest version details, send a GET request to the API endpoint:
**Optional Query Parameter:**
| Parameter Name | Type | Description |
| ------------------ | ------- | ------------------------------------------------------------ |
| with_file_metadata | boolean | Include detailed information about each available APK split. |
```
GET https://distroid.xhyrom.dev/v1/current
```
Returns map\[channel type - `stable`, `beta` or `alpha`\]\[[Channel Object](#channel-object)\]

View file

@ -0,0 +1,20 @@
---
title: Introduction
description: Introduction to the distroid api
---
# Introduction
This section of the documentation will cover the basics of the Distroid API, and how to use it.
Accessible on [https://distroid.xhyrom.dev](https://distroid.xhyrom.dev)
## What is Distroid API?
Distroid is an API that allows you to track and download the latest version of Discords Android app. It supports all three channels:
- stable
- beta
- alpha
> Did you know that distroid stands for **Discord Android Tracker**?

View file

@ -23,6 +23,10 @@
"source": "/docs/dux", "source": "/docs/dux",
"destination": "/docs/dux/introduction" "destination": "/docs/dux/introduction"
}, },
{
"source": "/docs/distroid",
"destination": "/docs/distroid/introduction"
},
{ {
"source": "/docs/peddlerspocket", "source": "/docs/peddlerspocket",
"destination": "/docs/peddlerspocket/introduction" "destination": "/docs/peddlerspocket/introduction"