jsonapi-api-draft.js

// source
const user = {
	Id: '4aa86780f44a0d5547895e12f1346e30508fba05653c69d1c53c17e500cb60ec',
	FirstName: 'Hans',
	LastName: 'Gold'
	email: 'mail@example.com',
	departmentId: 412,
};


// schema definition
const userSchema = new Schema({
	id: 'id',
	type: 'users',
	attributes: {
		id: 'Id',
		name: (obj) => `${obj.FirstName} ${obj.LastName}`,
		email: 'email',
	},
	relationships: [
		department: {
			schema: departmentSchema,
			id: 'departmentId',
			included: true,
		}
		projects: {
			schema: projectSchema,
			included: false,
		},
	],
	included: [
		// list of included objs or define included for each relationship?
	]
});

const projectSchema = new Schema({
	links: {
		self: (serializedObj) => `/projects/${serializedObj.id}`,
	}
});


// example usages
router.get('/user', () => {
	return userSchema.serialize(obj, {
		// this object will be merged into serialize result
		links: {
			self: (serializedObj) => `/users/${serializedObj.id}`,
		}
	});
});
router.get('/users', () => {
	return userSchema.serialize(objs);
});

// expected result
const result = {
	links: {
		self: '',	
	},
	data: [{
		type: '',
		id: '',
		attributes:	{},
		relationships: {},
	}],
	included: [
	],
};

http://jsonapi.org/format/#fetching

https://github.com/allistercsmith/simple-jsonapi

https://pypi.python.org/pypi/marshmallow-jsonapi

https://github.com/kutlerskaggs/json-api-ify