بناء التنزيلات مع SaveTK

# Available only after support activation
export SAVETK_CREATOR_KEY="issued-after-review"

curl -X POST https://savetk.app/v1/resolve \
  -H "X-API-Key: $SAVETK_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'

SaveTK يجعل سلامة Credential سهلة المسح الضوئي. تبدأ الصفحة بتخزين سري على جانب الخادم ، وتنتقل إلى عدم تضمين حزمة العميل ، وتذكر بوضوح عدم وجود سجلات أو مستودعات عامة.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

SaveTK يجعل معرف الشكل سهل المسح الضوئي. تبدأ الصفحة مع القيمة المرجعية دون تغيير ، وتنتقل إلى توافر لكل رابط ، وتذكر بوضوح عدم وجود علامة جودة تخمينية.

curl -X POST https://savetk.app/v1/jobs \
  -H "X-API-Key: $SAVETK_CREATOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_link":"https://www.youtube.com/watch?v=VIDEO_ID","save_option":"18"}'

curl https://savetk.app/v1/jobs/SAVE_TASK \
  -H "X-API-Key: $SAVETK_CREATOR_KEY"

SaveTK يتعامل مع استطلاع الوظيفة من خلال التعرف أولاً على الانتظار الأولي لمدة ثانية واحدة. يتبع مع الركود المقفل ويحافظ على التسليم المؤقت الموقع في الرؤية.

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

• استخدم منطق التطبيق idempotent ولا تبدأ أبدًا وظائف مكررة لنفس نقرة المستخدم.
• تقوم ذاكرة التخزين المؤقت بحل البيانات الوصفية باختصار ، ولكنها تعامل دائمًا عناوين URL الموقّعة للتنزيل على أنها تنتهي صلاحيتها.
• استخدام الارتداد الأسي المحدود مع التشتت لـ 429, 503 والأخطاء القابلة لإعادة المحاولة.
• لا تعالج سوى الوسائط العامة أو الوسائط التي تم الإذن لك بالوصول إليها. لا يتم تجاوز DRM وضوابط الوصول.
• احتفظ بأرقام تعريف الطلبات وأرقام تعريف الوظائف في سجلات التشغيل الخاصة.لا تسجل عناوين URL المقدمة دون داع.

SaveTK يقدم ثلاث نقاط عملية للوصول إلى Schema. يأتي أولاً التفعيل قبل الاستكشاف. يغطي تدفق العمل الموفر بعد ذلك المصادقة المخصصة. نقطة نهائيتها هي أشكال الطلب الموثقة.