Documentation: Clarify distinction between device/server usage of Simple Edge Discovery API

[maxplumley]

Documentation: Clarify distinction between device/server usage of Simple Edge Discovery API

[Kevsy]

Thanks for raising it Max, I'll add to #194

[Kevsy]

Hi @maxplumley sorry for slow reply -

Thanks for pointing this out, I'll make it clearer on 0.9.4.

If an IP-Address parameter is provided then the operator should assume the request is coming from a developer's server rather than a device attached to the network. In which case the developer server is expected to have been provided with the device public IP address (e.g. by the application client on that device signaling it back to the server)

If neither the IP-Address parameter nor any other device identifier is provided in the API request header, then the operator should assume the request is from a device attached to their network, and attempt to use the public IP source address to determine which packet gateway issued it (and hence the closest edge to that gateway).

If no IP-Address header is provided, but another device identifier(s) is provided, then the operator should assume the request is coming from a device attached to their network and should make use of one or both of the public IP source address (from the IP packet header) and the other device identifier(s).

[maxplumley]

Hi Kevin, thanks for the clarification! I think our implementation is aligned.