Към съдържанието
Sursa Developers

Кодове на грешки

Всеки отговор с грешка има една и съща структура. Разчитайте на HTTP статуса и на error.code; error.message е четим текст на английски и може да се промени.

Формат на грешката

{
  "detail": "…",
  "error": {
    "code": "api.cursor_invalid",
    "message": "The cursor is malformed or was issued for different filters.",
    "details": {"parameter": "cursor"},
    "request_id": "01JB7Q2M4X9V3K8T5N6P0R1S2A",
    "doc_url": "https://developers.sursa.com/errors/api.cursor_invalid"
  }
}

error.code е кодът от тази страница; error.request_id съвпада със заглавката X-Request-Id; error.doc_url води към тази страница.

access_requests

analytics

announcements

answers

  • 400answers.empty_questionпразен въпрос
  • 429answers.engine_busyуслугата за отговори е заета; опитайте отново след {retry_after} сек
  • 409answers.external_ai_disabledвъншната обработка е изключена за организацията, а без нея този отговор не може да бъде създаден
  • 400answers.last_message_not_userпоследното съобщение трябва да е от потребителя
  • 404answers.no_collectionsняма колекции, достъпни за четене
  • 422answers.scope_invalidобхватът на въпроса не може да бъде приложен: {reason}

api

  • 400api.cursor_invalidкурсорът е повреден или е издаден за други филтри
  • 400api.expand_invalidexpand[] е невалиден: {reason}
  • 410api.goneтози маршрут на API е премахнат; вижте docs/api/CHANGELOG.md
  • 409api.idempotency_in_progressзаявка с този Idempotency-Key още се обработва; опитайте по-късно
  • 400api.idempotency_key_invalidзаглавката Idempotency-Key трябва да съдържа от 1 до 255 печатими ASCII знака
  • 409api.idempotency_mismatchтози Idempotency-Key вече е използван с друга заявка
  • 400api.metadata_invalidполето metadata е невалидно: {reason}
  • 404api.not_foundНе е намерено
  • 413api.payload_too_largeтялото на заявката е твърде голямо
  • 429api.quota_exceededорганизацията е изразходвала квотата си за API заявки за този период
  • 429api.rate_limitedтвърде много заявки; опитайте по-късно

api_keys

api_logs

  • 404api_logs.not_foundзаявката не е намерена в дневника на API или е по-стара от 14 дни

auth

authz

  • 403authz.forbiddenизисква се правото „{permission}“
  • 400authz.group_key_invalidневалиден ключ на група: латински букви, цифри, „_“ и „-“, до 80 знака, започва с буква
  • 409authz.group_key_takenключът на група „{key}“ вече се използва
  • 409authz.group_kind_immutableтази група е вградена; членовете ѝ се изчисляват и не могат да се редактират, а самата група не може да бъде изтрита
  • 409authz.group_managed_externallyгрупата се управлява от доставчика на идентичност (SCIM)
  • 404authz.group_not_foundгрупата не е намерена
  • 409authz.last_ownerвърху обекта трябва да остане поне един „{role}“
  • 409authz.legacy_admin_single_user_onlyролята на администратор се присвоява само на потребители, не на групи
  • 409authz.managed_by_sourceправата на този обект се управляват от неговия източник
  • 400authz.role_key_invalidневалиден ключ на роля: латински букви, цифри, „_“ и „-“, до 64 знака, започва с буква
  • 409authz.role_key_takenключът на роля „{key}“ вече се използва
  • 404authz.role_not_foundролята не е намерена
  • 400authz.role_scope_mismatchролята „{key}“ не може да бъде присвоена върху {object_type}
  • 409authz.role_system_immutableсистемните роли не могат да се променят или изтриват
  • 400authz.subject_requiredзадължително е точно едно от group_id и user_id
  • 400authz.unknown_permissionнепознато право „{permission}“
  • 400authz.user_not_in_orgпотребителят не е намерен в организацията
  • 400authz.view_requiredролята за обекти трябва да включва COLLECTION_VIEW

billing

  • 402billing.seats_exceededВсички {purchased} места в абонамента са заети ({reserved} активни потребители и чакащи покани). Добавете места на страницата Billing, за да поканите още хора.

