เอกสารอ้างอิง API
Sursa API สาธารณะมี 222 เอนด์พอยต์ใน 35 หมวด เวอร์ชัน 1.62.0
Sursa API สาธารณะสำหรับระบบที่เชื่อมต่อซึ่งยืนยันตัวตนด้วยคีย์ API การเปลี่ยนแปลงภายใน /v1 เป็นการเปลี่ยนแปลงแบบเพิ่มเท่านั้น: อาจมีการดำเนินการใหม่ พารามิเตอร์ที่ไม่บังคับ ฟิลด์ในการตอบกลับ และค่า enum ใหม่ในการตอบกลับเพิ่มเข้ามา โดยไคลเอ็นต์ที่มีอยู่ยังทำงานได้ตามเดิม ให้ถือว่าค่า enum ที่ไม่รู้จักในการตอบกลับเป็นค่าที่ถูกต้อง
- URL ฐาน
- https://api.sursa.com
- การยืนยันตัวตน
- ส่งคีย์ API ในเฮดเดอร์ Authorization: Authorization: Bearer <คีย์>
หมวด
สถานะและเวอร์ชันของบริการ
การลงชื่อเข้าใช้ เซสชัน โหมด “View as” การเปลี่ยนและรีเซ็ตรหัสผ่าน และการตอบรับคำเชิญ
บัญชีผู้ใช้ขององค์กร
คีย์ API ขององค์กร
แอป OAuth ขององค์กรและการอนุญาตของพนักงาน
โปรโตคอล OAuth 2.0: หน้าจอขอความยินยอม การออกและเพิกถอนโทเค็น และข้อมูลเมตาของเซิร์ฟเวอร์การอนุญาต
ล็อกการตรวจสอบขององค์กร
องค์กร โลโก้ และการส่งออกข้อมูล
หมวดหมู่เอกสาร
คอลเลกชันความรู้
การ์ดความรู้: การอัปโหลด เนื้อหา ตาราง เวอร์ชัน การตรวจสอบ และความคิดเห็น
คิวการทำดัชนี: งานประมวลผล ตัวอย่างผลการแยกวิเคราะห์ และสตรีมการเปลี่ยนแปลง (SSE)
บทสนทนากับผู้ช่วย
การค้นหาและคำตอบของผู้ช่วย รวมถึงสตรีม SSE
คำขอสิทธิ์เข้าถึงแหล่งที่มาของคำตอบที่ถูกซ่อน
บันทึกคำถาม คำแนะนำ การส่งออกคำตอบ และคำตอบที่อัปเดตตามข้อมูล
ไฟล์ส่งออก
ข้อมูลเชิงลึก: สรุป การ์ดซ้ำ ความรู้ที่ยังขาด และสุขภาพความรู้
งานที่ต้องทำของผู้ใช้และของทีม
แหล่งข้อมูล เช่น Google Drive และ Confluence
ระบบสิทธิ์การเข้าถึง: ทะเบียนสิทธิ์และสิทธิ์ในองค์กร คอลเลกชัน การ์ด และแหล่งข้อมูล ทั้งที่ให้โดยตรงและที่สืบทอด
บทบาท: ชุดสิทธิ์ที่มีชื่อ ทั้งบทบาทในตัวและบทบาทที่กำหนดเอง
กลุ่มผู้ใช้: กลุ่มทั่วไป “All members” (สมาชิกทั้งหมด) กลุ่มตามบทบาท และกลุ่มส่วนตัว
โฟลเดอร์ของคอลเลกชัน: โครงสร้างแบบต้นไม้ลึกได้สูงสุดสามระดับ การจัดลำดับโดยอิงรายการระดับเดียวกัน การ์ดหนึ่งใบในหลายโฟลเดอร์ และสิทธิ์ที่สืบทอด
แค็ตตาล็อกบริการภายนอก (SaaS และผู้ขาย) พร้อมชื่อ เว็บไซต์ หมวดหมู่ ไอคอน และคำอธิบาย รวมถึงการเชื่อมโยงชื่อที่องค์กรของคุณใช้กับรายการในแค็ตตาล็อก
ฉบับร่างและการอนุมัติการเผยแพร่
การตรวจสอบ: สถานะ วันครบกำหนด ผู้ตรวจสอบ ประวัติ คิว “Verify first” (การ์ดที่ควรตรวจสอบก่อน) คะแนนความน่าเชื่อถือ (Trust Score) และการออฟบอร์ด
ประกาศที่ต้องอ่าน: กลุ่มเป้าหมาย การยืนยันว่าอ่านแล้ว รายงาน การแจ้งเตือน และการส่งออก
ความคิดเห็นแบบเธรดบนการ์ดพร้อมตำแหน่งอ้างอิงและสถานะ และรีแอ็กชัน
เว็บฮุกขององค์กร: การลงทะเบียนเว็บฮุก การสมัครรับอีเวนต์ ลายเซ็น การส่ง และการลองใหม่
API สาธารณะสำหรับระบบที่เชื่อมต่อ: ข้อกำหนดของ API นี้ในรูปแบบที่เครื่องอ่านได้
การอัปโหลดแบบหลายส่วน (multipart upload) สำหรับไฟล์ขนาดใหญ่: เซสชัน ส่วน การทำให้เสร็จพร้อมการตรวจไฟล์ และการนำไปใช้กับการ์ด ไฟล์บีบอัด หรือการนำเข้า
การวิเคราะห์การใช้งานผลิตภัณฑ์: อีเวนต์การใช้งาน ตัวนับรายออบเจ็กต์ แดชบอร์ดสุขภาพความรู้ การใช้งาน และการมีส่วนร่วม รายงานต่ออายุสัญญา และการส่งออก
คุณภาพของคำตอบ: คำถามที่ยังไม่มีคำตอบที่ดี และความรู้ที่ยังขาดซึ่งรับไปดำเนินการแล้ว
เอกสารทางการเงิน: อัตราแลกเปลี่ยนและทะเบียนคู่ค้า
ออบเจ็กต์
- AccessRequest
- AccessRequestDeny
- AccessRequestGrant
- AccessRequestList
- AccessRequestSource
- AccessRequestUser
- AccessRole
- AccessRoleCreate
- AccessRoleKind
- AccessRoleList
- AccessRoleScope
- AccessRoleUpdate
- Acl
- ActivityItem
- AnalyticsCardStats
- AnalyticsContribution
- AnalyticsHealth
- AnalyticsPeriod
- AnalyticsUsage
- Announcement
- AnnouncementAudience
- AnnouncementCreate
- AnnouncementList
- AnnouncementRecipient
- AnnouncementStats
- AnnouncementStatsSummary
- AnnouncementUsage
- AnswerAltPeriod
- AnswerAssignment
- AnswerBasis
- AnswerBasisCollection
- AnswerBasisCounted
- AnswerBasisExcluded
- AnswerBasisFlagged
- AnswerBasisScope
- AnswerCacheHit
- AnswerDataKind
- AnswerDrilldown
- AnswerEntity
- AnswerOutOfScope
- AnswerPeriod
- AnswerResponse
- AnswerSourceKind
- AnswerVerification
- AnswerVerificationItem
- AnswerWarning
- ApiKeyCreate
- ApiKeyCreated
- ApiKeyRoll
- ApiKeyRolled
- ApiKeyRow
- ApiKeyScope
- ApiKeyUpdate
- ApiLogEntry
- ApiLogList
- ApiUsage
- ApiUsagePoint
- ArchiveDocument
- ArchiveInfo
- ArchiveJob
- ArchiveSkip
- ArchiveSource
- ArchiveUploadForm
- ArchiveUploadFromUpload
- ArchiveUploadResult
- AskRequest
- Attachment
- AttachmentKind
- AuditActionCount
- AuditChainReport
- AuditEntry
- AuditExportRow
- BulkAction
- BulkRequest
- BulkResult
- BulkSkipped
- BulkSkipReason
- Calculation
- CalculationInput
- CallerApp
- CallerDataProfile
- CallerIdentity
- CallerKey
- CallerOrg
- CallerRateLimit
- CallerUser
- Card
- CardBrief
- CardBriefRow
- CardComment
- CardContent
- CardContentFile
- CardContentText
- CardCount
- CardDeleteResult
- CardEnrichmentStatus
- CardEvent
- CardExpanded
- CardExportFile
- CardFile
- CardFileUpsertForm
- CardFolderRef
- CardKind
- CardList
- CardPart
- CardSort
- CardStats
- CardStatsDay
- CardsXlsx
- CardTable
- CardTextContentType
- CardTextUpsert
- CardUpdate
- CardUploadForm
- CardUploadFromUpload
- CardUsage
- CardUsageEvent
- CardUsageItem
- CardUsageRow
- CardVerification
- CardVersion
- CardVersionDiff
- CatalogCategory
- CatalogResolveMatch
- CatalogResolveRequest
- CatalogResolveResponse
- CatalogService
- CategoryCount
- CategoryCreate
- CategoryDeleteResult
- CategoryProgress
- CategoryRef
- CategorySource
- CategoryUpdate
- CellType
- ChartReason
- ChartSpec
- ChartType
- ChatDone
- ChatErrorCode
- ChatEvent
- ChatEventData
- ChatEventError
- ChatEventFollowups
- ChatEventInterrupt
- ChatEventMeta
- ChatEventSources
- ChatEventStage
- ChatEventToken
- ChatEventTool
- ChatMessage
- ChatRequest
- ChatScope
- ChatScopePeriod
- ChatStage
- ChatStageInfo
- Collection
- CollectionDeleteResult
- CollectionExpanded
- CollectionHealth
- CollectionList
- CollectionRef
- CollectionReindex
- CollectionReindexResult
- CollectionRequest
- CollectionStats
- CollectionUpdate
- ColumnMeta
- ColumnRole
- CommentCreate
- CommentRequest
- CommentStatus
- CommentWithMentions
- ConfluenceSource
- ConnectorSource
- ContentJSON
- ContributionDay
- Contributor
- ConversationDetail
- ConversationList
- ConversationPublic
- DataProfileBrief
- Dataset
- DatasetCell
- DatasetColumn
- DatasetGroup
- DatasetRole
- DataSource
- DeletedResponse
- Delivery
- DiffHunk
- DiffLine
- DiffRow
- DocInvoiceExtraction
- DocInvoiceFields
- DocInvoiceLine
- DocInvoiceParty
- DocInvoiceTax
- DocKind
- DocumentCategory
- DocumentCategoryList
- DownloadFile
- Draft
- DraftCollaborator
- DraftCreate
- DraftList
- DraftScope
- DraftUpdate
- DraftWorkflowState
- DriveSource
- EditingLock
- EngineHealth
- EngineHealthLimited
- EngineLicenseSummary
- EntityAction
- EntityKind
- Error
- ErrorDetailObject
- ErrorInfo
- EventAccessRequest
- EventAccessRequestCreated
- EventAccessRequestResolved
- EventAnnouncement
- EventAnnouncementRead
- EventAnnouncementSent
- EventAPIKey
- EventApiKeyCreated
- EventApiKeyExpiring
- EventApiKeyRevoked
- EventAppAuthorized
- EventAppRevoked
- EventCard
- EventCardArchived
- EventCardCreated
- EventCardDeleted
- EventCardIndexed
- EventCardIndexFailed
- EventCardMoved
- EventCardPublished
- EventCardRestored
- EventCardUnverified
- EventCardUpdated
- EventCardVerified
- EventCollection
- EventCollectionCreated
- EventCollectionDeleted
- EventCollectionUpdated
- EventComment
- EventCommentCreated
- EventCommentResolved
- EventCreditsLow
- EventDraft
- EventDraftApproved
- EventDraftCreated
- EventDraftPublishRequested
- EventExportReady
- EventFile
- EventFolder
- EventFolderCreated
- EventFolderDeleted
- EventFolderUpdated
- EventGap
- EventGapDetected
- EventGroup
- EventGroupCreated
- EventGroupDeleted
- EventGroupMemberAdded
- EventGroupMemberRemoved
- EventGroupUpdated
- EventImportDocumentFailed
- EventImportSyncCompleted
- EventInvoice
- EventInvoiceIssued
- EventInvoicePaid
- EventJob
- EventJobCompleted
- EventJobFailed
- EventPlace
- EventQuestion
- EventQuestionAnswered
- EventQuestionFeedbackCreated
- EventQuestionUnanswered
- EventSource
- EventSourceConnectionLost
- EventSourceSyncCompleted
- EventSourceSyncFailed
- EventSubscription
- EventSubscriptionUpdated
- EventSync
- EventUser
- EventUserCreated
- EventUserDeactivated
- EventUserOffboarded
- EventUserUpdated
- EventVerification
- EventVerificationExpired
- EventVerificationRequested
- EventWebhookEndpointDisabled
- EventWebhookPing
- ExpandedUser
- ExportFile
- FeedbackRequest
- FeedItem
- FileAuthor
- FileAuthorList
- FileExpiry
- FileExtend
- FileList
- FileOrigin
- FilePreview
- FileRow
- FinanceCategoryRef
- FinanceCategorySource
- FinanceConversion
- FinanceConverted
- FinanceCurrencyMode
- FinanceDimension
- FinanceFilter
- FinanceInvoicePage
- FinanceInvoiceRow
- FinanceListRequest
- FinanceMeasure
- FinancePartyRef
- FinancePaymentPage
- FinancePaymentRow
- FinanceReport
- FinanceReportRequest
- FinanceReportRow
- FinanceReportTotal
- FinanceUnconverted
- Folder
- FolderCard
- FolderCardList
- FolderColor
- FolderCreate
- FolderDeleteResult
- FolderIcon
- FolderNode
- FolderPathItem
- FolderPosition
- FolderTree
- FolderTreeList
- FolderUpdate
- FolderWithPath
- Followup
- FollowupList
- GapCluster
- GapFollowup
- GapFollowupCreate
- GapFollowupPatch
- GapsResponse
- GrantLevel
- GrantObject
- GrantObjectType
- GrantRole
- GrantSubject
- Group
- GroupActivity
- GroupCreate
- GroupDetail
- GroupKind
- GroupList
- GroupManagedBy
- GroupMember
- GroupUpdate
- GuardrailVerdict
- HealthFull
- HealthLimited
- HealthPublic
- HealthServices
- HealthServiceState
- IndexUpgradeResult
- InvoiceDirection
- Job
- JobActionResult
- JobExpanded
- JobsBatch
- JobsResponse
- JobsSummary
- JobStatus
- JobStreamError
- JobStreamEvent
- JobStreamJob
- JobStreamSnapshot
- JobStreamSummary
- JobWithCard
- LoginChoice
- MePermissions
- Metadata
- MetadataPatch
- Notification
- NotificationKind
- NumberProvenance
- OAuthApp
- OAuthAppCreate
- OAuthAppList
- OAuthAppUpdate
- OAuthAppWithSecret
- OAuthAuthorization
- OAuthAuthorizationList
- OAuthClientType
- OAuthErrorResponse
- OAuthRevokeRequest
- OAuthScope
- OAuthServerMetadata
- OAuthTokenRequest
- OAuthTokenResponse
- ObjectGrant
- ObjectGrantRequest
- ObjectPermissionList
- ObjectPermissions
- OffboardRequest
- OffboardResult
- OrgInfo
- OrgLimits
- OrgLogoInfo
- OrgStatus
- OrgUsage
- OrgUsageView
- PaymentDirection
- PendingAction
- PendingActionResult
- PendingActionStatus
- Permission
- PermissionArea
- PermissionList
- ProvenanceKind
- ProvenanceMatch
- ProvenancePart
- PushDocument
- PushDocumentBatch
- PushDocumentBatchResult
- PushDocumentReason
- PushDocumentResult
- PushDocumentStatus
- PushDocumentStatusExpanded
- PushDocumentStatusList
- PushDocumentStatusValue
- PushPermissions
- PushSourceInfo
- PushSyncClose
- PushSyncOpen
- PushTouch
- PushTouchResult
- PushVerifiers
- QuestionFeedbackFilter
- QuestionFeedbackResult
- QuestionLogList
- QuestionLogRow
- QuestionPayload
- QuestionRow
- QuestionsCsv
- QuestionSource
- QuestionSourceSlim
- QueueStats
- ReactionDetail
- RefreshChange
- RefreshResult
- ReindexCounts
- ReindexPlan
- ReindexResult
- ReindexSkipped
- RestrictedInfo
- ReviewWarning
- Role
- SaveCardRequest
- SaveCardResult
- SearchHit
- SearchRequest
- SearchResponse
- ServiceRef
- SimilarItem
- SimilarResponse
- Source
- SourceCreate
- SourceItemCounts
- SourceKind
- SourceObjectType
- SourcePushKey
- SourcePushKeyCreate
- SourcePushKeyIssued
- SourcePushKeyList
- SourcePushSync
- SourcePushSyncList
- SourceRun
- SourceRunning
- SourceRunStatus
- SourceSettingsUpdate
- SourceStats
- SourceStatus
- SourceTrigger
- SourceUpdate
- SpendCategory
- SpendGroup
- SpendTaxonomy
- StatusOk
- StatusRevoked
- TableDiffItem
- TableProfile
- TableQuery
- TableRow
- TableRows
- TagList
- TaskScope
- TasksDetail
- TasksLegacy
- TextCardRequest
- TextCardResult
- Thread
- ThreadList
- ThreadUpdate
- Timings
- ToolCallInfo
- ToolName
- TrustParts
- TrustPoint
- TrustScore
- TurnVersions
- UnfinishedTurn
- UnverifyRequest
- Upload
- UploadComplete
- UploadCreate
- UploadPart
- UploadPartRef
- UploadPurpose
- UploadResult
- UploadStatus
- UsageDay
- UsageItem
- User
- UserActivityRow
- UserBrief
- UserBriefList
- UserCreate
- UserRowSlim
- UsersImportAction
- UsersImportCounts
- UsersImportInvitation
- UsersImportLimit
- UsersImportRequest
- UsersImportResult
- UsersImportRow
- UsersImportRowError
- UserUpdate
- ValidationError
- Verification
- VerificationEvent
- VerificationIntervalUpdate
- VerificationQueue
- VerificationQueueItem
- VerificationReason
- VerificationState
- VerificationType
- Verifier
- VerifierRef
- VerifierSet
- VerifierType
- VerifyCardRequest
- VerifyRequest
- ViewAs
- ViewAsOrg
- WebhookAttempt
- WebhookAttemptList
- WebhookAuthInput
- WebhookCatalog
- WebhookCatalogItem
- WebhookCreate
- WebhookCreated
- WebhookDelivery
- WebhookDeliveryBody
- WebhookDeliveryDetail
- WebhookDeliveryExpanded
- WebhookDeliveryList
- WebhookDeliveryStatus
- WebhookEndpoint
- WebhookEndpointList
- WebhookEvent
- WebhookEventFilter
- WebhookEventList
- WebhookEventObject
- WebhookEventType
- WebhookHeader
- WebhookHeaderInput
- WebhookHealth
- WebhookPayloadMode
- WebhookRedeliverRange
- WebhookRedeliverResult
- WebhookRole
- WebhookRotateSecret
- WebhookSecret
- WebhookStatus
- WebhookTestRequest
- WebhookUpdate