API SwapFlow

Pibliye kontni pwogramatikman atravè API REST

API REST

Pibliye sou nenpòt platfòm sosyal konekte ak curl, script, oswa pwòp zouti ou yo.

GET /api/cli/connections

Lis kont sosyal ou yo

POST /api/cli/publish

Pibliye kontni sou yon platfòm

POST /api/cli/posts

Pwograme yon pòs pou pibliye nan lavni

GET /api/cli/posts

Wè istwa piblikasyon yo

GET /api/cli/posts/:id

Jwenn detay pòs la

PATCH /api/cli/posts/:id

Mete ajou yon pòs pwograme

Jwenn kle API ou

Enskri nan SwapFlow pou jenere kle API epi kòmanse pibliye kontni nan fason pwogramatik.

Kòmanse

Sèlman de etap: jwenn ID koneksyon ou yo, epi pibliye. Fichye yo telechaje dirèkteman — pa bezwen telechaje sou SwapFlow anvan.

# 1. Lis kont konekte ou yo pou jwenn ID koneksyon ou
curl -s "https://www.swapflow.top/api/cli/connections" \
  -H "X-API-Key: sf_your_api_key_here" | jq .

# 2. Pibliye yon fichye dirèkteman — pa bezwen telechaje anvan!
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!"

Pwograme pòs pou pibliye nan lavni sou nenpòt platfòm. Yo pibliye otomatikman ak presizyon jiska 5 minit.

# Pwograme yon pòs pou pibliye nan lavni
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"
  }'

Ou kapab tou telechaje yon fichye epi konfigire opsyon espesifik platfòm nan:

# Pwograme yon pòs pou pibliye nan lavni
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"}}'

Referans paramèt yo

Paramèt	Obligatwa	Deskripsyon
connectionId	Yes	UUID koneksyon sosyal sib la
platform	Yes	Non platfòm (twitter, tiktok, youtube, elatriye)
file	No	Fichye medya (multipart/form-data)
file1, file2, ...	No	Plizyè fichye imaj pou piblikasyon karousèl (multipart)
mediaId	No	UUID medya ki egziste deja nan /api/media
mediaIds	No	Array JSON de UUID medya pou piblikasyon plizyè imaj
mediaUrl	No	URL dirèk pou fichye medya
caption	No	Tèks oswa caption piblikasyon
mediaType	No	video, image, oswa text (detekte otomatikman)
tiktokUserConsent	TikTok	Dwe true pou pibliye sou TikTok
tiktokPrivacyLevel	No	SELF_ONLY, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, oswa PUBLIC_TO_EVERYONE
youtubePrivacy	No	public, private, oswa unlisted (pa default: private)
youtubeIsShorts	No	true pou Shorts, false pou long (pa default: true)
pinterestBoardId	Pinterest	ID tablo Pinterest (obligatwa pou Pinterest)
snapchatType	No	spotlight oswa stories (pa default: spotlight)
scheduledAt	No	Dat ISO 8601 pou pibliye nan lavni (minimòm 5 minit). Kite vid pou pibliye imedyatman
webhookUrl	No	URL HTTPS pou callback estati pibliye/echèk
platformSettings	No	Opsyon espesifik platfòm an JSON (egzanp: TikTok privacy, YouTube tip)

Platfòm ki sipòte

twitter

tiktok

instagram standalone

facebook

youtube

threads

bluesky

snapchat

Kòmanse