Integrazzjonijiet

Ippubblika fuq spirkz minn kull scheduler

L-API tal-Integrazzjonijiet iħalli schedulers ta' partijiet terzi — Zapier, Metricool, Buffer u simili — jibagħtu vidjows lil spirkz f'isem kreatur. Vidjo mibgħut hawn jgħaddi mill-istess regoli u mill-istess kju ta' reviżjoni bħal wieħed imtella' fl-app.

URL bażi: https://server.spirkz.com/api/v1/integrations

Kif jaħdem

1
Il-kreatur joħloq API key fl-app ta' spirkz u jwaħħalha fl-scheduler.
2
L-scheduler isejjaħ POST /videos b'videoUrl pubbliku u d-dettalji. spirkz twieġeb 202 minnufih.
3
spirkz tniżżel il-fajl fl-isfond, taħżnu, u toħloq sottomissjoni pending għall-kreatur.
4
It-tim ta' spirkz jirrevedi. Jekk jiġi approvat u scheduledAt għadu fil-futur, jitla' f'dak il-ħin; inkella jitla' minnufih.
5
L-scheduler jagħmel poll ta' GET /videos/:id għall-progress.

Awtentikazzjoni

Ibgħat l-key tal-kreatur ma' kull talba. Key nieqsa, mhux magħrufa jew revokata tieħu 401. L-keys jaġixxu bħala l-kreatur li ħariġhom.

Authorization: Bearer spk_...

Limiti tar-rata, għal kull key

600

talbiet fis-siegħa, b'kollox

sejħiet ta' POST /videos fis-siegħa

Endpoints

GET/me

Test tal-konnessjoni. Sejjaħha eżatt wara li l-kreatur iwaħħal l-key tiegħu.

{ "user": { "id", "name", "username" }, "keyName" }

GET/categoriesGET/languages

Dejta għall-pickers tiegħek: categoryIds validi (kategoriji attivi; ?locale= għall-ismijiet) u valuri ta' languageSlug.

POST/videos

Ibgħat vidjo. Il-body huwa JSON:

Qasam		Regoli
videoUrl	Meħtieġ	`https`, aċċessibbli pubblikament, ≤ 2000 karattru. mp4 / mov / webm / avi, ≤ 500 MB. L-indirizzi privati jew interni jiġu rrifjutati.
source	Meħtieġ	Min qed jibgħat, eż. `"zapier"`, `"metricool"`. ≤ 50 karattru, maħżun bl-ittri żgħar.
name	Meħtieġ	≤ 150 karattru.
categoryIds	Meħtieġ	1–5 ids minn `GET /categories`.
description	Mhux obbligatorju	≤ 500 karattru.
languageSlug	Mhux obbligatorju	Minn `GET /languages`. Default `en`.
tag	Mhux obbligatorju	Array ta' strings, sa 10 tags, kull wieħed ≤ 40 karattru.
duration	Mhux obbligatorju	Sekondi, numru sħiħ mhux negattiv.
scheduledAt	Mhux obbligatorju	ISO 8601. Mill-inqas 10 minuti u l-iktar 60 jum 'il quddiem. Ħallih barra jew `null` = jitla' mal-approvazzjoni.

202 — data.video b'status: "received".
400 / 404 — qasam mhuwiex validu. Xejn ma jinħażen.
409 — il-kreatur diġà għandu 10 vidjows li qed jistennew sottomissjoni jew reviżjoni (inklużi dawk li għadhom qed jitniżżlu).

GET/videosGET/videos/:id

Il-vidjows tal-integrazzjoni tal-kreatur, l-aħħar l-ewwel (?limit, ?offset), jew wieħed bl-id.

{
  "id": "...",
  "source": "zapier",
  "video_url": "https://...",
  "status": "submitted",
  "error": null,
  "created_at": "...",
  "updated_at": "...",
  "userVideo": {
    "id": "...",
    "name": "...",
    "status": "pending",
    "scheduled_at": "2026-10-10T09:00:00.000Z",
    "decline_reason": null,
    "publishedVideoId": null
  }
}

Segwi vidjo

Tniżżil — `status`

receivedprocessingsubmittedjewfailed

Fuq failed, ir-raġuni tinsab f'error.

Reviżjoni — `userVideo.status`

pendingscheduledapprovedjewdeclined

publishedVideoId jiġi stabbilit hekk kif il-vidjo jitla'. Vidjo miċħud ikollu decline_reason.

Eżempju

curl -X POST https://server.spirkz.com/api/v1/integrations/videos \
  -H "Authorization: Bearer spk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "videoUrl": "https://example.com/clip.mp4",
    "source": "zapier",
    "name": "Morning routine",
    "categoryIds": ["<category id>"],
    "description": "Day 1",
    "scheduledAt": "2026-10-10T09:00:00Z"
  }'

Appoġġ nattiv

Kull scheduler jista' jintegra mal-endpoints ta' hawn fuq. Dawn l-għodod diġà jappoġġjaw spirkz mill-kaxxa:

NattivgenzlJappoġġja spirkz b'mod nattiv — qabbad l-API key tiegħek u skeduljia.genzl.com →

Qed tibni integrazzjoni?

Għidilna x'qed tagħmel u se ngħinuk tiżviluppaha.

Ibgħatilna email