/dns

Register a long name and a service.
Only authorised requests can invoke the API.

The API will only create an empty file in the directory specified in the file path.

Request Header

Authorization: Bearer <TOKEN> 
Content-Type: application/json

Request Payload

{
    longName: 'maidsafe',
    serviceName: 'www',
    rootPath: 'app',
    serviceHomeDirPath: '/www'
}

Field	Description
longName	The long name to which the service is to be added.
serviceName	Name of the service to be added.
rootPath	Root path of the service directory. Accepted value is app or drive.
serviceHomeDirPath	The full path of the directory that is to be associated to the service.

Response

HTTP 200

Ok

401

Unauthorized

400

Fields are missing

Examples

Nodejs

var request = require('request');
var endPoint = 'http://localhost:8100/dns';

var payload = {
  longName: 'api-test',
  serviceName: 'www',
  rootPath: 'app',
  serviceHomeDirPath: '/home/website'
};

var onResponse = function(err, response, body) {
  if (err) {
    return console.error(err.message);
  }
  if (response.statusCode === 200) {
    return console.log('DNS registered successfully');
  }
  console.error('Operation failed', body);
};

request.post(endPoint, {
  auth: {
    bearer: constants.token
  },
  json: true,
  body: payload
}, onResponse);