recommender.ir v2.6 Cheat Sheet

5
API ﺧﻮ ﻓﺮ ﺳﺮﻫﻨﻤﺎ - 2 ﻮﺳﺖEndpoint HTTP Params Sample Request Sample Response ( ﺸﺘﺮ) ﺗﻮﺿG D acceleratedItemsAdd GET /acceleratedItemsAdd/item20/item67/item59 ["Accelerated Items":["item20","item59","item67"]] ﺸﺘﺮ(ﻧﻤﺎ/ﻓﺮ) ﻋﺮﺿﻪ ﺷﺘﺎﺑﺪﻫﺴﺖ ﺑﻪﺘﻢ ﻓﺰ G D acceleratedItemsList GET /acceleratedItemsList ["Accelerated Items":["item20","item59","item67"]] ﺸﺘﺮ ﻫﺴﺘﻨﺪ ﺷﺘﺎ ﺗﺤﺖ ﺘﻢﻫﺎ ﻧﻤﺎG D acceleratedItemsRemove GET /acceleratedItemsRemove/item67 ["Accelerated Items":["item20","item59"]] ﺸﺘﺮ ﺷﺘﺎﺑﺪﻫﺴﺖ ﺘﻢﻫﺎ ﺣﺪB D allItems GET /allItems [item12,item60,item01, …,item95] (ﻧﺪ ﮔﺮﻓﺘﻪ ﻗﺮﻨﻪ ﭘﺮ ﻣﻮ ﻧﻬﺎ) ﺘﻢﻫﺎ ﺗﻤﺎ ﻧﻤﺎB D allUsers GET /allUsers [1439411087705833,1439411087705834, … ,1437079100128154] (ﻧﺪ ﮔﺮﻓﺘﻪ ﻗﺮﻨﻪ ﭘﺮ ﻣﻮ ﻧﻬﺎ) ﺑﺮ ﺗﻤﺎ ﻧﻤﺎS D because GET /because/53363/item18 [["item67",0.20823988],["item68",0.1966852],["item24",0.19152178],["item84", 0.023919692]] ﺑﺮ ﺑﻪﺘﻢ ﺸﻨﻬﺎ ﭼﺮ ﻧﻤﺎS D currentMood GET fresh /currentMood/1442088759755854 [["item98",1.0],["item94",1.0],["item51",1.0],["item35",1.0],["item91",1.0],["item24",1.0], ["item86",1.0],["item26",0.6131483],["item33",0.45875573],["item08",0.4478908], ["item47",0.41864693],["item62",0.4014793],["item72",0.39807698],["item78", 0.3872042],["item11",0.3664694],["item51",0.3422646],["item69",0.33165655]] ﺳﺖ ﺷﺘﻪ ﺟﻌﻪ ﻣﺮﻧﻬﺎ ﺑﻪﺑﺮ ﺘﻢﻫﺎ ﺗﺮ ﻣﺤﺒﻮﺘﻢﻫﺎ ﺸﺘﺮG C disinterest GET /disinterest/1441746820592613/item10/item21/ item56 [["item21",0.60017335],["item56",-0.02231534],["item10",-0.24618937]] ( ﺑﺒ interest) (ﻧﻔﺮ) ﻋﻼﻗﻪ ﻋﺪﺳﺎ ﺑﺮﺘﻢﻫﺎ ﺳﺎ ﻣﺮﺗﺐﺸﺘﺮG D estimateAudienceProfiles GET fresh /estimateAudienceProfiles/item22/ [["userId":"-1","gender":"m","birthYear":"1981"], ["userId":"-1","gender":"f","birthYear":"1985"]] ﺳﻦ ﺟﻨﺴ ﻧﻈﺮ ﺘﻢ ﻣﺨﺎﻃﺐ ﺟﺎﻣﻌﻪ ﺗﺨﻤﺸﺘﺮG D estimateUserMajorityProfile GET /estimateUserMajorityProfile/1436635367727933 [["userId":"-1","gender":"m","birthYear":"1980"]] ﺸﺘﺮ.ﺑﺮ ﺳﻦ ﺟﻨﺴ ﺗﺨﻤG D fastRecommend GET fresh /fastRecommend/53363 [["item34",0.36695516],["item22",0.22838621],["item35",0.15942049],["item45", 2.459468E-4],["item41",-0.077491485]] ﻣﻌﺮﻓfreshItemsAdd ﻣﺘﺪ ﺗﻮﺳﻂ ﺟﺪﺎﻻﻫﺎ ﻓﻬﺮﺳﺖﻨﺪ ﻣﺮﺗﺐ ﻋﻼﻗﻤﻨﺪ ﺑﺮ ﻓﻌﺎﻟﺧﺮ ﺳﺎ ﺑﺮ ﺷﺪG D fastStart GET /fastStart/item84,item85,item86,item88/item10,200/ item21,50 [["item84",0.036399312],["item86",0.01302167],["item85",-0.027945817], ["item88",-0.09022728]] . ﺟﺪﺑﺮ ﻋﻼﻗﻪﺳﺎ ﺑﺮ ﺟﺪﺘﻢﻫﺎ ﻣﺮﺗﺐﺳﺎ. ﺷﺪ ﻣﺮﺗﺐ ﻓﻬﺮﺳﺖ21 10 ﺘﻢﻫﺎ ﺳﺎ ﺑﺮ ﺗﻨﻬﺎﺸﺘﺮB D fetchingTrustedMachinesAdd GET /fetchingTrustedMachinesAdd/1.2.3.4 ["Fetching Trusted Machines":["1.2.3.4","0.0.0.0"]] . ﭘﺮﺳﺶﺟﺮ ﺑﻪ ﻣﺠﺎ ﻓﻬﺮﺳﺖ ﺑﻪ ﻣﺎﺷIP ﻓﺰ B D fetchingTrustedMachinesList GET /fetchingTrustedMachinesList [“Fetching Trusted Machines”:["1.2.3.4","0.0.0.0"]] .ﻨﻨﺪ ﺟﺮ ﭘﺮﺳﺶﻧﺪ ﺟﺎ ﻦﻫﺎ ﻣﺎﺷ ﻓﻬﺮﺳﺖB D fetchingTrustedMachinesRemove GET /fetchingTrustedMachinesRemove/1.2.3.4/ ["Fetching Trusted Machines":["0.0.0.0"]] . ﭘﺮﺳﺶﺟﺮ ﺑﻪ ﻣﺠﺎ ﻓﻬﺮﺳﺖ ﻣﺎﺷ ﺣﺬB C forget GET remember=1 list /forget/item22/item23/item24 .ﺳﺖ ﺷﺪ ﻣﻨﻘﻀ ﺴﺖ ﻣﻮﺟﻮ ﺘﻤ ﺳﭙﺮﻣﻮﺷ ﻓﺮ ﺑﻪﺳﺘﻔﺎ list ﻣﺘﺮ ﭘﺎ ﺷﺪﻣﻮ ﻓﺮﺘﻢﻫﺎ ﻓﻬﺮﺳﺖ ﻣﺸﺎﻫﺪ ﺑﺮ. ﺳﺘﻔﺎ remember ﻣﺘﺮ ﭘﺎ ، ﺧﺎﻃﺮ ﺑﻪ ﺑﺮ ﺸﺘﺮD freshItemsAdd GET /freshItemsAdd/item22/item41/item34/item35/item45 ["Fresh Items”:["item41","item35","item34","item45","item22"]] ﺟﺪﺘﻢﻫﺎ ﻓﻬﺮﺳﺖ ﺑﻪﺘﻢ ﻓﺰ D freshItemsList GET /freshItemsList ["Fresh Items":["item41","item35","item34","item45","item22"]] ﺟﺪ ﻓﻬﺮﺳﺖﺘﻢﻫﺎ ﻣﺸﺎﻫﺪP L of 1 5 recommender.ir Version 2.6 2016 recommender.ir User Experience Excellence . ﻣﻄﺎﻟﻌﻪ ﺟﺪﻧﺘﻬﺎ ﻫﻨﻤﺎ ﺷﺮA ﺳﻄﺢ ﺑﺎ ﺑﺮ ﺑﻬﺮ ﭘﻠﻦﻫﺎGold Silver Bronze . ﺟﻌﻪ ﻣﺮ2.6 ﻧﺴﺨﻪ ﻓﻨﻫﻨﻤﺎ ﺑﻪ ﻣﺘﺪﻫﺎﺧﻮ ﻓﺮ ﺟﺰﺋ ﻣﻄﺎﻟﻌﻪ ﺑﺮ

Transcript of recommender.ir v2.6 Cheat Sheet

API‌ پيیوست 2 - ررااهنمايییي سريیع فرااخواانيی

P   L Endpoint HTTP Params Sample Request Sample Response توضيیح (رروويییي بيیشتر كکليیكک كکنيید)

G D acceleratedItemsAdd GET /acceleratedItemsAdd/item20/item67/item59 ["Accelerated Items":["item20","item59","item67"]] اافزووددنن آآيیتم به ليیست شتابدهيی ددرر عرضه (فرووشش/نمايیش…) بيیشتر

G D acceleratedItemsList GET /acceleratedItemsList ["Accelerated Items":["item20","item59","item67"]] نمايیش آآيیتمهايیيی كکه تحت شتاببددهيی هستند بيیشتر

G D acceleratedItemsRemove GET /acceleratedItemsRemove/item67 ["Accelerated Items":["item20","item59"]] حدفف آآيیتمها اازز ليیست شتابدهيی بيیشتر

B D allItems GET /allItems [item12,item60,item01, …,item95] نمايیش تمامم آآيیتمها (آآنها كکه مورردد پرددااززشش ززميینه قراارر گرفته ااند)

B D allUsers GET /allUsers [1439411087705833,1439411087705834, … ,1437079100128154] نمايیش تمامم كکارربراانن (آآنها كکه مورردد پرددااززشش ززميینه قراارر گرفته ااند)

S D because GET /because/53363/item18 [["item67",0.20823988],["item68",0.1966852],["item24",0.19152178],["item84",0.023919692]]

نمايیش چراايیيی پيیشنهادد يیكک آآيیتم به كکارربر

S D currentMood GET fresh /currentMood/1442088759755854 [["item98",1.0],["item94",1.0],["item51",1.0],["item35",1.0],["item91",1.0],["item24",1.0],["item86",1.0],["item26",0.6131483],["item33",0.45875573],["item08",0.4478908],["item47",0.41864693],["item62",0.4014793],["item72",0.39807698],["item78",0.3872042],["item11",0.3664694],["item51",0.3422646],["item69",0.33165655]]

تركکيیبيی اازز آآيیتمهايیيی كکه كکارربر به آآنها مرااجعه مكکررر ددااشته ااست وو آآيیتمهايییي محبوبب وويییي

بيیشتر

G C disinterest GET /disinterest/1441746820592613/item10/item21/item56

[["item21",0.60017335],["item56",-0.02231534],["item10",-0.24618937]] مرتب ساززيییي آآيیتمها بر ااساسس عدممعالقه (نفرتت) (interest رراا ببيینيید) بيیشتر

G D estimateAudienceProfiles GET fresh /estimateAudienceProfiles/item22/ [["userId":"-1","gender":"m","birthYear":"1981"],["userId":"-1","gender":"f","birthYear":"1985"]]

تخميین جامعه مخاطب يیكک آآيیتم اازز نظر جنسيیت وو سن بيیشتر

G D estimateUserMajorityProfile GET /estimateUserMajorityProfile/1436635367727933 [["userId":"-1","gender":"m","birthYear":"1980"]] تخميین جنسيیت وو سن يیكک كکارربر. بيیشتر

G D fastRecommend GET fresh /fastRecommend/53363 [["item34",0.36695516],["item22",0.22838621],["item35",0.15942049],["item45",2.459468E-4],["item41",-0.077491485]]

فهرست كکاالهايییي جديید رراا كکه توسط متد freshItemsAdd معرفيی شدهه بر ااساسس آآخريین فعاليیت كکارربر وو عالقمنديییي وويییي مرتب ميیكکند

G D fastStart GET /fastStart/item84,item85,item86,item88/item10,200/item21,50

[["item84",0.036399312],["item86",0.01302167],["item85",-0.027945817],["item88",-0.09022728]]

مرتبساززيییي آآيیتمهايییي جديید بر ااساسس عالقه كکارربر جديید. تنها بر ااساسس ددوو كکليیكک رروويییي آآيیتمهايییي 10 وو 21 فهرست مرتب شدهه.

بيیشتر

B D fetchingTrustedMachinesAdd GET /fetchingTrustedMachinesAdd/1.2.3.4 ["Fetching Trusted Machines":["1.2.3.4","0.0.0.0"]] اافزووددنن IP ماشيین به فهرست مجازز به ااجراايییي پرسش.

B D fetchingTrustedMachinesList GET /fetchingTrustedMachinesList [“Fetching Trusted Machines”:["1.2.3.4","0.0.0.0"]] فهرست ماشيینهايیيی كکه ااجاززهه ددااررند پرسش ااجراا كکنند.

B D fetchingTrustedMachinesRemove GET /fetchingTrustedMachinesRemove/1.2.3.4/ ["Fetching Trusted Machines":["0.0.0.0"]] حذفف كکرددنن يیكک ماشيین اازز فهرست مجازز به ااجراايییي پرسش.

B C forget GET remember=1list

/forget/item22/item23/item24 به فرااموشيی سپرددنن آآيیتميی كکه موجودد نيیست يیا منقضيی شدهه ااست.

براايییي مشاهدهه فهرست آآيیتمهايییي فرااموشش شدهه اازز پارراامتر list ااستفاددهه

كکنيید براايییي به خاطر آآووررددنن، اازز پارراامتر remember ااستفاددهه كکنيید. بيیشتر

D freshItemsAdd GET /freshItemsAdd/item22/item41/item34/item35/item45 ["Fresh Items”:["item41","item35","item34","item45","item22"]] اافزووددنن آآيیتم به فهرست آآيیتمهايییي جديید

D freshItemsList GET /freshItemsList ["Fresh Items":["item41","item35","item34","item45","item22"]] مشاهدهه آآيیتمهايییي فهرست جديید

P   L

� of �1 5 recommender.ir

Version 2.6 2016

recommender.irUser Experience Excellence

ررااهنمايییي بكکاررگيیريییي رراا ددرر اانتهايییي جدوولل مطالعه كکنيید.

با سطح A شرووعع كکنيید

پلنهايییي بهرهه بردداارريییي Gold Silver Bronze

براايییي مطالعه جزئيیاتت فرااخواانيی متدها به ررااهنمايییي فنيی نسخه 2.6 مرااجعه كکنيید.

API‌ پيیوست 2 - ررااهنمايییي سريیع فرااخواانيی

D freshItemsRemove GET freshItemsRemove/item65/ ["Fresh Items":["item41","item35","item34","item45","item22"]] حذفف آآيیتم اازز فهرست آآيیتمهايییي جديید

G D getUserProfile GET /getUserProfile/2931 [["userId":"53363","gender":"m","birthYear":"1352","priorities":["Samsung"],"homeLocation":[Ekbatan (35.7131389,35.7131389)],"workLocation":[SimayeIran (35.753937,35.753937)],"currentLocation":[Tajrish (35.792944,35.792944)]]]

ددرريیافت پرووفايیل كکارربر. (setUserProfile رراا ببيینيید) بيیشتر

G D guessUserProfile GET /guessUserProfiles/1442039315348012 [["userId":"-1","gender":"m","birthYear":"1979"],["userId":"-1","gender":"f","birthYear":"1982"]]

تخميین پرووفايیلهايییي كکارربر ااحتماليی اازز نظر جنسيیت وو سن بيیشتر

B A ingest * POST GET

/ingest?id=45046703250601&url='item99'&value=100

ااررسالل فعاليیت كکارربر اازز قبليی كکليیكک، ااسكکروولل، ززددنن ددكکمه پليی، ااندااختن به

سبد خريید …

G C interest GET /interest/1441746820592613/item10/item21/item56/ [["item10",0.24618937],["item56",0.02231534],["item21",-0.60017335]] مرتب ساززيییي آآيیتمها بر ااساسس عالقه كکارربر. بيیشتر

S C itemFrequentlyVisitors GET howMany /itemFrequentlyVisitors/item23 ["item23":["1352","2210","1436989362353633"]] كکارربراانيی كکه به يیكک آآيیتم مكکررر مرااجعه ددااررند بيیشتر

G D itemLocationAdd GET overwritenocheck

/itemLocationAdd/item22/tehran,37.4822537,49.4346751/arak,34.4823337,43.433751/shiraz,15.4822537,75.4346751?overwrite

["item22":["arak, 34.4823337, 34.4823337"]["shiraz, 15.4822537, 15.4822537"]["tehran, 37.4822537, 37.4822537"]]

معرفيی موقيیتهايییي مكکانيی يیكک آآيیتم. براايییي مثالل آآيیتميی كکه ددرر چند شهر يیا فرووشگاهه عرضه ميیشودد. مكکاننهايییي تورريیستيی. فرووشگاههها، مكکانن سيینما

… (مختصاتت فرضيی ااست) بيیشتر

G D itemLocationList GET nocheck /itemLocationList/item22 ["item22":["arak, 34.4823337, 34.4823337"]["shiraz, 15.4822537, 15.4822537"]["tehran, 37.4822537, 37.4822537"]]

نمايیش موقيیتهايییي مكکانيی يیكک آآيیتم. (مختصاتت فرضيی ااست) بيیشتر

S C latestTouchedItems GET howMany /latestTouchedItems/3630 [["item75",1.0],["item68",1.0],["item15",1.0],["item67",1.0],["item21",1.0],["item65",1.0]] نمايیش آآخريین آآيیتمهايیيی كکه كکارربر با آآنها تعامل ددااشته ااست. بيیشتر

S C latestTouchedTerms GET howMany /latestTouchedTerms/3630 [["1yGuarantee",6.0],["Sony",6.0],["MotherDay",5.5],["Samsung",5.0],["400000",4.5],["2yGuarantee",4.5],["Apple",4.5],["FatherDay",4.0]]

نمايیش آآخريین وويیژگيیهايیيی كکه كکارربر با آآنها تعامل ددااشته ااست، مرتب شدهه بر ااساسس ميیزاانن عالقمنديییي كکارربر به وويیژگيی. بيیشتر

B A luckyUser GET howManyfresh

/luckyUser/1442092449719194/item35?howMany=5 [["item90",1.0],["item97",1.0],["item84",1.0],["item27",1.0]] پيیشنهادد به كکارربر بر ااساسس اانتخابب وويییي

B A mostPopularItems GET howManyfresh

/mostPopularItems?howMany=5&fresh [["item93",29.0],["item11",27.0],["item02",25.0],["item53",25.0],["item90",25.0]] محبوببتريین آآيیتمهايییي سايیت بيیشتر

S B mostPopularTerms GET howManyfresh

/mostPopularTerms [["Atari",20.0],["Sony",15.5],["Apple",9.0],["1yGuarantee",5.0],["Samsung",5.0],["3yGuarantee",4.5],["HTC",4.5],["900000",4.0],["2yGuarantee",3.5],["400000",3.0]]

محبوببتريین وويیژگيیها مرتب شدهه بر ااساسس عالقمنديییي كکارربر به وويیژگيی بيیشتر

B B recommend GET howManyfreshradiusdither

/recommend/53363?fresh&radius=5&howMany=7 [["item07",0.73203593],["item75",0.6558009],["item55",0.61088717],["item48",0.49726927],["item93",0.48469344],["item53",0.46815696],["item58",0.41965076]]

پيیشبيینيی وو پيیشنهادد به كکارربر. ددرر اايینجا به كکارربر 7 آآيیتم ددرر شعاعع 5 كکيیلومتريییي پيیشنهادد شدهه ااست.

بيیشتر

B C recommendToGroup GET howManyfreshradius

/recommendToGroup/143173/14393/14392?howMany=5&dither

[["item51",0.82533973],["item58",0.7489276],["item87",0.6468189],["item75",0.6280777]]

پيیشنهادد مشتركککك براايییي گرووهيی اازز كکارربراانن. ددرر اايینجا به سه كکارربر پيیشنهادديییي مشتركککك وو لرززاانن اارراائه شدهه ااست.

بيیشتر

B B recommendToNewcomer GET howMany /recommendToNewcomer/item13/item14/item24?howMany=3

[["item02",0.0],["item09",0.0],["item93",0.0]] پيیشنهادد به كکارربر تاززهه وواارردد بر ااساسس مركکزيیت چند آآيیتم ددرر خوشه بنديییيها. بيیشتر

G D setUserProfile GET overwrite  /setUserProfile/53363?gender=m&birthYear=1352&homeLocation=Ekbatan,35.7131389,51.3136691&workLocation=SimayeIran,35.753937,51.355773&currentLocation=Tajrish,35.792944,51.436035&priorities=Samsung,Ski

ثبت پرووفايیل كکارربر شامل جسيیت، سن وو سالل، ااوولويیتها وو مكکاننهايییي ززندگيی، كکارر وو مكکانن فعليی.

بيیشتر

B A similarity GET howManyfresh

/similarity/item09/ [["item49",0.3915792],["item95",0.34301394],["item62",0.33226618],["item56",0.2982561],["item42",0.29208604],["item88",0.2892871],["item97",0.28522074],["item70",0.26975223],["item79",0.25677094],["item12",0.2414928]]

فهرست آآيیتمهايییي مشابه، مرتب شدهه بر ااساسس ميیزاانن تشابه. بيیشتر

G D similarityAccelerated GET fresh /similarityAccelerated/item44 [["item05",0.5292722],["item30",0.26879534],["item98",0.23387812],["item84",0.16914937],["item68",0.14613901],["item61",0.1258337],["item40",0.10009991],["item20",0.09199348],["item16",9.131974E-4],["item59",6.2219835E-5],["item58",-0.09531883],["item66",-0.098475724],["item67",-0.13596192]]

فهرست آآيیتمهايییي مورردد شتابدهيی، مرتب شدهه بر ااساسس ميیزاانن شباهت. نمايیش آآيیتمهايیيی كکه مقداارر باالتريییي ددااررند توصيیه ميیشودد.

بيیشتر

Endpoint HTTP Params Sample Request Sample Response Pتوضيیح (رروويییي بيیشتر كکليیكک كکنيید)   L

� of �2 5 recommender.ir

API‌ پيیوست 2 - ررااهنمايییي سريیع فرااخواانيی

S C similiarityToItem GET /similarityToItem/item10/item11/item20/item23/item31/item35

0.1662501-0.00660250660.0575754230.047396146-0.048667256

ميیزاانن شباهت يیكک آآيیتم با چند آآيیتم. مقادديیر اازز منفيی يیكک تا مثبت يیكک. ددرر اايینجا آآيیتم 10 به آآيیتم 11 بيیش اازز بقيیه آآيیتمها شباهت دداارردد.

G C spectrometer GET howManyfresh

/spectrometer/1439640120513293?howMany=5 [["item36",0.74051636],["item86",0.54609585],["item45",0.48444077],["item20",0.4622491],["item09",0.40032625]]

پيیشنهادد بر ااساسس همگراايیيی ررفتارر كکارربر بر وويیژگيیها بيیشتر

G C spotlight GET howManyfresh

/spotlight/1442088759755854?howMany=4&fresh [["item45",0.39117086],["item57",0.33638176],["item72",0.29789722]] پيیشنهادد بر ااساسس همگراايیيی كکارربر بر آآيیتمها بيیشتر

S C termBasedMostPopularItems GET howManyfresh

/termBasedMostPopularItems/Apple [["item02",25.0],["item90",25.0],["item32",24.0],["item61",24.0],["item16",23.0],["item65",23.0],["item49",23.0],["item78",23.0],["item52",22.0],["item46",22.0]]

محبوببتريین آآيیتمها ددرر دداامنه خاصص. ددرر اايینجا محبوببتريین آآيیتمهايییي ااپل نمايیش ددااددهه شدهه ااست.

S C termBasedMostPopularItemsInclusive *** GET howManyfresh

/termBasedMostPopularItemsInclusive/Apple/Samsung/HTC

[["item02",25.0],["item53",25.0],["item90",25.0],["item58",25.0],["item20",25.0],["item32",24.0],["item61",24.0],["item26",24.0],["item54",24.0],["item16",23.0]]

محبوببتريین آآيیتمها ددرر دداامنههايییي خاصص با قيید يیا منطقيی. ددرر اايینجا محبوببتريین آآيیتمهايییي ااپل، سامسونگ وو ااچچتيیسيی.

S D termBasedMostPopularItemsInclusiveRegex ** ***

GET howManyfresh

/termBasedMostPopularItemsInclusiveRegex/.*Guarantee.*/[1-3][0-9][0-9][0-9][0-9][0-9][0-9]

[["item93",29.0],["item11",27.0],["item02",25.0],["item53",25.0],["item90",25.0],["item51",25.0],["item58",25.0],["item20",25.0],["item27",24.0],["item32",24.0]]

محبوببتريین آآيیتمها كکه دداارريییي گارراانتيیبوددهه يیا بيین يیكک صد االيی چهارر صد هزاارر تومانن قيیمت ددااررند

S D termBasedMostPopularItemsRegex ** GET howManyfresh

/termBasedMostPopularItemsRegex/.*Guarantee.*/[1-3][0-9][0-9][0-9][0-9][0-9][0-9]

[["item53",25.0],["item79",22.0],["item12",20.0],["item77",18.0],["item05",15.0]] محبوببتريین آآيیتمهايیيی كکه گارراانتيی ددااررند وو بيین يیكک صد االيی چهارر صد هزاارر تومانن قيیمت ددااررند

S B termBasedRecommend GET howManyfreshprofileBasedradiusdither

Example 1 : /termBasedRecommend/53363/Samsung?freshExample 2 : /termBasedRecommend/53363?profileBased&fresh

[["item48",0.49726927],["item44",0.4121405],["item30",0.2765867],["item77",0.24433237],["item18",0.19513626],["item57",0.098177716],["item15",0.08537362],["item02",0.009985133],["item05",-0.02166349],["item10",-0.121401876]]

پيیشنهادد بر ااساسس وويیژگيی. وويیژگيی ميیتوااند به متد پاسس شودد وو يیا اازز پرووفايیل كکارربر خوااندهه شودد. ددرر پرسش 1 وويیژگيی سامسونگ پاسس شدهه

ااست. ددرر پرسش 2 وويیژگيی سامسونگ اازز پرووفايیل كکارربر ااستخرااجج شدهه وو نتيیجه هر ددوو پرسش يیكکسانن ااست. ددرر صوررتيی كکه چند وويیژگيی به متد

بدهيید AND ميی شوند. بيیشتر

S C termBasedRecommendInclusive *** GET howManyfreshprofileBasedraduisdither

Example 1 : /termBasedRecommendInclusive/2931?profileBased&fresh

Example 2 : /termBasedRecommendInclusive/2931/2yGuarantee?profileBased&fresh

Response 1 : [[“item52",0.7969372],["item41",0.62855315],["item47",0.60146236]]

Response 2 : [["item52",0.7969372],["item73",0.700196],["item41",0.62855315],["item47",0.60146236]]

پيیشنهادد بر ااساسس وويیژگيی. وويیژگيی ميیتوااند به متد پاسس شودد وو يیا اازز پرووفايیل كکارربر خوااندهه شودد. ددرر پرسش 1 وويیژگيی سامسونگ اازز پرووفايیل كکارربر ااستخرااجج شدهه ااست. ددرر پرسش 2 وويیژگيی سامسونگ اازز پرووفايیل

كکارربر ااستخرااجج شدهه وو با وويیژگيی ددووساللگارراانتيی OR شدهه ااست. ددرر

صوررتيی كکه چند وويیژگيی به متد بدهيید OR ميی شوند. بيیشتر

S D termBasedRecommendInclusiveRegex ** ***

GET howManyfreshradiusdither

/termBasedRecommendInclusiveRegex/2931/.*Guarantee.*/.*Day.*?fresh

[["item35",1.0674956],["item73",0.700196],["item36",0.6348405],["item59",0.54223126],["item81",0.53099],["item71",0.527475]]

پيیشنهادد بر ااساسس االگو.

به كکارربر بر ااساسس ددااشتن وويیژگيیهايییي گارراانتيی يیا Day پيیشنهادد ميیددهد. نتايیج عالووهه بر اانطباقق با سليیقه كکارربر دداارراايییي گارراانتيی وو مناسب براايییي

مناسبتهايییي پدرر/ماددرر خوااهند بودد. بيیشتر وو بيیشتر

S D termBasedRecommendRegext ** GET howManyfreshradiusdither

/termBasedRecommendRegex/2931/.*Guarantee.*/[3-5]00000?fresh

[["item36",0.6348405]] پيیشنهادد بر ااساسس االگو. به كکارربر بر ااساسس االگويییي گارراانتيی وو ررنج قيیمت سيیصد تا پانصد هزاارر تومانن

پيینشهادد ميیددهد. بيیشتر وو بيیشتر

S B termBasedSimilarity GET howManyfresh

/termBasedSimilarity/item83/Samsung/3yGuarantee [["item24",0.15452914],["item90",0.1358181],["item31",0.1057769]] آآيیتم هايییي مشابه با قيید دداارراا بوددنن وويیژگيیهايییي معيین

S C termBasedSimilarityInclusive *** GET howManyfresh

/termBasedSimilarityInclusive/item83/Samsung/3yGuarantee

[["item22",0.30606335],["item47",0.25987005],["item43",0.22566336],["item98",0.17148176],["item86",0.16528602],["item24",0.15452914],["item20",0.14147559],["item74",0.13745928],["item90",0.1358181],["item04",0.1180849]]

آآيیتم هايییي مشابه با قيید دداارراا بوددنن حدااقل يیكکيی اازز وويیژگيیهايییي معيین

S D termBasedSimilarityInclusiveRegex ** *** GET howManyfresh

/termBasedSimilarityInclusiveRegex/item83/.*Day.*/.*Guarantee.*?fresh

[["item50",0.33030114],["item13",0.32054996],["item22",0.30606335],["item71",0.28904608],["item79",0.28899446],["item57",0.23636602],["item43",0.22566336],["item60",0.1959262],["item80",0.18367699],["item98",0.17148176]]

آآيیتمهايییي مشابه با قيید دداارراا بوددنن حدااقل يیكکيی اازز االگوها. ددرر اايینجا االگوهايییي مناسبت وو گارراانتيی.

بيیشتر

S D termBasedSimilarityRegex ** GET howManyfresh

/termBasedSimilarityRegex/item83/.*Day.*/.*Guarantee.*?fresh

[["item57",0.23636602],["item86",0.16528602],["item25",0.071953855],["item36",0.054402694],["item08",0.02778767]

آآيیتمهايییي مشابه با قيید دداارراا بوددنن االگوها. ددرر اايینجا االگوهايییي مناسبت وو گارراانتيی. بيیشتر

S B termItemAdd GET nocheckoverwrite

/termItemAdd/item96/Apple/1yGuarantee/iPhone5SE?nocheck&overwrite

اافزووددنن وويیژگيی به آآيیتم بيیشتر

S B termItemList GET nocheck /termItemList/item96?nocheck ["item96":["1yGuarantee","Apple","iPhone5SE"]] ددرريیافت فهرست وويیژگيیها بيیشتر

S B termItemRemove GET /termItemRemove/item96/1yGuarantee حذفف وويیژگيیهايییي آآيیتم بيیشتر

Endpoint HTTP Params Sample Request Sample Response Pتوضيیح (رروويییي بيیشتر كکليیكک كکنيید)   L

� of �3 5 recommender.ir

API‌ پيیوست 2 - ررااهنمايییي سريیع فرااخواانيی

S C termNeighborhood GET howManyfresh

/termNeighborhood/Apple [[“Apple”,20.0],["iPhone",6.0],["iPad",5.0],["1yGuarantee",4.0],["HTC",4.0],["Samsung",4.0],["MotherDay",3.0],["120000",2.0],["2yGuarantee",2.0],["900000",2.0],["3yGuarantee",2.0],["FatherDay",1.0],["iPhone5SE",1.0]]

نزدديیكکتريین وويیژگيیها. ددرر اايینجا نزدديیكکتريین وويیژگيیها به ااپل.

بيیشتر

S C termRecommend GET howManyfresh

/termRecommend/7710 [["MotherDay",14.0],["120000",13.5],["FatherDay",12.5],["1yGuarantee",9.0],["2yGuarantee",6.0],["3yGuarantee",6.0],["900000",5.0],["Apple",4.5],["Sony",3.5],["Samsung",3.0]]

پيیشبيینيی وويیژگيیهايیيی كکه كکارربر به ددنبالل آآنهاست.

S C termRecommendToGroup GET howManyfresh

/termRecommendToGroup/1473/14472/14712?howMany=5

[[“MotherDay",3.5],["FatherDay",3.0],["Sony",3.0],["HTC",3.0],["120000",2.5],] پيیشبيینيی وويیژگيیهايیيی كکه گرووهيی اازز گارربراانن به ددنبالل آآننها هستند.

S C termSimilarity GET guesshowManyfresh

/termSimilarity/item60?guess [["2yGuarantee",11.5],["1yGuarantee",9.5],["3yGuarantee",5.0],["Apple",4.5],["Samsung",4.5],["FatherDay",3.0],["Sony",3.0],["MotherDay",3.0]]

تخميین وويیژگيیهايییي يیكک آآيیتم بر ااساسس آآيیتمهايییي خوشه. بيیشتر

G A termTrendLongTime GET howMany /termTrendLongTime [["camera8mp",6.0],["Sony",6.0],["Apple",6.0],["Gold",6.0],["3yGuarantee",5.5],["HTC",5.5],["Lcd3.5",5.0],["MotherDay",5.0],["1yGuarantee",4.5],["White",4.5]]

وويیژگيیهايیيی كکه ددرر باززهه ززمانيی طوالنيی ددرر حالل ترند شدنن هستند. بيیشتر

G A termTrendMidTime GET howMany /termTrendMidTime [["Gold",6.0],["1yGuarantee",5.5],["White",5.5],["Black",5.5],["2yGuarantee",5.5],["Lcd3.5",5.0],["MotherDay",5.0],["400000",4.5],["FatherDay",4.5],["camera10mp",4.5]]

وويیژگيیهايیيی كکه ددرر باززهه ززمانيی ميیاننمدتت ددرر حالل ترند شدنن هستند. بيیشتر

G A termTrendShortTime GET howMany /termTrendShortTime [["1yGuarantee",6.0],["Lcd3.5",6.0],["3yGuarantee",5.5],["HTC",5.5],["camera8mp",5.0],["Sony",5.0],["Apple",5.0],["Gold",5.0],["Black",4.5],["Lcd5.5",4.5]]

وويیژگيیهايیيی كکه ددرر باززهه ززمانيی كکوتاههمدتت ددرر حالل ترند شدنن هستند. بيیشتر

G A trendLongTime GET howMany /trendLongTime [["item48",24.0],["item90",24.0],["item17",24.0],["item56",24.0],["item33",24.0],["item42",23.0],["item53",23.0],["item77",23.0],["item15",22.0],["item45",21.0]]

تخميین وويیژگيیهايییي يیكک آآيیتم بر ااساسس آآيیتمهايییي خوشه. بيیشتر

G A trendMidTime GET howMany /trendMidTime [["item56",18.0],["item77",18.0],["item42",17.0],["item90",17.0],["item93",17.0],["item13",17.0],["item53",16.0],["item44",15.0],["item45",15.0],["item48",15.0]]

تخميین وويیژگيیهايییي يیكک آآيیتم بر ااساسس آآيیتمهايییي خوشه. بيیشتر

G A trendShortTime GET howMany /trendShortTime [["item47",5.0],["item17",4.0],["item44",3.0],["item56",3.0],["item14",3.0],["item62",3.0],["item29",3.0],["item33",3.0],["item74",3.0],["item77",3.0]]

تخميین وويیژگيیهايییي يیكک آآيیتم بر ااساسس آآيیتمهايییي خوشه. بيیشتر

B D trustedMachinesAdd GET /trustedMachinesAdd/1.2.3.4 ["Trusted Machines":["1.2.3.4","0.0.0.0"]] اافزووددنن IP ماشيین به فهرست مجازز به ااررسالل وو وويیراايیش ددااددهه.

B D trustedMachinesList GET /trustedMachinesList [“Trusted Machines”:["1.2.3.4","0.0.0.0"]] فهرست ماشيینهايیيی كکه ااجاززهه ددااررند ددااددهه ااررسالل كکنند.

B D trustedMachinesRemove GET /trustedMachinesRemove/1.2.3.4 ["Trusted Machines":["0.0.0.0"]] حذفف كکرددنن يیكک ماشيین اازز فهرست مجازز به ااررسالل ددااددهه.

S C userFrequentlyTouchedItems GET /userFrequentlyTouchedItems/1710 [["item19",1.0]] آآيیتمهايیيی كکه كکارربر به آآنها مكکررر سر ميیززند. بيیشتر

Endpoint HTTP Params Sample Request Sample Response Pتوضيیح (رروويییي بيیشتر كکليیكک كکنيید)   L

� of �4 5 recommender.ir

”Params“ ررااهنمايییي ستونن

howMany=n حدااكکثر تعداادد نتايیج رراا تعيیيین ميیكکند.

fresh اانجامم مجددد محاسباتت رراا تضميین ميیكکند.

dither با اافزووددنن نويیز نتايیج لرززاانن توليید ميیكکنيید.

radius=n حدااكکثر فاصله مكکانن كکارربر با مكکانن آآيیتم

nocheck كکنترلل ووجودد آآيیتم (ددرريیافت اايینجست) رراا خاموشش ميیكکند.

profileBased بر ااساسس ااوولويیتهايییي پرووفايیل كکارربر وويیژگيیها رراا ااستخرااجج ميیكکند.

overwrite محتواايییي ددرريیافت شدهه رراا بر رروويییي محتواايییي موجودد ميینويیسد.

remember=true آآيیتم فرااموشش شدهه رراا مجددداا به خاطر ميیآآوورردد.

list فهرست آآيیتمها رراا بازز ميیگرددااند.

 “L” ررااهنمايییي ستونن

A .فرااخواانيی اايین متدها براايییي شرووعع كکارر االزااميی وو كکافيی ااست

ددرر ساددهه تريین سطح اازز اايین متدها ااستفاددهه كکنيید. تنها 4

متد ددرر اايین سطح قراارر ددااررند.

B ددرر اايین سطح اازز فرااخواانيی به ااررسالل محتواا پرددااخته وو

متدهايیيی كکه بر ااساسس محتواايییي آآيیتم كکارر ميیكکنند فرااخواانيی

ميیكکنيید.

C متدهايییي اايین سطح ممكکن ااست ددرر بدوو ررااهه ااندااززيییي سروويیس

جواابيی توليید نكکنند. لذاا توصيیه ميیشودد پس اازز آآشنايیيی با

كکارركکردد متدهايییي سطوحح قبل به سرااغغ اايین متدها بيیايیيید.

D ددرر اايین سطح متدهايیيی قراارر ددااررند كکه براايییي فرااخواانيی آآنها

بهتر ااست با مفاهيیميی همچونن ررگوالررااكکسپرشن، پرووفايیل

كکارربر، موقعيیت مكکانيی(طولل وو عرضض جغراافيیايیيی) وو اامنيیت

شبكکه آآشنايیيی ددااشته باشيید.

ررااهنمايییي ستونن “ررنگ”

متدهايییي شتابدهيی به عرضه آآيیتم، حرااجج، فرووشش وويیژهه، اافزاايیش هوشمند نمايیش …

نمايیش تمامم آآيیتمها / تمامم كکارربراانن

محاسبه عالقه / عدمم عالقه كکارربر نسبت به آآيیتمهايییي خاصص

متدهايییي ااررسالل ددااددهههايیيی اازز تعامل كکارربر وو آآيیتم - محتواايییي آآيیتم - مكکانن آآيیتم

شباهت آآيیتمها وو جزئيیاتت محتواا (وويیژگيیهايییي)

محبوبيیت/ترند آآيیتمها وو جزئيیاتت محتواا (وويیژگيیهايییي)

محاسبه عاليیق كکارربر(پيیشنهادد) بر ااساسس وويیژگيی، موقعيیت جغراافيیايیيی وو فاصله وو عاليیق

پرووفايیل كکارربر، جنسيیت، سن، موقعيیت جغراافيیايیيی، ااوولويیتها

آآخريین تعامل كکارربراانن با آآيیتمها

فهرستهايییي IP ماشيین هايییي مجازز به ااررسالل وو ددرريیافت ددااددههها

API‌ پيیوست 2 - ررااهنمايییي سريیع فرااخواانيی

� of �5 5 recommender.ir

متدهايییي هر پلن بر ااساسس تعلق به كکالسسهايییي طاليیيی (Gold) ، نقرههاايییي (Silver) وو برنزيییي (Bronze) ددرر ستونن P با حرووفف G, S وو B مشخص شدههااند.

متد ingest ددرر مد POST قاددرر به ددرريیافت ااطالعاتت به صوررتت جريیانن ( فايیل Bulk) ميیباشد. *

** متدهايیيی كکه نامم آآننها به Regex ختم ميیشودد، ررگوالررااكکسپرشن ااستانداارردد ميیپذيیرند.

*** متدهايیيی كکه ددرر نامم آآننها Inclusive مشاهدهه ميیشودد، نتايیج فيیلتريینگ رراا OR ميیكکنند. ددرر غيیر اايین صوررتت نتيیجه فيیلتريینگ پارراامترها AND ميیشودد.

متدهايییي جدوولل بر ااساسس كکارربردد به كکمكک تگهايییي ررنگيی ددسته بنديییيشدهه ااند. ررااهنمايییي ستونن ررنگ رراا ددرر جدوولل “ررااهنمايییي ستونن ررنگ” مشاهدهه ميیكکنيید. همچنيین بر ااساسس ساددگيی فرااخواانيی وو ااوولويیت پيیاددهه ساززيییي ددرر سايیت/

ااپليیكکيیشن شما نيیز يیكک ددسته بنديییي 4 سطحيی ووجودد ددااررهه. اايین ددسته بنديییي متدهايییي ساددهه وو پايیه رراا A وو متدهايییي سطوحح بعديییي رراا با D, C, B مشخص كکرددهه ااست. پارراامترهايییي فرااخواانيی (GET) نيیز ددرر جدوولل ررااهنمايییي ستونن معرفيی

شدهه ااند. معرفيی كکامل متدها رراا ددرر ررااهنمايییي فنيی مطالعه كکنيید. ددرر توضيیح متدها، بيیشتر شما رراا به پست مرتبط ددرر recommender.ir/blog منتقل ميیكکند.

كکنارر نامم برخيی متدهايییي ستاررهه (*) ووجودد دداارردد. ررااهنمايییي ستاررههها ددرر ززيیر آآمدهه ااست.

ااگر كکسبووكکارر شما به متديییي خاصص نيیازز دداارردد كکه ددرر جدوولل موجودد

[email protected] :نيیست، كکافيیست اازز ما بخوااهيید

recommender.irتــعالــيی تــجــربه كکــــارربــــر

linkedin.com/company/recommender-ir

twitter.com/recommender_ir

instagram.com/recommender_ir

telegram.me/recommender

recommender.ir/blog

[email protected]

aparat.com/recommender

با ما ددرر شبكکههايییي ااجتماعيی وو ررسانههايییي ززيیر ددرر ااررتباطط باشيید: