Affiliated Items

This guide explains how to interact with the Affiliated Items API endpoints in the Sumaya369 web application. These endpoints allow affiliate marketers to retrieve their affiliated items and links.

List Affiliated Items

Retrieve a list of items available for affiliate marketing along with their usage statistics and affiliate links.

Endpoint

• Method: GET
• URL: /v1/customer/affiliated-items

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer token	Yes

Query Parameters

Parameter	Type	Description	Required
search_text	string	Filter items by name	No

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "affiliated_link": "https://testing-storefront.sumaya369.net/?ref=sumaya_content",
        "affiliated_items": [
            {
                "id": "d32c6190-b67a-11ec-955e-b940e5a4bde1",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/16187/%D8%A7%D9%84%D8%AB%D9%82%D8%A9-%D8%A8%D8%A7%D9%84%D9%86%D9%81%D8%B3.png",
                "type": "course",
                "name": "الثقة بالنفس  ( العار )",
                "price": 95.65,
                "uses": 0,
                "link": "https://testing-storefront.sumaya369.net/materials/d32c6190-b67a-11ec-955e-b940e5a4bde1?ref=sumaya_content"
            },
            {
                "id": "6a9a3cd0-6f1c-11ed-b3bb-b7db1a5a5fb4",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/6018/%D8%A7%D9%84%D9%8A%D8%A3%D8%B3.png",
                "type": "course",
                "name": "اليأس",
                "price": 290.44,
                "uses": 0,
                "link": "https://testing-storefront.sumaya369.net/materials/6a9a3cd0-6f1c-11ed-b3bb-b7db1a5a5fb4?ref=sumaya_content"
            },
            {
                "id": "ef9b1d00-b67a-11ec-b5e0-ffb2af260487",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/745/3f8d8748--%D8%A7%D9%84%D9%81%D9%88%D8%B6%D9%89-2021-%D9%85%D9%88%D9%82%D8%B9.png",
                "type": "course",
                "name": "طاقة الفوضى",
                "price": 60,
                "uses": 0,
                "link": "https://testing-storefront.sumaya369.net/materials/ef9b1d00-b67a-11ec-b5e0-ffb2af260487?ref=sumaya_content"
            },
            {
                "id": "d1d32030-b67a-11ec-b8eb-3137cf020f28",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/618/%D8%A7%D9%84%D8%AE%D9%88%D9%81-%D8%AC%D8%AF%D9%8A%D8%AF-%D9%85%D9%88%D9%82%D8%B9.png",
                "type": "course",
                "name": "الخوف",
                "price": 240,
                "uses": 0,
                "link": "https://testing-storefront.sumaya369.net/materials/d1d32030-b67a-11ec-b8eb-3137cf020f28?ref=sumaya_content"
            },
            {
                "id": "eed201c0-b67a-11ec-b65b-7d2fd5d62143",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/744/cd295fc8--%D8%A7%D9%84%D8%AC%D8%B0%D8%A8-2021-%D9%85%D9%88%D9%82%D8%B9.png",
                "type": "course",
                "name": "قانون الجذب",
                "price": 60,
                "uses": 0,
                "link": "https://testing-storefront.sumaya369.net/materials/eed201c0-b67a-11ec-b65b-7d2fd5d62143?ref=sumaya_content"
            },
            {
                "id": "6527fff0-fdf0-11ed-937d-057750dd123c",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/22670/3--%D8%A7%D9%84%D8%AD%D9%8A%D8%A7%D8%AF.png",
                "type": "course",
                "name": "الحياد",
                "price": 290.44,
                "uses": 1,
                "link": "https://testing-storefront.sumaya369.net/materials/6527fff0-fdf0-11ed-937d-057750dd123c?ref=sumaya_content"
            },
        ]
    },
    "status_code": 200
}

Implementation Flow

1. Authenticate with valid customer token
2. Call the endpoint to retrieve affiliated items
3. Use the returned links for affiliate marketing
4. Track usage through the 'uses' count

Key Considerations

• Authentication is required
• Links are automatically generated with the affiliate's username
• Usage statistics are tracked per item
• Items can be filtered using the search parameter
• Response includes both individual item links and a main affiliate link