Visualizzazioni:

Request:
Perché nel mio strumento viene visualizzato un messaggio di errore che indica che le mie richieste sono limitate?


Risposta:
Per evitare di gravare troppo sul vostro sistema cloud, le richieste troppo frequenti vengono limitate.
Il motivo è che richieste troppo frequenti e non necessarie possono avere un impatto negativo sui vostri flussi di lavoro.

Attualmente, le seguenti richieste sono limitate e limitate a:
Funzionalità Limitazione API Uri
Accesso al conto (a partire dal 6 aprile 2022) 60 chiamate al minuto /Acconto/Logon
Descrizione del file cabinet 60 chiamate al minuto /Archivio

Ciòsignifica, ad esempio, che se un client tenta di accedere più di 60 volte in un minuto, la 61a richiesta di accesso viene strozzata.
Throttling significa:
  • Normalmente, una richiesta viene consegnata entro pochi millisecondi. Quando una richiesta viene strozzata, la risposta viene inviata dopo 10 secondi.
  • Viene restituito il codice di stato HTTP 429.
  • La richiesta non viene elaborata. L'applicazione deve inviare nuovamente la richiesta.
 
Se si riceve uno stato HTTP 429, controllare attentamente l'applicazione della piattaforma.
Un'applicazione della piattaforma ottimizzata aiuta l'utente e tutti gli altri utenti di DocuWare a ottenere una risposta più rapida dal sistema cloud di DocuWare.
 
Un esempio di best practice su come gestire il throttling è disponibile nella pagina degli sviluppatori

. Si noti che il throttling si applica solo agli strumenti SDK che si connettono alla piattaforma DocuWare.Le azioni eseguite dall'utente all'interno del client Web non sono soggette a throttling.

Attenzione:
Se un'applicazione della piattaforma utilizza lo stesso login utente DocuWare Desktop di un client DocuWare (ad esempio un'applicazione desktop) e l'indirizzo IP visibile del server DocuWare è lo stesso ,
può accadere che il client DocuWare venga strozzato.
Il motivo è che il server delle applicazioni conta tutte le richieste di un'organizzazione per periodo di tempo. Se, ad esempio, l'applicazione della piattaforma ha già richiesto
"Archivi/Index" 60 volte in un minuto e l'applicazione desktop cerca di ottenere queste informazioni, l'applicazione desktop viene strozzata. È quindi
è quindi importante che tutte le applicazioni della piattaforma siano programmate con attenzione per evitare ulteriori problemi o effetti collaterali.

Il 6. aprile 2022 verrà introdotto il throttling nell'Identity Service. Ciò significa che alcune Request verranno bloccate se superano una soglia. Attualmente è previsto un limite di

60 richieste al minuto per i seguenti endpoint:

  • Tutte le richieste POST al controller Conto - tutti i percorsi che iniziano con "/Conto".
  • Tutte le richieste all'API di Identity Service - tutti i percorsi che iniziano con "/api".
  • Tutte le richieste all'endpoint OIDC authorize - tutti i percorsi che iniziano con "/connect/authorize".
  • Tutte le richieste all'endpoint OIDC token - tutti i percorsi che iniziano con "/connect/token".

Quando la soglia viene raggiunta, gli endpoint restituiscono una risposta di questo tipo:

  • Codice di stato: Codice di stato HTTP 429 (Troppe Request)
  • Riprova dopo: 58 (intestazione HTTP)
  • Contenuto: Quota di chiamate API superata! Massimo ammesso 60 per 1m.

Se la soglia non viene raggiunta, la risposta contiene le seguenti intestazioni:

  • X-Rate-Limit-Limit: il periodo di limitazione della velocità (es. 1m, 12h, 1d)
  • X-Rate-Limit-Remaining: numero di Request rimanenti
  • X-Rate-Limit-Reset: data e ora UTC (ISO 8601) in cui i limiti si azzerano.

KBA è applicabile SOLO alle organizzazioni cloud.

Si prega di notare: Questo articolo è una traduzione dall'inglese. Le informazioni contenute in questo articolo si basano sulla versione originale in inglese del/i prodotto/i. Potrebbero esserci piccoli errori, ad esempio nella grammatica utilizzata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa accuratezza della traduzione, nella maggior parte dei casi la troverete sufficientemente informativa. In caso di dubbi, si prega di fare riferimento alla versione inglese di questo articolo.

This article is valid for DocuWare versions: All DocuWare Cloud Versions, Throttling, Cloud SDK Tools, Platform API, URI, NET, Status 429