القائمة
Create and manage time-limited, count-limited, and password-protected share links for uploaded files.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/heldernoid/agentic-build-templates --skill expiring-linksيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
Edit the visual grid layout of a garden bed, assigning crops to cells on a canvas editor. Use when asked to arrange crops in a bed, draw a planting layout, move crops around, visualize companion planting placement, or check for enemy crop adjacency in a specific bed. Triggers include "layout editor", "bed grid", "draw the bed", "assign crops to cells", "companion warning in layout", or similar visual planning tasks.
Plan crop rotations, planting schedules, and companion planting for garden beds and fields. Use when asked to manage a farm, garden, or plot layout; schedule what to plant and when; check companion planting relationships; track rotation history; or generate a printable planting schedule. Triggers include "crop rotation", "planting schedule", "companion planting", "garden bed", "what to plant", "frost dates", or any task involving seasonal crop planning.
Log crop harvests with yield quantity, quality grade, field, and storage destination. Use when asked to record a harvest, check total yield for a crop or field, filter harvest history by date or grade, view analytics charts, or export harvest data. Triggers include "log harvest", "record yield", "harvest entry", "crop yield", "grade breakdown", "field yield", "harvest history", or any task involving tracking what was picked and where it went.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | expiring-links |
| display_name | Expiring Share Links |
| description | Create and manage time-limited, count-limited, and password-protected share links for uploaded files. |
| base_url | http://localhost:3000 |
| auth | none |
| version | 1.0 |
Use this skill when you need to:
A share link is checked in this order when accessed via GET /dl/:token:
is_active = 1)? If not, return 410.expires_at set and in the past? Return 410.max_downloads set and download_count >= max_downloads? Return 410.password_hash != NULL)? Check X-Link-Password header. If missing or wrong, return 401.download_count and insert a downloads row.curl -X POST http://localhost:3000/api/files/ab3kx9mz1qwe/links \
-H "Content-Type: application/json" \
-d '{
"label": "7-day access",
"expires_at": "2026-03-27T00:00:00Z"
}'
curl -X POST http://localhost:3000/api/files/ab3kx9mz1qwe/links \
-H "Content-Type: application/json" \
-d '{"max_downloads": 1, "label": "One-time access"}'
After the first download, this link returns 410 Gone.
curl -X POST http://localhost:3000/api/files/ab3kx9mz1qwe/links \
-H "Content-Type: application/json" \
-d '{
"expires_at": "2026-04-20T00:00:00Z",
"max_downloads": 10,
"label": "Client share - limited"
}'
curl -X POST http://localhost:3000/api/files/ab3kx9mz1qwe/links \
-H "Content-Type: application/json" \
-d '{
"password": "MySecretPassword",
"label": "Secure access"
}'
The password is hashed with bcrypt (cost 10) before storage. It is never returned in API responses.
Use HEAD /dl/:token to check validity without downloading the file and without consuming a download slot:
curl -I http://localhost:3000/dl/pq7rn4xyz90a
Responses:
| Status | Meaning |
|---|---|
| 200 | Link is active and the file is accessible |
| 401 | Link is active but password-protected; provide X-Link-Password |
| 404 | Token does not exist |
| 410 | Link is expired, revoked, or download limit reached |
curl http://localhost:3000/api/links/pq7rn4xyz90a
Response includes:
{
"token": "pq7rn4xyz90a",
"max_downloads": 10,
"download_count": 3,
"expires_at": "2026-04-20T00:00:00Z",
"is_active": true
}
Remaining downloads = max_downloads - download_count = 7.
If max_downloads is null, the link has no download limit.
curl -X PUT http://localhost:3000/api/links/pq7rn4xyz90a \
-H "Content-Type: application/json" \
-d '{"expires_at": "2026-06-01T00:00:00Z"}'
curl -X PUT http://localhost:3000/api/links/pq7rn4xyz90a \
-H "Content-Type: application/json" \
-d '{"expires_at": null}'
curl -X PUT http://localhost:3000/api/links/pq7rn4xyz90a \
-H "Content-Type: application/json" \
-d '{"max_downloads": null}'
curl -X DELETE http://localhost:3000/api/links/pq7rn4xyz90a
This sets is_active = 0. The link immediately returns 410 for all new download attempts. The download history is preserved.
PATCH is not supported. To reactivate, use PUT to update is_active:
# Note: is_active cannot be directly set via PUT.
# Delete and recreate the link to reactivate, or use the admin UI.
The admin UI has a "Reactivate" button that calls an internal endpoint. Via the API, revocation is permanent - create a new link if access needs to be restored.
The server runs a cleanup job every CLEANUP_INTERVAL_HOURS (default: 1 hour). This job:
is_active = 0 for all links where expires_at < nowThe cleanup job does not delete download history or the file records themselves.
Link returns 410 but it was just created
Check that expires_at is in the future (UTC). The server compares against UTC time.
date -u # Check current UTC time
Password returns 401 even with the correct password
Ensure you are sending the password in the X-Link-Password request header, not as a query parameter or body field.
download_count is not incrementing
The count only increments after the file stream completes successfully. Cancelled or aborted downloads do not increment the count. Check GET /api/links/:token/downloads to see the log of completed downloads.
Link is active but still returns 410
Check max_downloads. If the count equals the limit, the link is exhausted regardless of is_active.
curl http://localhost:3000/api/links/pq7rn4xyz90a | jq '{max_downloads, download_count, expires_at, is_active}'