Favorite-skript Konfiguration
Den här sidan dokumenterar konfigurationsparametrarna för favorite-skriptet.
Översikt
favorite-skriptet lägger till ett inlägg i Favoriter (på TikTok) / Sparat (på Instagram). Med flera mål-URL:er via API:t skapas en uppgift per mål-URL. Styr utförandetid med parametern start_time.
Skriptet identifierar inlägg som redan är sparade och hoppar över dem, så att köra om en uppgift inte tar bort ett inlägg från favoriter.
Skriptkonfiguration (script_config)
Konfigurationsparametrar för favorite-skriptet:
Parametrar
| Parameter | Typ | Krävs | Standard | Beskrivning |
|---|---|---|---|---|
| target_post_urls | string[] | Ja* | [] | Array med mål-URL:er att spara (en uppgift per URL) |
| target_post_url | string | Ja* | "" | Enstaka mål-URL eller flera URL:er separerade med radbrytningar/kommatecken |
Antingen target_post_urls-arrayen eller target_post_url-strängen måste anges. Om båda, har target_post_urls prioritet.
Med flera mål-URL:er skapar API:t en uppgift per mål-URL. Exempelvis: 3 URL:er + 2 enheter = 6 uppgifter. Använd start_time för att styra när uppgifter startar.
Exempel
Spara ett inlägg
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "favorite",
"script_config": {
"target_post_url": "https://www.tiktok.com/@username/video/1234567890"
}
}'
Spara flera inlägg
Med flera inlägg skapas en uppgift per inlägg:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "favorite",
"script_config": {
"target_post_urls": [
"https://www.tiktok.com/@user1/video/111",
"https://www.tiktok.com/@user2/video/222",
"https://www.tiktok.com/@user3/video/333"
]
}
}'
Skapar 3 separata uppgifter som körs omedelbart.
Schemalägg sparningar med starttid
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "favorite",
"script_config": {
"target_post_url": "https://www.tiktok.com/@username/video/1234567890"
},
"start_time": "14:30"
}'
Spara via användarnamnlista
Skapa favorite-uppgifter för specifika konton:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"usernames": ["@my_account1", "@my_account2"],
"script_name": "favorite",
"script_config": {
"target_post_url": "https://www.tiktok.com/@target/video/123"
}
}'
Instagram-exempel
På Instagram sparar favorite-skriptet inlägget (bokmärker det):
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "favorite",
"script_config": {
"target_post_url": "https://www.instagram.com/p/ABC123/"
}
}'
Svar
{
"code": 0,
"message": "success",
"data": {
"task_ids": [601, 602, 603],
"created_count": 3
}
}
URL-format
TikTok
https://www.tiktok.com/@username/video/1234567890123456
https://vm.tiktok.com/ABCDEFG/
Instagram
https://www.instagram.com/p/ABCDEFGHIJK/
https://www.instagram.com/reel/ABCDEFGHIJK/
Bästa Praxis
-
Schemalägg uppgifter: Använd parametern
start_timeför att sprida åtgärder över tid. -
Multikonto: Aktivera
enable_multi_accountför att spara inlägg med flera konton på samma enhet.
Felkoder
| Code | Beskrivning |
|---|---|
| 40001 | Mål-URL saknas |
| 40003 | Skript stöds inte via API |
| 40301 | Pro+-plan krävs |
Se Även
- Like-skript Konfiguration - Gilla inlägg
- View-skript Konfiguration - Titta på inlägg under en tid
- Uppgiftshantering API - Skapa, hantera och fråga uppgifter
- Lokalt API Översikt - API-översikt och snabbstart