Read bounded canonical contributors to one returned failure groupCitește contributorii canonici ai unui grup de erori

Read bounded canonical contributors to one returned failure group. Reads a bounded canonical view without mutation. Required inputs: from, to, scope, code. HTTP success: 200; documented failures: 401, 403, 405, 422, 500, 503. Treat the returned cursor as opaque and preserve the operation's filters across pages.Citește contributorii canonici ai unui grup de erori. Citește o vedere canonică limitată fără modificare. Intrări obligatorii: from, to, scope, code. Succes HTTP: 200; erori documentate: 401, 403, 405, 422, 500, 503. Tratează cursorul returnat ca opac și păstrează filtrele operației între pagini.

Roles: administrator, engineer, operator, auditor, business_viewerRoluri: administrator (administrator), engineer (inginer), operator (operator), auditor (auditor), business_viewer (cititor business)Host-local session requiredEste necesară sesiunea hostului

A session with must_change_password=true is forbidden regardless of role; only session read, password change, and logout remain authorized.O sesiune cu must_change_password=true este interzisă indiferent de rol; rămân autorizate doar citirea sesiunii, schimbarea parolei și deconectarea.

Required headers and parametersHeadere și parametri obligatorii

fromquery · requiredobligatoriu
Inclusive UTC cohort boundary copied from decision-summary.Limita UTC inclusivă pentru received_at; implicit este cu 30 de zile înainte de to.
2026-08-01T10:00:00Z

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "format": "date-time"
}

toquery · requiredobligatoriu
Exclusive UTC cohort boundary copied from decision-summary.Limita UTC exclusivă pentru received_at; implicit este momentul curent și permite un interval de cel mult 366 de zile.
2026-08-01T10:00:00Z

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "format": "date-time"
}

scopequery · requiredobligatoriu
Exact canonical failure scope returned by decision-summary.Domeniul canonic exact al erorii returnat de decision-summary.
ingestion_rejection

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "enum": [
    "ingestion_rejection",
    "processing_failure",
    "blocked_dependency"
  ]
}

codequery · requiredobligatoriu
Exact canonical code returned by decision-summary; ingestion rejection codes use underscore words while processing codes also permit dots and hyphens.Codul canonic exact returnat de decision-summary; codurile de respingere la ingestie folosesc cuvinte separate prin underscore, iar codurile de procesare permit și puncte și cratime.
synthetic-example

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "minLength": 1,
  "maxLength": 128,
  "pattern": "^(?:[a-z0-9]+(?:_[a-z0-9]+)*|[a-z][a-z0-9_.-]{0,63})$"
}

limitquery · optionalopțional
Maximum number of ordered results to return on this page.Numărul maxim de rezultate ordonate returnate în această pagină.
50

Complete parameter schemaSchema completă a parametrului

{
  "type": "integer",
  "minimum": 1,
  "maximum": 100,
  "default": 50
}

cursorquery · optionalopțional
Opaque cursor bound to every normalized contributor filter.Cursor stabil și opac din pagina ordonată precedentă; păstrează filtrele operației la continuare.
synthetic-cursor

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "minLength": 1,
  "maxLength": 512
}

Parameter limitsLimitele parametrilor

{"name":"code","maximum":null,"max_length":128}{"name":"limit","maximum":100,"max_length":null}{"name":"cursor","maximum":null,"max_length":512}

Lifecycle and conventionsCiclu și convenții

Request examplesExemple de cerere

Synthetic curl · copy onlycurl sintetic · numai pentru copiere

curl --request GET "$DOCULA_URL/api/v1/analytics/failure-contributors" \
  --get \
  --data-urlencode "from=$FROM" \
  --data-urlencode "to=$TO" \
  --data-urlencode "scope=$SCOPE" \
  --data-urlencode "code=$CODE" \
  --cookie "$COOKIE_JAR"

No request body applies. Use the documented method, path, headers, and parameters.Nu se aplică un body al cererii. Folosește metoda, calea, headerele și parametrii documentați.

Responses and failuresRăspunsuri și erori

200One refreshed failure group and its bounded canonical contributors.Un grup actualizat de erori și contributorii săi canonici mărginiți.