OPLOG’s Cargo Carriers API provides comprehensive management capabilities for cargo and shipping companies integrated with the platform. This guide covers the essential requirements, query methods, and examples for working with cargo carrier data.

​
Integration Overview

The Cargo Carriers API is designed to handle shipping partner management:
  • Carrier Information - Access shipping company details and capabilities
  • Dynamic Updates - Real-time carrier availability and service updates
  • Reference Management - Consistent carrier identification across systems
  • Service Integration - Connect with various shipping and logistics providers
All cargo carrier operations use GET endpoints to retrieve current carrier information. The system maintains up-to-date carrier data and provides query capabilities for integration purposes.

​
What are CargoCarriers?

Definition: Defines the cargo/shipping companies that OPLOG works with. Requests should be sent or read using these definitions. CargoCarriers represent the logistics partners and shipping companies integrated with the OPLOG platform. These entities are essential for managing shipments, tracking deliveries, and coordinating logistics operations.
Important NotesSince cargo companies can be updated, please make an API request for the current response to ensure you have the latest information.

​
API Usage

​
Basic Carrier Query

Retrieve all available cargo carriers: 
GET /openapi/v1/CargoCarriers

​
Response Fields

key

String - Unique identifier for the cargo carrier. Use this value when making API requests.

value

String - Human-readable display name of the cargo carrier for UI purposes.

​
Best Practices

Cache the Response

Cache cargo carrier data locally to minimize API calls and improve application performance. Update cache periodically based on your business needs.

Use Key Values

Always use the key field when making API requests or storing references. Keys remain consistent while display values may change.

Display Values

Use the value field for user-facing displays, labels, and dropdown options. This provides human-readable carrier names.

Regular Updates

Refresh cargo carrier data regularly as new carriers may be added or existing ones updated. Consider implementing automated refresh mechanisms.