Added shell API helper.

api/mist_api.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+
+# This file contains functions that may be used to make MistServer API calls using your shell.
+# Dependencies: curl, jq, md5sum, cut, cat
+# If any of the dependencies are missing, the functions will warn you and exit.
+#
+# Run a function without arguments for usage information and a short explanation.
+#
+# Function list:
+# - mistCall; Make raw JSON API calls, returning raw JSON results.
+#
+
+function mistCheckDeps {
+  command -v curl >/dev/null 2>&1 && command -v jq >/dev/null 2>&1 && command -v md5sum >/dev/null 2>&1 && command -v cut >/dev/null 2>&1 && command -v cat >/dev/null 2>&1 && return 0
+  echo "ERROR: Not all dependencies are installed (curl, jq, md5sum, cut, cat)" >&2
+  return 1
+}
+
+function mistCall {
+  mistCheckDeps || return 3
+
+  if [ "$#" -eq 0 ] ; then
+    echo "mistCall allows you to pass a partial JSON object and make an API call with it." >&2
+    echo "The reply is send to standard output, any errors are send to standard error." >&2
+    echo "Returns a non-zero exit code on error." >&2
+    echo "" >&2
+    echo "The COMMAND passed is inserted into a JSON object as follows:" >&2
+    echo "  {\"auth\":{...}, COMMAND, \"minimal\":1}" >&2
+    echo "" >&2
+  fi
+  if [ "$#" -ne 4 ] ; then
+    echo "ERROR: Usage: mistCall SERVER USERNAME PASSWORD COMMAND" >&2
+    return 3
+  fi
+
+  #Load auth, if any
+  MIST_AUTH=`cat /tmp/MistBashAuth 2> /dev/null`
+
+  #Send request
+  RESP=`curl -s -X POST -d "command={${MIST_AUTH}, ${4}, \"minimal\":1}" http://${1}/api/`
+
+  #Catch problems with reaching the server, display clear error message
+  if [ "$?" != "0" ] ; then
+    echo "ERROR: Could not contact server (${1}), is it correct and online?" >&2
+    return 1
+  fi
+
+  #Check if this is a challenge
+  if [ `echo $RESP | jq -r .authorize.status` == "CHALL" ] ; then
+    echo "Challenge detected, (re)calculating login string..." >&2
+    PASSW=`echo -n $3 | md5sum | cut -f 1 -d " "`""
+    CHALL=`echo $RESP | jq -r .authorize.challenge`
+    SUMMD=`echo -n $PASSW$CHALL | md5sum | cut -f 1 -d " "`
+    MIST_AUTH="\"authorize\":{\"username\":\"${2}\",\"password\":\"${SUMMD}\"}"
+    #Repeat request
+    RESP=`curl -s -X POST -d "command={${MIST_AUTH}, ${4}, \"minimal\":1}" http://${1}/api/`
+  fi
+
+  #Still a challenge? We must have invalid credentials
+  if [ `echo $RESP | jq -r .authorize.status` == "CHALL" ] ; then
+    echo "ERROR: User/pass incorrect?" >&2
+    return 2
+  fi
+
+  #Cache auth credentials for next call
+  echo -n $MIST_AUTH > /tmp/MistBashAuth
+
+  #Echo the API call result
+  echo $RESP
+}
+