API
Mae pob adroddiad cyhoeddus hefyd yn JSON. Does dim allwedd i ofyn amdani a dim cyfrif i greu - os mae safle wedi cyhoeddi ei adroddiad, mae ei rhifau'n darllenadwy gan unrhyw un, yn yr un ffurf y darperir y dudalen adroddiad ei hun.
Dyna' r pwynt yn hytrach na chyfleuster. Rhif na allwch ei dderbyn a' i wirio' n annibynnol yw sgrînlun. Y ddwy ddiwedd- bwynt yma yw' r rhai sy' n gwneud y datganiad ar flaen y safle hwn yn brofiadwy.
Data adroddiadau
Popeth tu ôl i adroddiad cyhoeddedig: cyfanswm, y gyfres amser y darperir y siart ohoni, a'r ffynhonnell, tudalen, gwlad, porwr, system, dyfais a chrynodiadau ymgyrch.
| Paramedrau | Gwerthoedd | Pwysau |
|---|---|---|
period | last24h · last7d · last30d · last90d · all |
Y ffenestr. Rhagosodiadau i last24h; mae unrhyw beth nad yw'n cael ei adnabod yn dychwelyd ato yn hytrach na chreu gwallau. |
granularity | hourly · daily |
Maint y bwced ar gyfer y gyfres. Os ei hepgorer, bydd pob cyfnod yn defnyddio ei un naturiol - awr ar gyfer diwrnod, diwrnod ar gyfer popeth sy'n hirach. |
Un gwrthrych yw'r ymateb gyda'r allweddi hyn:
Ymwelwyr byw
Pwy sy' n ymweld â' r safle ar hyn o bryd, a ble daethant o. Cyfansoddion yn unig - byth enw ymwelydd, byth llwybr, byth unrhyw beth a allai ddewis person.
| Paramedrau | Gwerthoedd | Pwysau |
|---|---|---|
minutes | 1–60 | Faint o'r blaen y cyfrifir fel nawr. Rhagosodiadau i 5; gwerthoedd tu allan i'r amrediad yn cael eu clymu, nid eu gwrthod. |
Mae'r un yma yn anfon Access-Control-Allow-Origin: * ac yn cadw yn y storfa am ddeugain eiliad, felly gall safwe fewnosod ei rhif byw ei hun wedi ei gyfrif yn annibynnol yn ei dudalen ei hun - a gall darllenydd agor yr adroddiad a gwirio ei fod yn cyd-fynd â'r hyn mae'r dudalen yn ei ddweud.
Beth allwch chi ei ddisgwyl
- Dim dilysiant, dim allwedd, dim terfyn cyflymder i gofrestru ar ei gyfer. Mae'r ddau ddiwedd-bwynt yn GETau arferol.
- Rhaid i adroddiad fod yn gyhoeddus. Os nad yw ei berchennog wedi ei gyhoeddi, dychwelir 404 gan y ddau ddiwedd-bwynt - yr un ateb a geir gan safle anhysbys, felly ni fydd yr API byth yn datgelu bod safle preifat yn bodoli.
- Ni ddarperir dim dynodiad, oherwydd ni chedwir dim dynodiad. Ni ysgrifennir cyfeiriadau IP, a chaiff dynodiad ymwelydd ei saltio bob dydd ac ni ellir ei ymuno dros ddyddiau.
- Mae Yfory a'r blaen yn cael eu selio mewn rhwydwaith crwydro diwrnodol y gallwch ei ail-gyfrif eich hun. Y rhifau yn yr API hwn yw'r rhifau yn y rhwydwaith hwn.