API

Յուրաքանչյուր հանրային զեկույցը նույնպես JSON է։ Ոչ մի կոդ չի պահանջվում և ոչ մի հաշիվ չի ստեղծվում՝ եթե կայքը հրապարակել է իր զեկույցը, նրա թվերը կարող են կարդալ բոլորը, նույն ձևով, ինչ զեկույցի էջը։

Դա ավելի շատ նպատակահարմարություն է, քան հարմարություն։ Ավելի շատ թվի, որը դուք չեք կարող ստանալ և ինքնուրույն ստուգել, նկար է։ Այս երկու վերջնական կետերը այն են, ինչը այս կայքի առաջի հայտարարությունը ստուգելի է դարձնում։

Տեղեկություն

Ընդհանուր տվյալներ, ժամանակային շարք, որից նկարագրությունը նկարահանվել է, և աղբյուր, էջ, երկիր, բրաուզեր, համակարգ, սարք և քարոզարշավի բաժանում։

GET https://visits.report/r/507de85247a64071f4e5583f9ba2583b/data/?period=last24h&granularity=hourly

Փարամետրի ցուցակ	արժեքներ	իմաստ
`period`	`last24h` · `last7d` · `last30d` · `last90d` · `all`	Պարզեցված պատուհանը։ Լռելյայն վերջին 24 ժամը։ Որևէ անհայտ բան վերադարձվում է դրան, այլ ոչ թե սխալ է առաջանում։
`granularity`	`hourly` · `daily`	Սերիայի համար ջրի բաժակի չափը։ Հեռացրեք այն և յուրաքանչյուր ժամանակահատված կօգտագործի իր բնական ժամանակահատվածը՝ օրվա համար ժամային, իսկ ավելի երկար ժամանակահատվածների համար օրական։

Պատասխանը մեկ օբյեկտ է այս կոճակների հետ.

{ "totals": { "pageviews": 0, "visitors": 0, "visits": 0, ... }, "series": [ { "label": "...", "pageviews": 0, "visitors": 0 }, ... ], "sources": [ ... ], "pages": [ ... ], "countries": [ ... ], "browsers": [ ... ], "systems": [ ... ], "devices": [ ... ], "campaigns": [ ... ], "live": 0 }

Ցուցադրել այցելուներին

Ովքեր են այս պահին կայքում և որտեղից են նրանք եկել։ Միայն համախմբված տվյալներ՝ ոչ մի այցելուի id, ոչ մի ուղի, ոչ մի բան, որ կարող է մարդկանց առանձնացնել։

GET https://visits.report/r/507de85247a64071f4e5583f9ba2583b/live/?minutes=5

Փարամետրի ցուցակ	արժեքներ	իմաստ
`minutes`	1–60	Որքան հեռու է անցել ժամանակը մինչև այժմ։ Լռելյայն 5 է։ Առանձնահատկություններից դուրս արժեքները կպչուն են, բայց չեն հերքում։

Այս մեկը ուղարկում է Access-Control-Allow-Origin: * և պահպանում է 10 վայրկյան, այնպես որ կայքը կարող է ներառել իր սեփական անկախ հաշվարկված կենդանի թիվը իր էջում — և կարդացողը կարող է բացել զեկույցը և ստուգել այն, ինչ էջը պնդում է.

{ "domain": "visits.report", "verified": true, "minutes": 5, "visitors": 0, "sources": [ ... ], "countries": [ ... ], "report_url": "https://visits.report/r/…/" }

Ի՞նչ կարող եք հաշվել

Ոչ մի ստուգում, ոչ մի կոդ, գրանցման համար ոչ մի արագության սահմանափակում։ Երկու վերջավորությունները պարզ GET-եր են։
Հաշվետվությունը պետք է հանրային լինի։ Եթե դրա տիրոջը չի հաջողվել հրապարակել այն, ապա երկու վերջնական կետերը կվերադարձնեն 404-ը, որը նույն պատասխանն է, որ անհայտ կայքը ստանում է, այնպես որ API-ն երբեք չի հայտնաբերի, որ առանձին կայք գոյություն ունի։
Ոչ մի ճանաչողական տեղեկություն չի ծառայվում, քանի որ ոչ մի ճանաչողական տեղեկություն չի պահպանվում։ IP հասցեները երբեք չեն գրանցվում, և այցելուի id- ները օրական ջերմաչափվում են և չեն կարող միավորվել օրերի ընթացքում։
Երեկվա և նախորդ օրվա տվյալները ամրագրված են օրական հիշողության մեջ, որը դուք կարող եք ինքներդ վերահաշվարկի։ Այս API-ի թվերը նույնպես այդ հիշողության մեջ են։

Ինչպես ձեռքով ստուգել շղթան →