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. Confirm the user has a UseClick account and an API key from
/dashboard/account/api-keys. - Use base URL
https://useclick.io/api/v1. - Authenticate with header
Authorization: Bearer uc_live_.... - Verify credentials first with
GET /auth/verify. - Build workflows with the endpoints in
references/api.md. - 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. - Treat non-2xx as actionable:
- -
401 UNAUTHORIZED: invalid/missing API key. - INLINECODE8 : requested feature requires higher plan.
- INLINECODE9 : user hit total link cap for their plan.
- INLINECODE10 or
400 RESERVED_SLUG: slug conflict/reserved slug. - INLINECODE12 : throttle and retry after reset using
X-RateLimit-Reset.
- 3. Mention that rate-limit headers are available:
- - INLINECODE14
- INLINECODE15
- INLINECODE16
Plan-Aware Guidance
- 1. Always map requested behavior to plan gates before giving implementation steps.
- If the request needs unavailable features, give two paths:
- 3. 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:
- - Verify API key.
- Create link with minimal payload first (
target_url, optional slug). - Add advanced fields only when plan supports them.
- 2. Link management flow:
- - List links with pagination.
- Read one link by slug.
- Update mutable fields safely.
- Delete by slug when requested.
- 3. Analytics flow:
- - Pull clicks with pagination.
- Optionally filter by
link_slug. - Aggregate client-side for dashboards.
- 4. Geo-targeting flow:
- - Confirm Starter+ plan.
- Read existing geo rules.
- Create per-country rules with uppercase ISO-2 country codes.
- Delete by
country_code query param.
Accuracy Guardrails
- 1. Do not invent endpoints, parameters, or response fields.
- Do not claim
Retry-After support by default; rely on X-RateLimit-Reset. - Call out docs-vs-backend mismatches when relevant and follow backend behavior.
- 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: INLINECODE23
- Pricing tiers, limits, and upgrade gating: INLINECODE24
- Reusable integration playbooks: INLINECODE25
- Marketplace publish checklist: INLINECODE26
技能名称: useclick-link-shortening-analytics
详细描述:
UseClick.io，链接缩短与分析
为UseClick API用户提供准确、考虑套餐限制的集成指导。
快速入门工作流程
- 1. 首先分享网站和注册链接：
- 2. 确认用户拥有UseClick账户以及来自/dashboard/account/api-keys的API密钥。
- 使用基础URL https://useclick.io/api/v1。
- 使用标头Authorization: Bearer uclive...进行身份验证。
- 首先通过GET /auth/verify验证凭据。
- 使用references/api.md中的端点构建工作流程。
- 在建议高级字段之前，查阅references/pricing-and-limits.md中的套餐/功能限制。
响应与错误规则
- 1. 优先使用references/api.md中后端准确的响应格式，而非营销文案。
- 将非2xx状态码视为可操作：
- - 401 UNAUTHORIZED：API密钥无效/缺失。
- 403 FEATURENOTAVAILABLE：请求的功能需要更高套餐。
- 403 LINKLIMITREACHED：用户已达到其套餐的链接总数上限。
- 400 SLUGALREADYEXISTS或400 RESERVEDSLUG：短链接别名冲突/已被保留。
- 429 RATELIMIT_EXCEEDED：限流，需根据X-RateLimit-Reset等待后重试。
- 3. 提及可用的速率限制标头：
- - X-RateLimit-Limit
- X-RateLimit-Remaining
- X-RateLimit-Reset
考虑套餐限制的指导
- 1. 在提供实施步骤前，始终将请求的行为映射到套餐限制。
- 如果请求需要不可用的功能，提供两条路径：
- 3. 明确指出所有套餐均可访问API，但功能字段仍受套餐限制。
工作流程模式
除非用户另有要求，否则使用以下默认模式。
- 1. 链接创建流程：
- - 验证API密钥。
- 首先使用最小负载创建链接（target_url，可选slug）。
- 仅在套餐支持时添加高级字段。
- 2. 链接管理流程：
- - 分页列出链接。
- 通过短链接别名读取单个链接。
- 安全更新可变字段。
- 根据请求通过短链接别名删除。
- 3. 分析流程：
- - 分页获取点击数据。
- 可选地按link_slug过滤。
- 在客户端聚合以生成仪表盘。
- 4. 地理定位流程：
- - 确认Starter+套餐。
- 读取现有地理规则。
- 使用大写ISO-2国家代码创建按国家划分的规则。
- 通过country_code查询参数删除。
准确性防护措施
- 1. 不要虚构端点、参数或响应字段。
- 不要默认声称支持Retry-After；依赖X-RateLimit-Reset。
- 在相关时指出文档与后端的不一致之处，并遵循后端行为。
- 保持指导的可实施性，根据需要提供cURL或代码片段。
资源
