API for Google Wifi and OnHub; mostly untested

Google-Wifi-API.md

Endpoints

Default GET read timeout: 10 sec

Request headers:

X-XSRF-Protection: 1

• http://onhub.here/api/v1/get-attestation-information
  • GET; in testing:
    • Response Content-Type: text/plain
    • Status: 403
    • Response body: Device is registered
• http://onhub.here/api/v1/get-endorsement-information
  • GET; in testing:
    • Response Content-Type: text/plain
    • Status: 403
    • Response body: Device is registered
• http://onhub.here/api/v1/prepare-for-setup
  • POST
    • Content-Type: application/json
    • Expects an empty JSON object ({})
    • Resets mesh credentials
• http://onhub.here/api/v1/wan-configuration
  • GET
    • Response Content-Type: application/json
    • Returns the type property of the current configuration; all other properties are omitted
  • POST
    • Content-Type: application/json
• http://onhub.here/api/v1/diagnostic-report
  • GET
    • Connect timeout: 5 sec
    • Read timeout: 45 sec
• http://onhub.here/api/v1/submit-feedback
  • POST
    • Content-Type: application/json
    • Connect timeout: 5 sec
    • Read timeout: 45 sec
• http://onhub.here/api/v1/join-group
  • POST
    • Content-Type: application/json
    • Read timeout: 30 sec
• http://onhub.here/api/v1/prove-identity
  • POST
    • Content-Type: application/x-protobuf
• http://onhub.here/api/v1/register-device
  • POST
    • Content-Type: application/json
    • Read timeout: 25 sec
• http://onhub.here/api/v1/status
  • GET
    • Response Content-Type: application/json
    • Optional querystring parameter: type; one of:
      • wan
      • system
      • software

Response formats

Arbitrary error response

• error: string
• code: int32

status response

• wan
  • online: boolean
  • ethernetLink: boolean
  • pppoeDetected: boolean
  • invalidCredentials: boolean
• system
  • deviceId: string
  • countryCode: string
• software
  • updateStatus: string; one of:
    • checking
    • downloading
    • idle
    • unknown
    • updated
    • updating
    • waiting
  • updateProgress: float64
  • updateRequired: boolean

wan-configuration GET response

• type: string; one of:
  • pppoe
  • static
  • dhcp

Request formats

join-group request

• groupConfiguration: string
• kek: string
• mac: string

register-device request

• ticketId: string
• displayName: string

wan-configuration requests

Common properties:

• type: string; one of:
  • pppoe
  • static
  • dhcp

Set PPPoE

• type: string; "pppoe"
• username: string
• password: string

Set static IP address

• type: string; "static"
• ipAddress: string
• netmask: string
• gateway: string

Set DHCP

• type: string; "dhcp"