Menü

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

  1. készítsen el egy alábbi dokumentációnak és példának megfelelő JSON fájlt a szinkronizálandó termékeiről
  2. 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
  3. 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)
  4. vegye fel a kapcsolatot velünk, eljuttatva a JSON fájl URL-jét is
  5. 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 4: 11030
        • iPhone 4: 11031
        • iPhone 4S: 11032
      • iPhone 5: 11040
        • iPhone 5: 11041
        • iPhone 5C: 11042
        • iPhone 5S: 11043
      • iPhone 6: 11050
        • iPhone 6: 11051
        • iPhone 6 Plus: 11052
        • iPhone 6S: 11053
        • iPhone 6S Plus: 11054
      • iPhone SE: 11060
        • iPhone SE 2016 (1. gen.): 11061
        • iPhone SE 2020 (2. gen.): 11062
        • iPhone SE 2022 (3. gen.): 11063
      • iPhone 7: 11070
        • iPhone 7: 11071
        • iPhone 7 Plus: 11072
      • iPhone 8: 11080
        • iPhone 8: 11081
        • iPhone 8 Plus: 11082
      • iPhone X: 11090
        • iPhone X: 11091
        • iPhone XR: 11092
        • iPhone XS: 11093
        • iPhone XS Max: 11094
      • iPhone 11: 11100
        • iPhone 11: 11101
        • iPhone 11 Pro: 11102
        • iPhone 11 Pro Max: 11103
      • iPhone 12: 11110
        • iPhone 12: 11111
        • iPhone 12 mini: 11112
        • iPhone 12 Pro: 11113
        • iPhone 12 Pro Max: 11114
      • iPhone 13: 11120
        • iPhone 13: 11121
        • iPhone 13 mini: 11122
        • iPhone 13 Pro: 11123
        • iPhone 13 Pro Max: 11124
      • iPhone 14: 11130
        • iPhone 14: 11131
        • iPhone 14 Plus: 11132
        • iPhone 14 Pro: 11133
        • iPhone 14 Pro Max: 11134
      • iPhone 15: 11140
        • iPhone 15: 11141
        • iPhone 15 Plus: 11142
        • iPhone 15 Pro: 11143
        • iPhone 15 Pro Max: 11144
      • iPhone 16: 11150
        • iPhone 16: 11151
        • iPhone 16 Plus: 11152
        • iPhone 16 Pro: 11153
        • iPhone 16 Pro Max: 11154
    • 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 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 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 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
    • MacBook: 13000
      • MacBook Pro: 13100
      • MacBook Air: 13200
      • MacBook Pro Retina: 13300
    • 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 Ultra: 14900
        • Apple Watch Ultra: 14901
        • Apple Watch Ultra 2: 14902
    • iMac: 15000
    • Airpods: 16000
    • TV: 17000
  • 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
  • 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
  • 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
  • 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
  • Mac
  • iMac
    • 21,5"
    • 27"
  • 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
  • Felújított
    • Renewd
      • iPhone SE 2020
      • iPhone X
  • Apple
    • TV
      • 4k 1.gen
  • Android
  • Egyéb
  • Kiegészítők