cards

  • 400cards.archive_emptyархивът не съдържа поддържани документи
  • 400cards.archive_encryptedархивът е шифрован; качете архив без парола
  • 400cards.archive_invalidфайлът не е zip архив или архивът е повреден
  • 404cards.archive_job_not_foundзаданието за разархивиране не е намерено
  • 413cards.archive_too_largeразархивираният архив е по-голям от разрешеното
  • 413cards.archive_too_many_filesархивът съдържа повече файлове от разрешеното
  • 400cards.bulk_invalid{reason}
  • 403cards.category_whole_accessкатегорията може да се промени само при достъп до целия документ
  • 404cards.comment_not_foundкоментарът не е намерен или не е ваш
  • 403cards.content_whole_accessсъдържанието на картата може да се замени само при достъп до целия документ
  • 403cards.delete_whole_accessкартата може да се изтрие само при достъп до целия документ
  • 403cards.duplicate_restrictedсъществува идентичен документ, който не е изцяло достъпен с вашия профил за достъп
  • 400cards.export_formatformat трябва да е pdf, docx или md
  • 409cards.external_id_takenexternal_id „{external_id}“ вече се използва от друга карта на организацията
  • 409cards.indexing_in_progressкартата се индексира в момента
  • 400cards.invalid_folder_filterfolder=none изисква параметъра collection
  • 400cards.invalid_kind_filterkind трябва да е една от стойностите ('file', 'text', 'connector')
  • 400cards.invalid_orderorder трябва да е 'asc' или 'desc'
  • 400cards.invalid_owner_filterowner трябва да е 'me', 'none' или ID на потребител
  • 400cards.invalid_sortsort трябва да е една от стойностите ('created_at', 'updated_at', 'title', 'size', 'verified_at', 'trust', 'due')
  • 400cards.invalid_status_filterstatus трябва да е една от стойностите ('processing', 'ready', 'error', 'archived', 'all')
  • 400cards.invalid_type_filtertype трябва да е 'table' или 'text'
  • 400cards.invalid_verification_filterverification трябва да е една от стойностите ('verified', 'needs_verification', 'stale')
  • 409cards.managed_by_sourceтази карта се управлява от източник; променете документа в източника (при собствен източник – изпратете го отново)
  • 403cards.no_accessнямате достъп за {action} до тази карта
  • 409cards.no_original_fileоригиналният файл не се съхранява за тази карта
  • 404cards.not_foundкартата не е намерена
  • 400cards.review_requires_asyncreview=true изисква async=true: прегледът на разбора се показва, докато заданието чака
  • 403cards.sensitivity_admin_onlyсамо администратор може да понижи чувствителността или да премести чувствителна карта
  • 404cards.table_not_foundтаблицата не е намерена
  • 400cards.unknown_table_partнепозната таблица „{table_id}“
  • 415cards.unsupported_formatформатът {ext} не се поддържа; разрешени: ['.adoc', '.asciidoc', '.bmp', '.csv', '.docx', '.eml', '.htm', '.html', '.jpeg', '.jpg', '.markdown', '.md', '.ods', '.pdf', '.png', '.pptx', '.tif', '.tiff', '.tsv', '.txt', '.webp', '.xls', '.xlsm', '.xlsx']
  • 403cards.verify_forbiddenсамо отговорникът, проверяващ или администратор може да провери тази карта
  • 400cards.verify_user_account_requiredпроверката изисква потребителски акаунт, а не API ключ
  • 404cards.version_not_foundверсията не е намерена

catalog

categories

collections

  • 403collections.admin_fieldsза настройките на достъпа, чувствителността, стойностите по подразбиране и настройките на търсенето в колекцията се изисква роля на администратор
  • 409collections.index_outdatedиндексът на тази колекция е остарял; първо го обновете: PATCH /v1/collections/{name} с upgrade_index: true индексира колекцията повторно
  • 409collections.indexing_in_progressдокументите в тази колекция се индексират в момента; променете настройките на търсенето, когато индексирането приключи
  • 400collections.invalid_nameневалидно име на колекция: 1–64 знака, латински букви, цифри, „_“ и „-“
  • 403collections.no_accessнямате достъп за „{action}“ до колекцията „{name}“
  • 403collections.no_write_accessнямате достъп за запис до колекцията „{name}“
  • 404collections.not_foundколекцията „{name}“ не е намерена

comments

conversations

drafts

  • 409drafts.already_requestedза тази чернова вече е подадена заявка за публикуване; можете да продължите редактирането, докато тя очаква преглед
  • 409drafts.card_deletedкартата на тази чернова е изтрита
  • 409drafts.card_publishedкартата е публикувана или променена след началото на тази чернова; започнете нова чернова от публикуваната версия
  • 422drafts.content_json_invalidcontent_json трябва да е обект със schemaVersion (низ) и doc (обект), най-много 500000 байта
  • 409drafts.deleted_by_collaboratorдруг съавтор е изтрил тази чернова; започнете нова чернова, за да продължите редактирането
  • 409drafts.existsвече имате чернова на тази карта
  • 422drafts.invalid_scopescope трябва да е mine, all или orphaned
  • 403drafts.not_collaboratorсамо съавтор или администратор може да промени тази чернова
  • 404drafts.not_foundчерновата не е намерена
  • 409drafts.not_requestedза тази чернова не е поискано публикуване
  • 403drafts.publish_forbiddenнямате право да публикувате в тази колекция
  • 422drafts.scheduled_pastпланираната дата трябва да е в бъдещето
  • 422drafts.title_requiredзаглавието е задължително

