API taking into account load

With the addition of load balancing we now have some info about the load of the gateways:

  • fullness, a float64 that indicates the load
  • overload, a bool indicating if we consider this gateway overloaded

In the current API we have a single entry point /json and if we GET it the response looks like:

{
  "ip": "x.x.x.x",  // your IP address
  "cc": "DE",       // a two letter country code of that IP
  "city": "Berlin", // the guessed city from the IP
  "lat": 52.4963,
  "lon": 13.4417,
  "gateways": ["foo.riseup.net", ...] // a list of gateway host names
}

How should we include this information in the API?

Edited by meskio