Documentation

docs/swagger.yml

@@ -14,10 +14,10 @@ info:
     Use the "Try it out" button to send a real world payload to the endpoint and inspect
     the corresponding response.
 
-    Authentication
-    --------------
+    OAuth Authentication
+    --------------------
       
-    To authenticate, use OAuth. You can register your own app using the `/api/v1/oauth/apps/` endpoint. Proceed to the standard OAuth flow afterwards:
+    You can register your own OAuth app using the `/api/v1/oauth/apps/` endpoint. Proceed to the standard OAuth flow afterwards:
       
     - Our authorize URL is at `/authorize`
     - Our token acquisition and refresh URL is at `/api/v1/oauth/token`
@@ -27,6 +27,13 @@ info:
     
     You can use our demo server at `https://demo.funkwhale.audio` for testing purposes.
         
+    Application token authentication
+    --------------------------------
+    
+    If using OAuth isn't practical and you have an account on the Funkwhale pod, you can create an application by visiting `/settings`.
+
+    Once the application is created, you can authenticate using its access token in the `Authorization` header, like this: `Authorization: Bearer <token>`. 
+
     Rate limiting
     -------------