Create shortlinks scoped to a limited number of clicks.
Counts visits and automatically disables the link once the `max_clicks` threshold is reached. Handy for single-use downloads, gated demos, or coupon drops. Drop this helper wherever you want to create shortlinks scoped to a limited number of clicks with a single HTTP call. Send the documented inputs and the API streams back polished results you can hand directly to your users.
/links/one-time-linksWhere this helper shines
Create shortlinks scoped to a limited number of clicks. keeps links helpers on autopilot. Use it whenever you need to create shortlinks scoped to a limited number of clicks without pausing a sprint or asking design/dev to jump in.
- Trigger this helper whenever you need to create shortlinks scoped to a limited number of clicks without waiting on a full deploy.
- Drop it into automations (Zapier, Make, workers) to create shortlinks scoped to a limited number of clicks as part of your workflow.
- Share the GET URL so support and success can create shortlinks scoped to a limited number of clicks safely using their Dataczar API key.
Copy & ship snippets
GET
Instant link
GET https://api.dataczar.app/links/one-time-links?url=https%3A%2F%2Fexample.com%2Fsample.png&max_clicks=1&domain=sample-domain&dryrun=true&ak=demoOpen directly in any browser, webhook, or low-code workflow.
curl
curl GET
curl "https://api.dataczar.app/links/one-time-links?url=https%3A%2F%2Fexample.com%2Fsample.png&max_clicks=1&domain=sample-domain&dryrun=true&ak=demo"Swap ak=demo with your Dataczar API key.
curl
curl POST
curl -X POST "https://api.dataczar.app/links/one-time-links?ak=demo" \
-H 'Content-Type: application/json' \
-d '{
"url": "https://example.com/sample.png",
"max_clicks": 20,
"domain": "sample_domain",
"dryrun": true
}'Send JSON payloads from back-end jobs, queues, or workers.
Parameters
Query Parameters
| Name | Type | Description |
|---|---|---|
| url | string · required | |
| max_clicks | integer | |
| domain | string | |
| dryrun | boolean |
All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.
Responses
Status 200
Shortlink metadata
{
"ok": true,
"data": {
"slug": "abc123",
"short_url": "https://dzr.io/abc123",
"remaining_clicks": 1
},
"meta": {
"dryrun": false
}
}Examples
Request
"POST /links/one-time-links {\"url\":\"https://example.com/secret.pdf\",\"max_clicks\":3,\"dryrun\":true}"Response
{
"ok": true,
"data": {
"slug": "one321",
"short_url": "https://dzr.io/one321",
"remaining_clicks": 3
},
"meta": {
"dryrun": true
}
}Grab your Dataczar API key
Every helper runs with the same simple API key. Sign in (or create a free Dataczar account) at Dataczar Connect to issue keys in seconds, then drop the key into any `ak=` parameter and start shipping.
Tip: reuse the same key across these helpers, or rotate keys per project from the Connect dashboard.