contentdb/app/flatpages/help/api.md
2020-07-18 01:48:37 +01:00

2.8 KiB

title: API

Authentication

Not all endpoints require authentication. Authentication is done using Bearer tokens:

Authorization: Bearer YOURTOKEN

You can use the /api/whoami to check authentication.

Tokens can be attained by visiting Profile > "API Tokens".

Endpoints

Misc

  • GET /api/whoami/ - Json dictionary with the following keys:
    • is_authenticated - True on successful API authentication
    • username - Username of the user authenticated as, null otherwise.
    • 4xx status codes will be thrown on unsupported authentication type, invalid access token, or other errors.

Packages

  • GET /api/packages/ - See Package Queries
  • GET /api/scores/ - See Package Queries
  • GET /api/packages/<username>/<name>/
  • GET /api/packages/<username>/<name>/dependencies/
    • If query argument only_hard is present, only hard deps will be returned.

Releases

  • GET /api/packages/<username>/<name>/releases/
  • POST /api/packages/<username>/<name>/releases/new/
    • Requires authentication.
    • title: human-readable name of the release.
    • method: Release-creation method, only git is supported.
    • If git release-creation method:
      • ref - git reference, eg: master.
    • You can set min and max Minetest Versions using the content's .conf file.

Topics

  • GET /api/topics/ - Supports Package Queries, and the following two options:
    • show_added - Show topics which exist as packages, default true.
    • show_discarded - Show topics which have been marked as outdated, default false.

Minetest

  • GET /api/minetest_versions/

Package Queries

Example:

/api/packages/?type=mod&type=game&q=mobs+fun&hide=nonfree&hide=gore

Supported query parameters:

  • type - Package types (mod, game, txp).
  • q - Query string.
  • author - Filter by author.
  • tag - Filter by tags.
  • random - When present, enable random ordering and ignore sort.
  • limit - Return at most limit packages.
  • hide - Hide content based on Content Flags.
  • sort - Sort by (name, title, score, downloads, created_at, approved_at, last_release).
  • order - Sort ascending (asc) or descending (desc).
  • protocol_version - Only show packages supported by this Minetest protocol version.
  • engine_version - Only show packages supported by this Minetest engine version, eg: 5.3.0.

Topic Queries

Example:

/api/topics/?q=mobs

Supported query parameters:

  • q - Query string.
  • sort - Sort by (name, views, date).
  • order - Sort ascending (asc) or descending (desc).
  • show_added - Show topics that have an existing package.
  • show_discarded - Show topics marked as discarded.
  • limit - Return at most limit topics.