توثيق الـAPI

curl "https://thseen.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
    "data": {
        "id": 2087,
        "name": "منى أحمد",
        "store_name": "متجر منى",
        "email": "you@example.com",
        "phone": "01012345678",
        "side": "marketer",
        "token": {
            "name": "متجر WooCommerce",
            "abilities": [
                "catalog:read",
                "orders:read",
                "orders:write",
                "wallet:read"
            ],
            "expires_at": null
        }
    }
}

curl "https://thseen.com/api/v1/categories" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
    "data": [
        {
            "id": 4,
            "name": "إلكترونيات",
            "slug": "electronics",
            "parent_id": null
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total": 8,
        "last_page": 1
    }
}

curl "https://thseen.com/api/v1/products?updated_since=2026-10-01T00%3A00%3A00%2B03%3A00" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
    "data": [
        {
            "id": 118,
            "title": "سماعة بلوتوث لاسلكية",
            "slug": "wireless-earbuds",
            "category": {
                "id": 4,
                "name": "إلكترونيات"
            },
            "description": "بطارية 30 ساعة، ومقاومة للمياه.",
            "images": [
                "https://thseen.com/product_files/earbuds-1.webp",
                "https://thseen.com/product_files/earbuds-2.webp"
            ],
            "files": [
                "https://thseen.com/product_files/earbuds-specs.pdf"
            ],
            "video_url": null,
            "marketing_files_url": "https://drive.google.com/drive/folders/example",
            "url": "https://thseen.com/product-detail/wireless-earbuds",
            "variants": [
                {
                    "id": 731,
                    "label": "أسود",
                    "price": "245.00",
                    "suggested_min": "320.00",
                    "suggested_max": "380.00",
                    "in_stock": true,
                    "stock_hint": 14,
                    "available": 14
                }
            ],
            "warranties": [
                {
                    "id": 2,
                    "name": "ضمان استبدال",
                    "admin_fee": 30,
                    "percent": 3,
                    "price_rule": "admin_fee + sale_price * percent / 100",
                    "price_from": 39.6,
                    "duration_days": 30,
                    "terms": "- استبدال بنفس المنتج خلال 30 يوم من الاستلام.\n- المنتج في علبته الأصلية بكل مشتملاته.",
                    "icon_url": null
                }
            ],
            "updated_at": "2026-10-06T18:42:00+03:00"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total": 240,
        "last_page": 10
    }
}

curl "https://thseen.com/api/v1/products/118" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
    "data": {
        "id": 118,
        "title": "سماعة بلوتوث لاسلكية",
        "slug": "wireless-earbuds",
        "category": {
            "id": 4,
            "name": "إلكترونيات"
        },
        "description": "بطارية 30 ساعة، ومقاومة للمياه.",
        "images": [
            "https://thseen.com/product_files/earbuds-1.webp",
            "https://thseen.com/product_files/earbuds-2.webp"
        ],
        "files": [
            "https://thseen.com/product_files/earbuds-specs.pdf"
        ],
        "video_url": null,
        "marketing_files_url": "https://drive.google.com/drive/folders/example",
        "url": "https://thseen.com/product-detail/wireless-earbuds",
        "variants": [
            {
                "id": 731,
                "label": "أسود",
                "price": "245.00",
                "suggested_min": "320.00",
                "suggested_max": "380.00",
                "in_stock": true,
                "stock_hint": 14,
                "available": 14
            }
        ],
        "warranties": [
            {
                "id": 2,
                "name": "ضمان استبدال",
                "admin_fee": 30,
                "percent": 3,
                "price_rule": "admin_fee + sale_price * percent / 100",
                "price_from": 39.6,
                "duration_days": 30,
                "terms": "- استبدال بنفس المنتج خلال 30 يوم من الاستلام.\n- المنتج في علبته الأصلية بكل مشتملاته.",
                "icon_url": null
            }
        ],
        "updated_at": "2026-10-06T18:42:00+03:00"
    }
}

curl "https://thseen.com/api/v1/shipping/options" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
    "data": [
        {
            "id": 1,
            "name": "توصيل عادي",
            "governorates": [
                {
                    "id": 2,
                    "name": "القاهرة",
                    "delivery_charge": "60.00",
                    "shipping_tax_percent": "0.00",
                    "total_due_tax_percent": "1.00",
                    "example": {
                        "goods": "500.00",
                        "delivery_charge": "65.60"
                    }
                }
            ]
        }
    ]
}

