HTTP Drop Find


Request


GET https://api.flowthings.io/v0.1/<account_id>/drop/<flow_id>?filter=<filter>&start=<start>&limit=<limit>&sort=<sort>&order=<order>&hints=<hints>

Params

  • flow_id - The id of the Flow you'd like to search through. Drops can only be looked up within the context of a Flow.
  • start - For the starting index of the search, default is 0
  • limit - To limit the maximum number of results returned, default is 20
  • sort - For selecting a member field to sort the search results. Default is creationDate
  • order - For selecting the order of the sort, options are ‘asc’ (ascending) or ‘desc’ (descending). Default is desc
  • filter - For defining the parameters of the search, see the Flow Filter Language documentation for more details
  • hints - For displaying type / value pairs, to only display the value, turn hints off with a value of 0, to display the data types, turn hints on with a value of 1. Hints are on by default.

Headers

NameDescription
Content-Typeapplication/json
X-Auth-TokenAuthentication Token

Example

GET https://api.flowthings.io/v0.1/<account_id>/drop/f54b006740cf25b8ea459c3da?filter=elems.error_rate>0.10&start=0&limit=10&sort=elems.error_rate&order=asc

Response


HTTP Codes

CodeDescription
200Request Successful
400Bad Request
401Unauthorized
503Service Unavailable
{
  "head" : {
    "status" : 200,
    "ok" : true,
    "messages" : [ {
      "start" : "0"
    }, {
      "limit" : "20"
    }, {
      "order" : "desc"
    }, {
      "filter" : "elems.error_rate > 0.10"
    } ],
    "errors" : [ ],
    "references" : { }
  },
  "body" : [ {
    "id" : "d54b006810cf25b8ea459c3e9",
    "flowId" : "f54b006740cf25b8ea459c3da",
    "creationDate" : 1420822145109,
    "path" : "/bob/doc_test_rgazwuxqke",
    "location" : {
      "lat" : -76.06215616961697,
      "lon" : -100.61710053048706,
      "specifiers" : { }
    },
    "elems" : {
      "error_rate" : {
        "type" : "float",
        "value" : 0.98
      },
      "stats" : {
        "type" : "map",
        "value" : {
          "temp" : {
            "type" : "float",
            "value" : 30.4
          },
          "uptime" : {
            "type" : "float",
            "value" : 1992343.4
          },
          "voltage" : {
            "type" : "float",
            "value" : 15.4
          }
        }
      },
      "service_available" : {
        "type" : "boolean",
        "value" : true
      }
    }
  }, {
    "id" : "d54b0067f0cf224952d5723b5",
    "flowId" : "f54b006740cf25b8ea459c3da",
    "creationDate" : 1420822143724,
    "path" : "/bob/doc_test_rgazwuxqke",
    "location" : {
      "lat" : -72.5377612990504,
      "lon" : 151.47476985562548,
      "specifiers" : { }
    },
    "elems" : {
      "error_rate" : {
        "type" : "float",
        "value" : 0.62
      },
      "stats" : {
        "type" : "map",
        "value" : {
          "temp" : {
            "type" : "float",
            "value" : 30.4
          },
          "uptime" : {
            "type" : "float",
            "value" : 1992343.4
          },
          "voltage" : {
            "type" : "float",
            "value" : 15.4
          }
        }
      },
      "service_available" : {
        "type" : "boolean",
        "value" : true
      }
    }
  }, {
    "id" : "d54b006760cf25b8ea459c3df",
    "flowId" : "f54b006740cf25b8ea459c3da",
    "creationDate" : 1420822134767,
    "path" : "/bob/doc_test_rgazwuxqke",
    "location" : {
      "lat" : 40.703285,
      "lon" : -73.987852,
      "specifiers" : { }
    },
    "elems" : {
      "error_rate" : {
        "type" : "float",
        "value" : 0.15
      },
      "stats" : {
        "type" : "map",
        "value" : {
          "temp" : {
            "type" : "float",
            "value" : 30.4
          },
          "uptime" : {
            "type" : "float",
            "value" : 1992343.4
          },
          "voltage" : {
            "type" : "float",
            "value" : 15.4
          }
        }
      }
      "service_available" : {
        "type" : "boolean",
        "value" : true
      }
    }
  }, {
    "id" : "d54b006750cf224952d5723ac",
    "flowId" : "f54b006740cf25b8ea459c3da",
    "creationDate" : 1420822133472,
    "lastEditDate" : 1420822141202,
    "path" : "/bob/doc_test_rgazwuxqke",
    "location" : {
      "lat" : 40.703285,
      "lon" : 73.987852,
      "specifiers" : { }
    },
    "elems" : {
      "error_rate" : {
        "type" : "float",
        "value" : 0.15
      },
      "stats" : {
        "type" : "map",
        "value" : {
          "temp" : {
            "type" : "float",
            "value" : 30.4
          },
          "uptime" : {
            "type" : "float",
            "value" : 1992343.4
          },
          "voltage" : {
            "type" : "float",
            "value" : 15.4
          }
        }
      },
      "service_available" : {
        "type" : "boolean",
        "value" : true
      }
    }
  } ]
}