98 lines
2.9 KiB
Plaintext
98 lines
2.9 KiB
Plaintext
|
syntax = "v1"
|
|||
|
|
|
|||
|
|
type (
|
|||
|
|
ThreadsAccountPublic {
|
|||
|
|
Id string `json:"id"`
|
|||
|
|
Username string `json:"username"`
|
|||
|
|
DisplayName string `json:"display_name"`
|
|||
|
|
Connection string `json:"connection"` // connected|error|disconnected
|
|||
|
|
IsUsable bool `json:"is_usable"`
|
|||
|
|
AvatarColor string `json:"avatar_color,optional"`
|
|||
|
|
AvatarUrl string `json:"avatar_url,optional"`
|
|||
|
|
ErrorMessage string `json:"error_message,optional"`
|
|||
|
|
SessionExpiresAt int64 `json:"session_expires_at,optional"`
|
|||
|
|
SessionRefreshedAt int64 `json:"session_refreshed_at,optional"`
|
|||
|
|
// never expose access_token / refresh_token
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
ThreadsAccountListData {
|
|||
|
|
List []ThreadsAccountPublic `json:"list"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
ThreadsOAuthStartData {
|
|||
|
|
AuthorizeUrl string `json:"authorize_url"`
|
|||
|
|
State string `json:"state"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Callback is query-string from Meta / fake provider (public).
|
|||
|
|
ThreadsOAuthCallbackReq {
|
|||
|
|
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"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
ThreadsOAuthCallbackData {
|
|||
|
|
Ok bool `json:"ok"`
|
|||
|
|
Message string `json:"message,optional"`
|
|||
|
|
// RedirectURL for custom handler (browser flow)
|
|||
|
|
RedirectUrl string `json:"redirect_url,optional"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
ThreadsAccountIdPath {
|
|||
|
|
Id string `path:"id"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// 擴充（含舊版）匯入 Chrome storageState；寫入 scout crawler-session 供 dev 模式海巡
|
|||
|
|
ImportThreadsAccountSessionReq {
|
|||
|
|
// path id + body
|
|||
|
|
Id string `path:"id"`
|
|||
|
|
StorageState string `json:"storageState"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
ImportThreadsAccountSessionData {
|
|||
|
|
Success bool `json:"success"`
|
|||
|
|
Valid bool `json:"valid"`
|
|||
|
|
Synced bool `json:"synced"`
|
|||
|
|
AccountId string `json:"account_id"`
|
|||
|
|
Username string `json:"username,optional"`
|
|||
|
|
Message string `json:"message"`
|
|||
|
|
UpdateAt int64 `json:"update_at,optional"`
|
|||
|
|
}
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
// Public OAuth callback (no JWT)
|
|||
|
|
@server (
|
|||
|
|
group: threads
|
|||
|
|
prefix: /api/v1/threads-accounts
|
|||
|
|
)
|
|||
|
|
service gateway {
|
|||
|
|
@handler ThreadsOAuthCallback
|
|||
|
|
get /oauth/callback (ThreadsOAuthCallbackReq) returns (ThreadsOAuthCallbackData)
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
@server (
|
|||
|
|
jwt: Auth
|
|||
|
|
group: threads
|
|||
|
|
prefix: /api/v1/threads-accounts
|
|||
|
|
middleware: AuthJWT
|
|||
|
|
)
|
|||
|
|
service gateway {
|
|||
|
|
@handler ThreadsOAuthStart
|
|||
|
|
get /oauth/start returns (ThreadsOAuthStartData)
|
|||
|
|
|
|||
|
|
@handler ListThreadsAccounts
|
|||
|
|
get / returns (ThreadsAccountListData)
|
|||
|
|
|
|||
|
|
@handler RefreshThreadsAccount
|
|||
|
|
post /:id/refresh (ThreadsAccountIdPath) returns (ThreadsAccountPublic)
|
|||
|
|
|
|||
|
|
// Chrome 擴充：匯入 Playwright storageState（舊路徑相容；實際存 crawler session）
|
|||
|
|
@handler ImportThreadsAccountSession
|
|||
|
|
post /:id/session/import (ImportThreadsAccountSessionReq) returns (ImportThreadsAccountSessionData)
|
|||
|
|
|
|||
|
|
@handler DisconnectThreadsAccount
|
|||
|
|
delete /:id (ThreadsAccountIdPath) returns (OkData)
|
|||
|
|
}
|