Almapro.hu termék feed API dokumentáció
Ez az API egy termékeket tartalmazó JSON fájlt vár a partner webáruházától. A feedet legalább naponta egyszer szinkronizáljuk, hajnal 3 és 6 óra közötti időszakban. Jelenleg azonban minden óra 5. percében fut szinkronizáció. A feed struktúrája és használata az alábbiakban kerül bemutatásra.
Együttműködés lépései
- készítsen el egy alábbi dokumentációnak és példának megfelelő JSON fájlt a szinkronizálandó termékeiről
- biztosítsa, hogy ha új terméket szeretne hirdetni, vagy meglévőt deaktiválni (például eladásra került), akkor a változás jelentkezzen a JSON fájlban
- a JSON elérését biztosítsa egy URL-en keresztül, például a honlap tárhelyére feltöltve (például:
https://domain.hu/rss/almapro-feed.json
) - vegye fel a kapcsolatot velünk, eljuttatva a JSON fájl URL-jét is
- a feed ellenőrzése után elkészítünk és aktiválunk önnek egy kereskedői fiókot és biztosístjuk a folyamatos szinkronizációt, Önnek nincs további teendője
JSON struktúra
Az alábbiakban bemutatjuk a termékek JSON struktúráját. A feltüntetendő kategória pontos struktúrális leírását ide kattintva érheti el.
Változók leírása
Mező | Típus | Kötelező / opcionális | Maximális hossz | Leírás | Példa |
---|---|---|---|---|---|
id |
Egész szám | kötelező | A termék egyedi azonosítója a partner rendszerében | 1234 | |
subject |
Szöveg | kötelező | 128 | Az eladásra kínált termék megnevezése | Eladó újszerű fekete iPhone 19 Pro Max |
slug |
Szöveg | opcionális | 128 | A termék slug-ja a partner honlapján. | xyz-123 |
description |
Szöveg | kötelező | 1024 | A termék bővebb leírása. | Lorem ipsum dolor... |
price |
Egész szám | kötelező | 32 | A termék ára forintban | 12345689 |
external_link |
Szöveg | opcionális | 512 | A termék közvetlen linkje a partner honlapján. | https://partner.domain.hu/termek/xyz-123 |
categoryType1 |
Szöveg | kötelező | Szülőkategória (például iPhone; iPad; Watch) | ||
categoryType2 |
Szöveg | kötelező | Alkategória (például iPhone 11; SE series; Air; Galaxy) | ||
categoryType3 |
Szöveg | kötelező | Al-alkategória (például SE 2020; S10) | ||
images |
Szöveg (URL) | opcionális | A termékhez tartozó képek linkjei | ["http:\/\/domain.hu\/img\/media\/xyz_1.webp","http:\/\/domain.hu\/img\/media\/xyz-2.jpg","http:\/\/domain.hu\/img\/media\/xyz3.png"] | |
attributes |
Objektum | opcionális | A termék további attribútumai (pl. tárhely, szín, állapot) |
JSON példa
[
{
"id": 10442,
"subject": "Apple iPhone 16 PRO MAX Black szép állapotú - 12 HÓNAP GARANCIA",
"slug": "apple-iphone-16-pro-max-black-szep-allapotu-12-ho-garancia-102",
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
"price": 275000,
"external_link": "https://domain.hu/bolt/elado-apple-iphone-16-pro-max",
"categoryType1": "iPhone",
"categoryType2": "16",
"categoryType3": "Pro",
"images": [
"https://domain.hu/img/1.webp",
"https://domain.hu/img/2.png",
"https://domain.hu/img/3.jpg"
],
"attributes": {
"hattertar": "32 GB",
"szin": "Black",
"allapot": "A",
"battery": 88,
"display_status": "összességében szép"
}
},
{
"id": 10442,
"subject": "Samsung Galaxy J4 Plus 32 GB Black sz\u00e9p \u00e1llapot\u00fa - 12 H\u00d3 GARANCIA",
"slug": "elado-samsung-galaxy-j4-plus-32-gb-black-szep-allapotu-12-ho-garancia-10442",
"description": "K\u00e9sz\u00fcl\u00e9k : Samsung Galaxy J4 Plus\nAzonos\u00edt\u00f3: R8053\nT\u00e1rhely: 32 GB\nSz\u00edn: Black\n\u00c1llapot: \u00dajszer\u0171\nKijelz\u0151 \u00e1llapot: nagyon sz\u00e9p, szinte hib\u00e1tlan\nKeret \u00e1llapot: hib\u00e1tlan\nH\u00e1tlap \u00e1llapot: hib\u00e1tlan\n",
"price": 27500,
"external_link": "http:\/\/domain.hu\/marketplace\/elado-samsung-galaxy-j4-plus-32-gb-black-szep-allapotu-12-ho-garancia-10442",
"categoryType1": "Samsung",
"categoryType2": "Galaxy",
"categoryType3": "J4 Plus",
"attributes": {
"hattertar": "32 GB",
"szin": "Black",
"allapot": "\"A\"",
"battery": null,
"display_status": "\u00d6sszess\u00e9g\u00e9ben sz\u00e9p",
"frame_status": "Hib\u00e1tlan",
"backcover_status": "Hib\u00e1tlan"
}
}
]
Kategória struktúra
Az alábbi táblázat JSON formátumban elérhető itt: /api/categories.json
Főkategória | Alkategória | Al-alkategória | Al-al-alkategória | Kategória azonosító |
---|---|---|---|---|
Apple | 100000 |
|||
Apple | iPhone | 110000 |
||
Apple | iPhone | iPhone / iPhone 1 / iPhone 2G | 110100 |
|
Apple | iPhone | iPhone 3G | 110200 |
|
Apple | iPhone | iPhone 3G | iPhone 3G | 110201 |
Apple | iPhone | iPhone 3G | iPhone 3GS | 110202 |
Apple | iPhone | iPhone 4 | 110300 |
|
Apple | iPhone | iPhone 4 | iPhone 4 | 110301 |
Apple | iPhone | iPhone 4 | iPhone 4S | 110302 |
Apple | iPhone | iPhone 5 | 110400 |
|
Apple | iPhone | iPhone 5 | iPhone 5 | 110401 |
Apple | iPhone | iPhone 5 | iPhone 5C | 110402 |
Apple | iPhone | iPhone 5 | iPhone 5S | 110403 |
Apple | iPhone | iPhone 6 | 110500 |
|
Apple | iPhone | iPhone 6 | iPhone 6 | 110501 |
Apple | iPhone | iPhone 6 | iPhone 6 Plus | 110502 |
Apple | iPhone | iPhone 6 | iPhone 6S | 110503 |
Apple | iPhone | iPhone 6 | iPhone 6S Plus | 110504 |
Apple | iPhone | iPhone SE | 110600 |
|
Apple | iPhone | iPhone SE | iPhone SE 2016 (I. generáció) | 110601 |
Apple | iPhone | iPhone SE | iPhone SE 2020 (II. generáció) | 110602 |
Apple | iPhone | iPhone SE | iPhone SE 2022 (III. generáció) | 110603 |
Apple | iPhone | iPhone 7 | 110700 |
|
Apple | iPhone | iPhone 7 | iPhone 7 | 110701 |
Apple | iPhone | iPhone 7 | iPhone 7 Plus | 110702 |
Apple | iPhone | iPhone 8 | 110800 |
|
Apple | iPhone | iPhone 8 | iPhone 8 | 110801 |
Apple | iPhone | iPhone 8 | iPhone 8 Plus | 110802 |
Apple | iPhone | iPhone X | 110900 |
|
Apple | iPhone | iPhone X | iPhone X | 110901 |
Apple | iPhone | iPhone X | iPhone XR | 110902 |
Apple | iPhone | iPhone X | iPhone XS | 110903 |
Apple | iPhone | iPhone X | iPhone XS Max | 110904 |
Apple | iPhone | iPhone 11 | 111000 |
|
Apple | iPhone | iPhone 11 | iPhone 11 | 111001 |
Apple | iPhone | iPhone 11 | iPhone 11 Pro | 111002 |
Apple | iPhone | iPhone 11 | iPhone 11 Pro Max | 111003 |
Apple | iPhone | iPhone 12 | 111100 |
|
Apple | iPhone | iPhone 12 | iPhone 12 | 111101 |
Apple | iPhone | iPhone 12 | iPhone 12 mini | 111102 |
Apple | iPhone | iPhone 12 | iPhone 12 Pro | 111103 |
Apple | iPhone | iPhone 12 | iPhone 12 Pro Max | 111104 |
Apple | iPhone | iPhone 13 | 111200 |
|
Apple | iPhone | iPhone 13 | iPhone 13 | 111201 |
Apple | iPhone | iPhone 13 | iPhone 13 mini | 111202 |
Apple | iPhone | iPhone 13 | iPhone 13 Pro | 111203 |
Apple | iPhone | iPhone 13 | iPhone 13 Pro Max | 111204 |
Apple | iPhone | iPhone 14 | 111300 |
|
Apple | iPhone | iPhone 14 | iPhone 14 | 111301 |
Apple | iPhone | iPhone 14 | iPhone 14 Plus | 111302 |
Apple | iPhone | iPhone 14 | iPhone 14 Pro | 111303 |
Apple | iPhone | iPhone 14 | iPhone 14 Pro Max | 111304 |
Apple | iPhone | iPhone 15 | 111400 |
|
Apple | iPhone | iPhone 15 | iPhone 15 | 111401 |
Apple | iPhone | iPhone 15 | iPhone 15 Plus | 111402 |
Apple | iPhone | iPhone 15 | iPhone 15 Pro | 111403 |
Apple | iPhone | iPhone 15 | iPhone 15 Pro Max | 111404 |
Apple | iPhone | iPhone 16 | 111500 |
|
Apple | iPhone | iPhone 16 | iPhone 16 | 111501 |
Apple | iPhone | iPhone 16 | iPhone 16 Plus | 111502 |
Apple | iPhone | iPhone 16 | iPhone 16 Pro | 111503 |
Apple | iPhone | iPhone 16 | iPhone 16 Pro Max | 111504 |
Apple | iPad | 120000 |
||
Apple | iPad | iPad | 120100 |
|
Apple | iPad | iPad | iPad (1. generáció) | 120101 |
Apple | iPad | iPad | iPad 2 | 120102 |
Apple | iPad | iPad | iPad 3 | 120103 |
Apple | iPad | iPad | iPad 4 | 120104 |
Apple | iPad | iPad | iPad 5 | 120105 |
Apple | iPad | iPad | iPad 6 | 120106 |
Apple | iPad | iPad | iPad 7 | 120107 |
Apple | iPad | iPad | iPad 8 | 120108 |
Apple | iPad | iPad | iPad 9 | 120109 |
Apple | iPad | iPad | iPad 10 | 120110 |
Apple | iPad | iPad mini | 120200 |
|
Apple | iPad | iPad mini | iPad mini (1. generáció) | 120201 |
Apple | iPad | iPad mini | iPad mini 2 | 120202 |
Apple | iPad | iPad mini | iPad mini 3 | 120203 |
Apple | iPad | iPad mini | iPad mini 4 | 120204 |
Apple | iPad | iPad mini | iPad mini 5 | 120205 |
Apple | iPad | iPad mini | iPad mini 6 | 120206 |
Apple | iPad | iPad mini | iPad mini 7 | 120207 |
Apple | iPad | iPad Air | 120300 |
|
Apple | iPad | iPad Air | iPad Air (1. generáció) | 120301 |
Apple | iPad | iPad Air | iPad Air 2 | 120302 |
Apple | iPad | iPad Air | iPad Air 3 | 120303 |
Apple | iPad | iPad Air | iPad Air 4 | 120304 |
Apple | iPad | iPad Air | iPad Air 5 | 120305 |
Apple | iPad | iPad Air | iPad Air 6 | 120306 |
Apple | iPad | iPad Pro | 120400 |
|
Apple | iPad | iPad Pro | iPad Pro (1. generáció) | 120401 |
Apple | iPad | iPad Pro | iPad Pro 2 | 120402 |
Apple | iPad | iPad Pro | iPad Pro 3 | 120403 |
Apple | iPad | iPad Pro | iPad Pro 4 | 120404 |
Apple | iPad | iPad Pro | iPad Pro 5 | 120405 |
Apple | iPad | iPad Pro | iPad Pro 6 | 120406 |
Apple | iPad | iPad Pro | iPad Pro 7 | 120407 |
Apple | MacBook | 130000 |
||
Apple | MacBook | MacBook Pro | 130100 |
|
Apple | MacBook | MacBook Air | 130200 |
|
Apple | MacBook | MacBook Pro Retina | 130300 |
|
Apple | Watch | 140000 |
||
Apple | Watch | Watch 1 | 140100 |
|
Apple | Watch | Watch 2 | 140200 |
|
Apple | Watch | Watch 3 | 140300 |
|
Apple | Watch | Watch 4 | 140400 |
|
Apple | Watch | Watch 5 | 140500 |
|
Apple | Watch | Watch 6 | 140600 |
|
Apple | Watch | Watch 7 | 140700 |
|
Apple | Watch | Watch 8 | 140800 |
|
Apple | Watch | Watch 9 | 140900 |
|
Apple | Watch | Watch 10 | 141000 |
|
Apple | Watch | Watch SE | 141100 |
|
Apple | Watch | Watch SE | Watch SE 1 | 141101 |
Apple | Watch | Watch SE | Watch SE 2 | 141102 |
Apple | Watch | Watch SE | Watch SE 3 | 141103 |
Apple | Watch | Watch Ultra | 141200 |
|
Apple | Watch | Watch Ultra | Watch Ultra | 141201 |
Apple | Watch | Watch Ultra | Watch Ultra 2 | 141202 |
Apple | iMac | 150000 |
||
Apple | Airpods | 160000 |
||
Apple | TV | 170000 |
||
Android | 200000 |
|||
Samsung | 300000 |
|||
Kiegészítők | 800000 |
|||
Egyéb | 900000 |
Korábbi kategória struktúra
Kategória struktúra
- Apple:
10000
- iPhone:
11000
- iPhone / iPhone 1 / iPhone 2G:
11010
- iPhone 3G:
11020
- iPhone 3G:
11021
- iPhone 3GS:
11022
- iPhone 3G:
- iPhone 4:
11030
- iPhone 4:
11031
- iPhone 4S:
11032
- iPhone 4:
- iPhone 5:
11040
- iPhone 5:
11041
- iPhone 5C:
11042
- iPhone 5S:
11043
- iPhone 5:
- iPhone 6:
11050
- iPhone 6:
11051
- iPhone 6 Plus:
11052
- iPhone 6S:
11053
- iPhone 6S Plus:
11054
- iPhone 6:
- iPhone SE:
11060
- iPhone SE 2016 (1. gen.):
11061
- iPhone SE 2020 (2. gen.):
11062
- iPhone SE 2022 (3. gen.):
11063
- iPhone SE 2016 (1. gen.):
- iPhone 7:
11070
- iPhone 7:
11071
- iPhone 7 Plus:
11072
- iPhone 7:
- iPhone 8:
11080
- iPhone 8:
11081
- iPhone 8 Plus:
11082
- iPhone 8:
- iPhone X:
11090
- iPhone X:
11091
- iPhone XR:
11092
- iPhone XS:
11093
- iPhone XS Max:
11094
- iPhone X:
- iPhone 11:
11100
- iPhone 11:
11101
- iPhone 11 Pro:
11102
- iPhone 11 Pro Max:
11103
- iPhone 11:
- iPhone 12:
11110
- iPhone 12:
11111
- iPhone 12 mini:
11112
- iPhone 12 Pro:
11113
- iPhone 12 Pro Max:
11114
- iPhone 12:
- iPhone 13:
11120
- iPhone 13:
11121
- iPhone 13 mini:
11122
- iPhone 13 Pro:
11123
- iPhone 13 Pro Max:
11124
- iPhone 13:
- iPhone 14:
11130
- iPhone 14:
11131
- iPhone 14 Plus:
11132
- iPhone 14 Pro:
11133
- iPhone 14 Pro Max:
11134
- iPhone 14:
- iPhone 15:
11140
- iPhone 15:
11141
- iPhone 15 Plus:
11142
- iPhone 15 Pro:
11143
- iPhone 15 Pro Max:
11144
- iPhone 15:
- iPhone 16:
11150
- iPhone 16:
11151
- iPhone 16 Plus:
11152
- iPhone 16 Pro:
11153
- iPhone 16 Pro Max:
11154
- iPhone 16:
- iPhone / iPhone 1 / iPhone 2G:
- iPad:
12000
- iPad:
12100
- iPad (1. gen.):
12101
- iPad 2:
12102
- iPad (3. gen.):
12103
- iPad (4. gen.):
12104
- iPad (5. gen.):
12105
- iPad (6. gen.):
12106
- iPad (7. gen.):
12107
- iPad (8. gen.):
12108
- iPad (9. gen.):
12109
- iPad (10. gen.):
12110
- iPad (1. gen.):
- iPad mini:
12200
- iPad mini:
12201
- iPad mini 2:
12202
- iPad mini 3:
12203
- iPad mini 4:
12204
- iPad mini 5:
12205
- iPad mini 6:
12206
- iPad mini 7:
12207
- iPad mini:
- iPad Air:
12300
- iPad Air:
12301
- iPad Air 2:
12302
- iPad Air (3. gen.):
12303
- iPad Air (4. gen.):
12304
- iPad Air (5. gen.):
12305
- iPad Air (6. gen.):
12306
- iPad Air:
- iPad Pro:
12400
- iPad Pro:
12401
- iPad Pro 2:
12402
- iPad Pro (3. gen.):
12403
- iPad Pro (4. gen.):
12404
- iPad Pro (5. gen.):
12405
- iPad Pro (6. gen.):
12406
- iPad Pro (7. gen.):
12407
- iPad Pro:
- iPad:
- MacBook:
13000
- MacBook Pro:
13100
- MacBook Air:
13200
- MacBook Pro Retina:
13300
- MacBook Pro:
- Apple Watch:
14000
- Apple Watch 5:
14200
- Apple Watch 6:
14300
- Apple Watch 7:
14400
- Apple Watch 8:
14500
- Apple Watch 9:
14600
- Apple Watch 10:
14700
- Apple Watch SE:
14800
- Apple Watch SE 1:
14801
- Apple Watch SE 2:
14802
- Apple Watch SE 3:
14803
- Apple Watch SE 1:
- Apple Watch Ultra:
14900
- Apple Watch Ultra:
14901
- Apple Watch Ultra 2:
14902
- Apple Watch Ultra:
- Apple Watch 5:
- iMac:
15000
- Airpods:
16000
- TV:
17000
- iPhone:
- Android:
20000
- Samsung:
30000
- Android:
20000
- Kiegészítők:
80000
- Egyéb:
90000
-
iPhone
-
SE series
- SE 2016
- SE 2020
-
6
- Plus
-
6s
- Plus
-
7 series
- 7
- 7 Plus
-
8 series
- 8
- 8 Plus
-
X series
- X
- XR
- XS
- XS Max
-
11 series
- 11
- 11 Pro
- 11 Pro Max
-
12 series
- 12 Mini
- 12
- 12 Pro
- 12 Pro Max
-
13 series
- 13
- 13 Pro
- 13 Pro Max
- 13 Mini
-
4
-
4S
-
5
-
5S
-
5C
-
14 series
- 14 Pro
- 14
- 14 Plus
- 14 Pro Max
-
15
- Pro
- Pro Max
-
SE series
-
MacBook
-
Pro
- Retina
- 1th gen
- 5th gen
- 3th gen
- 5th gen
- 4th gen
- 3th gen
- 2th gen
- Retina
- 4th gen
- 3th gen
- 5th gen
- 1th gen
- 2th gen
-
PRO
-
Pro
-
Watch
-
S5
-
S6
- edge
-
SE
- (2022)
- 2th gen
- Nike
-
S7
- Nike
- 45MM (Model:A2474)
- active
-
S8
-
S4
- Nike
-
S3
- Nike
-
S1
-
Ultra
-
5 Pro
-
5
-
S5
-
iPad
-
Air
- 1th gen
- 2th gen
- Retina
- 1th gen
- 1th gen
- 2th gen
- 3th gen
- 3th gen
- 5th Wifi+Cellular (A2589)
- 2th gen
- 2th gen
- 4th gen
- 4th gen
-
Mini
- 2th gen
- 5th gen
- Intel i7 4gb RAM 2012 Late (A1347)
- 2th gen
- 2th gen
- 4th gen
- 2 Cellular
- 2 Wifi+Cellular (A1490)
- 4th gen
- 6th gen
- 4th gen
-
6th gen
-
8th gen
-
7th gen
-
9,7"
- Wifi (Model:A1219) 2010
-
9th gen
-
6th gen
-
Air
-
Mac
-
iMac
-
21,5"
-
27"
-
21,5"
-
Samsung
-
Galaxy
- A5 2015
- A40
- Note 20
- A70
- A71
- Note
- Note 20 Ultra
- S9
- S8 PLUS
- S10e
- Tab
- A12
- S8
- A52S
- S22 Ultra
- S21
- S21 Plus
- Alpha
- Z
- S20
- S20 Ultra
- A51
- Grand
- S10 Lite
- S20 FE
- A3 2017
- S20
- A10
- A3
- S10
- A50
- A52 5G
- J3 2017
- J5 2017
- Note 10 PLUS
- A32 5G
- S10 Plus
- S9 Plus
- A20 E
- A40
- XCover 4S
- S10
- Z Fold 4
- S21 FE
- S22
- A22 5G
- A02S
- A04s
- S23 Ultra
- S23 Plus
- S23
- S22 Plus
- S21 Ultra
- S20 Plus
- S10 E
- Note 9
- Note 8
- Note 10
- A13 4G
- A13 5G
- A14 4G
- A14 5G
- A20 S
- A21 S
- A22 4G
- A32 4G
- A23 5G
- A30S
- A31
- A33 5G
- A34 5G
- A41
- A42 5G
- A52 4G
- A53 5G
- A54 5G
- Fold 5
- Watch 4
- A72
- A73 5G
- A3 2015
- J1 2016
- J3 2016
- J4
- J4 Plus
- J5 2015
- J5 2016
- J6 2018
- J6 Plus
- J7 2016
- J7 2017
- M21S
- M22
- M23 5G
- M32
- Watch 4 Classic
- M33 5G
- M51
- M52 5G
- M53 5G
- J1 2015
- A3 2016
- A5 2016
- A5 2017
- A6 2018
- A6 Plus
- A7 2018
- A8 2018
- A80
- A9 2018
- Watch
- Buds 2
- A
- A Series
-
Galaxy
-
Felújított
-
Renewd
- iPhone SE 2020
- iPhone X
-
Renewd
-
Apple
-
TV
- 4k 1.gen
-
TV
-
Android
-
Egyéb
-
Kiegészítők