action threatjammer_parse_user_agents_v1_ua_post {
  label: "Get the information found in a set of User Agents."
  description: "### What\nGet the information found in the list of User Agents passed as argument. This information includes:\n- Type\n- Render Engine\n- Version\n- Vendor\n- Operating System\n- Device\n- How common is the agent worldwide\n\n### Parameters\nA list of User Agents are required in the body of the request.\n\n### Result\nThe result contains a list of the result for each User Agent, with the following data set:\n\nThe result is a JSON object with the following structure:\n- ``self``: the URI of the API call\n- ``string``:  The full user agent string passed as argument.\n- ``classification``: The classification of the user agent. It can be one of the following: ``CRAWLER``, ``CLIENT``, ``UNKNOWN``.\n- ``type``: An URI to the type of user agent used to identify the client (browser, bot, crawler, etc.).\n- ``agent``: Name of the agent and the version, if any.\n- ``engine``: Agent render engine.\n- ``version``: Version of the agent.\n- ``latest``: Latests known version of the agent.\n- ``family``: URI to the family of the agent.\n- ``vendor``: URI to the vendor or company that produces the agent.\n- ``os``: URI to the operating system used by the agent.\n- ``device``: URI to the device used by the agent.\n- ``frequent``: If the agent is frequently used worlwide or not. The values are ``COMMON``, ``RARE``, and ``UNKNOWN``.\n\n\n### Errors\nThe endpoint will return the API Global errors described in the API description."
  provider: threatjammer
  method: POST
  path: "/v1/ua"
  encoding: json
  input: {
    type: "array"
    items: {
      type: "string"
    }
  }
  output: {
    type: "object"
    required: ["results", "self"]
    properties: {
      results: {
        type: "array"
        items: {
          type: "object"
          required: ["string", "classification", "type", "agent", "engine", "version", "latest", "family", "vendor", "os", "device", "frequent"]
          properties: {
            agent: {
              type: "string"
            }
            classification: {
              type: "string"
              enum: ["CRAWLER", "CLIENT", "UNKNOWN"]
            }
            device: {
              type: "string"
            }
            engine: {
              type: "string"
            }
            family: {
              type: "string"
            }
            frequent: {
              type: "string"
              enum: ["COMMON", "RARE", "VERY_RARE", "UNKNOWN"]
            }
            latest: {
              type: "string"
            }
            os: {
              type: "string"
            }
            self: {
              type: "string"
            }
            string: {
              type: "string"
            }
            type: {
              type: "string"
            }
            vendor: {
              type: "string"
            }
            version: {
              type: "string"
            }
          }
        }
      }
      self: {
        type: "string"
      }
    }
  }
}