curl -X POST "https://thseen.com/api/v1/shipping/quote" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "shipping_option_id": 1,
    "governorate_id": 2,
    "lines": [
        {
            "variant_id": 731,
            "quantity": 2,
            "profit": 50
        }
    ]
}'

{
    "data": {
        "shipping_option_id": 1,
        "governorate_id": 2,
        "products": "590.00",
        "warranties": "0.00",
        "delivery_charge": "66.00",
        "customer_total": "656.00",
        "profit": "100.00",
        "income_tax": "4.00",
        "net_profit": "96.00"
    }
}

curl -X POST "https://thseen.com/api/v1/orders" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: 7f3c9a2e-wc-10425" \
  -H "Content-Type: application/json" \
  -d '{
    "external_reference": "WC-10425",
    "full_name": "منى أحمد",
    "phone": "01012345678",
    "second_phone": null,
    "address": "مدينة نصر، شارع عباس العقاد، عمارة 12، الدور 3",
    "governorate_id": 2,
    "shipping_option_id": 1,
    "store_name": "متجر منى",
    "store_link": "https://mona-store.example",
    "note": "اتصل قبل التوصيل",
    "lines": [
        {
            "variant_id": 731,
            "quantity": 2,
            "profit": 50,
            "warranty_ids": [
                2
            ]
        }
    ]
}'

{
    "data": {
        "id": 1543,
        "number": "EG-7K3P9X2Q",
        "external_reference": "WC-10425",
        "tracking_url": null,
        "status": {
            "key": "order_confirmed",
            "label": "أكد العميل الطلب وجاري توفيره"
        },
        "family": "confirmed",
        "customer": {
            "name": "منى أحمد",
            "phone": "01012345678",
            "second_phone": null,
            "address": "مدينة نصر، شارع عباس العقاد، عمارة 12، الدور 3",
            "governorate": {
                "id": 2,
                "name": "القاهرة"
            }
        },
        "shipping_option": {
            "id": 1,
            "name": "توصيل عادي"
        },
        "lines": [
            {
                "id": 9001,
                "variant_id": 731,
                "product_id": 118,
                "title": "سماعة بلوتوث لاسلكية",
                "variant_label": "أسود",
                "quantity": 2,
                "delivered_quantity": null,
                "returned_quantity": null,
                "damaged_quantity": 0,
                "lost_quantity": 0,
                "destroyed_quantity": 0,
                "sell_price": "295.00",
                "profit": "50.00",
                "commission_on": true,
                "warranties": [
                    {
                        "id": 2,
                        "name": "ضمان استبدال",
                        "unit_price": "38.85",
                        "quantity": 2,
                        "total": "77.70",
                        "duration_days": 30,
                        "terms": "- استبدال بنفس المنتج خلال 30 يوم من الاستلام.\n- المنتج في علبته الأصلية بكل مشتملاته."
                    }
                ]
            }
        ],
        "totals": {
            "products": "590.00",
            "warranties": "77.70",
            "delivery_charge": "67.30",
            "customer_total": "735.00",
            "profit": "100.00",
            "income_tax_percent": "4",
            "income_tax": "4.00",
            "net_profit": "96.00"
        },
        "payout": {
            "state": "expected",
            "ready_at": null
        },
        "timeline": [
            {
                "status": "order_pending",
                "label": "الطلب معلق",
                "at": "2026-10-08T13:00:00+03:00",
                "reason": null
            },
            {
                "status": "order_confirmed",
                "label": "أكد العميل الطلب وجاري توفيره",
                "at": "2026-10-08T15:12:00+03:00",
                "reason": null
            }
        ],
        "created_at": "2026-10-08T13:00:00+03:00",
        "updated_at": "2026-10-08T15:12:00+03:00",
        "confirmed_at": "2026-10-08T15:12:00+03:00",
        "delivered_at": null
    }
}

