A new feature has been added to the Integration module, allowing users to generate and use the Sentry API for uploading time logs via Postman. This guide provides step-by-step instructions for installing Postman, setting up an account, and integrating the Sentry API.


Instructions for Installing Postman and Setting Up an Account

1. Downloading the Postman App

Follow these steps to download Postman to your system:

  1. Go to the official Postman download page:

  2. Choose the appropriate version of the app:

    • For Windows: Click on the Windows 64-bit download button.

    • For Mac:

      • Choose the version depending on your system: Intel Chip or Apple Chip.

    • For Linux:

      • Select the version (x64, arm64) suitable for your distribution.

  3. Once downloaded, open the installer file and follow the on-screen instructions to install Postman.



2. Setting Up a Postman Account

To use Postman effectively, you need to create or log in to an account. Follow these steps:

  1. Launch Postman after installation.

  2. You will see a login screen:

    • Option 1: Enter your work email to create a free account:

      • Fill in your email and click Create Free Account.

    • Option 2: Use a third-party login:

      • Click Continue with Google to sign in via Google.

      • Select Single Sign On (SSO) for company-specific logins.

  3. If you don’t want to sign up immediately:

    • Click on "Continue without an account" at the bottom of the screen.

    • Note: Some features may be limited without an account.

  4. After account setup:

    • Verify your email if prompted.

    • Log in with your new credentials.



3. Troubleshooting

  • Download Issues: Check your internet connection and ensure the correct installer version is chosen.

  • Login Issues: Double-check your email credentials or reset your password via the login screen.

  • Installation Issues: For Mac/Linux, ensure you have the necessary permissions to install applications.


How to Add Sentry API and Generate Code for Postman Integration

This guide provides step-by-step instructions to integrate and use the Sentry API for uploading time logs via Postman.


Steps to Generate Sentry API Code

  1. Access the Administration Module

    • Click the profile icon in the upper-right corner of the page.

    • Navigate to the Administration module in the system.

  2. Open the Integration Module

    • Go to the Integration module.

  3. Access the Sentry API

    • Select the Access button under the Sentry API section. 

  4. Generate the API Code

    • Click the Add button. 

    • Enter a Label to identify the API code.

    • Click Generate.

    • Copy the generated code. 

  5. Save the Configuration

    • Click Save.

    • A confirmation message will appear asking you to confirm adding the Sentry API. Click Yes. 

    • Another message will confirm that the API was successfully created. Click OK. 


Steps to Use Sentry API Code in Postman

  1. Open Postman Application

    • Launch the Postman application on your system. 

  2. Configure the API Request 

    • Step 1: Set HTTP Method

      • Select POST as the HTTP method.

    • Step 2: Enter the Request URL

      • Enter the URL provided by your administrator. 

    • Step 3: Set Authorization

      • Navigate to the Authorization tab.

      • Under Auth Type, select API Key.

      • Enter the following values:

        • Key: x-api-key

        • Value: Paste the generated API code from the Integration module.

        • Add to: Select Header. 

    • Step 4: Add Request Body

      • Navigate to the Body tab.

      • Select raw.

      • Add the following keys and required values

    • [ 
 { 
 "comp_id": null, 
 "bio_id": "121225", 
 "timelog": "2025-09-05 18:30:20", 
 "type": "IN", 
 "flag": "123123" 
 } 
 ]

    • Step 5: Send the Request

      • Click the Send button. 

3. Verify the Response

  • A success message (e.g., "Successfully added") will appear if the request is successful. 


Post-Verification Steps

  1. Confirm API Usage

    • Return to the Integration module.

    • Verify that the Sentry API displays the date and time it was last accessed. 

  2. Check Uploaded Time Logs

    • Navigate to the Time Logs module.

    • Confirm that the uploaded time logs appear correctly. 


Additional Scenario for Multiple Entries

  1. Follow the same procedure outlined above for multiple entries.

    • Enter the appropriate values in the designated fields beside the format, then click "Send." 

  2. A confirmation message will indicate that the data has been successfully added. 

  3. Proceed to the Time Logs module to verify that the data has been uploaded correctly. 


Important Notes

  • The time log value must adhere to the YYYY-MM-DD HH:MM:SS format.

  • Ensure you have the correct Bio ID, Company ID, Time log, and Type values for a successful upload.


With the new Sentry API integration feature, users can efficiently manage and upload time logs via Postman. By following the steps outlined in this guide, you can set up Postman, generate an API key, and verify successful data transmission. This enhancement in the Integration module ensures a streamlined process for tracking and managing time logs effectively.