Getting Started

The Tajir Integration API allows you to sync your store data with external systems like Odoo ERP. You can pull products, orders, customers, and inventory — or receive real-time webhook notifications when data changes.

Base URL

All API requests are made to:

https://api.durj.ly/api/v1/

Quick Start

1. Generate an API Token

Go to your Admin Dashboard → Integrations (التكاملات) → API Keys tab and create a new token.

2. Make Your First Request

curl -H "Authorization: Bearer tjr_your_token_here" \
  https://api.durj.ly/api/v1/products?limit=5

3. Response

{
  "data": [
    {
      "id": "abc123",
      "name": "Premium Coffee Beans",
      "price": 25.00,
      "stock": 150,
      "variants": [],
      "last_modified": "2026-04-20T10:30:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "2026-04-20T10:30:00Z",
    "has_more": true,
    "limit": 5
  }
}

Key Concepts

Cursor-Based Pagination

All list endpoints use cursor-based pagination via the last_modified timestamp. Pass cursor from the previous response to get the next page.

curl -H "Authorization: Bearer tjr_..." \
  "https://api.durj.ly/api/v1/products?cursor=2026-04-20T10:30:00Z&limit=50"

Rate Limiting

• Standard endpoints: 60 requests/minute per token
• Export endpoints: 10 requests/minute per token

Rate limit info is returned in response headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Available Entities

Entity	Endpoint	Description
Products	/v1/products	Catalog with variants and images
Orders	/v1/orders	Sales orders with line items
Customers	/v1/customers	Customer records
Inventory	/v1/inventory	Stock levels and movements