JSON API documentation static site https://docs.biotorrents.de
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

requests.md 3.1KB

Requests

Endpoints related to torrent requests.

Request

Request

ajax.php?action=request

&id= — request id (required)

&page= — page of the comments to display (default: last page)

Response

{
    "status": "success",
    "response": {
        "requestId": 2,
        "requestorId": 2,
        "requestorName": "me",
        "isBookmarked": false,
        "requestTax": 0.1,
        "timeAdded": "2020-04-23 02:02:37",
        "canEdit": true,
        "canVote": true,
        "minimumVote": 20971520,
        "voteCount": 1,
        "lastVote": "2020-11-15 06:51:56",
        "topContributors": [
            {
                "userId": 2,
                "userName": "me",
                "bounty": 15461882266
            }
        ],
        "totalBounty": 15461882266,
        "categoryId": 10,
        "categoryName": "Models",
        "title": "Markov State Model Database of Protein Folding Datasets",
        "year": 0,
        "image": "",
        "bbDescription": "BBcode",
        "description": "HTML",
        "artists": [
            {
                "id": 88,
                "name": "Thomas Lane"
            }
        ],
        "isFilled": false,
        "fillerId": 0,
        "fillerName": "",
        "torrentId": 0,
        "timeFilled": "",
        "tags": [
            "coding",
            "proteomics",
            "biochemistry",
            "data.science",
            "gene.expression"
        ],
        "comments": [],
        "commentPage": 1,
        "commentPages": 0
    }
}

Search

If no arguments are specified then the most recent requests are shown.

Request

ajax.php?action=requests

&page= — page to display (default: 1)

&search= — search term

&show_filled= — include filled requests in results true or false (default: false)

&tag= — tags to search by (comma separated)

&tags_type=0 for any, 1 for match all

filter_cat[], releases[], bitrates[], formats[], media[] — as used on requests.php

Response

{
    "status": "success",
    "response": {
        "currentPage": 1,
        "pages": 1,
        "results": [
            {
                "requestId": 3,
                "requestorId": 2,
                "requestorName": "me",
                "timeAdded": "2020-11-15 06:49:10",
                "lastVote": "2020-11-15 06:49:27",
                "voteCount": 1,
                "bounty": 7825312768,
                "categoryId": 8,
                "categoryName": "Images",
                "authors": [
                    {
                        "id": 148,
                        "name": "Oliver Batchelor"
                    }
                ],
                "title": "trees.tar.gz",
                "year": 0,
                "picture": "",
                "description": "BBcode",
                "isFilled": false,
                "fillerId": 0,
                "fillerName": "",
                "torrentId": 0,
                "timeFilled": ""
            },
            {
                "requestId": 2,
                "requestorId": 2,
                # etc.
            },
            # etc.
        ]
    }
}