curl "https://thseen.com/api/v1/orders?family=shipping" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
    "data": [
        {
            "id": 1543,
            "number": "EG-7K3P9X2Q",
            "external_reference": "WC-10425",
            "tracking_url": null,
            "status": {
                "key": "order_confirmed",
                "label": "أكد العميل الطلب وجاري توفيره"
            },
            "family": "confirmed",
            "customer": {
                "name": "منى أحمد",
                "phone": "01012345678",
                "second_phone": null,
                "address": "مدينة نصر، شارع عباس العقاد، عمارة 12، الدور 3",
                "governorate": {
                    "id": 2,
                    "name": "القاهرة"
                }
            },
            "shipping_option": {
                "id": 1,
                "name": "توصيل عادي"
            },
            "lines": [
                {
                    "id": 9001,
                    "variant_id": 731,
                    "product_id": 118,
                    "title": "سماعة بلوتوث لاسلكية",
                    "variant_label": "أسود",
                    "quantity": 2,
                    "delivered_quantity": null,
                    "returned_quantity": null,
                    "damaged_quantity": 0,
                    "lost_quantity": 0,
                    "destroyed_quantity": 0,
                    "sell_price": "295.00",
                    "profit": "50.00",
                    "commission_on": true,
                    "warranties": [
                        {
                            "id": 2,
                            "name": "ضمان استبدال",
                            "unit_price": "38.85",
                            "quantity": 2,
                            "total": "77.70",
                            "duration_days": 30,
                            "terms": "- استبدال بنفس المنتج خلال 30 يوم من الاستلام.\n- المنتج في علبته الأصلية بكل مشتملاته."
                        }
                    ]
                }
            ],
            "totals": {
                "products": "590.00",
                "warranties": "77.70",
                "delivery_charge": "67.30",
                "customer_total": "735.00",
                "profit": "100.00",
                "income_tax_percent": "4",
                "income_tax": "4.00",
                "net_profit": "96.00"
            },
            "payout": {
                "state": "expected",
                "ready_at": null
            },
            "timeline": [
                {
                    "status": "order_pending",
                    "label": "الطلب معلق",
                    "at": "2026-10-08T13:00:00+03:00",
                    "reason": null
                },
                {
                    "status": "order_confirmed",
                    "label": "أكد العميل الطلب وجاري توفيره",
                    "at": "2026-10-08T15:12:00+03:00",
                    "reason": null
                }
            ],
            "created_at": "2026-10-08T13:00:00+03:00",
            "updated_at": "2026-10-08T15:12:00+03:00",
            "confirmed_at": "2026-10-08T15:12:00+03:00",
            "delivered_at": null
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 25,
        "total": 57,
        "last_page": 3
    }
}

curl "https://thseen.com/api/v1/orders/1543" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
    "data": {
        "id": 1543,
        "number": "EG-7K3P9X2Q",
        "external_reference": "WC-10425",
        "tracking_url": null,
        "status": {
            "key": "order_confirmed",
            "label": "أكد العميل الطلب وجاري توفيره"
        },
        "family": "confirmed",
        "customer": {
            "name": "منى أحمد",
            "phone": "01012345678",
            "second_phone": null,
            "address": "مدينة نصر، شارع عباس العقاد، عمارة 12، الدور 3",
            "governorate": {
                "id": 2,
                "name": "القاهرة"
            }
        },
        "shipping_option": {
            "id": 1,
            "name": "توصيل عادي"
        },
        "lines": [
            {
                "id": 9001,
                "variant_id": 731,
                "product_id": 118,
                "title": "سماعة بلوتوث لاسلكية",
                "variant_label": "أسود",
                "quantity": 2,
                "delivered_quantity": null,
                "returned_quantity": null,
                "damaged_quantity": 0,
                "lost_quantity": 0,
                "destroyed_quantity": 0,
                "sell_price": "295.00",
                "profit": "50.00",
                "commission_on": true,
                "warranties": [
                    {
                        "id": 2,
                        "name": "ضمان استبدال",
                        "unit_price": "38.85",
                        "quantity": 2,
                        "total": "77.70",
                        "duration_days": 30,
                        "terms": "- استبدال بنفس المنتج خلال 30 يوم من الاستلام.\n- المنتج في علبته الأصلية بكل مشتملاته."
                    }
                ]
            }
        ],
        "totals": {
            "products": "590.00",
            "warranties": "77.70",
            "delivery_charge": "67.30",
            "customer_total": "735.00",
            "profit": "100.00",
            "income_tax_percent": "4",
            "income_tax": "4.00",
            "net_profit": "96.00"
        },
        "payout": {
            "state": "expected",
            "ready_at": null
        },
        "timeline": [
            {
                "status": "order_pending",
                "label": "الطلب معلق",
                "at": "2026-10-08T13:00:00+03:00",
                "reason": null
            },
            {
                "status": "order_confirmed",
                "label": "أكد العميل الطلب وجاري توفيره",
                "at": "2026-10-08T15:12:00+03:00",
                "reason": null
            }
        ],
        "created_at": "2026-10-08T13:00:00+03:00",
        "updated_at": "2026-10-08T15:12:00+03:00",
        "confirmed_at": "2026-10-08T15:12:00+03:00",
        "delivered_at": null
    }
}

