This article provides the essential technical foundation for developers looking to integrate with the Tradogram API (v1.0.4). Our RESTful API allows you to programmatically manage and sync procurement data—such as requisitions, purchase orders, and invoices—directly with your internal systems.

Core Connection Details

To interact with the Tradogram API, all requests must be directed to the following base URL:

Base URL: https://api.tradogram.com/v1.0.4

Example Request: https://api.tradogram.com/v1.0.4/purchase_orders

Authentication

Security is handled via HTTP headers. Every request sent to the API must be authenticated using your unique account-specific API key.

1. Obtain Your API Key

You can retrieve your API key from the API Configuration Page when logged into your Tradogram account.

2. Encode and Format

Connecting to the API requires two steps to format your key correctly:

• Base64 Encoding: First, convert your raw API key to a base64-encoded string.
• Header Inclusion: For every request, include the encoded key as the value in an HTTP header named x-api-key.

Header Example:

headers["x-api-key"] = "<YOUR BASE64 ENCODED ΑΡΙ ΚΕΥ>"

Key Technical Specifications

Before you begin your development, keep these system-wide details in mind:

• Time Zone: All API timestamps are recorded in EST (America/Toronto).
• Methodology: The API uses standard REST methods (GET for requesting data, POST for creating/updating, and PUT for status changes).
• Response Format: Successful requests return a JSON object with an HTTP status of 200.
• Rate Limits & Pagination: For high-volume data retrieval, it is recommended to use the pagination parameters to avoid request timeouts.

‍