1025 lines
35 KiB
Plaintext
1025 lines
35 KiB
Plaintext
syntax = "v1"
|
|
|
|
type (
|
|
ThreadsAccountData {
|
|
ID string `json:"id"`
|
|
DisplayName string `json:"display_name,omitempty"`
|
|
Username string `json:"username,omitempty"`
|
|
ThreadsUserID string `json:"threads_user_id,omitempty"`
|
|
PersonaID string `json:"persona_id,omitempty"` // deprecated: persona is chosen per publish, not bound to account
|
|
BrowserConnected bool `json:"browser_connected"`
|
|
ApiConnected bool `json:"api_connected"`
|
|
APITokenExpiresAt int64 `json:"api_token_expires_at,omitempty"`
|
|
Status string `json:"status"`
|
|
CreateAt int64 `json:"create_at"`
|
|
UpdateAt int64 `json:"update_at"`
|
|
}
|
|
|
|
ListThreadsAccountsData {
|
|
List []ThreadsAccountData `json:"list"`
|
|
ActiveAccountID string `json:"active_account_id"`
|
|
}
|
|
|
|
DeleteThreadsAccountData {
|
|
DeletedID string `json:"deleted_id"`
|
|
ActiveAccountID string `json:"active_account_id,omitempty"`
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
CreateThreadsAccountReq {
|
|
DisplayName string `json:"display_name,optional"`
|
|
Activate *bool `json:"activate,optional"`
|
|
}
|
|
|
|
UpdateThreadsAccountReq {
|
|
DisplayName *string `json:"display_name,optional"`
|
|
PersonaID *string `json:"persona_id,optional"` // deprecated: use persona_id in publish payload instead
|
|
}
|
|
|
|
ThreadsAccountPath {
|
|
ID string `path:"id" validate:"required"`
|
|
}
|
|
|
|
ThreadsAccountConnectionPrefs {
|
|
SearchViaApi bool `json:"search_via_api"`
|
|
SearchSourceMode string `json:"search_source_mode"`
|
|
PublishViaApi bool `json:"publish_via_api"`
|
|
DevMode bool `json:"dev_mode"`
|
|
ScrapeReplies bool `json:"scrape_replies"`
|
|
RepliesPerPost int `json:"replies_per_post"`
|
|
PublishHeaded bool `json:"publish_headed"`
|
|
PlaywrightDebug bool `json:"playwright_debug"`
|
|
}
|
|
|
|
ThreadsAccountConnectionData {
|
|
AccountID string `json:"account_id"`
|
|
AccountName string `json:"account_name"`
|
|
Username string `json:"username,omitempty"`
|
|
BrowserConnected bool `json:"browser_connected"`
|
|
ApiConnected bool `json:"api_connected"`
|
|
Prefs ThreadsAccountConnectionPrefs `json:"prefs"`
|
|
}
|
|
|
|
UpdateThreadsAccountConnectionReq {
|
|
SearchViaApi *bool `json:"search_via_api,optional"`
|
|
SearchSourceMode *string `json:"search_source_mode,optional"`
|
|
PublishViaApi *bool `json:"publish_via_api,optional"`
|
|
DevMode *bool `json:"dev_mode,optional"`
|
|
ScrapeReplies *bool `json:"scrape_replies,optional"`
|
|
RepliesPerPost *int `json:"replies_per_post,optional"`
|
|
PublishHeaded *bool `json:"publish_headed,optional"`
|
|
PlaywrightDebug *bool `json:"playwright_debug,optional"`
|
|
}
|
|
|
|
ImportThreadsAccountSessionReq {
|
|
StorageState string `json:"storageState" validate:"required"`
|
|
}
|
|
|
|
ImportThreadsAccountSessionData {
|
|
Success bool `json:"success"`
|
|
Valid bool `json:"valid"`
|
|
Synced bool `json:"synced"`
|
|
AccountID string `json:"account_id"`
|
|
Username string `json:"username,omitempty"`
|
|
Message string `json:"message"`
|
|
UpdateAt int64 `json:"update_at"`
|
|
}
|
|
|
|
ThreadsAccountAiSettingsData {
|
|
AccountID string `json:"account_id"`
|
|
Provider string `json:"provider"`
|
|
Model string `json:"model"`
|
|
ResearchProvider string `json:"research_provider,omitempty"`
|
|
ResearchModel string `json:"research_model,omitempty"`
|
|
ApiKeys map[string]string `json:"api_keys"`
|
|
ApiKeysConfigured map[string]interface{} `json:"api_keys_configured"`
|
|
}
|
|
|
|
UpdateThreadsAccountAiSettingsReq {
|
|
Provider *string `json:"provider,optional"`
|
|
Model *string `json:"model,optional"`
|
|
ResearchProvider *string `json:"research_provider,optional"`
|
|
ResearchModel *string `json:"research_model,optional"`
|
|
ApiKeys map[string]string `json:"api_keys,optional"`
|
|
}
|
|
|
|
UpdateThreadsAccountHandlerReq {
|
|
ThreadsAccountPath
|
|
UpdateThreadsAccountReq
|
|
}
|
|
|
|
UpdateThreadsAccountConnectionHandlerReq {
|
|
ThreadsAccountPath
|
|
UpdateThreadsAccountConnectionReq
|
|
}
|
|
|
|
ImportThreadsAccountSessionHandlerReq {
|
|
ThreadsAccountPath
|
|
ImportThreadsAccountSessionReq
|
|
}
|
|
|
|
UpdateThreadsAccountAiSettingsHandlerReq {
|
|
ThreadsAccountPath
|
|
UpdateThreadsAccountAiSettingsReq
|
|
}
|
|
|
|
ThreadsAccountAiProviderPath {
|
|
ID string `path:"id" validate:"required"`
|
|
Provider string `path:"provider" validate:"required,oneof=opencode-go xai"`
|
|
}
|
|
|
|
ListThreadsAccountAiProviderModelsReq {
|
|
ApiKey string `json:"api_key,optional"` // 選填；未帶則用已儲存的 key
|
|
}
|
|
|
|
ThreadsAccountAiProviderModelsHandlerReq {
|
|
ThreadsAccountAiProviderPath
|
|
ListThreadsAccountAiProviderModelsReq
|
|
}
|
|
|
|
ThreadsAccountAiProviderModelsData {
|
|
ID string `json:"id"`
|
|
Label string `json:"label"`
|
|
Models []string `json:"models"`
|
|
Streams bool `json:"streams"`
|
|
Error string `json:"error,optional"`
|
|
}
|
|
|
|
StartThreadsOAuthQuery {
|
|
AccountID string `form:"account_id,optional"`
|
|
}
|
|
|
|
StartThreadsOAuthData {
|
|
AuthorizeURL string `json:"authorize_url"`
|
|
State string `json:"state"`
|
|
AccountID string `json:"account_id"`
|
|
}
|
|
|
|
ThreadsOAuthCallbackQuery {
|
|
Code string `form:"code,optional"`
|
|
State string `form:"state,optional"`
|
|
Error string `form:"error,optional"`
|
|
ErrorReason string `form:"error_reason,optional"`
|
|
ErrorDescription string `form:"error_description,optional"`
|
|
}
|
|
|
|
ThreadsOAuthLogItem {
|
|
At int64 `json:"at"`
|
|
Level string `json:"level"`
|
|
Stage string `json:"stage"`
|
|
AccountID string `json:"account_id,omitempty"`
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
ListThreadsOAuthLogsData {
|
|
List []ThreadsOAuthLogItem `json:"list"`
|
|
}
|
|
|
|
ThreadsOAuthConfigData {
|
|
RedirectURI string `json:"redirect_uri"`
|
|
SuccessRedirect string `json:"success_redirect"`
|
|
Enabled bool `json:"enabled"`
|
|
RequiresHTTPS bool `json:"requires_https"`
|
|
}
|
|
|
|
ThreadsAPISmokeTestItem {
|
|
Scope string `json:"scope"`
|
|
Name string `json:"name"`
|
|
Status string `json:"status"`
|
|
Message string `json:"message"`
|
|
Count int `json:"count"`
|
|
}
|
|
|
|
RunThreadsAPISmokeTestData {
|
|
List []ThreadsAPISmokeTestItem `json:"list"`
|
|
Passed int `json:"passed"`
|
|
Failed int `json:"failed"`
|
|
Skipped int `json:"skipped"`
|
|
Total int `json:"total"`
|
|
}
|
|
|
|
RunThreadsAPIPlaygroundReq {
|
|
Action string `json:"action" validate:"required"`
|
|
Query string `json:"query,optional"`
|
|
Username string `json:"username,optional"`
|
|
MediaID string `json:"media_id,optional"`
|
|
ReplyID string `json:"reply_id,optional"`
|
|
ReplyToID string `json:"reply_to_id,optional"`
|
|
Text string `json:"text,optional"`
|
|
Permalink string `json:"permalink,optional"`
|
|
HintText string `json:"hint_text,optional"`
|
|
SkipPrime bool `json:"skip_prime,optional"`
|
|
LocationQuery string `json:"location_query,optional"`
|
|
Limit int `json:"limit,optional"`
|
|
Hide bool `json:"hide,optional"`
|
|
SearchType string `json:"search_type,optional"`
|
|
}
|
|
|
|
RunThreadsAPIPlaygroundHandlerReq {
|
|
ThreadsAccountPath
|
|
RunThreadsAPIPlaygroundReq
|
|
}
|
|
|
|
ThreadsAPIPlaygroundData {
|
|
Action string `json:"action"`
|
|
Ok bool `json:"ok"`
|
|
Message string `json:"message"`
|
|
Data string `json:"data,optional"`
|
|
}
|
|
|
|
ListThreadsPostPerformanceQuery {
|
|
Limit int `form:"limit,optional"`
|
|
}
|
|
|
|
ListThreadsPostPerformanceHandlerReq {
|
|
ThreadsAccountPath
|
|
ListThreadsPostPerformanceQuery
|
|
}
|
|
|
|
ThreadsPostMetricCapability {
|
|
Scope string `json:"scope"`
|
|
Name string `json:"name"`
|
|
Metrics []string `json:"metrics"`
|
|
Trackable bool `json:"trackable"`
|
|
Note string `json:"note,optional"`
|
|
}
|
|
|
|
ThreadsInsightMetricItem {
|
|
Name string `json:"name"`
|
|
Value int `json:"value"`
|
|
}
|
|
|
|
ThreadsAccountInsightsBlock {
|
|
Status string `json:"status"`
|
|
Message string `json:"message,optional"`
|
|
Metrics []ThreadsInsightMetricItem `json:"metrics,optional"`
|
|
}
|
|
|
|
ThreadsPostPerformanceItem {
|
|
MediaID string `json:"media_id"`
|
|
Text string `json:"text,optional"`
|
|
Permalink string `json:"permalink,optional"`
|
|
Timestamp string `json:"timestamp,optional"`
|
|
MediaType string `json:"media_type,optional"`
|
|
MediaURL string `json:"media_url,optional"`
|
|
ThumbnailURL string `json:"thumbnail_url,optional"`
|
|
TopicTag string `json:"topic_tag,optional"`
|
|
Shortcode string `json:"shortcode,optional"`
|
|
LikeCount int `json:"like_count"`
|
|
ReplyCount int `json:"reply_count"`
|
|
RepostCount int `json:"repost_count,optional"`
|
|
QuoteCount int `json:"quote_count,optional"`
|
|
Views int `json:"views,optional"`
|
|
Shares int `json:"shares,optional"`
|
|
InsightsStatus string `json:"insights_status,optional"`
|
|
InsightsMessage string `json:"insights_message,optional"`
|
|
}
|
|
|
|
ThreadsPostPerformanceData {
|
|
AccountID string `json:"account_id"`
|
|
Username string `json:"username,optional"`
|
|
ThreadsUserID string `json:"threads_user_id,optional"`
|
|
FetchedAt int64 `json:"fetched_at"`
|
|
Capabilities []ThreadsPostMetricCapability `json:"capabilities"`
|
|
AccountInsights ThreadsAccountInsightsBlock `json:"account_insights"`
|
|
Posts []ThreadsPostPerformanceItem `json:"posts"`
|
|
}
|
|
|
|
PublishQueueItemPath {
|
|
ID string `path:"id" validate:"required"`
|
|
QID string `path:"qid" validate:"required"`
|
|
}
|
|
|
|
ListPublishQueueQuery {
|
|
Status string `form:"status,optional"`
|
|
Page int `form:"page,optional"`
|
|
PageSize int `form:"pageSize,optional"`
|
|
}
|
|
|
|
ListPublishQueueHandlerReq {
|
|
ThreadsAccountPath
|
|
ListPublishQueueQuery
|
|
}
|
|
|
|
CreatePublishQueueReq {
|
|
Text string `json:"text" validate:"required"`
|
|
ScheduledAt int64 `json:"scheduled_at,optional"`
|
|
}
|
|
|
|
CreatePublishQueueHandlerReq {
|
|
ThreadsAccountPath
|
|
CreatePublishQueueReq
|
|
}
|
|
|
|
PatchPublishQueueReq {
|
|
Text *string `json:"text,optional"`
|
|
ScheduledAt *int64 `json:"scheduled_at,optional"`
|
|
}
|
|
|
|
PatchPublishQueueHandlerReq {
|
|
PublishQueueItemPath
|
|
PatchPublishQueueReq
|
|
}
|
|
|
|
PublishQueueItemData {
|
|
ID string `json:"id"`
|
|
AccountID string `json:"account_id"`
|
|
PersonaID string `json:"persona_id,omitempty"`
|
|
CopyMissionID string `json:"copy_mission_id,omitempty"`
|
|
CopyDraftID string `json:"copy_draft_id,omitempty"`
|
|
Text string `json:"text"`
|
|
ScheduledAt int64 `json:"scheduled_at"`
|
|
Status string `json:"status"`
|
|
MediaID string `json:"media_id,optional"`
|
|
Permalink string `json:"permalink,optional"`
|
|
PublishedAt int64 `json:"published_at,optional"`
|
|
ErrorMessage string `json:"error_message,optional"`
|
|
RetryCount int `json:"retry_count,omitempty"`
|
|
LastAttemptAt int64 `json:"last_attempt_at,omitempty"`
|
|
NextAttemptAt int64 `json:"next_attempt_at,omitempty"`
|
|
MissedAt int64 `json:"missed_at,omitempty"`
|
|
PausedReason string `json:"paused_reason,omitempty"`
|
|
CreateAt int64 `json:"create_at"`
|
|
UpdateAt int64 `json:"update_at"`
|
|
}
|
|
|
|
PublishQueueListData {
|
|
Pagination PaginationData `json:"pagination"`
|
|
List []PublishQueueItemData `json:"list"`
|
|
}
|
|
|
|
ListThreadsPublishHealthQuery {
|
|
Page int `form:"page,optional"`
|
|
PageSize int `form:"pageSize,optional"`
|
|
}
|
|
|
|
ListThreadsPublishHealthHandlerReq {
|
|
ThreadsAccountPath
|
|
ListThreadsPublishHealthQuery
|
|
}
|
|
|
|
ThreadsPublishHealthSummary {
|
|
PendingScheduled int64 `json:"pending_scheduled"`
|
|
FailedCount int64 `json:"failed_count"`
|
|
Published7d int64 `json:"published_7d"`
|
|
TotalLikes7d int `json:"total_likes_7d"`
|
|
TotalReplies7d int `json:"total_replies_7d"`
|
|
}
|
|
|
|
ThreadsPublishHealthCheckpoint {
|
|
Checkpoint string `json:"checkpoint"`
|
|
LikeCount int `json:"like_count"`
|
|
ReplyCount int `json:"reply_count"`
|
|
RepostCount int `json:"repost_count"`
|
|
QuoteCount int `json:"quote_count"`
|
|
Views int `json:"views,optional"`
|
|
CheckedAt int64 `json:"checked_at"`
|
|
}
|
|
|
|
ThreadsPublishHealthItem {
|
|
MediaID string `json:"media_id"`
|
|
Permalink string `json:"permalink,optional"`
|
|
Text string `json:"text,optional"`
|
|
PublishedAt int64 `json:"published_at"`
|
|
LikeCount int `json:"like_count"`
|
|
ReplyCount int `json:"reply_count"`
|
|
RepostCount int `json:"repost_count,optional"`
|
|
QuoteCount int `json:"quote_count,optional"`
|
|
Views int `json:"views,optional"`
|
|
Shares int `json:"shares,optional"`
|
|
Checkpoints []ThreadsPublishHealthCheckpoint `json:"checkpoints"`
|
|
}
|
|
|
|
ThreadsPublishHealthData {
|
|
Summary ThreadsPublishHealthSummary `json:"summary"`
|
|
Pagination PaginationData `json:"pagination"`
|
|
List []ThreadsPublishHealthItem `json:"list"`
|
|
}
|
|
|
|
PublishSlotData {
|
|
Weekday int `json:"weekday"`
|
|
Time string `json:"time"`
|
|
}
|
|
|
|
PublishSourceRefData {
|
|
Type string `json:"type"`
|
|
PersonaID string `json:"persona_id,omitempty"`
|
|
CopyMissionID string `json:"copy_mission_id,omitempty"`
|
|
ScanPostID string `json:"scan_post_id,omitempty"`
|
|
ManualSeed string `json:"manual_seed,omitempty"`
|
|
}
|
|
|
|
PublishInventoryPolicyData {
|
|
AccountID string `json:"account_id"`
|
|
Enabled bool `json:"enabled"`
|
|
TargetDailyCount int `json:"target_daily_count"`
|
|
LowStockThreshold int `json:"low_stock_threshold"`
|
|
LookaheadDays int `json:"lookahead_days"`
|
|
Timezone string `json:"timezone"`
|
|
Slots []PublishSlotData `json:"slots"`
|
|
SourceRefs []PublishSourceRefData `json:"source_refs"`
|
|
UpdateAt int64 `json:"update_at"`
|
|
}
|
|
|
|
UpsertPublishInventoryPolicyReq {
|
|
Enabled bool `json:"enabled"`
|
|
TargetDailyCount int `json:"target_daily_count,optional"`
|
|
LowStockThreshold int `json:"low_stock_threshold,optional"`
|
|
LookaheadDays int `json:"lookahead_days,optional"`
|
|
Timezone string `json:"timezone,optional"`
|
|
Slots []PublishSlotData `json:"slots,optional"`
|
|
SourceRefs []PublishSourceRefData `json:"source_refs,optional"`
|
|
}
|
|
|
|
UpsertPublishInventoryPolicyHandlerReq {
|
|
ThreadsAccountPath
|
|
UpsertPublishInventoryPolicyReq
|
|
}
|
|
|
|
StartPublishInventoryRefillJobReq {
|
|
Count int `json:"count,optional"`
|
|
}
|
|
|
|
StartPublishInventoryRefillJobHandlerReq {
|
|
ThreadsAccountPath
|
|
StartPublishInventoryRefillJobReq
|
|
}
|
|
|
|
StartPublishInventoryRefillJobData {
|
|
JobID string `json:"job_id"`
|
|
Status string `json:"status"`
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
PublishSlotInsightData {
|
|
Weekday int `json:"weekday"`
|
|
Time string `json:"time"`
|
|
AvgLikes1h int `json:"avg_likes_1h"`
|
|
AvgReplies1h int `json:"avg_replies_1h"`
|
|
AvgLikes24h int `json:"avg_likes_24h"`
|
|
AvgReplies24h int `json:"avg_replies_24h"`
|
|
AvgLikes7d int `json:"avg_likes_7d"`
|
|
AvgReplies7d int `json:"avg_replies_7d"`
|
|
SampleSize int `json:"sample_size"`
|
|
Recommendation string `json:"recommendation"`
|
|
}
|
|
|
|
PublishSlotInsightsData {
|
|
AccountID string `json:"account_id"`
|
|
Timezone string `json:"timezone"`
|
|
Slots []PublishSlotInsightData `json:"slots"`
|
|
}
|
|
|
|
PublishGuardPolicyData {
|
|
AccountID string `json:"account_id"`
|
|
Enabled bool `json:"enabled"`
|
|
MaxDailyPosts int `json:"max_daily_posts"`
|
|
MinIntervalMinutes int `json:"min_interval_minutes"`
|
|
ConsecutiveFailurePauseLimit int `json:"consecutive_failure_pause_limit"`
|
|
Paused bool `json:"paused"`
|
|
PausedReason string `json:"paused_reason,omitempty"`
|
|
UpdateAt int64 `json:"update_at"`
|
|
}
|
|
|
|
UpsertPublishGuardPolicyReq {
|
|
Enabled bool `json:"enabled"`
|
|
MaxDailyPosts int `json:"max_daily_posts,optional"`
|
|
MinIntervalMinutes int `json:"min_interval_minutes,optional"`
|
|
ConsecutiveFailurePauseLimit int `json:"consecutive_failure_pause_limit,optional"`
|
|
Paused *bool `json:"paused,optional"`
|
|
PausedReason string `json:"paused_reason,optional"`
|
|
}
|
|
|
|
UpsertPublishGuardPolicyHandlerReq {
|
|
ThreadsAccountPath
|
|
UpsertPublishGuardPolicyReq
|
|
}
|
|
|
|
PublishQueueEventData {
|
|
ID string `json:"id"`
|
|
QueueID string `json:"queue_id"`
|
|
EventType string `json:"event_type"`
|
|
FromStatus string `json:"from_status,omitempty"`
|
|
ToStatus string `json:"to_status,omitempty"`
|
|
Message string `json:"message,omitempty"`
|
|
CreateAt int64 `json:"create_at"`
|
|
}
|
|
|
|
PublishQueueEventsData {
|
|
List []PublishQueueEventData `json:"list"`
|
|
}
|
|
|
|
PublishAlertData {
|
|
Type string `json:"type"`
|
|
Severity string `json:"severity"`
|
|
Message string `json:"message"`
|
|
QueueID string `json:"queue_id,omitempty"`
|
|
AccountID string `json:"account_id"`
|
|
CreateAt int64 `json:"create_at"`
|
|
}
|
|
|
|
PublishAlertsData {
|
|
List []PublishAlertData `json:"list"`
|
|
}
|
|
|
|
PublishQueueRangeQuery {
|
|
StartAt int64 `form:"startAt,optional"`
|
|
EndAt int64 `form:"endAt,optional"`
|
|
Status string `form:"status,optional"`
|
|
}
|
|
|
|
PublishQueueRangeHandlerReq {
|
|
ThreadsAccountPath
|
|
PublishQueueRangeQuery
|
|
}
|
|
|
|
PublishDashboardAccountSummary {
|
|
AccountID string `json:"account_id"`
|
|
AccountName string `json:"account_name"`
|
|
PendingScheduled int64 `json:"pending_scheduled"`
|
|
FailedCount int64 `json:"failed_count"`
|
|
Published7d int64 `json:"published_7d"`
|
|
TotalLikes7d int `json:"total_likes_7d"`
|
|
TotalReplies7d int `json:"total_replies_7d"`
|
|
Paused bool `json:"paused"`
|
|
BestSlot string `json:"best_slot,omitempty"`
|
|
LowSlot string `json:"low_slot,omitempty"`
|
|
}
|
|
|
|
PublishDashboardSummaryData {
|
|
List []PublishDashboardAccountSummary `json:"list"`
|
|
TotalPending int64 `json:"total_pending"`
|
|
TotalFailed int64 `json:"total_failed"`
|
|
TotalPublished7d int64 `json:"total_published_7d"`
|
|
TotalLikes7d int `json:"total_likes_7d"`
|
|
TotalReplies7d int `json:"total_replies_7d"`
|
|
}
|
|
|
|
GenerateOwnPostReplyDraftReq {
|
|
MediaID string `json:"media_id"`
|
|
PersonaID string `json:"persona_id,optional"`
|
|
ReplyToID string `json:"reply_to_id,optional"`
|
|
PostText string `json:"post_text,optional"`
|
|
ReplyText string `json:"reply_text,optional"`
|
|
ThreadPostText string `json:"thread_post_text,optional"`
|
|
ParentReplyText string `json:"parent_reply_text,optional"`
|
|
}
|
|
|
|
GenerateOwnPostReplyDraftHandlerReq {
|
|
ThreadsAccountPath
|
|
GenerateOwnPostReplyDraftReq
|
|
}
|
|
|
|
GenerateOwnPostReplyDraftData {
|
|
Text string `json:"text"`
|
|
}
|
|
|
|
MentionInboxItemData {
|
|
MediaID string `json:"media_id"`
|
|
AuthorUsername string `json:"author_username,omitempty"`
|
|
Text string `json:"text,omitempty"`
|
|
Permalink string `json:"permalink,omitempty"`
|
|
Shortcode string `json:"shortcode,omitempty"`
|
|
Timestamp string `json:"timestamp,omitempty"`
|
|
MediaType string `json:"media_type,omitempty"`
|
|
IsReply bool `json:"is_reply"`
|
|
IsQuotePost bool `json:"is_quote_post"`
|
|
HasReplies bool `json:"has_replies"`
|
|
RootPostID string `json:"root_post_id,omitempty"`
|
|
ParentID string `json:"parent_id,omitempty"`
|
|
ThreadPostText string `json:"thread_post_text,omitempty"`
|
|
ParentReplyText string `json:"parent_reply_text,omitempty"`
|
|
ReplyReady bool `json:"reply_ready"`
|
|
ReplyReadyMsg string `json:"reply_ready_msg,omitempty"`
|
|
SyncedAt int64 `json:"synced_at"`
|
|
}
|
|
|
|
SyncMentionInboxReq {
|
|
Limit int `json:"limit,optional"`
|
|
MaxPages int `json:"max_pages,optional"`
|
|
}
|
|
|
|
SyncMentionInboxHandlerReq {
|
|
ThreadsAccountPath
|
|
SyncMentionInboxReq
|
|
}
|
|
|
|
SyncMentionInboxData {
|
|
Synced int `json:"synced"`
|
|
Ready int `json:"ready"`
|
|
Total int64 `json:"total"`
|
|
}
|
|
|
|
ListMentionInboxQuery {
|
|
Page int `form:"page,optional"`
|
|
PageSize int `form:"pageSize,optional"`
|
|
}
|
|
|
|
ListMentionInboxHandlerReq {
|
|
ThreadsAccountPath
|
|
ListMentionInboxQuery
|
|
}
|
|
|
|
ListMentionInboxData {
|
|
List []MentionInboxItemData `json:"list"`
|
|
Pagination PaginationData `json:"pagination"`
|
|
ReadyTotal int64 `json:"ready_total"`
|
|
NewestSyncedAt int64 `json:"newest_synced_at,omitempty"`
|
|
}
|
|
|
|
PublishMentionReplyReq {
|
|
Text string `json:"text"`
|
|
}
|
|
|
|
PublishMentionReplyPath {
|
|
ID string `path:"id" validate:"required"`
|
|
MediaID string `path:"media_id" validate:"required"`
|
|
}
|
|
|
|
PublishMentionReplyHandlerReq {
|
|
PublishMentionReplyPath
|
|
PublishMentionReplyReq
|
|
}
|
|
|
|
PublishMentionReplyData {
|
|
MediaID string `json:"media_id,omitempty"`
|
|
Permalink string `json:"permalink,omitempty"`
|
|
}
|
|
|
|
GenerateOwnPostFormulaReq {
|
|
MediaID string `json:"media_id"`
|
|
PersonaID string `json:"persona_id,optional"`
|
|
PostText string `json:"post_text,optional"`
|
|
TopicTag string `json:"topic_tag,optional"`
|
|
MediaType string `json:"media_type,optional"`
|
|
Timestamp string `json:"timestamp,optional"`
|
|
LikeCount int `json:"like_count,optional"`
|
|
ReplyCount int `json:"reply_count,optional"`
|
|
Views int `json:"views,optional"`
|
|
RepostCount int `json:"repost_count,optional"`
|
|
QuoteCount int `json:"quote_count,optional"`
|
|
Shares int `json:"shares,optional"`
|
|
Force bool `json:"force,optional"`
|
|
}
|
|
|
|
GenerateOwnPostFormulaHandlerReq {
|
|
ThreadsAccountPath
|
|
GenerateOwnPostFormulaReq
|
|
}
|
|
|
|
OwnPostFormulaReviewData {
|
|
MediaID string `json:"media_id"`
|
|
ReviewedAt int64 `json:"reviewed_at"`
|
|
FromCache bool `json:"from_cache,omitempty"`
|
|
Summary string `json:"summary"`
|
|
Wins []string `json:"wins"`
|
|
Improvements []string `json:"improvements"`
|
|
Formula string `json:"formula"`
|
|
PostTemplate string `json:"post_template"`
|
|
HookPattern string `json:"hook_pattern"`
|
|
Structure string `json:"structure"`
|
|
ReplicationTips []string `json:"replication_tips"`
|
|
Avoid []string `json:"avoid"`
|
|
}
|
|
|
|
GenerateOwnPostFormulaData {
|
|
OwnPostFormulaReviewData
|
|
}
|
|
|
|
ListOwnPostFormulasHandlerReq {
|
|
ThreadsAccountPath
|
|
}
|
|
|
|
ListOwnPostFormulasData {
|
|
List []OwnPostFormulaReviewData `json:"list"`
|
|
}
|
|
|
|
ThreadsDiagnosticsData {
|
|
AccountID string `json:"account_id"`
|
|
CheckedAt int64 `json:"checked_at"`
|
|
ApiConnected bool `json:"api_connected"`
|
|
TokenExpiresAt int64 `json:"token_expires_at,omitempty"`
|
|
Scopes []string `json:"scopes"`
|
|
Items []ThreadsAPISmokeTestItem `json:"items"`
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
ContentFormulaSourceMetricsData {
|
|
LikeCount int `json:"like_count,omitempty"`
|
|
ReplyCount int `json:"reply_count,omitempty"`
|
|
Views int `json:"views,omitempty"`
|
|
RepostCount int `json:"repost_count,omitempty"`
|
|
QuoteCount int `json:"quote_count,omitempty"`
|
|
Shares int `json:"shares,omitempty"`
|
|
}
|
|
|
|
ContentFormulaData {
|
|
ID string `json:"id"`
|
|
AccountID string `json:"account_id"`
|
|
Label string `json:"label"`
|
|
SourceType string `json:"source_type"`
|
|
SourceRef string `json:"source_ref,omitempty"`
|
|
SourcePostText string `json:"source_post_text,omitempty"`
|
|
SourceAuthor string `json:"source_author,omitempty"`
|
|
SourcePermalink string `json:"source_permalink,omitempty"`
|
|
SourceMetrics *ContentFormulaSourceMetricsData `json:"source_metrics,omitempty"`
|
|
Summary string `json:"summary"`
|
|
Wins []string `json:"wins,omitempty"`
|
|
Improvements []string `json:"improvements,omitempty"`
|
|
Formula string `json:"formula"`
|
|
PostTemplate string `json:"post_template"`
|
|
HookPattern string `json:"hook_pattern"`
|
|
Structure string `json:"structure"`
|
|
ReplicationTips []string `json:"replication_tips,omitempty"`
|
|
Avoid []string `json:"avoid,omitempty"`
|
|
Tags []string `json:"tags,omitempty"`
|
|
CreateAt int64 `json:"create_at"`
|
|
UpdateAt int64 `json:"update_at"`
|
|
}
|
|
|
|
ListContentFormulasReq {
|
|
Page int64 `form:"page,optional"`
|
|
PageSize int64 `form:"pageSize,optional"`
|
|
SourceType string `form:"source_type,optional"`
|
|
Tag string `form:"tag,optional"`
|
|
}
|
|
|
|
ListContentFormulasHandlerReq {
|
|
ThreadsAccountPath
|
|
ListContentFormulasReq
|
|
}
|
|
|
|
ListContentFormulasData {
|
|
Pagination PaginationData `json:"pagination"`
|
|
List []ContentFormulaData `json:"list"`
|
|
}
|
|
|
|
ContentFormulaItemPath {
|
|
ID string `path:"id" validate:"required"`
|
|
FormulaID string `path:"formulaId" validate:"required"`
|
|
}
|
|
|
|
GetContentFormulaHandlerReq {
|
|
ContentFormulaItemPath
|
|
}
|
|
|
|
AnalyzeContentFormulaReq {
|
|
SourceType string `json:"source_type" validate:"required"`
|
|
PersonaID string `json:"persona_id,optional"`
|
|
PostText string `json:"post_text,optional"`
|
|
MediaID string `json:"media_id,optional"`
|
|
ScanPostID string `json:"scan_post_id,optional"`
|
|
Keyword string `json:"keyword,optional"`
|
|
SaveLabel string `json:"save_label,optional"`
|
|
AuthorName string `json:"author_name,optional"`
|
|
Permalink string `json:"permalink,optional"`
|
|
LikeCount int `json:"like_count,optional"`
|
|
ReplyCount int `json:"reply_count,optional"`
|
|
Views int `json:"views,optional"`
|
|
RepostCount int `json:"repost_count,optional"`
|
|
QuoteCount int `json:"quote_count,optional"`
|
|
Shares int `json:"shares,optional"`
|
|
ForceRefresh bool `json:"force_refresh,optional"`
|
|
}
|
|
|
|
AnalyzeContentFormulaHandlerReq {
|
|
ThreadsAccountPath
|
|
AnalyzeContentFormulaReq
|
|
}
|
|
|
|
AnalyzeContentFormulaData {
|
|
Formula ContentFormulaData `json:"formula"`
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
SearchContentFormulaPostsReq {
|
|
Keyword string `json:"keyword" validate:"required"`
|
|
SearchType string `json:"search_type,optional"`
|
|
Limit int `json:"limit,optional"`
|
|
}
|
|
|
|
SearchContentFormulaPostsHandlerReq {
|
|
ThreadsAccountPath
|
|
SearchContentFormulaPostsReq
|
|
}
|
|
|
|
ContentFormulaSearchPostData {
|
|
Text string `json:"text"`
|
|
Author string `json:"author"`
|
|
Permalink string `json:"permalink,omitempty"`
|
|
MediaID string `json:"media_id,omitempty"`
|
|
LikeCount int `json:"like_count"`
|
|
ReplyCount int `json:"reply_count"`
|
|
EngagementScore int `json:"engagement_score"`
|
|
}
|
|
|
|
SearchContentFormulaPostsData {
|
|
List []ContentFormulaSearchPostData `json:"list"`
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
PatchContentFormulaReq {
|
|
Label *string `json:"label,optional"`
|
|
Formula *string `json:"formula,optional"`
|
|
PostTemplate *string `json:"post_template,optional"`
|
|
HookPattern *string `json:"hook_pattern,optional"`
|
|
Structure *string `json:"structure,optional"`
|
|
Tags []string `json:"tags,optional"`
|
|
}
|
|
|
|
PatchContentFormulaHandlerReq {
|
|
ContentFormulaItemPath
|
|
PatchContentFormulaReq
|
|
}
|
|
|
|
DeleteContentFormulaData {
|
|
FormulaID string `json:"formula_id"`
|
|
Message string `json:"message"`
|
|
}
|
|
|
|
ImportOwnPostFormulaReq {
|
|
MediaID string `json:"media_id" validate:"required"`
|
|
Label string `json:"label,optional"`
|
|
}
|
|
|
|
ImportOwnPostFormulaHandlerReq {
|
|
ThreadsAccountPath
|
|
ImportOwnPostFormulaReq
|
|
}
|
|
)
|
|
|
|
@server(
|
|
group: threads_account
|
|
prefix: /api/v1/threads-accounts
|
|
middleware: AuthJWT
|
|
tags: "ThreadsAccount"
|
|
summary: "Threads operating account endpoints. Requires Bearer JWT."
|
|
)
|
|
service gateway {
|
|
@handler listThreadsAccounts
|
|
get / returns (ListThreadsAccountsData)
|
|
|
|
@handler createThreadsAccount
|
|
post / (CreateThreadsAccountReq) returns (ThreadsAccountData)
|
|
|
|
@handler getThreadsAccount
|
|
get /:id (ThreadsAccountPath) returns (ThreadsAccountData)
|
|
|
|
@handler updateThreadsAccount
|
|
patch /:id (UpdateThreadsAccountHandlerReq) returns (ThreadsAccountData)
|
|
|
|
@handler deleteThreadsAccount
|
|
delete /:id (ThreadsAccountPath) returns (DeleteThreadsAccountData)
|
|
|
|
@handler activateThreadsAccount
|
|
post /:id/activate (ThreadsAccountPath)
|
|
|
|
@handler getThreadsAccountConnection
|
|
get /:id/connection (ThreadsAccountPath) returns (ThreadsAccountConnectionData)
|
|
|
|
@handler updateThreadsAccountConnection
|
|
patch /:id/connection (UpdateThreadsAccountConnectionHandlerReq) returns (ThreadsAccountConnectionData)
|
|
|
|
@handler importThreadsAccountSession
|
|
post /:id/session/import (ImportThreadsAccountSessionHandlerReq) returns (ImportThreadsAccountSessionData)
|
|
|
|
@handler getThreadsAccountAiSettings
|
|
get /:id/ai-settings (ThreadsAccountPath) returns (ThreadsAccountAiSettingsData)
|
|
|
|
@handler updateThreadsAccountAiSettings
|
|
put /:id/ai-settings (UpdateThreadsAccountAiSettingsHandlerReq) returns (ThreadsAccountAiSettingsData)
|
|
|
|
@handler listThreadsAccountAiProviderModels
|
|
post /:id/ai-settings/providers/:provider/models (ThreadsAccountAiProviderModelsHandlerReq) returns (ThreadsAccountAiProviderModelsData)
|
|
|
|
@handler startThreadsOauth
|
|
get /oauth/start (StartThreadsOAuthQuery) returns (StartThreadsOAuthData)
|
|
|
|
@handler listThreadsOauthLogs
|
|
get /oauth/logs returns (ListThreadsOAuthLogsData)
|
|
|
|
@handler getThreadsOauthConfig
|
|
get /oauth/config returns (ThreadsOAuthConfigData)
|
|
|
|
@handler disconnectThreadsApi
|
|
post /:id/api/disconnect (ThreadsAccountPath) returns (ThreadsAccountData)
|
|
|
|
@handler runThreadsApiSmokeTest
|
|
post /:id/api/smoke-test (ThreadsAccountPath) returns (RunThreadsAPISmokeTestData)
|
|
|
|
@handler runThreadsApiPlayground
|
|
post /:id/api/playground (RunThreadsAPIPlaygroundHandlerReq) returns (ThreadsAPIPlaygroundData)
|
|
|
|
@handler listThreadsPostPerformance
|
|
get /:id/post-performance (ListThreadsPostPerformanceHandlerReq) returns (ThreadsPostPerformanceData)
|
|
|
|
@handler createPublishQueueItem
|
|
post /:id/publish-queue (CreatePublishQueueHandlerReq) returns (PublishQueueItemData)
|
|
|
|
@handler listPublishQueueItems
|
|
get /:id/publish-queue (ListPublishQueueHandlerReq) returns (PublishQueueListData)
|
|
|
|
@handler getPublishQueueItem
|
|
get /:id/publish-queue/:qid (PublishQueueItemPath) returns (PublishQueueItemData)
|
|
|
|
@handler patchPublishQueueItem
|
|
patch /:id/publish-queue/:qid (PatchPublishQueueHandlerReq) returns (PublishQueueItemData)
|
|
|
|
@handler cancelPublishQueueItem
|
|
post /:id/publish-queue/:qid/cancel (PublishQueueItemPath) returns (PublishQueueItemData)
|
|
|
|
@handler deletePublishQueueItem
|
|
delete /:id/publish-queue/:qid (PublishQueueItemPath)
|
|
|
|
@handler listThreadsPublishHealth
|
|
get /:id/publish-health (ListThreadsPublishHealthHandlerReq) returns (ThreadsPublishHealthData)
|
|
|
|
@handler getPublishInventoryPolicy
|
|
get /:id/publish-inventory-policy (ThreadsAccountPath) returns (PublishInventoryPolicyData)
|
|
|
|
@handler upsertPublishInventoryPolicy
|
|
put /:id/publish-inventory-policy (UpsertPublishInventoryPolicyHandlerReq) returns (PublishInventoryPolicyData)
|
|
|
|
@handler startPublishInventoryRefillJob
|
|
post /:id/publish-inventory/refill-jobs (StartPublishInventoryRefillJobHandlerReq) returns (StartPublishInventoryRefillJobData)
|
|
|
|
@handler getPublishSlotInsights
|
|
get /:id/publish-slot-insights (ThreadsAccountPath) returns (PublishSlotInsightsData)
|
|
|
|
@handler getPublishGuardPolicy
|
|
get /:id/publish-guard-policy (ThreadsAccountPath) returns (PublishGuardPolicyData)
|
|
|
|
@handler upsertPublishGuardPolicy
|
|
put /:id/publish-guard-policy (UpsertPublishGuardPolicyHandlerReq) returns (PublishGuardPolicyData)
|
|
|
|
@handler resumePublishGuard
|
|
post /:id/publish-guard/resume (ThreadsAccountPath) returns (PublishGuardPolicyData)
|
|
|
|
@handler retryPublishQueueItem
|
|
post /:id/publish-queue/:qid/retry (PublishQueueItemPath) returns (PublishQueueItemData)
|
|
|
|
@handler listPublishQueueEvents
|
|
get /:id/publish-queue/:qid/events (PublishQueueItemPath) returns (PublishQueueEventsData)
|
|
|
|
@handler listPublishAlerts
|
|
get /:id/publish-alerts (ThreadsAccountPath) returns (PublishAlertsData)
|
|
|
|
@handler listPublishQueueRange
|
|
get /:id/publish-calendar (PublishQueueRangeHandlerReq) returns (PublishQueueListData)
|
|
|
|
@handler getThreadsDiagnostics
|
|
get /:id/diagnostics (ThreadsAccountPath) returns (ThreadsDiagnosticsData)
|
|
|
|
@handler generateOwnPostReplyDraft
|
|
post /:id/own-post-reply-draft (GenerateOwnPostReplyDraftHandlerReq) returns (GenerateOwnPostReplyDraftData)
|
|
|
|
@handler syncMentionInbox
|
|
post /:id/mention-inbox/sync (SyncMentionInboxHandlerReq) returns (SyncMentionInboxData)
|
|
|
|
@handler listMentionInbox
|
|
get /:id/mention-inbox (ListMentionInboxHandlerReq) returns (ListMentionInboxData)
|
|
|
|
@handler publishMentionReply
|
|
post /:id/mention-inbox/:media_id/reply (PublishMentionReplyHandlerReq) returns (PublishMentionReplyData)
|
|
|
|
@handler generateOwnPostFormula
|
|
post /:id/own-post-formula (GenerateOwnPostFormulaHandlerReq) returns (GenerateOwnPostFormulaData)
|
|
|
|
@handler listOwnPostFormulas
|
|
get /:id/own-post-formulas (ListOwnPostFormulasHandlerReq) returns (ListOwnPostFormulasData)
|
|
|
|
@handler getPublishDashboardSummary
|
|
get /publish-dashboard-summary returns (PublishDashboardSummaryData)
|
|
|
|
@handler listContentFormulas
|
|
get /:id/content-formulas (ListContentFormulasHandlerReq) returns (ListContentFormulasData)
|
|
|
|
@handler getContentFormula
|
|
get /:id/content-formulas/:formulaId (GetContentFormulaHandlerReq) returns (ContentFormulaData)
|
|
|
|
@handler analyzeContentFormula
|
|
post /:id/content-formulas/analyze (AnalyzeContentFormulaHandlerReq) returns (AnalyzeContentFormulaData)
|
|
|
|
@handler searchContentFormulaPosts
|
|
post /:id/content-formulas/search-posts (SearchContentFormulaPostsHandlerReq) returns (SearchContentFormulaPostsData)
|
|
|
|
@handler patchContentFormula
|
|
patch /:id/content-formulas/:formulaId (PatchContentFormulaHandlerReq) returns (ContentFormulaData)
|
|
|
|
@handler deleteContentFormula
|
|
delete /:id/content-formulas/:formulaId (GetContentFormulaHandlerReq) returns (DeleteContentFormulaData)
|
|
|
|
@handler importOwnPostToContentFormula
|
|
post /:id/content-formulas/import-own-post (ImportOwnPostFormulaHandlerReq) returns (AnalyzeContentFormulaData)
|
|
}
|
|
|
|
@server(
|
|
group: threads_account
|
|
prefix: /api/v1/threads-accounts
|
|
tags: "ThreadsAccount"
|
|
summary: "Threads OAuth callback (public redirect from Meta)."
|
|
)
|
|
service gateway {
|
|
@handler threadsOauthCallback
|
|
get /oauth/callback (ThreadsOAuthCallbackQuery)
|
|
} |