{"data":{"markdownRemark":{"html":"<p>One of the main modes of working with your simulation is via the REST API. The built-in console makes usage of this same API in order to show the basic UI with ability to view data and control the simulation. As long as you have registered a model with the server in your Main class you are able to run the server locally and from your own customized dashboard or via command line run actions and retrieve outputs from the simulation.</p>\n<p>Details on the format and structure of this REST API can be found <a href=\":version/rest_api/rest_api\">here</a></p>\n<p>Below is a quick example using the REST API with the command line in this case running the <a href=\":version/rest_api/model_sampler\">Model Sampler</a> on a Windows machine. To start since we are not working with an existing API let's create a sample calibration file in the JSON format to make it easier when calling on the machine.</p>\n<div class=\"gatsby-highlight\" data-language=\"javascript\"><pre class=\"language-javascript\"><code class=\"language-javascript\"><span class=\"token punctuation\">{</span>\n  <span class=\"token string\">\"modelName\"</span><span class=\"token punctuation\">:</span> <span class=\"token string\">\"High Frequency Model\"</span><span class=\"token punctuation\">,</span>\n  <span class=\"token string\">\"outputPath\"</span><span class=\"token punctuation\">:</span><span class=\"token string\">\"/tmp/calibration\"</span><span class=\"token punctuation\">,</span>\n  <span class=\"token string\">\"mcCount\"</span><span class=\"token punctuation\">:</span><span class=\"token number\">2</span><span class=\"token punctuation\">,</span>\n  <span class=\"token string\">\"modelSampler\"</span><span class=\"token punctuation\">:</span> <span class=\"token punctuation\">{</span>\n      <span class=\"token string\">\"dimensions\"</span><span class=\"token punctuation\">:</span> <span class=\"token punctuation\">{</span>\n        <span class=\"token string\">\"price\"</span><span class=\"token punctuation\">:</span><span class=\"token punctuation\">[</span><span class=\"token number\">560.00</span><span class=\"token punctuation\">,</span> <span class=\"token number\">600.00</span><span class=\"token punctuation\">]</span>\n      <span class=\"token punctuation\">}</span><span class=\"token punctuation\">,</span>\n      <span class=\"token string\">\"seeds\"</span><span class=\"token punctuation\">:</span><span class=\"token punctuation\">[</span><span class=\"token number\">156415615</span><span class=\"token punctuation\">,</span><span class=\"token number\">15184849</span><span class=\"token punctuation\">,</span><span class=\"token number\">66261846</span><span class=\"token punctuation\">,</span><span class=\"token number\">18749891</span><span class=\"token punctuation\">,</span><span class=\"token number\">98798416</span><span class=\"token punctuation\">]</span><span class=\"token punctuation\">,</span>\n      <span class=\"token string\">\"nbSamples\"</span><span class=\"token punctuation\">:</span><span class=\"token number\">5</span><span class=\"token punctuation\">,</span>\n      <span class=\"token string\">\"nbTicks\"</span><span class=\"token punctuation\">:</span><span class=\"token number\">108000</span>\n  <span class=\"token punctuation\">}</span>\n<span class=\"token punctuation\">}</span></code></pre></div>\n<p>This sets out output, the model we wish to run, some inputs and seed values, and how many ticks and sample runs we want. To run this we simply need to make usage of <a href=\"https://curl.se/\">Curl</a> alongside our regular Maven command.</p>\n<div class=\"gatsby-highlight\" data-language=\"shell\"><pre class=\"language-shell\"><code class=\"language-shell\">mvn clean compile exec:java -s settings.xml\n\n<span class=\"token punctuation\">..</span>. <span class=\"token punctuation\">(</span>wait <span class=\"token keyword\">until</span> completed and server says it's online<span class=\"token punctuation\">)</span>\n\n<span class=\"token function\">curl</span> -X POST http://localhost:8080/api/simulations/model-sampler -d @calibration.json -H <span class=\"token string\">\"Content-Type: application/json\"</span> -H <span class=\"token string\">\"Cache-Control: no-cache\"</span></code></pre></div>\n<p>This will in turn run the simulation. As always please refer to the <a href=\":version/rest_api/rest_api\">REST API</a> docs for info on constructing your POST/GET statements both for running headless per above or in your existing/new dashboard.</p>","headings":[],"frontmatter":{"title":"REST API Usage","toc":null,"experimental":null}},"site":{"siteMetadata":{"title":"Simudyne Docs","latestVersion":"2.6"}}},"pageContext":{"absolutePath":"/home/vsts/work/1/s/content/2.5/reference/run_deploy/rest_api.md","versioned":true,"version":"2.5","kind":"reference","pagePath":"/reference/run_deploy/rest_api","chronology":{"prev":{"name":"CLI Model Runner","path":"/reference/run_deploy/cli"},"next":{"name":"Deploying via Local Server","path":"/reference/run_deploy/local"}},"lastUpdated":"2026-04-21T13:56:54.862Z"}}