API ya SwapFlow

Chapisha maudhui kwa njia ya programu kupitia API ya REST

API ya REST

Chapisha kwenye jukwaa lolote la kijamii lililounganishwa kwa kutumia curl, hati, au zana zako.

GET /api/cli/connections

Orodhesha akaunti zako za kijamii

POST /api/cli/publish

Chapisha maudhui kwenye jukwaa

POST /api/cli/posts

Panga chapisho la siku zijazo

GET /api/cli/posts

Tazama historia ya machapisho

GET /api/cli/posts/:id

Pata maelezo ya chapisho

PATCH /api/cli/posts/:id

Sasisha chapisho lililopangwa

Pata ufunguo wako wa API

Jisajili kwenye SwapFlow ili kutengeneza funguo za API na kuanza kuchapisha maudhui kwa njia ya programu.

Anza

Hatua mbili tu: pata ID za miunganisho yako, kisha chapisha. Faili zinapakiwa moja kwa moja — hakuna haja ya kupakia kwenye SwapFlow kwanza.

# 1. Orodhesha akaunti zilizounganishwa kupata ID ya miunganisho yako
curl -s "https://www.swapflow.top/api/cli/connections" \
  -H "X-API-Key: sf_your_api_key_here" | jq .

# 2. Chapisha faili moja kwa moja — hakuna haja ya kupakia mapema!
curl -X POST "https://www.swapflow.top/api/cli/publish" \
  -H "X-API-Key: sf_your_api_key_here" \
  -F "file=@photo.jpg" \
  -F "connectionId=YOUR_CONNECTION_ID" \
  -F "platform=twitter" \
  -F "caption=Posted from the API!"

Panga machapisho ya siku zijazo kwenye jukwaa lolote. Yanachapishwa kiotomatiki kwa usahihi wa hadi dakika 5.

# Panga chapisho la siku zijazo
curl -X POST "https://www.swapflow.top/api/cli/posts" \
  -H "X-API-Key: sf_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "CONNECTION_ID",
    "caption": "Launching tomorrow!",
    "scheduledAt": "2026-04-01T15:30:00Z"
  }'

Unaweza pia kupakia faili na kuweka chaguo maalum za jukwaa:

# Panga chapisho la siku zijazo
curl -X POST "https://www.swapflow.top/api/cli/posts" \
  -H "X-API-Key: sf_your_api_key_here" \
  -F "file=@video.mp4" \
  -F "connectionId=CONNECTION_ID" \
  -F "caption=Check this out!" \
  -F "scheduledAt=2026-04-01T15:30:00Z" \
  -F 'platformSettings={"youtube":{"privacyStatus":"public","videoType":"shorts"}}'

Rejea ya vigezo

Kigezo	Inahitajika	Maelezo
connectionId	Yes	UUID ya miunganisho ya kijamii lengwa
platform	Yes	Jina la jukwaa (twitter, tiktok, youtube, nk.)
file	No	Faili ya media (multipart/form-data)
file1, file2, ...	No	Faili nyingi za picha kwa machapisho ya carousel (multipart)
mediaId	No	UUID ya media iliyopo kutoka /api/media
mediaIds	No	Safu ya JSON ya UUID za media kwa machapisho ya picha nyingi
mediaUrl	No	URL ya moja kwa moja ya faili ya media
caption	No	Maandishi au maelezo ya chapisho
mediaType	No	video, image, au text (inagunduliwa kiotomatiki)
tiktokUserConsent	TikTok	Lazima iwe true kuchapisha kwenye TikTok
tiktokPrivacyLevel	No	SELF_ONLY, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, au PUBLIC_TO_EVERYONE
youtubePrivacy	No	public, private, au unlisted (chaguo-msingi: private)
youtubeIsShorts	No	true kwa Shorts, false kwa ndefu (chaguo-msingi: true)
pinterestBoardId	Pinterest	ID ya bodi ya Pinterest (inahitajika kwa Pinterest)
snapchatType	No	spotlight au stories (chaguo-msingi: spotlight)
scheduledAt	No	Tarehe ya ISO 8601 ya kuchapisha baadaye (angalau dakika 5 mbele). Acha ili kuchapisha mara moja
webhookUrl	No	URL ya HTTPS kwa callbacks za hali ya kuchapisha/kushindwa
platformSettings	No	Chaguo maalum za jukwaa katika JSON (mfano: faragha ya TikTok, aina ya YouTube)

Majukwaa yanayoungwa mkono

twitter

tiktok

instagram standalone

facebook

youtube

threads

bluesky

snapchat

Anza