Overview

JAMES is a web service for creating and interpreting charts of child growth and development. The current version

1. provides access to high-quality growth charts used by the Dutch youth health care;
2. interchanges data coded according to the Basisdataset JGZ;
3. screens for abnormal height, weight and head circumference;
4. converts developmental data into the D-score;
5. predicts future growth and development.

JAMES is a RESTful API that runs on a remote host. The following sections illustrate how a client can make requests to JAMES using various client languages. In principle, any HTTP client will work with JAMES. The document highlights some applications of the service and provides pointers to relevant background information.

The service aids in monitoring and evaluating childhood growth. JAMES is created and maintained by the Netherlands Organisation for Applied Scientific Research TNO. Please contact Stef van Buuren <stef.vanbuuren at tno.nl> for further information.

Primary JAMES user functionality

Verb	API end point	Description	Maps to james function
POST	/version/{dfm}	Obtain version information	version()
POST	/data/upload/{dfm}	Upload child data	upload_data()
POST	/charts/draw/{ffm}	Draw child data on growth chart	draw_chart()
POST	/charts/list/{dfm}	List available growth charts	list_charts()
POST	/charts/validate/{dfm}	Validate a chart code	validate_chartcode()
POST	/dscore/calculate/{dfm}	Calculate developmental score (D-score)	calculate_dscore()
POST	/vwc/select/{dfm}	Select developmental milestones for age	select_vwc()
POST	/vwc/percentiles/{dfm}	Obtain developmental milestone percentiles	percentiles_vwc()
POST	/dcat/calculate/{dfm}	Adaptive testing of milestones	dcat()
POST	/screeners/list/{dfm}	List available growth screeners	list_screeners()
POST	/screeners/apply/{dfm}	Apply growth screeners to child data	apply_screeners()
GET	/site	Request empty site	request_site()
POST	/site/request/{dfm}	Request personalised site	request_site()
POST	/blend/request/{sfm}	Obtain a blend from multiple end points	request_blend()
GET	/{session}/{info}	Extract session details
GET	/{2}/{1}/man	Consult R help	help({1}_{2})

The table lists the defined API end points and the mapping to each end point to the corresponding R function.

The definition of the JAMES endpoints can be found at OpenAPI specification.

Resources

Internal

Description	Status
Example requests	current
OpenAPI specification	current
JSON data schema 3.0	current
JAMES issue tracker	current
GitHub Organization	current

External

Description	Status
JAMES demo	current
Basisdataset JGZ	current
OpenCPU API	current