B2B API Integration Guide

This guide explains how to integrate with our API to fetch product data.

Base URLs

https://gorgia.ge/data/producs_0.json (Batch 1)
https://gorgia.ge/data/producs_1.json (Batch 2)
https://gorgia.ge/data/producs_2.json (Batch 3)

Note: The batch structure is dynamic and subject to change. Batches may be added, removed, or modified over time. Always implement your integration to handle batch URLs flexibly.

Authentication

IP-based authentication is used. Contact us to whitelist your IP address before accessing the API.

Testing with Postman

1. Open Postman and create a new request
2. Set the request method to GET
3. Enter one of the base URLs (e.g., https://gorgia.ge/data/producs_0.json)
4. Click "Send" to execute the request

That's it! If your IP is whitelisted, you'll receive the product data in JSON format.

Product Data Structure

{
  "category": "string",
  "brand": "string",
  "sku": "string",
  "model": "string",
  "title": "string",
  "selling_price": "string",
  "purchase_price": "string",
  "quantity": "string",
  "images": ["string"],
  "specifications": {
    "texture": "string",
    "color": "string",
    "import": "string"
  },
  "description": "string",
  "discounted_price": "string"
}

Important Note: Currently, all values are passed in string type. We believe changing the field type without notifying the vendors is not advisable to ensure the accuracy of the information. Vendors must specifically request a type change for a particular field at their own endpoint, and we will only implement the change at their requested endpoint.

Field Descriptions

Field	Description
category	Product category
brand	Brand name (if multiple brands exist)
sku	Unique product identifier
model	Product model
title	Product name
selling_price	Retail price on the platform
purchase_price	Wholesale price
quantity	Available stock
images	Array of direct URLs to product images
specifications	Product characteristics (texture, color, etc.)
description	Product description
discounted_price	Discounted price (if applicable)

Data Updates

• The API provides data in 3 batches
• Only products marked with "import": true in specifications are updated

Best Practices

1. Error Handling

   • Implement robust error handling
   • Use appropriate retry mechanisms
   • Log all API interactions

2. Rate Limiting

   • Implement reasonable delays between batch requests
   • Monitor API response times
   • Cache responses when appropriate

3. Data Validation

   • Validate all received data
   • Handle missing or null values gracefully
   • Implement type checking

4. Performance

   • Use batch processing efficiently
   • Implement proper caching strategies
   • Monitor memory usage when processing large datasets

Getting Started

1. Contact us with your IP address for access
2. Test the API endpoints using Postman
3. Implement the integration in your system
4. Set up regular fetching of product data

Support

Need help? Our technical support team is available to assist you with your integration needs.