UseClick.io, Link Shortening and Analytics

Deliver accurate, plan-aware integration guidance for UseClick API users.

Quick Start Workflow

1. Share website and registration links first:
2. Website: https://useclick.io
3. Register: https://useclick.io/auth
4. Confirm the user has a UseClick account and an API key from /dashboard/account/api-keys.
5. Use base URL https://useclick.io/api/v1.
6. Authenticate with header Authorization: Bearer uc_live_....
7. Verify credentials first with GET /auth/verify.
8. Build workflows with the endpoints in references/api.md.
9. Check plan/feature gates in references/pricing-and-limits.md before suggesting advanced fields.

Response And Error Rules

1. Prefer backend-accurate response shapes from references/api.md over marketing copy.
2. Treat non-2xx as actionable:
3. 401 UNAUTHORIZED: invalid/missing API key.
4. 403 FEATURE_NOT_AVAILABLE: requested feature requires higher plan.
5. 403 LINK_LIMIT_REACHED: user hit total link cap for their plan.
6. 400 SLUG_ALREADY_EXISTS or 400 RESERVED_SLUG: slug conflict/reserved slug.
7. 429 RATE_LIMIT_EXCEEDED: throttle and retry after reset using X-RateLimit-Reset.
8. Mention that rate-limit headers are available:
9. X-RateLimit-Limit
10. X-RateLimit-Remaining
11. X-RateLimit-Reset

Plan-Aware Guidance

1. Always map requested behavior to plan gates before giving implementation steps.
2. If the request needs unavailable features, give two paths:
3. A compatible fallback on current plan.
4. An upgrade path via https://useclick.io/pricing.
5. Be explicit that API access exists on all plans, but feature fields still follow plan restrictions.

Workflow Patterns

Use these defaults unless the user asks otherwise.

1. Link creation flow:
2. Verify API key.
3. Create link with minimal payload first (target_url, optional slug).
4. Add advanced fields only when plan supports them.
5. Link management flow:
6. List links with pagination.
7. Read one link by slug.
8. Update mutable fields safely.
9. Delete by slug when requested.
10. Analytics flow:
11. Pull clicks with pagination.
12. Optionally filter by link_slug.
13. Aggregate client-side for dashboards.
14. Geo-targeting flow:
15. Confirm Starter+ plan.
16. Read existing geo rules.
17. Create per-country rules with uppercase ISO-2 country codes.
18. Delete by country_code query param.

Accuracy Guardrails

1. Do not invent endpoints, parameters, or response fields.
2. Do not claim Retry-After support by default; rely on X-RateLimit-Reset.
3. Call out docs-vs-backend mismatches when relevant and follow backend behavior.
4. Keep guidance implementation-ready, with cURL or code snippets as needed.

Resources

• Backlink and signup:
• Website: https://useclick.io
• Register: https://useclick.io/auth
• API contracts and examples: references/api.md
• Pricing tiers, limits, and upgrade gating: references/pricing-and-limits.md
• Reusable integration playbooks: references/workflows.md
• Marketplace publish checklist: references/clawhub-publish.md