Examples

POST /api/v1/domains/1/records/
auth_token=RDzmeQgUG7scYE3BSUuP&record[name]=xxxx.domain36.com&record[type]=A&record[content]=1.2.3.4&record[ttl]=100000
201
{
  "change_date": null,
  "content": "1.2.3.4",
  "created_at": "2013-02-28T17:49:32+01:00",
  "domain_id": 1,
  "id": 11,
  "name": "xxxx.domain36.com",
  "prio": null,
  "ttl": 100000,
  "type": "A",
  "updated_at": "2013-02-28T17:49:32+01:00"
}
POST /api/v1/domains/1/records/
auth_token=yMTwRXm6eYsLHwrrPvdQ&record[name]=xxxxdomain40.com&record[type]=A&record[content]=1.2.3.4&record[ttl]=100000
422
{
  "errors": {
    "name": [
      "You can't setup record names out of your domain name"
    ]
  }
}

Supported Formats

json

Errors

401 Unauthorized
422 Bad parameter
404 Not found
500 Server crashed for some reason

Params

Param name Description
auth_token
required

API authentication key


Value: Must be String
record
required

Value: Must be a Hash
record[name]
required

record name


Value: Must be String
record[ttl]
required

Time To Live of the record


Value: Must be Fixnum
record[type]
required

record type: A, MX, SOA, NS, PTR, etc…


Value: Must be String
record[content]
required

record content, validation depends on the record type


Value: Must be String
Free DNS // dynamic IP DNS service // 24/7 Service // Plans with extra features //
hiya!