Пређите на садржај
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

api

  • 400api.cursor_invalidкурсор је неисправан или је издат за друге филтере
  • 400api.expand_invalidнеисправан expand[]: {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метаподаци су неисправни: {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

billing

  • 402billing.seats_exceededЗаузета су сва места претплате: {purchased} (активни корисници и позивнице на чекању: {reserved}). Додајте места на страници Billing да бисте позвали још људи.

cards

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

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хост вебхука се не разрешава