https://easyf.appRakenna lataukset EasyF: llä
EasyF näyttää käyttöliittymän etukäteen, jotta kehittäjät voivat arvioida työnsä. Tukiarviointi vaaditaan edelleen ennen kuin live-avain ja käyttöraja ovat käytettävissä.
EasyfClientJSON HTTPS:n kauttaAsynkroniset työtLaajennetut tunnistetiedot
01
Pika-aloitus
Selittää API isäntä, EasyF erottaa tuen aktivoitu tunnukset määritetty vuokraajan päätepisteen. A plain-kieli työnkulku antaa palvelimen vain puhelun polku oma paikka.
X-API-Key: pending_activation_…EasyfClientv1# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"
curl -X POST https://easyf.app/v1/resolve \
-H "X-API-Key: $EASYF_SERVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'Tunnistetietojen turvallisuus alkaa palvelinpuolen salaisesta tallennuksesta EasyF:ssa. Seuraava näkymä käsittelee sitä, ettei asiakaspuolen pakettiin upoteta mitään. Sivulla ei näy julkisia lokeja tai säilytettäviä tietovarastoja.
02
Linkin ratkaiseminen
Selittääkseen Resolve-toiminnon EasyF erottaa lähdetunnistuksen muodoista yhdestä lähetetystä URL-osoitteesta. Tavallisen kielen työnkulku ei anna keksittyjä tuloksia omalle paikalleen.
POSTI
/v1/resolveLaajuus: ratkaista| Kenttä | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
asset_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
}Muotoilutunniste alkaa palautetulla arvolla muuttumattomana EasyF:ssä. Seuraava näkymä kattaa linkkikohtaisen saatavuuden. Sivulla ei näy mitään arvaillun laadun merkintää.
03
Luo ja seuraa lataustehtävää
EasyF esittelee kolme käytännöllistä kohtaa työn luomisesta. Ensimmäisenä tulee asynkroninen valmistelu. Yksinkertainen työnkulku kattaa sitten lyhyen HTTP-pyynnön. Sen viimeinen kohta on rajattu työntekijän suoritus.
POSTI
/v1/jobsLaajuus: työpaikat| Kenttä | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
asset_url | HTTPS- URL | - Kyllä. | Sama normalisoitu lähde lähetetty ratkaistavaksi. |
variant_code | merkkijono | - Kyllä. | Tarkka tunnus ratkaisuvasteesta. |
tenant | merkkijono | Ei | Määrätty vuokralaisalue. Yleensä jätetään pois. |
curl -X POST https://easyf.app/v1/jobs \
-H "X-API-Key: $EASYF_SERVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'delivery_id.GET /v1/jobs/{delivery_id} samalla avaimella.| 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_codeYritä uudelleen vain, kun sitä kehotetaan. |
expired | Väliaikainen tuotos poistettiin. | Luo uusi työpaikka. |
curl https://easyf.app/v1/jobs/DELIVERY_ID \
-H "X-API-Key: $EASYF_SERVICE_KEY"EasyF lähestyy työtehtävien pollingia yhden sekunnin alkuodotuksella ja sen jälkeen rajatulla takaisinviiveellä. Selkokielinen työnkulku pitää väliaikaisen allekirjoitetun toimituksen selvästi esillä.
04
Ennustettavat virheet
EasyF järjestää Virhe sopimus ympärille yksi ei-2xx kirjekuori. Sen selkokielinen työnkulku vertaa tukipyyntötunnus. Ennakoitavissa asiakas käsittely pysyy lopullinen tarkistus.
{
"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ä. |
05
Toiminnan sopimus
EasyF sopii käytännön käyttörajoista kunkin hyväksytyn tuotteen kanssa ennustettavan ohjatun työnkulun säilyttämiseksi.
- 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,503ja 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.
Selittääkseen Schema-käyttöoikeuden, EasyF erottaa aktivoinnin ennen tutkimista määritetystä todennuksesta. Tavallisen kielen työnkulku antaa dokumentoiduille pyyntömuodoille oman paikkansa.
Aktivoi tuen kautta
Kerro EasyF:lle, mitä olet rakentamassa, kuinka usein se kutsuu API:a ja mitkä palveluntarjoajat ovat tärkeitä. Tarkistus päättää sallitut toiminnot ja näyttää sitten tunnuksen vain kerran tallentaen samalla vain sen turvallisen tiivisteen.
Pyydä aktivointia Avain on vuokralaiskohtainen, peruutettavissa ja myönnetään Yhteydenottolomakkeen kautta. Anonyymit skriptit eivät voi suorittaa lataustyötä.