Measurement creation is managed based on the premise of having to submit as little information as possible while still obtaining something useful. With that said, even the simplest measurement requires a rather large amount of information to initiate things. You will need to compose a measurement definition that has at least the
target fields, as well as a
probes object telling us which probes you want to use for the measurement.
If you omit the
start_time, we assume you want it started right away; if you don't set the
is_oneoff flag, we assume it must be a regular measurement, and so on.
You will also have to use a valid
key with the right permissions. See the section on keys for more information.
This section of the manual doesn't contain a try-it-out box, because it would create real measurements on the RIPE Atlas system and place unnecessary burden on the network. In addition, you would need a valid key.
If you do want to create measurements, you must use a tool that is able to send POST requests with a payload to RIPE Atlas. Three such tools are postman (a plug-in for Chrome), HttpRequester (a plugin for Firefox) and cURL (a command-line tool).
Our measurement REST API uses a JSON payload with a POST verb to create new measurements.
You can fill in one or more measurement
definitions, one or more
probes objects, and some fields that are applicable to all measurements you want to create.
The response to any successful
POST request will return an object that has one field called
measurements. This field holds an array that contains the IDs of the created measurements. The array reflects the order in which they were specified in the
definitions list of you request.