SubC Rayfin v4 API

Making an API call using Postman

Table of Contents

The commands used in this document are examples, please ensure you are getting all commands from the API Calls page.

Getting Started

This document provides scenario style examples for sending GET and POST requests using Postman.

Also refer to the API Calls document for API usage and examples.

Sending a GET Request

Let's say you are running the application API on IP 192.168.2.99 on port 8080 (port 8080 is the default port number).

If we want to set the camera to auto focus, we start with the base of http://192.168.2.99:8080/api/focus/auto.

Before proceeding to the Steps, here is an overview example:

image-20230517-184849.png
Captured section from API Calls doc - GET call, setting the auto focus


Postman GET Example

image-20230517-190610.png

GET Steps

  1. Open Postman

  2. Choose the method Get

  3. Fill-in the URL address - Example: http://192.168.2.99:8080/api/focus/auto

  4. Click the Send button

  5. When complete, the Status response should be “200 OK

Sending a POST Request

Sending a POST request is similar to sending a Get Request, with a few additional steps.

Before proceeding to the Steps, here is an overview example:

image-20230517-191500.png

Postman POST Example

image-20230517-192253.png

POST Steps

  1. Open Postman

  2. Choose the method POST

  3. Fill-in the URL address
    Example: http://192.168.2.99:8080/api/pathtemplate/set

  4. Click on Body tab

  5. Select raw

  6. From the drop-down, choose the type as JSON

  7. Populate the command field and modify as needed.
    Example: { "PathTemplate":"ProjectName-Still/{yyyy}{MM}{dd}-{HH}{mm}{ss}" }

  8. Click the Send button

  9. When complete, the Status response should be “200 OK