Documentation

The software running this website is licensed under AGPL-3.0-or-later. You can find information about this software in the public git repository.

Web API

We provide a public API access. It's still in beta so the data formats may change without warning.

Known repositories

You can retreive our list of known repositories with a GET request to folloing JSON endpoint:

https://appiverse.io/api/fdroid/repos

Here's an example for a response with some annotations:

{
  "platforms":
    [
      {
        // web address of the repository
        "fdroidRepoUrl": "https://f-droid.org/repo",

        // cryptographic fingerprint for verifying signing signatures
        "fdroidFingerprint": "43238D512C1E5EB2D6569F4A3AFBF5523418B82E0A3ED1552770ABB9A9C9CCAB",

        // unique identifier used in appiverse.io urls: e.g. https://appiverse.io/fdroid/fdroidorg/
        "slug": "fdroidorg",

        // human readable name of this repository
	// (translations are not reliably available, so you will need to implement a fallback logic)
        "name":
          {
            "en": "F-Droid",
          },

        // optional, description texts for this repository
        "description":
          {
            "en": "This is the default repository for new installs of the official F-Droid app. It is maintained by the developers of F-Droid and contains an extensive curated catalogue of FOSS (Free and Open Source Software) applications for the Android platform.",
	    "fr": "Voici le dépôt par défaut pour les nouvelles installations de l'application officielle F-Droid. Il est maintenu par les développeurs de F-Droid et contient un vaste catalogue soigneusement sélectionné d'applications FOSS (logiciels libres et open source) pour la plateforme Android.",
          },

        // optional, website of this repository
        "website":
          {
            "en": "https://f-droid.org"
            "fr": "https://f-droid.org/fr"
          },

        // tags assigend to this repo by the appiverse.io team
        "tags":
          {
            "DownStream": {},
            "FullyFOSS": {}
          },

         // total number of apps in this repository
         "appCount": 1299
      }
    ]
}

Submit Repository

Submitting repositories is supported by sending a HTTP POST request using form data, to this endpoint:

https://appiverse.io/submit

Due to our moderation process there is only one mandatory piece of information required to submit a repository.

• fdroidRepoUrl - http address of the F-Droid repository

The form also accept some optional data, which may inform to the submission process: repository name, repository description and website link. It's not reuqired for the submission process though.

This enpoint uses CSRF protection. For a successfull requests implementers need to provide valid values for:

• csrftoken - cookie value
• csrfmiddlewaretoken - hidden form input