api-docs/reference/general.rst

   1 General Information
   2 ===================
   3
   4 The API can be accessed via http and https. https is preferable from a security
   5 / privacy point of view and should be used by all clients. gpodder.net also
   6 seems to be blocked in China via plain http.
   7
   8 All endpoints are offered at https://api.gpodder.net/3/.
   9
  10
  11 Podcast is identified by its feed URL, episode is identified by its media URL.
  12
  13
  14 Status Codes
  15 ------------
  16
  17 * Maintenance
  18 * Request not allowed (eg quota, authentication, permissions, etc)