Read bounded canonical contributors to one returned processing-load bucketCitește contributorii canonici ai unui interval de încărcare

Read bounded canonical contributors to one returned processing-load bucket. Reads a bounded canonical view without mutation. Required inputs: from, to, phase, bucket_start, bucket_width_seconds. 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 interval de încărcare. Citește o vedere canonică limitată fără modificare. Intrări obligatorii: from, to, phase, bucket_start, bucket_width_seconds. 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"
}

phasequery · requiredobligatoriu
Exact canonical processing phase returned by decision-summary.Faza canonică exactă de procesare returnată de decision-summary.
ingestion

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "enum": [
    "ingestion",
    "transformation",
    "docx_composition",
    "pdf_generation"
  ]
}

bucket_startquery · requiredobligatoriu
Exact UTC start returned by decision-summary.Începutul UTC exact returnat de decision-summary.
2026-08-01T10:00:00Z

Complete parameter schemaSchema completă a parametrului

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

bucket_width_secondsquery · requiredobligatoriu
Exact actual whole-hour bucket width returned by decision-summary.Lățimea exactă, în ore întregi, a bucketului real returnat de decision-summary.
3600

Complete parameter schemaSchema completă a parametrului

{
  "type": "integer",
  "minimum": 3600,
  "maximum": 86400,
  "multipleOf": 3600
}

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":"bucket_width_seconds","maximum":86400,"max_length":null}{"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/processing-contributors" \
  --get \
  --data-urlencode "from=$FROM" \
  --data-urlencode "to=$TO" \
  --data-urlencode "phase=$PHASE" \
  --data-urlencode "bucket_start=$BUCKET_START" \
  --data-urlencode "bucket_width_seconds=$BUCKET_WIDTH_SECONDS" \
  --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 processing-load bucket and its bounded canonical contributors.Un bucket actualizat al încărcării procesării și contributorii săi canonici mărginiți.