events

  • 404events.not_foundсъбитието не е намерено или е по-старо от 30 дни

files

  • 410files.expiredсрокът на файла е изтекъл
  • 422files.infectedфайлът {filename} е отхвърлен от антивирусната проверка: {signature}
  • 422files.invalid_expiry_filterexpiry трябва да е една от стойностите active, expiring, expired
  • 422files.invalid_kind_filterkind трябва да е една от стойностите pdf, xlsx, csv, docx, md
  • 422files.invalid_origin_filterorigin трябва да е една от стойностите answer, card, insights, list
  • 409files.no_expiryтози файл се съхранява без срок на изтичане
  • 404files.not_foundфайлът не е намерен
  • 409files.not_regenerable{reason}
  • 422files.preview_failedтози файл не може да бъде прегледан: {reason}
  • 404files.regeneration_requiredтози файл е създаден на основния адрес и съдържа подробности, които адресът на API не връща; създайте го наново чрез POST /v1/files/{file_id}/regenerate или го изтеглете от основния адрес
  • 409files.removedфайлът вече е премахнат след изтичането на срока му; създайте го наново
  • 503files.scan_unavailableантивирусната проверка не е налична; опитайте по-късно
  • 413files.too_largeфайлът {filename} е по-голям от лимита за качване от {limit}
  • 415files.type_mismatchфайлът {filename} не съответства на типа си: разширение {extension}, деклариран тип {declared}, съдържание {detected}

finance

folders

  • 400folders.appearance_invalidcolor трябва да е една от стойностите blue, violet, emerald, amber, orange, rose, cyan, slate; icon трябва да е ключ на категория или lock
  • 400folders.card_collection_mismatchкартата и папката принадлежат на различни колекции
  • 409folders.cycleпапка не може да бъде преместена в самата себе си или в своя подпапка
  • 409folders.depth_exceededполучената дълбочина на папките надвишава максимума от 3
  • 404folders.not_foundпапката не е намерена
  • 400folders.parent_mismatchродителската папка принадлежи на друга колекция
  • 400folders.sibling_not_foundprev_sibling_id трябва да е 'first', 'last' или ID на съседна папка в целевата родителска папка
  • 400folders.title_invalidзаглавието на папката трябва да е от 1 до 200 знака

insights

internal

jobs

  • 409jobs.already_processingзаданието вече се обработва и не може да бъде премахнато от опашката
  • 409jobs.cancel_failedзаданието не можа да бъде премахнато от опашката
  • 410jobs.cancel_unsupportedзаданието е поставено в опашката, преди да се поддържа отмяна; изчакайте да приключи
  • 422jobs.invalid_filter{reason}
  • 404jobs.not_foundзаданието не е намерено
  • 409jobs.not_queuedсамо задания, които чакат в опашката, могат да бъдат премахнати от нея (статусът на това задание е {status})

limits

  • 402limits.cardsОрганизацията е достигнала лимита си за карти – {limit}{plan}. Изтрийте картите, които вече не са ви нужни, или помолете системния администратор да увеличи лимита.
  • 429limits.concurrent_answersброят на отговорите в процес на генериране в организацията вече е {used} (лимит {limit}); опитайте отново след няколко секунди
  • 429limits.questionsОрганизацията е изразходвала лимита си за въпроси – {limit} за 24 часа{plan}. Въпросите отново ще бъдат достъпни след около {wait}. Ако ви трябват повече, помолете системния администратор да увеличи лимита.
  • 402limits.sourcesОрганизацията е достигнала лимита си за източници – {limit}{plan}. Изтрийте източниците, които вече не са ви нужни, или помолете системния администратор да увеличи лимита.
  • 402limits.sources_instantМигновените актуализации не са включени в плана на организацията{plan}; източникът остава на график.
  • 402limits.storageНяма достатъчно място за съхранение: организацията използва {used} от {limit} GB{plan}, а за този файл са нужни още {amount}. Изтрийте картите или файловете, които вече не са ви нужни, или помолете системния администратор да увеличи лимита.
  • 402limits.usersОрганизацията е достигнала лимита си за потребители – {limit}{plan}, като се броят активните потребители и чакащите покани. Деактивирайте акаунтите или анулирайте поканите, които вече не са ви нужни, или помолете системния администратор да увеличи лимита.

notifications

oauth

  • 403oauth.operation_not_allowedтази операция не е достъпна за токен на OAuth приложение
  • 401oauth.token_expiredсрокът на токена за достъп е изтекъл; получете нов с токена за опресняване

