{
    "info": {
        "_postman_id": "kitobchi-client-api-v1",
        "name": "Kitobchi Client API",
        "description": "Kitobchi Client & Affiliate API Postman Collection",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "variable": [
        {
            "key": "BASE_URL",
            "value": "https://kitobchi.com/api/v1/client",
            "type": "string"
        },
        {
            "key": "APP_ID",
            "value": "app_xxxxxxxxxxxxxxxx",
            "type": "string"
        },
        {
            "key": "APP_SECRET",
            "value": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
            "type": "string"
        }
    ],
    "item": [
        {
            "name": "Products",
            "item": [
                {
                    "name": "Bitta kitob tafsiloti",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/book/{id}",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "book",
                                "{id}"
                            ]
                        },
                        "description": "Kitobning to‘liq tavsifi, muallifi, nashriyoti, narxi, qoldig‘i va rasmlarini qaytaradi."
                    },
                    "response": []
                },
                {
                    "name": "Kanselyariya mahsuloti tafsiloti",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/stationery/{id}",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "stationery",
                                "{id}"
                            ]
                        },
                        "description": "Kanselyariya tovarining to‘liq ma’lumoti va variantlarini qaytaradi."
                    },
                    "response": []
                },
                {
                    "name": "Muallif bo‘yicha kitoblar",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/by-author/{authorId}",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "by-author",
                                "{authorId}"
                            ]
                        },
                        "description": "Muayyan muallifning barcha faol kitoblari ro‘yxatini sahifalab qaytaradi."
                    },
                    "response": []
                },
                {
                    "name": "Nashriyot bo‘yicha kitoblar",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/by-publisher/{publisherId}",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "by-publisher",
                                "{publisherId}"
                            ]
                        },
                        "description": "Muayyan nashriyotning barcha faol kitoblari ro‘yxatini sahifalab qaytaradi."
                    },
                    "response": []
                },
                {
                    "name": "Mahsulotlar ro‘yxati",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/{col}",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "{col}"
                            ]
                        },
                        "description": "Katalogdagi mahsulotlarni turi bo‘yicha sahifalab qaytaradi."
                    },
                    "response": []
                },
                {
                    "name": "Tavsiya qilingan mahsulotlar",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/recommendation/{col}",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "recommendation",
                                "{col}"
                            ]
                        },
                        "description": "Vitrina va “sizga mos” bloklari uchun tavsiya ro‘yxati."
                    },
                    "response": []
                },
                {
                    "name": "Sellerlar va oxirgi mahsulotlari",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/sellers/list",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "sellers",
                                "list"
                            ]
                        },
                        "description": "Do‘konlar ro‘yxati va har biri uchun eng so‘nggi mahsulotlar."
                    },
                    "response": []
                },
                {
                    "name": "QR orqali seller",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/sellers/by-qr/{token}",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "sellers",
                                "by-qr",
                                "{token}"
                            ]
                        },
                        "description": "QR token orqali do‘kon ma’lumotini olish."
                    },
                    "response": []
                },
                {
                    "name": "Seller profili",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/sellers/profile/{id}/{page}",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "sellers",
                                "profile",
                                "{id}",
                                "{page}"
                            ]
                        },
                        "description": "Do‘kon profili va uning sahifalangan mahsulotlari."
                    },
                    "response": []
                },
                {
                    "name": "Shtrix-kod / ISBN bo‘yicha mahsulot",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/sellers/{sellerId}/code/{code}",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "sellers",
                                "{sellerId}",
                                "code",
                                "{code}"
                            ]
                        },
                        "description": "Do‘kon ichidan shtrix-kod yoki ISBN orqali bitta mahsulotni topadi. `/isbn/{isbn}` alias ham mavjud."
                    },
                    "response": []
                }
            ]
        },
        {
            "name": "Search",
            "item": [
                {
                    "name": "Global qidiruv",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/search",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "search"
                            ]
                        },
                        "description": "Nom, muallif, kategoriya va turga qarab natija qaytaradi."
                    },
                    "response": []
                },
                {
                    "name": "Autocomplete takliflari",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/search/suggestions",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "search",
                                "suggestions"
                            ]
                        },
                        "description": "Qidiruv maydoni uchun tezkor takliflar (nom, muallif, teg)."
                    },
                    "response": []
                },
                {
                    "name": "Trend so‘rovlar",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/search/trending",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "search",
                                "trending"
                            ]
                        },
                        "description": "Oxirgi 7 kunda eng ko‘p qidirilgan so‘rovlar."
                    },
                    "response": []
                },
                {
                    "name": "Kategoriyalar",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/search/categories",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "search",
                                "categories"
                            ]
                        },
                        "description": "Katalog menyusi va filtr paneli uchun kategoriyalar ro‘yxati."
                    },
                    "response": []
                },
                {
                    "name": "Kategoriya mahsulotlari",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/search/category/{cat_id}/{type}",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "search",
                                "category",
                                "{cat_id}",
                                "{type}"
                            ]
                        },
                        "description": "Bitta kategoriya ichidagi mahsulotlarni turi bo‘yicha qaytaradi."
                    },
                    "response": []
                }
            ]
        },
        {
            "name": "Seller",
            "item": [
                {
                    "name": "Zaxirani kod bo‘yicha yangilash",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/stock/by-code",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "stock",
                                "by-code"
                            ]
                        },
                        "description": "Do‘konga bog‘langan kalit orqali ISBN (kitob) yoki shtrix-kod (kanselyariya) bo‘yicha zaxirani o‘rnatadi (`stock`) yoki o‘zgartiradi (`delta`). `stock:write` ability va seller-scoped kalit talab qilinadi.",
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"code\": \"9781847941831\",\n    \"stock\": 25\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        }
                    },
                    "response": []
                },
                {
                    "name": "Mening mahsulotlarim",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/products/mine",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "products",
                                "mine"
                            ]
                        },
                        "description": "Kalitga bog‘langan do‘konning mahsulotlari va zaxirasi (sahifalangan)."
                    },
                    "response": []
                }
            ]
        },
        {
            "name": "Deeplink",
            "item": [
                {
                    "name": "Deep Link generator",
                    "request": {
                        "method": "GET",
                        "header": [
                            {
                                "key": "X-App-ID",
                                "value": "{{APP_ID}}",
                                "type": "text"
                            },
                            {
                                "key": "X-App-Secret",
                                "value": "{{APP_SECRET}}",
                                "type": "text"
                            },
                            {
                                "key": "Accept",
                                "value": "application/json",
                                "type": "text"
                            }
                        ],
                        "url": {
                            "raw": "{{BASE_URL}}/deeplink",
                            "host": [
                                "{{BASE_URL}}"
                            ],
                            "path": [
                                "deeplink"
                            ]
                        },
                        "description": "Ilova URL schemelari (kitobchi://...), Web, Play Market va App Store havolalarini avtomatik generatsiya qiladi."
                    },
                    "response": []
                }
            ]
        }
    ]
}