curl -X POST "https://thseen.com/api/v1/orders/1543/cancel" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "reason_note": "العميل غيّر رأيه"
}'

{
    "data": {
        "id": 1543,
        "number": "EG-7K3P9X2Q",
        "external_reference": "WC-10425",
        "tracking_url": null,
        "status": {
            "key": "rejected_by_Marketer",
            "label": "تم الإلغاء من المسوق"
        },
        "family": "cancelled",
        "customer": {
            "name": "منى أحمد",
            "phone": "01012345678",
            "second_phone": null,
            "address": "مدينة نصر، شارع عباس العقاد، عمارة 12، الدور 3",
            "governorate": {
                "id": 2,
                "name": "القاهرة"
            }
        },
        "shipping_option": {
            "id": 1,
            "name": "توصيل عادي"
        },
        "lines": [
            {
                "id": 9001,
                "variant_id": 731,
                "product_id": 118,
                "title": "سماعة بلوتوث لاسلكية",
                "variant_label": "أسود",
                "quantity": 2,
                "delivered_quantity": null,
                "returned_quantity": null,
                "damaged_quantity": 0,
                "lost_quantity": 0,
                "destroyed_quantity": 0,
                "sell_price": "295.00",
                "profit": "50.00",
                "commission_on": true,
                "warranties": [
                    {
                        "id": 2,
                        "name": "ضمان استبدال",
                        "unit_price": "38.85",
                        "quantity": 2,
                        "total": "77.70",
                        "duration_days": 30,
                        "terms": "- استبدال بنفس المنتج خلال 30 يوم من الاستلام.\n- المنتج في علبته الأصلية بكل مشتملاته."
                    }
                ]
            }
        ],
        "totals": {
            "products": "590.00",
            "warranties": "77.70",
            "delivery_charge": "67.30",
            "customer_total": "735.00",
            "profit": "100.00",
            "income_tax_percent": "4",
            "income_tax": "4.00",
            "net_profit": "96.00"
        },
        "payout": {
            "state": "expected",
            "ready_at": null
        },
        "timeline": [
            {
                "status": "order_pending",
                "label": "الطلب معلق",
                "at": "2026-10-08T13:00:00+03:00",
                "reason": null
            },
            {
                "status": "order_confirmed",
                "label": "أكد العميل الطلب وجاري توفيره",
                "at": "2026-10-08T15:12:00+03:00",
                "reason": null
            }
        ],
        "created_at": "2026-10-08T13:00:00+03:00",
        "updated_at": "2026-10-08T15:12:00+03:00",
        "confirmed_at": "2026-10-08T15:12:00+03:00",
        "delivered_at": null
    }
}

curl "https://thseen.com/api/v1/wallet" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
    "data": {
        "side": "marketer",
        "currency": "EGP",
        "income_tax_percent": "4",
        "ready": "1520.50",
        "held": {
            "amount": "390.25",
            "next_ready_at": "2026-10-12T14:20:00+03:00"
        },
        "expected": "2210.00",
        "referral": {
            "percent": "2",
            "earned": "64.10",
            "expected": "12.40"
        },
        "received": "8350.00",
        "total_commission": "10370.50",
        "pending_withdrawals": {
            "count": 1,
            "amount": "500.00",
            "items": [
                {
                    "id": 311,
                    "amount": "500.00",
                    "supply_amount": "0.00",
                    "status": {
                        "key": "pending",
                        "label": "قيد التحويل"
                    },
                    "wallet_number": "01012345678",
                    "wallet_description": "محفظة موبايل",
                    "notes": null,
                    "transfer_reference": null,
                    "receipt_url": null,
                    "created_at": "2026-10-07T11:30:00+03:00",
                    "decided_at": null
                }
            ]
        },
        "withdrawal": {
            "open": false,
            "days": [
                "sunday",
                "thursday"
            ],
            "timezone": "Africa/Cairo",
            "opens_at": "2026-10-22T00:00:00+03:00",
            "closes_at": "2026-10-23T00:00:00+03:00",
            "minimum": "50.00",
            "minimum_currency": "EGP",
            "note": "يُتاح سحب الأرباح يومَي الأحد والخميس من كل أسبوع بتوقيت القاهرة."
        }
    }
}