Bixby Developer Center

This guide assumes familiarity with the following information:

• The basics of the editor (Bixby Home Studio Basics)
• The Command node (Sending a Device Command)
• The Constant node (Creating a Bixby Response Using a Device Status)
• The Equal Comparison node (Concatenating Actions)
• The Response node (Creating a Bixby Response Using a Device Status)

In this guide, you'll learn how to get specific values in a usable format from raw JSON data using the JSON Query node. The device used in this guide is a SmartThings-enabled speaker, with the example utterance "Increase the volume of the speaker by 50".

For this voice command, you must get the result of a command and give the user the information. Sometimes the output of nodes (responses) are in JSON format. To extract information from these responses, you can use the JSON Query node.

Here is an example JSON response:

{
  "results": [
    {
      "id": "6a2e9434-5b19-47s0-92a8-685de69106a3",
      "status": "ACCEPTED"
    }
  ]
}

Extract Information With a JSON Query Node

To start extracting information, you first need to build your action flow with a Start node and a Command node, like in the Sending a Device Command guide.

1. Connect the Start node's main port to the Command node's trigger port, and the Start node's volumeLevel value port to the Command node's Level port.
2. Add a JSON Query node.
3. Click the JSON Query node to open the Node Configuration menu on the right.
4. Configure the node by entering a pointer value and selecting a dataType from the menu. This example uses the pointer value /results/0/status and the data type String. This pointer value selects the status property of the results and parses the status property from the response JSON. The JSON Pointer configuration selects a value with the JSON Pointer specification.
5. Connect the Command node's success port to the JSON Query node's trigger port, and its value port to the JSON Query node's input port.
6. Add an Equal Comparison node and configure it to use the equalTo operator.
7. Connect the JSON Query node's main port to the Equal Comparison node's trigger port, and its value port to the Equal Comparison node's leftValue port.
8. Add a Constant node and configure it to the String value of "ACCEPTED."
9. Connect the Constant node's value port to the Equal Comparison node's rightValue port.
10. Add a Response: Success node and a Response: Execution Failed node to the action flow.
11. Connect the Equal Comparison node's true port to the Response: Success node's trigger port, and its false port to the Response: Execution Failed node's trigger port.

The following image shows the finished action flow:

Test Your Action Flow

To test the action flow, click the Try It button at the top right of the editor window. The flow editor should look like this:

As shown in the example graph, the user's utterance value is 50. The user utterance "Increase the volume of the speaker by 50" executes the SmartThings Capabilities audioVolume command. For more information, see Sending A Device Command With an Argument.

For the audioVolume POST command, the server responds with JSON:

{
  "results": [
    {
      "id": "6d0dc5d1-c76d-48e6-bd64-0e834dd52778",
      "status": "ACCEPTED"
    }
  ]
}

The JSON Query node selects the status property of the results and parses the status property from the response JSON. Bixby then compares the status property output by the JSON Query node to the string "ACCEPTED" in the Constant node. The Equal Comparison node determines that these values are equal and triggers the "SUCCESS" response.

Additional Resources

The Node Recommendation feature enables you to get recommendations for next possible nodes, and can make it easier to create a graph.