Esikatselu vain — aktivointi vaaditaan

Rakenna lataukset Social Video Saver: llä

SocialVideoSaver tarjoaa tämän eri verkostot kattavan rajapintaskeeman teknistä suunnittelua varten. Tuotannon tunnistetiedot pysyvät poissa käytöstä, kunnes tuki on hyväksynyt ehdotetun käyttötapauksen.

SocialSaverWorkspaceJSON HTTPS:n kauttaAsynkroniset työtLaajennetut tunnistetiedot

Pika-aloitus

SocialVideoSaver-palvelun API-palvelimen käyttö alkaa tuen aktivoimista tunnistetiedoista. Sen jälkeen käytetään asiakkaalle osoitettua päätepistettä. Kutsut tehdään vain palvelimelta.

Vuokraajan URL- osoitehttps://socialvideosaver.com

TodentaminenX-API-Key: pending_activation_…

AsiakasprofiiliSocialSaverWorkspace

API-versiov1

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

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

SocialVideoSaver säilyttää salaiset tunnistetiedot palvelimella. Niitä ei sisällytetä asiakasohjelman tiedostoihin eikä julkisiin lokeihin tai koodivarastoihin.

Linkin ratkaiseminen

SocialVideoSaver aloittaa linkin tietojen selvittämisen lähteen tunnistuksesta. Sen jälkeen näytetään yhdelle lähetetylle osoitteelle saatavilla olevat muodot. Tuloksia ei keksitä.

POSTI/v1/resolveLaajuus: ratkaista

Kenttä	Tyyppi	Pakollinen	Kuvaus
`social_url`	HTTPS- URL	- Kyllä.	Julkinen tai valtuutettu mediapohja analysoitavaksi.
`tenant`	merkkijono	Ei	Määrätty vuokralaisalue. Yleensä jätetään pois.

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

SocialVideoSaver käyttää muodon tunnistetta sellaisena kuin se palautetaan. Saatavuus tarkistetaan linkkikohtaisesti, eikä laatumerkintöjä arvata.

Luo ja seuraa lataustehtävää

SocialVideoSaver luo tehtävän lyhyellä HTTP-pyynnöllä ja tekee valmistelun asynkronisesti. Työntekijän suoritus on rajattu.

POSTI/v1/jobsLaajuus: työpaikat

Kenttä	Tyyppi	Pakollinen	Kuvaus
`social_url`	HTTPS- URL	- Kyllä.	Sama normalisoitu lähde lähetetty ratkaistavaksi.
`media_profile`	merkkijono	- Kyllä.	Tarkka tunnus ratkaisuvasteesta.
`tenant`	merkkijono	Ei	Määrätty vuokralaisalue. Yleensä jätetään pois.

curl -X POST https://socialvideosaver.com/v1/jobs \
  -H "X-API-Key: $SVS_WORKSPACE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"social_url":"https://www.youtube.com/watch?v=VIDEO_ID","media_profile":"18"}'

1202 HyväksyttyTallenna delivery_job.

2Kyselyn tilaGET /v1/jobs/{delivery_job} samalla avaimella.

3Valmiina.Avaa allekirjoitettu lataus-URL.

Tila	Merkitys	Asiakastoiminta
`queued`	Pääsi rajattuun jonoon.	Kysely uudelleen takaisinvedolla.
`extracting`	Päivitetään lähdemetatietoja tai reittiä.	Jatka äänestystä.
`processing`	Ladataan, remuxataan tai yhdistetään.	Näytä palvelimen edistyminen.
`ready`	Allekirjoitettu lataus on saatavilla.	Lähetä URL-osoite käyttäjälle.
`failed`	Päätelaitteen rakenteellinen virhe.	Lue `error_code`Yritä uudelleen vain, kun sitä kehotetaan.
`expired`	Väliaikainen tuotos poistettiin.	Luo uusi työpaikka.

curl https://socialvideosaver.com/v1/jobs/DELIVERY_JOB \
  -H "X-API-Key: $SVS_WORKSPACE_KEY"

SocialVideoSaver-palvelussa tehtävän tilan kysely alkaa yhden sekunnin odotuksella. Sen jälkeen kyselyväliä kasvatetaan määritettyyn enimmäisrajaan asti. Tiedosto toimitetaan väliaikaisella allekirjoitetulla latauslinkillä.

Ennustettavat virheet

SocialVideoSaver käyttää yhtenäistä virhevastausrakennetta HTTP-tilakoodeille, jotka eivät kuulu 2xx-ryhmään. Vastauksessa annetaan tukipyyntöä varten pyynnön tunniste, jotta asiakasohjelma voi käsitellä virheet ennakoitavasti.

{
  "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	Tyypillinen merkitys	Toimi
400	Virheellinen URL-osoite, sisältö tai formaatti ei ole saatavilla.	Korjaa pyyntö. Ratkaise uudelleen formaateille.
401	Puuttuva, virheellinen, vanhentunut tai väärän laajuuden avain.	Tarkista palvelinpuolen tunnistetiedot.
403	Vuokralaisen tai lähdepolitiikan pyyntö hylättiin.	Älä ohita käytäntöä. Ota yhteyttä tukeen.
404	Tuntematon tai vanhentunut työpaikka.	Luo uusi tehtävä, jos tarpeen.
429	Pyyntö- tai aktiivisten tehtävien raja saavutettu.	Kunnia. `retry_after_seconds`.
503	Jono/kapasiteetti tai ylävirta tilapäisesti poissa käytöstä.	Yritä uudelleen eksponentiaalisella viiveellä ja häiriöllä.

Toiminnan sopimus

SocialVideoSaver tarkistaa ennakoitua verkon ylittävää kysyntää ennen rajojen määrittämistä hyväksytylle integraatiolle.

Käytä idempotenttia sovelluslogiikkaa äläkä koskaan käynnistä päällekkäisiä tehtäviä saman käyttäjän klikkauksesta.
Välimuisti ratkaisee metatiedot lyhyesti, mutta käsittelee aina allekirjoitettuja lataus-URL-osoitteita vanhenevina.
Käytä rajattua eksponentiaalista takaisinkytkentää häiriöllä varten 429, 503 ja uudelleenyritettävä virheitä.
Käsittele vain julkista mediaa tai mediaa, johon sinulla on oikeus. DRM- ja käyttöoikeusrajoituksia ei kiertää.
Pidä pyyntö- ja työn tunnukset yksityisissä toimintalokeissa. Älä kirjaa lähetettyjä URL-osoitteita tarpeettomasti.

SocialVideoSaver-palvelun rajapintaskeeman käyttö aktivoidaan ennen tutustumista. Sen jälkeen käytetään annettuja tunnistautumistietoja ja dokumentoituja pyyntörakenteita.

TOIMIJAN TARKASTAMALLA PÄÄSY

Aktivoi tuen kautta

Kuvaile eri verkostoja käyttävä tuote, arvioitu kuukausikysyntä ja kaikki siihen kuuluvat sosiaaliset palvelut. SocialVideoSaver aktivoi vain pyydetyt analyysi- tai tehtävätoiminnot ja tallentaa tunnisteen sijaan sen tiivisteen.

Pyydä aktivointia Avain on vuokralaiskohtainen, peruutettavissa ja myönnetään Yhteydenottolomakkeen kautta. Anonyymit skriptit eivät voi suorittaa lataustyötä.