API
Data API
Visits
methods allow you to get a list of visits or information on a specific visit also, you can confirm receipt of information about the visit and change the value of kpi in visit get get /visits return a list of visits tab request url https instance name api data v1 0 visits name request example method get request pathparameters queryparameters headerparameters kind required name authorization type string description string in token xxxxxx format bodydataparameters kind optional name limit type integer description the number of results to return per page kind optional name offset type integer description the initial index from which to return the results formdataparameters results languages id fj3zsbaijz6tuvfi40xny code n count 421 n next https test eyrene com api data v1 0 visits ?limit 30 offset 60 n previous https test eyrene com api data v1 0 visits ?limit 30 n results n n id 426 n cid n created at 2021 11 17t12 33 40 835225z n updated at 2021 11 17t12 33 40 835950z n n n id 427 n cid n created at 2021 11 17t12 33 40 072128z n updated at 2021 11 17t12 36 05 343056z n n n id 428 n cid n created at 2021 11 17t12 33 38 411075z n updated at 2021 11 17t12 33 38 412059z n n n language 200 customlabel selectedlanguageid fj3zsbaijz6tuvfi40xny examples languages id dpmodah zaotktusexn5x code curl i x get n https test eyrene com api data v1 0 visits n h authorization token 39fbb6e9 fbf9 459a 9e1b 416dbcf51875e language curl customlabel selectedlanguageid dpmodah zaotktusexn5x description get visits currentnewparameter label body parameter value bodydataparameters response parameters ​ https //help inspector cloud com/en/docs/api/backend/methods/v1/agents/agents list#response definitions count integer the number of visits next string (uri) nullable nullable next page previous string (uri) nullable nullable previous page results array of objects an array of objects with information about manufacturers id integer visit id cid string <= 255 characters <= 255 characters visit id in the user's system name string visit name created at string (date time) date and time of creation in the format «yyyy mm ddthh\ mm\ ssz» updated at string (date time) date and time of data update in the format «yyyy mm ddthh\ mm\ ssz» get get /visits/{id} returns information about visit by id tab examples url https instance name api data v1 0 visits id name request example method get request pathparameters kind required name id type string description visit id queryparameters headerparameters kind required name authorization type string description string in token xxxxxx format bodydataparameters formdataparameters results languages id fj3zsbaijz6tuvfi40xny code n id 324096 n cid n portal url https test eyrene com portal visit 324096 n agent id 5633 n current agent name alex n current agent route 164780 n current agent role null n store id 11020 n customer id 9e90fac2 4073 e911 811d 00505601 n is closed true n is deleted false n is new true n latitude 54 5208487 n longitude 37 0463798 n closed latitude 54 520429 n closed longitude 37 0467814 n closed at 2020 07 29t12 40 07 440127 03 00 n created at 2020 07 29t10 24 53 526334 03 00 n updated at 2020 07 30t08 07 03 598354z n app created at 2020 07 29t07 24 50 291000z n app closed at 2020 07 29t09 39 54 146000z n scenes n n id 7969 n created at 2020 07 29t07 24 55 860627z n task id 3835 n portal url https test eyrene com portal visit 324096 scene 7969 n images n image quality n clone id 0 n question groups n assortment n facing counts n n n id 8022 n created at 2020 07 29t08 49 31 907239z n task id 48 n portal url https test eyrene com portal visit 324096 scene 8022 n images n n id 26810278 n created at 2020 07 29t08 49 33 007637z n original url https storage com picture jpg n corrected perspective url https storage com picture jpg n is deleted false n annotations n shelf annotations n price annotations n n n image quality n clone id 0 n question groups n assortment n facing counts n n n id 8029 n created at 2020 07 29t09 01 16 174781z n task id 7185 n portal url https test inspector cloud com portal visit 324096 scene 8029 n images n n id 26873089 n created at 2020 07 29t09 22 38 401699z n original url https storage com picture jpg n corrected perspective url https storage com picture jpg n is deleted false n annotations n shelf annotations n price annotations n n n image quality n clone id 0 n question groups n n id 130 n questions n n id 25 n type select one n answer n 66942 promo can be done n n options n n id 66943 n value product did not arrive n n n id 66944 n value insufficient stock n n n id 66948 n value virtual stock n n n id 66945 n value product is blocked n n n id 66946 n value no promo info in store n n n id 66947 n value not in the chain matrix n n n id 66942 n value promo can be done n n n created at 2020 03 11t14 33 16 387348z n text promo status n required false n cid promo 1 n n n id 26 n type text n answer null n options n created at 2020 03 11t14 33 16 416687z n text description n required false n cid promo 5 n n n created at 2021 09 24t17 36 29 466080z n name promo n cid promo question groups n n n assortment n facing counts n n n kpi values n prices n n id 619644 n scene id 8022 n sku id 155279 n sku cid 5900020023308 n price 19 n target price null n is promo true n id competitor n updated at 2020 07 29t08 50 12 223645z n n n id 619645 n scene id 8022 n sku id 155282 n sku cid 5900020023322 n price 45 n target price null n is promo false n id competitor n updated at 2020 07 29t08 50 12 303729z n n n id 619658 n scene id 8022 n sku id 166776 n sku cid 5900020004451 n price 109 n target price null n is promo true n id competitor n updated at 2020 07 29t08 50 12 419022z n n n oos reasons n n id 7183552 n scene id 8022 n sku id 166823 n sku cid 7613036868983 n reason product is blocked n updated at 2020 07 29t09 30 14 828636z n n n id 7184629 n scene id 8022 n sku id 123878 n sku cid 4607085440583 n reason product did not arrive n updated at 2020 07 29t09 32 46 215048z n n n id 7184018 n scene id 8022 n sku id 171682 n sku cid 4600680012162 n reason recognition error n updated at 2020 07 29t09 31 20 650770z n n n dqi n n id 1979894965 n uuid 844e8e37 e4b5 4c8f 9fa8 933e3726e526 n cid dqi image perspective angle horizontal n created at 2021 09 22t13 27 05 049034z n updated at 2021 10 22t15 53 40 395212z n name perspective angle horizontal n description n related to image n severity info n threshold 0 3 n n n language 200 customlabel selectedlanguageid fj3zsbaijz6tuvfi40xny examples languages id dpmodah zaotktusexn5x code curl i x get n https test eyrene com api data v1 0 visits 324096 n h authorization token 39fbb6e9 fbf9 459a 9e1b 416dbcf51875e language curl customlabel selectedlanguageid dpmodah zaotktusexn5x description get visits id currentnewparameter label path parameter value pathparameters post post /visits/{id}/ack confirm receipt of information about the visit allows to get an only new visits list attention the is new visit attribute is reset to true each time the visit is updated tab examples url https instance name api data v1 0 visits id ack name request example method post request pathparameters kind required name id type string description visit id queryparameters headerparameters kind required name authorization type string description string in token xxxxxx format bodydataparameters kind optional name cid type integer description visit id in the user system formdataparameters results languages id fj3zsbaijz6tuvfi40xny code n details ok n language 200 customlabel selectedlanguageid fj3zsbaijz6tuvfi40xny examples languages id dpmodah zaotktusexn5x code curl i x get n https test eyrene com api data v1 0 visits 98495168681 ack n h authorization token 39fbb6e9 fbf9 459a 9e1b 416dbcf51875e language curl customlabel selectedlanguageid dpmodah zaotktusexn5x description post visits id ack currentnewparameter label path parameter value pathparameters post post /visits/{id}/kpivalue change the kpi value in visit tab examples url https instance name api data v1 0 visits id kpivalue name request example method get request pathparameters kind required name id type string description visit id queryparameters headerparameters kind required name authorization type string description string in token xxxxxx format bodydataparameters kind required name kpi type number description kpi id kind required name value type number description new kpi value kind optional name target value type number description kpi target value kind optional name category type string description kpi category formdataparameters results languages id fj3zsbaijz6tuvfi40xny code n result visit kpi value changed n language 200 customlabel selectedlanguageid fj3zsbaijz6tuvfi40xny examples languages id dpmodah zaotktusexn5x code curl i x get n https test eyrene com api data v1 0 visits 125 n h authorization token 39fbb6e9 fbf9 459a 9e1b 416dbcf51875e n f kpi 86 n f value 90 n f value 80 n f category tea language curl customlabel selectedlanguageid dpmodah zaotktusexn5x description post visits id kpivalue currentnewparameter label body parameter value bodydataparameters