oauth_apps

  • 400oauth_apps.invalid{reason}
  • 400oauth_apps.invalid_redirect_uriURI за пренасочване „{uri}“ не е разрешен: използвайте https, http само за localhost или схема на приложение с обърнат домейн, без фрагмент
  • 400oauth_apps.invalid_scopeнепознат обхват „{scope}“
  • 409oauth_apps.not_confidentialприложението е публично: няма тайна на клиента и достъп чрез client credentials
  • 404oauth_apps.not_foundOAuth приложението не е намерено
  • 409oauth_apps.too_manyорганизацията вече има максималния брой OAuth приложения ({max})

oauth_authorizations

org

  • 403org.deletedтази организация е изтрита
  • 404org.not_foundорганизацията не е намерена
  • 403org.suspendedтази организация е спряна: входът е затворен, данните се пазят; свържете се с администратора си

profiles

quality

query

questions

sources

tasks

  • 400tasks.invalid_scopescope трябва да е 'mine' или 'team'
  • 403tasks.team_forbiddenизгледът на екипа е достъпен за администраторите и проверяващите
  • 400tasks.user_account_requiredличните задачи принадлежат на потребителски акаунти, а не на API ключове

uploads

users

  • 422users.display_name_emptyпоказваното име не може да е празно
  • 409users.email_takenв организацията вече съществува потребител с този имейл
  • 400users.inactive_assignmentне може да се възлага на неактивен потребител
  • 409users.last_adminв организацията трябва да остане поне един активен администратор
  • 409users.managed_by_scimтози акаунт се управлява от вашия доставчик на идентичност (SCIM); променете го там
  • 404users.not_foundпотребителят не е намерен
  • 400users.not_in_orgпотребителят не е намерен в организацията
  • 400users.offboard_targetполучателят на прехвърлянето трябва да е активен потребител от същата организация, различен от извеждания
  • 403users.password_not_allowedтози акаунт влиза чрез вашия доставчик на идентичност и няма парола; администратор може да добави парола чрез връзка за възстановяване
  • 400users.unknown_or_inactiveнепознати или неактивни потребители: {ids}
  • 400users.update_invalid{reason}
  • 409users.username_takenв организацията вече съществува потребител с това потребителско име

users_import

validation

  • 422validation.failedвалидирането на заявката е неуспешно

verification

view_as

  • 403view_as.admin_key_requiredX-View-As изисква API ключ с ролята admin
  • 400view_as.invalid_headerX-View-As трябва да е <profile>[:viewer|verifier|editor] със съществуващ профил
  • 403view_as.read_onlyрежим на преглед: промените са забранени, докато преглеждате от името на друг профил

webhooks

  • 400webhooks.access_invalidролята, режимът на тялото, профилът за достъп, колекциите или етикетите на уебхука са невалидни
  • 400webhooks.auth_invalidизходящата оторизация трябва да е bearer с токен или basic с потребителско име и парола
  • 403webhooks.collections_outside_keyтози API ключ е ограничен до колекции: посочете collection_ids на уебхука, като всички те трябва да са сред колекциите на ключа
  • 404webhooks.delivery_not_foundдоставката на уебхука не е намерена
  • 400webhooks.description_too_longописанието на уебхука е по-дълго от 200 знака
  • 409webhooks.endpoint_disabledуебхукът е изключен; първо го включете
  • 409webhooks.event_not_permittedсега уебхукът не би получил това събитие: ролята, профилът за достъп, колекциите или етикетите му вече не го позволяват, затова доставката не се повтаря
  • 400webhooks.events_requiredабонирайте се поне за едно събитие
  • 403webhooks.feature_disabledуебхуковете не са включени в плана на организацията
  • 400webhooks.headers_invalidсобствените заглавки на уебхука са невалидни: най-много 10 заглавки, имена от букви, цифри и тирета без запазени имена, стойности до 1024 байта
  • 400webhooks.invalid_urlurl на уебхука трябва да е абсолютен https адрес без идентификационни данни
  • 404webhooks.not_foundуебхукът не е намерен
  • 400webhooks.overlap_invalidприпокриването при смяна трябва да е между 0 и 168 часа
  • 400webhooks.private_addressхостът на уебхука се преобразува в частен или запазен мрежов адрес
  • 400webhooks.redeliver_invalidпериодът за повторна доставка трябва да е в рамките на последните 30 дни, като since е преди until, а статусите трябва да са success, exhausted или cancelled
  • 409webhooks.too_manyедна организация може да има най-много 20 уебхука
  • 400webhooks.unknown_eventнепознато събитие на уебхук {type}
  • 400webhooks.unresolvableхостът на уебхука не се преобразува в адрес