පෙරදසුන පමණි — සක්‍රීය කිරීම අවශ්‍යයි

Insto සමඟ බිල්ඩ් බාගත කිරීම්

Insto ඇගයීම සඳහා දෘශ්‍ය මාධ්‍ය ඒකාබද්ධ කිරීමේ සැලැස්මක් ඉදිරිපත් කරයි. සජීව විශ්ලේෂණය සහ රැකියා ඉල්ලීම් සහාය දෙන තෙක් කුලීකරුවන්ට අදාළ අනුමැතිය ලබා දෙන තෙක් ලබා ගත නොහැක.

InstoMediaHTTPS මත JSONඅසමකාලීන රැකියාපරාසගත සහතික

ඉක්මන් ආරම්භය

API සත්කාරක සඳහා, Insto ආරම්භ වේ support-activated credentials සමඟ. එහි බාගත කිරීමේ සමාලෝචනය ඒකකය සමඟ පවරා ඇති කුලීන් අන්තර්ගතය එක් කරයි සහ සේවාදායක-මात्र ඇමතුම් මාර්ගයකින් අවසන් වේ.

භාණ්ඩාගාරික URLhttps://insto.app

සත්‍යාපනයX-API-Key: pending_activation_…

පාරිභෝගික පැතිකඩInstoMedia

API අනුවාදයv1

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

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

Insto සහතික ආරක්ෂාව සඳහා ප්‍රායෝගික කරුණු තුනක් ඉදිරිපත් කරයි. පළමුව සේවාදායක පාර්ශ්ව රහස් ගබඩා කිරීම. බාගත කිරීමේ සමාලෝචනය පසුව කිසිදු පාරිභෝගික බන්ඩල් ඇතුළත් කිරීමක් නොමැති බව ආවරණය කරයි. එහි අවසන් කරුණ වන්නේ කිසිදු මහජන ලොග් හෝ ගබඩා ස්ථාන නොමැති බවයි.

සබැඳිය විසඳන්න

විසඳුම් මෙහෙයුම සඳහා, Insto මූලාශ්‍ර හඳුනා ගැනීමෙන් ආරම්භ කරයි. එහි බාගත කිරීමේ සමාලෝචනය එක් URL එකකින් ඉදිරිපත් කරන ලද ආකෘති සමඟ ඒකරාශී කරයි සහ නිර්මාණය කළ ප්‍රතිදානයක් නොමැතිව අවසන් කරයි.

POST/v1/resolveපරාසය: විසඳන්න

ක්ෂේත්‍රය	වර්ගය	අවශ්‍ය	විස්තරය
`media_source`	HTTPS URL	ඔව්	විශ්ලේෂණය සඳහා මහජන හෝ අනුමත මාධ්‍ය පිටුවක්.
`tenant`	ස්ට්‍රිං	නැත	පවරා ඇති කුලීකරුවන්ගේ ඩොමේනය. සාමාන්‍යයෙන් අතහැර දමයි.

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

Insto ආකෘති හැඳුනුම්පත සඳහා ප්‍රායෝගික කරුණු තුනක් ඉදිරිපත් කරයි. පළමුව ආපසු ලැබුණු අගය වෙනස් නොවී ඇත. බාගත කිරීමේ සමාලෝචනය සබැඳිය අනුව ලබා ගැනීම ආවරණය කරයි. එහි අවසන් කරුණ වන්නේ අනුමානිත ගුණාත්මක ලේබලයක් නොමැති වීමයි.

බාගත කිරීමේ කාර්යයක් නිර්මාණය කර අනුගමනය කරන්න

Insto රැකියා නිර්මාණය අසමකාලීන සූදානම වටා සංවිධානය කරයි. එහි බාගත කිරීමේ සමාලෝචනය කෙටි HTTP ඉල්ලීමක් සමඟ සසඳයි. සීමාසහිත කාර්ය මණ්ඩල ක්‍රියාත්මක කිරීම අවසන් පරීක්ෂණය ලෙස ඉතිරි වේ.

POST/v1/jobsපරාසය: රැකියා

ක්ෂේත්‍රය	වර්ගය	අවශ්‍ය	විස්තරය
`media_source`	HTTPS URL	ඔව්	විසඳීමට ඉදිරිපත් කළ එකම සාමාන්‍යීකෘත මූලාශ්‍රය.
`media_variant`	ස්ට්‍රිං	ඔව්	විසඳුම් ප්‍රතිචාරයෙන් නිවැරදි හැඳුනුම් අංකයක්.
`tenant`	ස්ට්‍රිං	නැත	පවරා ඇති කුලීකරුවන්ගේ ඩොමේනය. සාමාන්‍යයෙන් අතහැර දමයි.

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

1202 පිළිගත්සුරකින්න prepare_id.

2සමීක්ෂණ තත්ත්වයGET /v1/jobs/{prepare_id} එම යතුර සමඟ.

3සූදානම්අත්සන් කළ බාගත කිරීමේ URL විවෘත කරන්න.

තත්ත්වය	අර්ථය	පාරිභෝගික ක්‍රියාව
`queued`	සීමාසහිත පෝරමයට පිවිස ඇත.	ආපසු යාම සමඟ නැවත මත පරීක්ෂණය කරන්න.
`extracting`	මූලාශ්‍ර මැටාදත්ත හෝ මාර්ගය යළි පිරික්සමින්.	පොලිං දිගටම කරගන්න.
`processing`	බාගත කිරීම, නැවත මාරු කිරීම හෝ ඒකාබද්ධ කිරීම.	සේවාදායක ප්‍රගතිය පෙන්වන්න.
`ready`	අත්සන් කළ බාගත කිරීම ලබා ගත හැක.	URL පරිශීලකයාට යවන්න.
`failed`	ටර්මිනල් ව්‍යුහගත දෝෂයක්.	පොඩින්න `error_code`. උපදෙස් දුන් විට පමණක් නැවත උත්සාහ කරන්න.
`expired`	තාවකාලික ප්‍රතිදානය ඉවත් කරන ලදී.	නව රැකියාවක් සාදන්න.

curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Insto හි, රැකියා පරීක්ෂණය විස්තර කිරීමේදී පළමුව තත්පරයක් ආරම්භක බලාපොරොත්තුවක් ඇත. එම බාගත කිරීමේ සමාලෝචනය සීමාසහිත ප්‍රතිචාර සමඟ අනුගමනය කරයි සහ තාවකාලික අත්සන් කළ බෙදාහැරීමේදී වසා දමයි.

පූර්ව අනාවැකි දෝෂ

දෝෂ ගිවිසුම පැහැදිලි කිරීමට, Insto එකක් නොවන 2xx ලිපිගොනුවක් සහාය ඉල්ලීමේ හැඳුනුම්පතෙන් වෙන් කරයි. බාගත කිරීමේ සමාලෝචනයක් පාරිභෝගිකයාට තම ස්ථානය ලබා දෙන පරිදි පූර්ව අනුමාන කළ හැකි කළමනාකරණයක් සපයයි.

{
  "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": "…"
}

HTTP	සාමාන්‍ය අර්ථය	ක්‍රියා
400	අවලංගු URL, ශරීරය හෝ ලබාගත නොහැකි ආකෘතිය.	අයදුම්පත නිවැරදි කරන්න. ආකෘති සඳහා නැවත විසඳන්න.
401	අහිමි, වැරදි, කල් ඉකුත් වූ හෝ වැරදි පරාසයේ යතුර.	සේවාදායක පාර්ශ්වයේ සහතික පරීක්ෂා කරන්න.
403	කිරුළිය හෝ මූලාශ්‍ර ප්‍රතිපත්තිය ඉල්ලීම ප්‍රතික්ෂේප කළා.	නීතිය හරහා යාමට ඉඩ නොදෙන්න. සහාය අමතන්න.
404	නොදන්නා හෝ කල් ඉකුත් වූ රැකියා.	සුදුසුනම් නව රැකියාවක් සාදන්න.
429	අයදුම්පත හෝ සක්‍රීය රැකියා සීමාවට ළඟා වී ඇත.	ගෞරවය `retry_after_seconds`.
503	පෝරමය/සමර්ථතාව හෝ ඉහළ ගමන් මාර්ගය තාවකාලිකව ලබා ගත නොහැක.	ආරෝහණීය ප්‍රතික්ෂේප සහ කම්පනය සමඟ නැවත උත්සාහ කරන්න.

මෙහෙයුම් ගිවිසුම

Insto දෘශ්‍ය මාධ්‍ය භාවිතා කේස් සහ අනුමත ගනුදෙනුකරු සම්බන්ධ වීමට නියමිත ජාල අනුව ඇමතුම් සීමා අභිරුචිකරණය කරයි.

අයිඩම්පොටන්ට් යෙදුම් ලොජික් භාවිතා කරන්න සහ එකම පරිශීලක ක්ලික් සඳහා නකල් රැකියා කිසි විටෙකත් ආරම්භ නොකරන්න.
සංක්ෂිප්තව මැටාදත්ත විසඳන්න, නමුත් සෑම විටම අත්සන් කළ බාගත URL කාලසීමාව ඉක්මවා යන බව සැලකිල්ලට ගන්න.
සීමාසහිත ප්‍රතිගාමී ප්‍රතිචාරය සහිතව භාවිතා කරන්න 429, 503 සහ නැවත උත්සාහ කළ හැකි දෝෂ.
පොදු මාධ්‍ය හෝ ඔබට ප්‍රවේශ වීමට අනුමත කරන ලද මාධ්‍ය පමණක් සැකසිය යුතුය. DRM සහ ප්‍රවේශ පාලන ඉවත නොහැරේ.
අයදුම්පත් හැඳුනුම් අංක සහ රැකියා හැඳුනුම් අංක පෞද්ගලික මෙහෙයුම් ලොග් වල තබා ගන්න. ඉදිරිපත් කළ URL අතිරික්තව ලොග් නොකරන්න.

Schema ප්‍රවේශය සඳහා, Insto සක්‍රීය කිරීමෙන් පසු සෙවීම ආරම්භ කරයි. එහි බාගත කිරීමේ සමාලෝචනය පවරා ඇති සත්‍යාපනය සමඟ යුගල කරයි සහ ලේඛිත ඉල්ලීම් ආකෘති සමඟ අවසන් වේ.

මෙහෙයුම්කරු-සමාලෝචනය කළ ප්‍රවේශය

සහාය මඟින් සක්‍රීය කරන්න

දෘශ්‍ය මාධ්‍ය නිෂ්පාදනය, අපේක්ෂිත මාසික භාවිතය සහ ඔබ කළමනාකරණය කිරීමට සැලසුම් කරන පළ කිරීමේ වර්ග සටහන් කරන්න. Insto අවශ්‍ය විශ්ලේෂණ හෝ සූදානම් කිරීමේ පරාස පමණක් ලබා දෙන අතර කියවිය හැකි ටෝකනය කිසි විටෙකත් ගබඩා නොකරයි.

සක්‍රීය කිරීම ඉල්ලීම යතුරු කුලීකරුවන්ට සීමා කර ඇති අතර, අහඹු ලෙස අවලංගු කළ හැකි අතර සම්බන්ධතා පෝරමය හරහා නිකුත් කර ඇත. අනන්‍ය ලිපිනයන් බාගත කිරීමේ වැඩසටහන් ක්‍රියාත්මක කළ නොහැක.