Use Postman to Retrieve Data Via API
search cancel

Use Postman to Retrieve Data Via API

book

Article ID: 286470

calendar_today

Updated On:

Products

Carbon Black App Control (formerly Cb Protection)

Issue/Introduction

Retrieve data available via Carbon Black's rest API using Postman.

Environment

  • App Control API: All supported Versions
  • Postman Utility for Windows

Resolution

  1. Generate an API Key. 
  2. Launch Postman and create a new HTTP Get Request and specify the API URL using the Server Address. Example:
    https://ServerAddress/api/bit9platform/v1/computer
  3. Specify the required Key & Value combinations in the Query Params for the API Request. Example:
    Key           Value
    Limit         0
    fields        agentVersion,Name
    q             deleted:false
    
    Note: The URL will adjust dynamically based on the key & value combinations entered in the Query Params.
    
  4. Click the Authorization tab and specify the API Key using X-Auth-Token. Example:
    • Type: API Key
    • Key: X-Auth-Token
    • Value: API Key from Step 1
    • Add to: Header
  5. Click Send.

Additional Information

  • The above example will pull the Agent Version and Machine Name for all machines currently shown in the Console > Assets > Computers.
  • If using a Self-signed Certificate it may be necessary to disable Postman's SSL Certificate Verification: File > Settings > General > SSL Certificate Verification > OFF.
  • See also: Getting Started with App Control APIs & Integrations