goldilocks.js/API.md

1.4 KiB

API

The API system is intended for use with Desktop and Mobile clients. It must be accessed using one of the following domains as the Host header:

admin.invalid
localhost.admin.daplie.me

All requests require an OAuth3 token in the request headers.

Tunnel

Check Status

  • URL /api/goldillocks@daplie.com/tunnel
  • Method POST
  • Reponse: An object whose keys are the URLs for the tunnels, and whose properties are arrays of the tunnel tokens.

This route with return only the sessions started by the same user who is checking the status.

Start Tunnel

  • URL /api/goldillocks@daplie.com/tunnel
  • Method POST

This route will use the stored token for the user matching the request header to request a tunnel token from the audience of the stored token.

Socks5 Proxy

Check Status

  • URL /api/goldillocks@daplie.com/socks5
  • Method GET
  • Response: The returned object will have up to two values inside
    • running: boolean value to indicate if the proxy is currently active
    • port: if the proxy is running this is the port it's running on

Start Proxy

  • URL /api/goldillocks@daplie.com/socks5
  • Method POST
  • Response: Same response as for the GET resquest

Stop Proxy

  • URL /api/goldillocks@daplie.com/socks5
  • Method DELETE
  • Response: Same response as for the GET resquest