Endlich: HTTPServer.registerEndpoint

// 20220917, CH: got HTTPServer.registerEndpoint to run! :-)
// 20230507, DE: get Parameters from URL 
//
// Verified on a Shelly Plus 2PM
//  Firmware version: 0.14.1
//  Firmware build ID: 20230308-091102/0.14.1-g22a4cb7
//  Web build ID: 230302093842-767992a8-HEAD
//
// Trigger a method (function) in a script via browser by
//   - registering a name (endpoint) in a script
//   - requesting the endpoint and Parameters via web
//
//  As of now I use this method to write debug outputs to the console when needed.
//  I don't have my computer connected all the time so all debug output to the console is lost.
//  This way I can see all data on demand.
// 
//  Trigger the callback method via http://SHELLY_IP/script/SCRIPT_ID/myTrigger?what=ever&you=Want
//    replace
//    - SHELLY_IP with the IP of your shelly
//    - SCRIPT_ID with the ID of this script ->
//    use http://SHELLY_IP/rpc/Shelly.GetConfig in your browser and search for your script name
//    - If you change the name of the query parameter (in this Description what and you), then you must also change the object name from ArgArray ;)  
// 
// ** Don't forget to set the 'run on reboot' to enabled! **

// function triggered via web request

function myCallback(optionalArg){
let optArg= optionalArg.query;
let ArgArray= getQueryParams(optArg); //With the example from above, I would get ArgArray.what and ArgArray.you here.

print("Endpoint request received with optional argument: What=", ArgArray.what, "and you=", ArgArray.you); 
//With the example from above, I would get: Endpoint request received with optional argument: What= ever and you= Want

  // put here whatever you want to do
  //  - debug outputs
  //  - call other scripts
  //  - reboot
  //  - etc.
}

HTTPServer.registerEndpoint(
  "myTrigger",    // endpoint to be registered (and later called via browser)
  myCallback,     // method to be called when endpoint triggered via web
  "callback_arg"  // I don't get this to work but who cares? 
                  // I have no idea what to pass to my own method on an external call... *gg*
);

function getQueryParams(str) {
  let result = JSON.parse('{}');
  let params = [];
  let currentParam = "";

  for (let i = 0; i < str.length; i++) {
    if (str[i] === '&') {
      params.push(currentParam);
      currentParam = "";
    } else {
      currentParam += str[i];
    }
  }
  params.push(currentParam);

  for (let i = 0; i < params.length; i++) {
    let separatorIndex = -1;
    for (let j = 0; j < params[i].length; j++) {
      if (params[i][j] === '=') {
        separatorIndex = j;
        break;
      }
    }

    let name = "";
    let value = "";
    if (separatorIndex !== -1) {
      name = params[i].slice(0, separatorIndex);
      value = params[i].slice(separatorIndex + 1);
    }

    result[name] = value;
  }

  return result;
}

// This script runs for ever and does nothing but to wait for the webbrowser to come in.
// I get an 504 error in the browser but the script does what it is supposed to!

// ** Don't forget to set the 'run on reboot' to enabled! **