dub 0.29.1 → 0.29.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -10
- package/docs/sdks/analytics/README.md +59 -93
- package/docs/sdks/clicks/README.md +579 -0
- package/docs/sdks/links/README.md +2 -2
- package/lib/config.d.ts +3 -3
- package/lib/config.js +3 -3
- package/models/components/domainschema.d.ts +14 -16
- package/models/components/domainschema.d.ts.map +1 -1
- package/models/components/domainschema.js +7 -3
- package/models/components/domainschema.js.map +1 -1
- package/models/components/linkschema.d.ts +7 -291
- package/models/components/linkschema.d.ts.map +1 -1
- package/models/components/linkschema.js +4 -0
- package/models/components/linkschema.js.map +1 -1
- package/models/components/security.d.ts +1 -4
- package/models/components/security.d.ts.map +1 -1
- package/models/components/security.js.map +1 -1
- package/models/components/tagschema.d.ts +24 -9
- package/models/components/tagschema.d.ts.map +1 -1
- package/models/components/tagschema.js +7 -3
- package/models/components/tagschema.js.map +1 -1
- package/models/components/workspaceschema.d.ts +38 -36
- package/models/components/workspaceschema.d.ts.map +1 -1
- package/models/components/workspaceschema.js +14 -6
- package/models/components/workspaceschema.js.map +1 -1
- package/models/errors/badrequest.d.ts +13 -13
- package/models/errors/badrequest.d.ts.map +1 -1
- package/models/errors/badrequest.js +7 -3
- package/models/errors/badrequest.js.map +1 -1
- package/models/errors/conflict.d.ts +13 -13
- package/models/errors/conflict.d.ts.map +1 -1
- package/models/errors/conflict.js +7 -3
- package/models/errors/conflict.js.map +1 -1
- package/models/errors/forbidden.d.ts +13 -13
- package/models/errors/forbidden.d.ts.map +1 -1
- package/models/errors/forbidden.js +7 -3
- package/models/errors/forbidden.js.map +1 -1
- package/models/errors/internalservererror.d.ts +13 -13
- package/models/errors/internalservererror.d.ts.map +1 -1
- package/models/errors/internalservererror.js +7 -3
- package/models/errors/internalservererror.js.map +1 -1
- package/models/errors/inviteexpired.d.ts +13 -13
- package/models/errors/inviteexpired.d.ts.map +1 -1
- package/models/errors/inviteexpired.js +7 -3
- package/models/errors/inviteexpired.js.map +1 -1
- package/models/errors/notfound.d.ts +13 -13
- package/models/errors/notfound.d.ts.map +1 -1
- package/models/errors/notfound.js +7 -3
- package/models/errors/notfound.js.map +1 -1
- package/models/errors/ratelimitexceeded.d.ts +13 -13
- package/models/errors/ratelimitexceeded.d.ts.map +1 -1
- package/models/errors/ratelimitexceeded.js +7 -3
- package/models/errors/ratelimitexceeded.js.map +1 -1
- package/models/errors/unauthorized.d.ts +13 -13
- package/models/errors/unauthorized.d.ts.map +1 -1
- package/models/errors/unauthorized.js +7 -3
- package/models/errors/unauthorized.js.map +1 -1
- package/models/errors/unprocessableentity.d.ts +13 -13
- package/models/errors/unprocessableentity.d.ts.map +1 -1
- package/models/errors/unprocessableentity.js +7 -3
- package/models/errors/unprocessableentity.js.map +1 -1
- package/models/operations/adddomain.d.ts +14 -12
- package/models/operations/adddomain.d.ts.map +1 -1
- package/models/operations/adddomain.js +7 -3
- package/models/operations/adddomain.js.map +1 -1
- package/models/operations/bulkcreatelinks.d.ts +4 -282
- package/models/operations/bulkcreatelinks.d.ts.map +1 -1
- package/models/operations/bulkcreatelinks.js.map +1 -1
- package/models/operations/createlink.d.ts +4 -282
- package/models/operations/createlink.d.ts.map +1 -1
- package/models/operations/createlink.js.map +1 -1
- package/models/operations/createtag.d.ts +24 -8
- package/models/operations/createtag.d.ts.map +1 -1
- package/models/operations/createtag.js +7 -3
- package/models/operations/createtag.js.map +1 -1
- package/models/operations/createworkspace.d.ts +1 -6
- package/models/operations/createworkspace.d.ts.map +1 -1
- package/models/operations/createworkspace.js.map +1 -1
- package/models/operations/deletedomain.d.ts +2 -8
- package/models/operations/deletedomain.d.ts.map +1 -1
- package/models/operations/deletedomain.js.map +1 -1
- package/models/operations/deletelink.d.ts +2 -8
- package/models/operations/deletelink.d.ts.map +1 -1
- package/models/operations/deletelink.js.map +1 -1
- package/models/operations/getbrowsersbyclicks.d.ts +922 -0
- package/models/operations/getbrowsersbyclicks.d.ts.map +1 -0
- package/models/operations/getbrowsersbyclicks.js +423 -0
- package/models/operations/getbrowsersbyclicks.js.map +1 -0
- package/models/operations/getbrowsersbyclicksdeprecated.d.ts +922 -0
- package/models/operations/getbrowsersbyclicksdeprecated.d.ts.map +1 -0
- package/models/operations/getbrowsersbyclicksdeprecated.js +423 -0
- package/models/operations/getbrowsersbyclicksdeprecated.js.map +1 -0
- package/models/operations/getcitiesbyclicks.d.ts +1693 -0
- package/models/operations/getcitiesbyclicks.d.ts.map +1 -0
- package/models/operations/{getcityanalytics.js → getcitiesbyclicks.js} +39 -27
- package/models/operations/getcitiesbyclicks.js.map +1 -0
- package/models/operations/getcitiesbyclicksdeprecated.d.ts +1693 -0
- package/models/operations/getcitiesbyclicksdeprecated.d.ts.map +1 -0
- package/models/operations/getcitiesbyclicksdeprecated.js +688 -0
- package/models/operations/{getcountryanalytics.js.map → getcitiesbyclicksdeprecated.js.map} +1 -1
- package/models/operations/getclickscount.d.ts +903 -0
- package/models/operations/getclickscount.d.ts.map +1 -0
- package/models/operations/{getclicksanalytics.js → getclickscount.js} +24 -16
- package/models/operations/getclickscount.js.map +1 -0
- package/models/operations/getclickscountdeprecated.d.ts +903 -0
- package/models/operations/getclickscountdeprecated.d.ts.map +1 -0
- package/models/operations/{getbrowseranalytics.js → getclickscountdeprecated.js} +26 -44
- package/models/operations/getclickscountdeprecated.js.map +1 -0
- package/models/operations/getcountriesbyclicks.d.ts +1688 -0
- package/models/operations/getcountriesbyclicks.d.ts.map +1 -0
- package/models/operations/{getcountryanalytics.js → getcountriesbyclicks.js} +39 -27
- package/models/operations/getcountriesbyclicks.js.map +1 -0
- package/models/operations/getcountriesbyclicksdeprecated.d.ts +1688 -0
- package/models/operations/getcountriesbyclicksdeprecated.d.ts.map +1 -0
- package/models/operations/getcountriesbyclicksdeprecated.js +684 -0
- package/models/operations/{getcityanalytics.js.map → getcountriesbyclicksdeprecated.js.map} +1 -1
- package/models/operations/getdevicesbyclicks.d.ts +922 -0
- package/models/operations/getdevicesbyclicks.d.ts.map +1 -0
- package/models/operations/{getdeviceanalytics.js → getdevicesbyclicks.js} +31 -23
- package/models/operations/getdevicesbyclicks.js.map +1 -0
- package/models/operations/getdevicesbyclicksdeprecated.d.ts +922 -0
- package/models/operations/getdevicesbyclicksdeprecated.d.ts.map +1 -0
- package/models/operations/getdevicesbyclicksdeprecated.js +423 -0
- package/models/operations/getdevicesbyclicksdeprecated.js.map +1 -0
- package/models/operations/getlinkinfo.d.ts +1 -7
- package/models/operations/getlinkinfo.d.ts.map +1 -1
- package/models/operations/getlinkinfo.js.map +1 -1
- package/models/operations/getlinks.d.ts +18 -20
- package/models/operations/getlinks.d.ts.map +1 -1
- package/models/operations/getlinks.js +7 -3
- package/models/operations/getlinks.js.map +1 -1
- package/models/operations/getlinkscount.d.ts +25 -24
- package/models/operations/getlinkscount.d.ts.map +1 -1
- package/models/operations/getlinkscount.js +20 -6
- package/models/operations/getlinkscount.js.map +1 -1
- package/models/operations/getmetatags.d.ts +2 -10
- package/models/operations/getmetatags.d.ts.map +1 -1
- package/models/operations/getmetatags.js.map +1 -1
- package/models/operations/getosbyclicks.d.ts +922 -0
- package/models/operations/getosbyclicks.d.ts.map +1 -0
- package/models/operations/{getosanalytics.js → getosbyclicks.js} +31 -23
- package/models/operations/getosbyclicks.js.map +1 -0
- package/models/operations/getosbyclicksdeprecated.d.ts +922 -0
- package/models/operations/getosbyclicksdeprecated.d.ts.map +1 -0
- package/models/operations/getosbyclicksdeprecated.js +423 -0
- package/models/operations/getosbyclicksdeprecated.js.map +1 -0
- package/models/operations/getqrcode.d.ts +18 -12
- package/models/operations/getqrcode.d.ts.map +1 -1
- package/models/operations/getqrcode.js +7 -3
- package/models/operations/getqrcode.js.map +1 -1
- package/models/operations/getreferersbyclicks.d.ts +922 -0
- package/models/operations/getreferersbyclicks.d.ts.map +1 -0
- package/models/operations/{getrefereranalytics.js → getreferersbyclicks.js} +31 -23
- package/models/operations/getreferersbyclicks.js.map +1 -0
- package/models/operations/getreferersbyclicksdeprecated.d.ts +922 -0
- package/models/operations/getreferersbyclicksdeprecated.d.ts.map +1 -0
- package/models/operations/getreferersbyclicksdeprecated.js +423 -0
- package/models/operations/getreferersbyclicksdeprecated.js.map +1 -0
- package/models/operations/gettags.d.ts +1 -2
- package/models/operations/gettags.d.ts.map +1 -1
- package/models/operations/gettags.js.map +1 -1
- package/models/operations/gettimeseriesbyclicks.d.ts +922 -0
- package/models/operations/gettimeseriesbyclicks.d.ts.map +1 -0
- package/models/operations/{gettimeseriesanalytics.js → gettimeseriesbyclicks.js} +24 -16
- package/models/operations/{gettoplinks.js.map → gettimeseriesbyclicks.js.map} +1 -1
- package/models/operations/gettimeseriesbyclicksdeprecated.d.ts +922 -0
- package/models/operations/gettimeseriesbyclicksdeprecated.d.ts.map +1 -0
- package/models/operations/gettimeseriesbyclicksdeprecated.js +423 -0
- package/models/operations/gettimeseriesbyclicksdeprecated.js.map +1 -0
- package/models/operations/gettoplinksbyclicks.d.ts +922 -0
- package/models/operations/gettoplinksbyclicks.d.ts.map +1 -0
- package/models/operations/{gettoplinks.js → gettoplinksbyclicks.js} +31 -23
- package/models/operations/gettoplinksbyclicks.js.map +1 -0
- package/models/operations/gettoplinksbyclicksdeprecated.d.ts +922 -0
- package/models/operations/gettoplinksbyclicksdeprecated.d.ts.map +1 -0
- package/models/operations/gettoplinksbyclicksdeprecated.js +423 -0
- package/models/operations/gettoplinksbyclicksdeprecated.js.map +1 -0
- package/models/operations/gettopurlsbyclicks.d.ts +922 -0
- package/models/operations/gettopurlsbyclicks.d.ts.map +1 -0
- package/models/operations/{gettopurls.js → gettopurlsbyclicks.js} +31 -23
- package/models/operations/{getclicksanalytics.js.map → gettopurlsbyclicks.js.map} +1 -1
- package/models/operations/gettopurlsbyclicksdeprecated.d.ts +922 -0
- package/models/operations/gettopurlsbyclicksdeprecated.d.ts.map +1 -0
- package/models/operations/gettopurlsbyclicksdeprecated.js +423 -0
- package/models/operations/gettopurlsbyclicksdeprecated.js.map +1 -0
- package/models/operations/getworkspace.d.ts +1 -4
- package/models/operations/getworkspace.d.ts.map +1 -1
- package/models/operations/getworkspace.js.map +1 -1
- package/models/operations/index.d.ts +20 -10
- package/models/operations/index.d.ts.map +1 -1
- package/models/operations/index.js +20 -10
- package/models/operations/index.js.map +1 -1
- package/models/operations/listdomains.d.ts +1 -2
- package/models/operations/listdomains.d.ts.map +1 -1
- package/models/operations/listdomains.js.map +1 -1
- package/models/operations/setprimarydomain.d.ts +1 -4
- package/models/operations/setprimarydomain.d.ts.map +1 -1
- package/models/operations/setprimarydomain.js.map +1 -1
- package/models/operations/transferdomain.d.ts +2 -9
- package/models/operations/transferdomain.d.ts.map +1 -1
- package/models/operations/transferdomain.js.map +1 -1
- package/models/operations/updatedomain.d.ts +15 -17
- package/models/operations/updatedomain.d.ts.map +1 -1
- package/models/operations/updatedomain.js +7 -3
- package/models/operations/updatedomain.js.map +1 -1
- package/models/operations/updatelink.d.ts +5 -287
- package/models/operations/updatelink.d.ts.map +1 -1
- package/models/operations/updatelink.js.map +1 -1
- package/models/operations/upsertlink.d.ts +4 -282
- package/models/operations/upsertlink.d.ts.map +1 -1
- package/models/operations/upsertlink.js.map +1 -1
- package/package.json +1 -1
- package/sdk/analytics.d.ts +39 -25
- package/sdk/analytics.d.ts.map +1 -1
- package/sdk/analytics.js +70 -248
- package/sdk/analytics.js.map +1 -1
- package/sdk/clicks.d.ts +87 -0
- package/sdk/clicks.d.ts.map +1 -0
- package/sdk/clicks.js +2355 -0
- package/sdk/clicks.js.map +1 -0
- package/sdk/links.d.ts +2 -2
- package/sdk/links.js +2 -2
- package/src/lib/config.ts +3 -3
- package/src/models/components/domainschema.ts +10 -19
- package/src/models/components/linkschema.ts +11 -293
- package/src/models/components/security.ts +1 -5
- package/src/models/components/tagschema.ts +10 -12
- package/src/models/components/workspaceschema.ts +20 -43
- package/src/models/errors/badrequest.ts +11 -17
- package/src/models/errors/conflict.ts +11 -17
- package/src/models/errors/forbidden.ts +11 -17
- package/src/models/errors/internalservererror.ts +11 -19
- package/src/models/errors/inviteexpired.ts +11 -18
- package/src/models/errors/notfound.ts +11 -17
- package/src/models/errors/ratelimitexceeded.ts +11 -19
- package/src/models/errors/unauthorized.ts +11 -18
- package/src/models/errors/unprocessableentity.ts +11 -19
- package/src/models/operations/adddomain.ts +10 -15
- package/src/models/operations/bulkcreatelinks.ts +8 -288
- package/src/models/operations/createlink.ts +8 -288
- package/src/models/operations/createtag.ts +10 -11
- package/src/models/operations/createworkspace.ts +1 -7
- package/src/models/operations/deletedomain.ts +2 -10
- package/src/models/operations/deletelink.ts +2 -10
- package/src/models/operations/{getbrowseranalytics.ts → getbrowsersbyclicks.ts} +39 -59
- package/src/models/operations/getbrowsersbyclicksdeprecated.ts +538 -0
- package/src/models/operations/getcitiesbyclicks.ts +797 -0
- package/src/models/operations/{getcityanalytics.ts → getcitiesbyclicksdeprecated.ts} +67 -69
- package/src/models/operations/{getclicksanalytics.ts → getclickscount.ts} +27 -40
- package/src/models/operations/getclickscountdeprecated.ts +483 -0
- package/src/models/operations/{getcountryanalytics.ts → getcountriesbyclicks.ts} +49 -68
- package/src/models/operations/getcountriesbyclicksdeprecated.ts +807 -0
- package/src/models/operations/{getdeviceanalytics.ts → getdevicesbyclicks.ts} +39 -59
- package/src/models/operations/getdevicesbyclicksdeprecated.ts +537 -0
- package/src/models/operations/getlinkinfo.ts +1 -8
- package/src/models/operations/getlinks.ts +16 -27
- package/src/models/operations/getlinkscount.ts +29 -31
- package/src/models/operations/getmetatags.ts +2 -12
- package/src/models/operations/{getosanalytics.ts → getosbyclicks.ts} +35 -59
- package/src/models/operations/{gettimeseriesanalytics.ts → getosbyclicksdeprecated.ts} +55 -63
- package/src/models/operations/getqrcode.ts +10 -15
- package/src/models/operations/{getrefereranalytics.ts → getreferersbyclicks.ts} +39 -59
- package/src/models/operations/getreferersbyclicksdeprecated.ts +538 -0
- package/src/models/operations/gettags.ts +1 -3
- package/src/models/operations/gettimeseriesbyclicks.ts +517 -0
- package/src/models/operations/gettimeseriesbyclicksdeprecated.ts +539 -0
- package/src/models/operations/gettoplinksbyclicks.ts +526 -0
- package/src/models/operations/{gettoplinks.ts → gettoplinksbyclicksdeprecated.ts} +56 -57
- package/src/models/operations/gettopurlsbyclicks.ts +522 -0
- package/src/models/operations/{gettopurls.ts → gettopurlsbyclicksdeprecated.ts} +55 -57
- package/src/models/operations/getworkspace.ts +1 -5
- package/src/models/operations/index.ts +20 -10
- package/src/models/operations/listdomains.ts +1 -3
- package/src/models/operations/setprimarydomain.ts +1 -5
- package/src/models/operations/transferdomain.ts +2 -11
- package/src/models/operations/updatedomain.ts +11 -22
- package/src/models/operations/updatelink.ts +9 -294
- package/src/models/operations/upsertlink.ts +8 -288
- package/src/sdk/analytics.ts +97 -317
- package/src/sdk/clicks.ts +2906 -0
- package/src/sdk/links.ts +2 -2
- package/src/types/enums.ts +16 -0
- package/src/types/index.ts +2 -0
- package/types/enums.d.ts +12 -0
- package/types/enums.d.ts.map +1 -0
- package/types/enums.js +11 -0
- package/types/enums.js.map +1 -0
- package/types/index.d.ts +2 -0
- package/types/index.d.ts.map +1 -1
- package/types/index.js +3 -1
- package/types/index.js.map +1 -1
- package/models/operations/getbrowseranalytics.d.ts +0 -418
- package/models/operations/getbrowseranalytics.d.ts.map +0 -1
- package/models/operations/getbrowseranalytics.js.map +0 -1
- package/models/operations/getcityanalytics.d.ts +0 -685
- package/models/operations/getcityanalytics.d.ts.map +0 -1
- package/models/operations/getclicksanalytics.d.ts +0 -395
- package/models/operations/getclicksanalytics.d.ts.map +0 -1
- package/models/operations/getcountryanalytics.d.ts +0 -679
- package/models/operations/getcountryanalytics.d.ts.map +0 -1
- package/models/operations/getdeviceanalytics.d.ts +0 -418
- package/models/operations/getdeviceanalytics.d.ts.map +0 -1
- package/models/operations/getdeviceanalytics.js.map +0 -1
- package/models/operations/getosanalytics.d.ts +0 -418
- package/models/operations/getosanalytics.d.ts.map +0 -1
- package/models/operations/getosanalytics.js.map +0 -1
- package/models/operations/getrefereranalytics.d.ts +0 -418
- package/models/operations/getrefereranalytics.d.ts.map +0 -1
- package/models/operations/getrefereranalytics.js.map +0 -1
- package/models/operations/gettimeseriesanalytics.d.ts +0 -418
- package/models/operations/gettimeseriesanalytics.d.ts.map +0 -1
- package/models/operations/gettimeseriesanalytics.js.map +0 -1
- package/models/operations/gettoplinks.d.ts +0 -418
- package/models/operations/gettoplinks.d.ts.map +0 -1
- package/models/operations/gettopurls.d.ts +0 -418
- package/models/operations/gettopurls.d.ts.map +0 -1
- package/models/operations/gettopurls.js.map +0 -1
|
@@ -0,0 +1,579 @@
|
|
|
1
|
+
# Clicks
|
|
2
|
+
(*analytics.clicks*)
|
|
3
|
+
|
|
4
|
+
### Available Operations
|
|
5
|
+
|
|
6
|
+
* [count](#count) - Retrieve the total clicks count
|
|
7
|
+
* [timeseries](#timeseries) - Retrieve timeseries click analytics
|
|
8
|
+
* [countries](#countries) - Retrieve top countries by clicks
|
|
9
|
+
* [cities](#cities) - Retrieve top cities by clicks
|
|
10
|
+
* [devices](#devices) - Retrieve top devices by clicks
|
|
11
|
+
* [browsers](#browsers) - Retrieve top browsers by clicks
|
|
12
|
+
* [os](#os) - Retrieve top OS by clicks
|
|
13
|
+
* [referers](#referers) - Retrieve top referers by clicks
|
|
14
|
+
* [topLinks](#toplinks) - Retrieve top links by clicks
|
|
15
|
+
* [topUrls](#topurls) - Retrieve top URLs by clicks
|
|
16
|
+
* [~~getClicksCountDeprecated~~](#getclickscountdeprecated) - Retrieve the total clicks count :warning: **Deprecated** Use `count` instead.
|
|
17
|
+
|
|
18
|
+
## count
|
|
19
|
+
|
|
20
|
+
Retrieve the total number of clicks for a link, a domain, or the authenticated workspace.
|
|
21
|
+
|
|
22
|
+
### Example Usage
|
|
23
|
+
|
|
24
|
+
```typescript
|
|
25
|
+
import { Dub } from "dub";
|
|
26
|
+
|
|
27
|
+
const dub = new Dub({
|
|
28
|
+
token: "DUB_API_KEY",
|
|
29
|
+
workspaceId: "<value>",
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
async function run() {
|
|
33
|
+
const result = await dub.analytics.clicks.count({});
|
|
34
|
+
|
|
35
|
+
// Handle the result
|
|
36
|
+
console.log(result)
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
run();
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### Parameters
|
|
43
|
+
|
|
44
|
+
| Parameter | Type | Required | Description |
|
|
45
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
46
|
+
| `request` | [operations.GetClicksCountRequest](../../models/operations/getclickscountrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
47
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
48
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
### Response
|
|
52
|
+
|
|
53
|
+
**Promise<[number](../../models/.md)>**
|
|
54
|
+
### Errors
|
|
55
|
+
|
|
56
|
+
| Error Object | Status Code | Content Type |
|
|
57
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
58
|
+
| errors.BadRequest | 400 | application/json |
|
|
59
|
+
| errors.Unauthorized | 401 | application/json |
|
|
60
|
+
| errors.Forbidden | 403 | application/json |
|
|
61
|
+
| errors.NotFound | 404 | application/json |
|
|
62
|
+
| errors.Conflict | 409 | application/json |
|
|
63
|
+
| errors.InviteExpired | 410 | application/json |
|
|
64
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
65
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
66
|
+
| errors.InternalServerError | 500 | application/json |
|
|
67
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
68
|
+
|
|
69
|
+
## timeseries
|
|
70
|
+
|
|
71
|
+
Retrieve timeseries click analytics for a link, a domain, or the authenticated workspace over a period of time.
|
|
72
|
+
|
|
73
|
+
### Example Usage
|
|
74
|
+
|
|
75
|
+
```typescript
|
|
76
|
+
import { Dub } from "dub";
|
|
77
|
+
|
|
78
|
+
const dub = new Dub({
|
|
79
|
+
token: "DUB_API_KEY",
|
|
80
|
+
workspaceId: "<value>",
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
async function run() {
|
|
84
|
+
const result = await dub.analytics.clicks.timeseries({});
|
|
85
|
+
|
|
86
|
+
// Handle the result
|
|
87
|
+
console.log(result)
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
run();
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### Parameters
|
|
94
|
+
|
|
95
|
+
| Parameter | Type | Required | Description |
|
|
96
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
97
|
+
| `request` | [operations.GetTimeseriesByClicksRequest](../../models/operations/gettimeseriesbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
98
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
99
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
### Response
|
|
103
|
+
|
|
104
|
+
**Promise<[operations.ResponseBody[]](../../models/.md)>**
|
|
105
|
+
### Errors
|
|
106
|
+
|
|
107
|
+
| Error Object | Status Code | Content Type |
|
|
108
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
109
|
+
| errors.BadRequest | 400 | application/json |
|
|
110
|
+
| errors.Unauthorized | 401 | application/json |
|
|
111
|
+
| errors.Forbidden | 403 | application/json |
|
|
112
|
+
| errors.NotFound | 404 | application/json |
|
|
113
|
+
| errors.Conflict | 409 | application/json |
|
|
114
|
+
| errors.InviteExpired | 410 | application/json |
|
|
115
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
116
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
117
|
+
| errors.InternalServerError | 500 | application/json |
|
|
118
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
119
|
+
|
|
120
|
+
## countries
|
|
121
|
+
|
|
122
|
+
Retrieve the top countries by number of clicks for a link, a domain, or the authenticated workspace.
|
|
123
|
+
|
|
124
|
+
### Example Usage
|
|
125
|
+
|
|
126
|
+
```typescript
|
|
127
|
+
import { Dub } from "dub";
|
|
128
|
+
|
|
129
|
+
const dub = new Dub({
|
|
130
|
+
token: "DUB_API_KEY",
|
|
131
|
+
workspaceId: "<value>",
|
|
132
|
+
});
|
|
133
|
+
|
|
134
|
+
async function run() {
|
|
135
|
+
const result = await dub.analytics.clicks.countries({});
|
|
136
|
+
|
|
137
|
+
// Handle the result
|
|
138
|
+
console.log(result)
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
run();
|
|
142
|
+
```
|
|
143
|
+
|
|
144
|
+
### Parameters
|
|
145
|
+
|
|
146
|
+
| Parameter | Type | Required | Description |
|
|
147
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
148
|
+
| `request` | [operations.GetCountriesByClicksRequest](../../models/operations/getcountriesbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
149
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
150
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
### Response
|
|
154
|
+
|
|
155
|
+
**Promise<[operations.GetCountriesByClicksResponseBody[]](../../models/.md)>**
|
|
156
|
+
### Errors
|
|
157
|
+
|
|
158
|
+
| Error Object | Status Code | Content Type |
|
|
159
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
160
|
+
| errors.BadRequest | 400 | application/json |
|
|
161
|
+
| errors.Unauthorized | 401 | application/json |
|
|
162
|
+
| errors.Forbidden | 403 | application/json |
|
|
163
|
+
| errors.NotFound | 404 | application/json |
|
|
164
|
+
| errors.Conflict | 409 | application/json |
|
|
165
|
+
| errors.InviteExpired | 410 | application/json |
|
|
166
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
167
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
168
|
+
| errors.InternalServerError | 500 | application/json |
|
|
169
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
170
|
+
|
|
171
|
+
## cities
|
|
172
|
+
|
|
173
|
+
Retrieve the top countries by number of clicks for a link, a domain, or the authenticated workspace.
|
|
174
|
+
|
|
175
|
+
### Example Usage
|
|
176
|
+
|
|
177
|
+
```typescript
|
|
178
|
+
import { Dub } from "dub";
|
|
179
|
+
|
|
180
|
+
const dub = new Dub({
|
|
181
|
+
token: "DUB_API_KEY",
|
|
182
|
+
workspaceId: "<value>",
|
|
183
|
+
});
|
|
184
|
+
|
|
185
|
+
async function run() {
|
|
186
|
+
const result = await dub.analytics.clicks.cities({});
|
|
187
|
+
|
|
188
|
+
// Handle the result
|
|
189
|
+
console.log(result)
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
run();
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
### Parameters
|
|
196
|
+
|
|
197
|
+
| Parameter | Type | Required | Description |
|
|
198
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
199
|
+
| `request` | [operations.GetCitiesByClicksRequest](../../models/operations/getcitiesbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
200
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
201
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
202
|
+
|
|
203
|
+
|
|
204
|
+
### Response
|
|
205
|
+
|
|
206
|
+
**Promise<[operations.GetCitiesByClicksResponseBody[]](../../models/.md)>**
|
|
207
|
+
### Errors
|
|
208
|
+
|
|
209
|
+
| Error Object | Status Code | Content Type |
|
|
210
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
211
|
+
| errors.BadRequest | 400 | application/json |
|
|
212
|
+
| errors.Unauthorized | 401 | application/json |
|
|
213
|
+
| errors.Forbidden | 403 | application/json |
|
|
214
|
+
| errors.NotFound | 404 | application/json |
|
|
215
|
+
| errors.Conflict | 409 | application/json |
|
|
216
|
+
| errors.InviteExpired | 410 | application/json |
|
|
217
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
218
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
219
|
+
| errors.InternalServerError | 500 | application/json |
|
|
220
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
221
|
+
|
|
222
|
+
## devices
|
|
223
|
+
|
|
224
|
+
Retrieve the top devices by number of clicks for a link, a domain, or the authenticated workspace.
|
|
225
|
+
|
|
226
|
+
### Example Usage
|
|
227
|
+
|
|
228
|
+
```typescript
|
|
229
|
+
import { Dub } from "dub";
|
|
230
|
+
|
|
231
|
+
const dub = new Dub({
|
|
232
|
+
token: "DUB_API_KEY",
|
|
233
|
+
workspaceId: "<value>",
|
|
234
|
+
});
|
|
235
|
+
|
|
236
|
+
async function run() {
|
|
237
|
+
const result = await dub.analytics.clicks.devices({});
|
|
238
|
+
|
|
239
|
+
// Handle the result
|
|
240
|
+
console.log(result)
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
run();
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
### Parameters
|
|
247
|
+
|
|
248
|
+
| Parameter | Type | Required | Description |
|
|
249
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
250
|
+
| `request` | [operations.GetDevicesByClicksRequest](../../models/operations/getdevicesbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
251
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
252
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
253
|
+
|
|
254
|
+
|
|
255
|
+
### Response
|
|
256
|
+
|
|
257
|
+
**Promise<[operations.GetDevicesByClicksResponseBody[]](../../models/.md)>**
|
|
258
|
+
### Errors
|
|
259
|
+
|
|
260
|
+
| Error Object | Status Code | Content Type |
|
|
261
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
262
|
+
| errors.BadRequest | 400 | application/json |
|
|
263
|
+
| errors.Unauthorized | 401 | application/json |
|
|
264
|
+
| errors.Forbidden | 403 | application/json |
|
|
265
|
+
| errors.NotFound | 404 | application/json |
|
|
266
|
+
| errors.Conflict | 409 | application/json |
|
|
267
|
+
| errors.InviteExpired | 410 | application/json |
|
|
268
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
269
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
270
|
+
| errors.InternalServerError | 500 | application/json |
|
|
271
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
272
|
+
|
|
273
|
+
## browsers
|
|
274
|
+
|
|
275
|
+
Retrieve the top browsers by number of clicks for a link, a domain, or the authenticated workspace.
|
|
276
|
+
|
|
277
|
+
### Example Usage
|
|
278
|
+
|
|
279
|
+
```typescript
|
|
280
|
+
import { Dub } from "dub";
|
|
281
|
+
|
|
282
|
+
const dub = new Dub({
|
|
283
|
+
token: "DUB_API_KEY",
|
|
284
|
+
workspaceId: "<value>",
|
|
285
|
+
});
|
|
286
|
+
|
|
287
|
+
async function run() {
|
|
288
|
+
const result = await dub.analytics.clicks.browsers({});
|
|
289
|
+
|
|
290
|
+
// Handle the result
|
|
291
|
+
console.log(result)
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
run();
|
|
295
|
+
```
|
|
296
|
+
|
|
297
|
+
### Parameters
|
|
298
|
+
|
|
299
|
+
| Parameter | Type | Required | Description |
|
|
300
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
301
|
+
| `request` | [operations.GetBrowsersByClicksRequest](../../models/operations/getbrowsersbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
302
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
303
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
304
|
+
|
|
305
|
+
|
|
306
|
+
### Response
|
|
307
|
+
|
|
308
|
+
**Promise<[operations.GetBrowsersByClicksResponseBody[]](../../models/.md)>**
|
|
309
|
+
### Errors
|
|
310
|
+
|
|
311
|
+
| Error Object | Status Code | Content Type |
|
|
312
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
313
|
+
| errors.BadRequest | 400 | application/json |
|
|
314
|
+
| errors.Unauthorized | 401 | application/json |
|
|
315
|
+
| errors.Forbidden | 403 | application/json |
|
|
316
|
+
| errors.NotFound | 404 | application/json |
|
|
317
|
+
| errors.Conflict | 409 | application/json |
|
|
318
|
+
| errors.InviteExpired | 410 | application/json |
|
|
319
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
320
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
321
|
+
| errors.InternalServerError | 500 | application/json |
|
|
322
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
323
|
+
|
|
324
|
+
## os
|
|
325
|
+
|
|
326
|
+
Retrieve the top OS by number of clicks for a link, a domain, or the authenticated workspace.
|
|
327
|
+
|
|
328
|
+
### Example Usage
|
|
329
|
+
|
|
330
|
+
```typescript
|
|
331
|
+
import { Dub } from "dub";
|
|
332
|
+
|
|
333
|
+
const dub = new Dub({
|
|
334
|
+
token: "DUB_API_KEY",
|
|
335
|
+
workspaceId: "<value>",
|
|
336
|
+
});
|
|
337
|
+
|
|
338
|
+
async function run() {
|
|
339
|
+
const result = await dub.analytics.clicks.os({});
|
|
340
|
+
|
|
341
|
+
// Handle the result
|
|
342
|
+
console.log(result)
|
|
343
|
+
}
|
|
344
|
+
|
|
345
|
+
run();
|
|
346
|
+
```
|
|
347
|
+
|
|
348
|
+
### Parameters
|
|
349
|
+
|
|
350
|
+
| Parameter | Type | Required | Description |
|
|
351
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
352
|
+
| `request` | [operations.GetOSByClicksRequest](../../models/operations/getosbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
353
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
354
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
355
|
+
|
|
356
|
+
|
|
357
|
+
### Response
|
|
358
|
+
|
|
359
|
+
**Promise<[operations.GetOSByClicksResponseBody[]](../../models/.md)>**
|
|
360
|
+
### Errors
|
|
361
|
+
|
|
362
|
+
| Error Object | Status Code | Content Type |
|
|
363
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
364
|
+
| errors.BadRequest | 400 | application/json |
|
|
365
|
+
| errors.Unauthorized | 401 | application/json |
|
|
366
|
+
| errors.Forbidden | 403 | application/json |
|
|
367
|
+
| errors.NotFound | 404 | application/json |
|
|
368
|
+
| errors.Conflict | 409 | application/json |
|
|
369
|
+
| errors.InviteExpired | 410 | application/json |
|
|
370
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
371
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
372
|
+
| errors.InternalServerError | 500 | application/json |
|
|
373
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
374
|
+
|
|
375
|
+
## referers
|
|
376
|
+
|
|
377
|
+
Retrieve the top referers by number of clicks for a link, a domain, or the authenticated workspace.
|
|
378
|
+
|
|
379
|
+
### Example Usage
|
|
380
|
+
|
|
381
|
+
```typescript
|
|
382
|
+
import { Dub } from "dub";
|
|
383
|
+
|
|
384
|
+
const dub = new Dub({
|
|
385
|
+
token: "DUB_API_KEY",
|
|
386
|
+
workspaceId: "<value>",
|
|
387
|
+
});
|
|
388
|
+
|
|
389
|
+
async function run() {
|
|
390
|
+
const result = await dub.analytics.clicks.referers({});
|
|
391
|
+
|
|
392
|
+
// Handle the result
|
|
393
|
+
console.log(result)
|
|
394
|
+
}
|
|
395
|
+
|
|
396
|
+
run();
|
|
397
|
+
```
|
|
398
|
+
|
|
399
|
+
### Parameters
|
|
400
|
+
|
|
401
|
+
| Parameter | Type | Required | Description |
|
|
402
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
403
|
+
| `request` | [operations.GetReferersByClicksRequest](../../models/operations/getreferersbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
404
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
405
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
406
|
+
|
|
407
|
+
|
|
408
|
+
### Response
|
|
409
|
+
|
|
410
|
+
**Promise<[operations.GetReferersByClicksResponseBody[]](../../models/.md)>**
|
|
411
|
+
### Errors
|
|
412
|
+
|
|
413
|
+
| Error Object | Status Code | Content Type |
|
|
414
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
415
|
+
| errors.BadRequest | 400 | application/json |
|
|
416
|
+
| errors.Unauthorized | 401 | application/json |
|
|
417
|
+
| errors.Forbidden | 403 | application/json |
|
|
418
|
+
| errors.NotFound | 404 | application/json |
|
|
419
|
+
| errors.Conflict | 409 | application/json |
|
|
420
|
+
| errors.InviteExpired | 410 | application/json |
|
|
421
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
422
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
423
|
+
| errors.InternalServerError | 500 | application/json |
|
|
424
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
425
|
+
|
|
426
|
+
## topLinks
|
|
427
|
+
|
|
428
|
+
Retrieve the top links by number of clicks for a domain or the authenticated workspace.
|
|
429
|
+
|
|
430
|
+
### Example Usage
|
|
431
|
+
|
|
432
|
+
```typescript
|
|
433
|
+
import { Dub } from "dub";
|
|
434
|
+
|
|
435
|
+
const dub = new Dub({
|
|
436
|
+
token: "DUB_API_KEY",
|
|
437
|
+
workspaceId: "<value>",
|
|
438
|
+
});
|
|
439
|
+
|
|
440
|
+
async function run() {
|
|
441
|
+
const result = await dub.analytics.clicks.topLinks({});
|
|
442
|
+
|
|
443
|
+
// Handle the result
|
|
444
|
+
console.log(result)
|
|
445
|
+
}
|
|
446
|
+
|
|
447
|
+
run();
|
|
448
|
+
```
|
|
449
|
+
|
|
450
|
+
### Parameters
|
|
451
|
+
|
|
452
|
+
| Parameter | Type | Required | Description |
|
|
453
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
454
|
+
| `request` | [operations.GetTopLinksByClicksRequest](../../models/operations/gettoplinksbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
455
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
456
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
457
|
+
|
|
458
|
+
|
|
459
|
+
### Response
|
|
460
|
+
|
|
461
|
+
**Promise<[operations.GetTopLinksByClicksResponseBody[]](../../models/.md)>**
|
|
462
|
+
### Errors
|
|
463
|
+
|
|
464
|
+
| Error Object | Status Code | Content Type |
|
|
465
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
466
|
+
| errors.BadRequest | 400 | application/json |
|
|
467
|
+
| errors.Unauthorized | 401 | application/json |
|
|
468
|
+
| errors.Forbidden | 403 | application/json |
|
|
469
|
+
| errors.NotFound | 404 | application/json |
|
|
470
|
+
| errors.Conflict | 409 | application/json |
|
|
471
|
+
| errors.InviteExpired | 410 | application/json |
|
|
472
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
473
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
474
|
+
| errors.InternalServerError | 500 | application/json |
|
|
475
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
476
|
+
|
|
477
|
+
## topUrls
|
|
478
|
+
|
|
479
|
+
Retrieve the top URLs by number of clicks for a given short link.
|
|
480
|
+
|
|
481
|
+
### Example Usage
|
|
482
|
+
|
|
483
|
+
```typescript
|
|
484
|
+
import { Dub } from "dub";
|
|
485
|
+
|
|
486
|
+
const dub = new Dub({
|
|
487
|
+
token: "DUB_API_KEY",
|
|
488
|
+
workspaceId: "<value>",
|
|
489
|
+
});
|
|
490
|
+
|
|
491
|
+
async function run() {
|
|
492
|
+
const result = await dub.analytics.clicks.topUrls({});
|
|
493
|
+
|
|
494
|
+
// Handle the result
|
|
495
|
+
console.log(result)
|
|
496
|
+
}
|
|
497
|
+
|
|
498
|
+
run();
|
|
499
|
+
```
|
|
500
|
+
|
|
501
|
+
### Parameters
|
|
502
|
+
|
|
503
|
+
| Parameter | Type | Required | Description |
|
|
504
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
505
|
+
| `request` | [operations.GetTopURLsByClicksRequest](../../models/operations/gettopurlsbyclicksrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
506
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
507
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
508
|
+
|
|
509
|
+
|
|
510
|
+
### Response
|
|
511
|
+
|
|
512
|
+
**Promise<[operations.GetTopURLsByClicksResponseBody[]](../../models/.md)>**
|
|
513
|
+
### Errors
|
|
514
|
+
|
|
515
|
+
| Error Object | Status Code | Content Type |
|
|
516
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
517
|
+
| errors.BadRequest | 400 | application/json |
|
|
518
|
+
| errors.Unauthorized | 401 | application/json |
|
|
519
|
+
| errors.Forbidden | 403 | application/json |
|
|
520
|
+
| errors.NotFound | 404 | application/json |
|
|
521
|
+
| errors.Conflict | 409 | application/json |
|
|
522
|
+
| errors.InviteExpired | 410 | application/json |
|
|
523
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
524
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
525
|
+
| errors.InternalServerError | 500 | application/json |
|
|
526
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
527
|
+
|
|
528
|
+
## ~~getClicksCountDeprecated~~
|
|
529
|
+
|
|
530
|
+
Retrieve the total number of clicks for a link, a domain, or the authenticated workspace.
|
|
531
|
+
|
|
532
|
+
> :warning: **DEPRECATED**: This method is deprecated. Use dub.analytics.clicks.count instead.. Use `count` instead.
|
|
533
|
+
|
|
534
|
+
### Example Usage
|
|
535
|
+
|
|
536
|
+
```typescript
|
|
537
|
+
import { Dub } from "dub";
|
|
538
|
+
|
|
539
|
+
const dub = new Dub({
|
|
540
|
+
token: "DUB_API_KEY",
|
|
541
|
+
workspaceId: "<value>",
|
|
542
|
+
});
|
|
543
|
+
|
|
544
|
+
async function run() {
|
|
545
|
+
const result = await dub.analytics.clicks.getClicksCountDeprecated({});
|
|
546
|
+
|
|
547
|
+
// Handle the result
|
|
548
|
+
console.log(result)
|
|
549
|
+
}
|
|
550
|
+
|
|
551
|
+
run();
|
|
552
|
+
```
|
|
553
|
+
|
|
554
|
+
### Parameters
|
|
555
|
+
|
|
556
|
+
| Parameter | Type | Required | Description |
|
|
557
|
+
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
558
|
+
| `request` | [operations.GetClicksCountDeprecatedRequest](../../models/operations/getclickscountdeprecatedrequest.md) | :heavy_check_mark: | The request object to use for the request. |
|
|
559
|
+
| `options` | RequestOptions | :heavy_minus_sign: | Used to set various options for making HTTP requests. |
|
|
560
|
+
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | :heavy_minus_sign: | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
|
|
561
|
+
|
|
562
|
+
|
|
563
|
+
### Response
|
|
564
|
+
|
|
565
|
+
**Promise<[number](../../models/.md)>**
|
|
566
|
+
### Errors
|
|
567
|
+
|
|
568
|
+
| Error Object | Status Code | Content Type |
|
|
569
|
+
| -------------------------- | -------------------------- | -------------------------- |
|
|
570
|
+
| errors.BadRequest | 400 | application/json |
|
|
571
|
+
| errors.Unauthorized | 401 | application/json |
|
|
572
|
+
| errors.Forbidden | 403 | application/json |
|
|
573
|
+
| errors.NotFound | 404 | application/json |
|
|
574
|
+
| errors.Conflict | 409 | application/json |
|
|
575
|
+
| errors.InviteExpired | 410 | application/json |
|
|
576
|
+
| errors.UnprocessableEntity | 422 | application/json |
|
|
577
|
+
| errors.RateLimitExceeded | 429 | application/json |
|
|
578
|
+
| errors.InternalServerError | 500 | application/json |
|
|
579
|
+
| errors.SDKError | 4xx-5xx | */* |
|
|
@@ -271,7 +271,7 @@ run();
|
|
|
271
271
|
|
|
272
272
|
## update
|
|
273
273
|
|
|
274
|
-
Update a link for the authenticated workspace. If there's no change, returns as is.
|
|
274
|
+
Update a link for the authenticated workspace. If there's no change, returns it as it is.
|
|
275
275
|
|
|
276
276
|
### Example Usage
|
|
277
277
|
|
|
@@ -380,7 +380,7 @@ run();
|
|
|
380
380
|
|
|
381
381
|
## upsert
|
|
382
382
|
|
|
383
|
-
Upsert a link for the authenticated workspace by its URL. If a link with the same URL already exists,
|
|
383
|
+
Upsert a link for the authenticated workspace by its URL. If a link with the same URL already exists, return it (or update it if there are any changes). Otherwise, a new link will be created.
|
|
384
384
|
|
|
385
385
|
### Example Usage
|
|
386
386
|
|