Cette API expose uniquement les ressources utiles au projet : catégories et produits. Le format par défaut reste compatible avec le dashboard, et un format ressource stable est disponible pour les services externes.
Authorization.goods_id stable et unique par dataset.source_url et category_url privilégiés pour le matching.| OpenAPI | /api/openapi.json |
|---|---|
| Catégories | /api/categories |
| Produit | /api/products/{goods_id} |
| Auth | Authorization: Bearer <token> |
| Version | 1.0.2 |
Liste les catégories dans un format stable.
{
"dataset": {"id": "shein", "label": "Shein Bright Data sample"},
"data": [
{
"name": "Dresses",
"slug": "dresses",
"top_category_name": "Dresses",
"source_url": "https://...",
"image_url": "https://..."
}
],
"pagination": {"page": 1, "pageSize": 100, "total": 502, "totalPages": 6}
}
Retourne une seule catégorie.
{
"dataset": {...},
"data": {
"name": "Dresses",
"slug": "dresses",
"source_url": "https://..."
}
}
Liste les produits. Utilise format=resource pour le schéma externe.
{
"dataset": {...},
"data": [
{
"goods_id": "shein:123",
"goods_sn": "123",
"spu": "123",
"name": "Long Dress",
"retail_price": "10.49",
"sale_price": "10.49",
"images": ["https://..."],
"attributes": [{"name": "brand", "value": "SHEIN"}]
}
],
"pagination": {...},
"categories": [...]
}
Retourne un produit unique par identifiant stable.
{
"dataset": {...},
"data": {
"goods_id": "shein:123",
"category_url": "http://host/api/categories/dresses?dataset=shein",
"product_url": "https://..."
}
}
| dataset | shein ou asos |
|---|---|
| page | Pagination, commence à 1 |
| pageSize | Jusqu’à 200 |
| search | Recherche texte |
| category | Filtre catégorie |
| imagesOnly | true/false |
| sort | relevance, price-asc, price-desc, rating-desc, reviews-desc, name-asc |
| format | legacy ou resource |
Tu peux aussi lire la spec brute via /api/openapi.json.