FAQ
Developer hub
Plugin Input Fields
Dictionary

Dictionary


A Dictionary (also called Map or Key-Value Pair) is a special input type in viaSocket that lets users dynamically define custom pairs of keys and values. This provides high flexibility when the structure of input data is variable or unknown in advance.


What Is a Dictionary?

In programming, a dictionary is a data structure where:

  • Each key is unique

  • Every key points to a corresponding value

  • Keys and values can be text, numbers, booleans, etc.


In viaSocket:

The dictionary field allows users to manually add rows of custom key-value pairs right from the UI.

Example Use Cases:

Use Case

Description

Custom headers for API request

Users can input "Authorization": "Bearer XYZ"

User metadata

Capture dynamic attributes like "age": "30"

Query parameters

Add flexible GET params like "limit": "100"


Benefits of Using Dictionary Fields

  • ✅ Highly flexible for unknown or dynamic input structures

  • ✅ Enables advanced users to pass complex parameters

  • ✅ Supports scalable API configurations

  • ✅ Works well with headers, query strings, custom payloads

📌

The key cannot contain a dot (.)