ინტეგრაციები

გამოაქვეყნე spirkz-ზე ნებისმიერი დამგეგმავიდან

Integrations API საშუალებას აძლევს მესამე მხარის დამგეგმავებს — Zapier-ს, Metricool-ს, Buffer-სა და მსგავსებს — კრეატორის სახელით გამოაგზავნონ ვიდეოები spirkz-ზე. აქ გამოგზავნილი ვიდეო იმავე წესებსა და იმავე განხილვის რიგს გადის, რასაც აპლიკაციაში ატვირთული.

ბაზის URL: https://server.spirkz.com/api/v1/integrations

როგორ მუშაობს

1
კრეატორი spirkz-ის აპლიკაციაში ქმნის API გასაღებს და ჩასვამს დამგეგმავში.
2
დამგეგმავი იძახებს POST /videos-ს საჯარო videoUrl-ითა და დეტალებით. spirkz მაშინვე პასუხობს 202-ით.
3
spirkz ფონურ რეჟიმში ჩამოტვირთავს ფაილს, შეინახავს და კრეატორისთვის შექმნის მოლოდინში მყოფ განაცხადს.
4
spirkz-ის გუნდი განიხილავს მას. თუ დამტკიცდა და scheduledAt ჯერ წინაა, ამ დროს გამოქვეყნდება; სხვა შემთხვევაში მაშინვე გამოქვეყნდება.
5
დამგეგმავი ამოწმებს GET /videos/:id-ს პროგრესის სანახავად.

ავთენტიფიკაცია

გაგზავნე კრეატორის გასაღები ყოველ მოთხოვნაში. გასაღები, რომელიც არ არის, უცნობია ან გაუქმებულია, 401-ს იღებს. გასაღებები მოქმედებენ იმ კრეატორის სახელით, ვინც გასცა.

Authorization: Bearer spk_...

მოთხოვნების ლიმიტები, გასაღებზე

600

მოთხოვნა საათში, ჯამში

POST /videos გამოძახება საათში

ენდფოინთები

GET/me

კავშირის ტესტი. გამოიძახე კრეატორის მიერ გასაღების ჩასმისთანავე.

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

GET/categoriesGET/languages

მონაცემები შენი ამომრჩევებისთვის: ვალიდური categoryIds (აქტიური კატეგორიები; სახელებისთვის ?locale=) და languageSlug მნიშვნელობები.

POST/videos

ვიდეოს გაგზავნა. სხეული არის JSON:

ველი		წესები
videoUrl	სავალდებულო	`https`, საჯაროდ ხელმისაწვდომი, ≤ 2000 სიმბოლო. mp4 / mov / webm / avi, ≤ 500 MB. კერძო ან შიდა მისამართები უარყოფილია.
source	სავალდებულო	ვინ აგზავნის, მაგ. `"zapier"`, `"metricool"`. ≤ 50 სიმბოლო, ინახება მცირე ასოებით.
name	სავალდებულო	≤ 150 სიმბოლო.
categoryIds	სავალდებულო	1–5 id `GET /categories`-დან.
description	არასავალდებულო	≤ 500 სიმბოლო.
languageSlug	არასავალდებულო	`GET /languages`-დან. ნაგულისხმევი `en`.
tag	არასავალდებულო	სტრიქონების მასივი, 10 ტეგამდე, თითოეული ≤ 40 სიმბოლო.
duration	არასავალდებულო	წამები, არაუარყოფითი მთელი რიცხვი.
scheduledAt	არასავალდებულო	ISO 8601. მინიმუმ 10 წუთით და მაქსიმუმ 60 დღით წინ. გამოტოვება ან `null` = გამოქვეყნდება დამტკიცებისთანავე.

202 — data.video status: "received"-ით.
400 / 404 — ველი არასწორია. არაფერი ინახება.
409 — კრეატორს უკვე აქვს 10 ვიდეო, რომელიც გაგზავნას ან განხილვას ელოდება (მათ შორის ისინიც, რომლებიც ჯერ იტვირთება).

GET/videosGET/videos/:id

კრეატორის ინტეგრაციის ვიდეოები, ახალი პირველად (?limit, ?offset), ან ერთი 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
  }
}

ვიდეოს თვალყურის დევნება

ჩამოტვირთვა — `status`

receivedprocessingsubmittedანfailed

failed-ის შემთხვევაში მიზეზი error-შია.

განხილვა — `userVideo.status`

pendingscheduledapprovedანdeclined

publishedVideoId ივსება, როცა ვიდეო გამოქვეყნდება. უარყოფილ ვიდეოს აქვს decline_reason.

მაგალითი

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"
  }'

მშობლიური მხარდაჭერა

ნებისმიერ დამგეგმავს შეუძლია ზემოთ მოცემულ ენდფოინთებთან ინტეგრაცია. ეს ხელსაწყოები spirkz-ს უკვე მხარს უჭერენ დამატებითი მოქმედებების გარეშე:

მშობლიურიgenzlმხარს უჭერს spirkz-ს მშობლიურად — დააკავშირე შენი API გასაღები და დაგეგმე.genzl.com →

აშენებ ინტეგრაციას?

გვითხარი, რას აკეთებ, და გამოშვებაში დაგეხმარებით.

მოგვწერე ელფოსტით