Latest revision as of 13:37, 31 January 2014

[edit] Authentication

• HTTP Basic Auth with DDNS user and passwd

[edit] API list

[edit] PUT /ddns/clients/{client_key}

Create a client

[edit] Request body

{ 
  "offline": false 
}

[edit] Response

• 201(+Location)
  • Locaiton: http://{api_server}/ddns/clients/{client_key}
• 401

[edit] GET /ddns/clients/{client_key}

Get a client

[edit] Request body

[edit] Response

• 200

{ 
  "offline": true
  "hosts": {
    "rel": "related",
    "href": "http://{api_server}/ddns/clients/{client_key}/hosts"
  }
}

• 404
• 403
• 401

[edit] PUT /ddns/clients/{client_key}

Update a client

[edit] Request body

{ 
  "offline": true 
}

[edit] Response

• 200

{ 
  "offline": false, 
  "hosts": {
    "href": "http://{api_server}/ddns/clients/{client_key}/hosts", 
    "rel": "related"
  }
}

• 404
• 403
• 401

[edit] GET /ddns/clients/{client_key}/hosts

Get all hosts

[edit] Request body

[edit] Response

• 200

{ 
  "hosts": [
    "hostname": "{hostname}"
    "ipAddress": "{ipaddr}"
    "links": [
      {
        "rel": "self",
        "href": "http://{api_server}/ddns/clients/{client_key}/hosts/{hostname}"
      }
    ]
  ]
}

• 404
• 403
• 401

[edit] POST /ddns/clients/{client_key}/action

Do an action

[edit] Request body

{ 
  "{action_name}": "{action_value}" 
}

[edit] Actions

• "updateIP" action
  • "default" value - update ALL hosts ipaddr at once

[edit] Response

• 204
• 404
• 403
• 401

[edit] PUT /ddns/clients/{client_key}/hosts/{hostname}

Attach a host (it's actually "connecting a host to client", the host should exist before)

[edit] Request body

[edit] Response

• 201(+Location)
  • Location: http://{api_server}/ddns/clients/{client_key}/hosts/{hostname}
• 404 - if host doesn't exist in DB
• 403
• 401

[edit] DELETE /ddns/clients/{client_key}/hosts/{hostname}

Detach a host

[edit] Request body

[edit] Response

• 204
• 404
• 403
• 401

[edit] DELETE /ddns/clients/{client_key}

Delete a client

[edit] Request body

[edit] Response

• 204
• 404
• 403
• 401