L'API Zoho Desk modifiedTimeRange renvoie une erreur HTTP 500

L'API de recherche Zoho Desk renvoie une erreur HTTP 500 lorsqu'un modifiedTimeRange inclut le timestamp exact 2026-03-08T02:00:00.000Z ; l'échec est reproductible uniquement à cette limite, tandis que les plages adjacentes réussissent. ^[1]

Ce que cela signifie

L'appel GET /api/v1/tickets/search rencontre une erreur de serveur interne dans Zoho Desk lorsque le paramètre modifiedTimeRange englobe ou inclut 2026-03-08T02:00:00.000Z. Le rapport de la communauté montre que le même appel réussit pour les plages immédiatement avant et après ce timestamp exact, et échoue avec {"errorCode":"INTERNALSERVERERROR","message":"An internal server error occurred while performing this operation."} lorsque la limite inclut le timestamp. ^[1]

Causes courantes

• Un bug côté serveur dans l'analyse des dates/heures ou une erreur de limite dans la routine de recherche qui ne se déclenche qu'à ce timestamp UTC exact. ^[1]
• Un cas limite d'enregistrement indexé où un enregistrement ou une entrée d'index a une valeur corrompue ou inhabituelle exactement à ce timestamp. ^[1]
• Une règle dans le pipeline de recherche (tri, filtrage ou agrégation) qui échoue à cette valeur limite. Le rapport montre que la suppression de sortBy ou from n'a pas évité l'erreur. ^[1]
• Un comportement de transition d'horloge/fuseau horaire au niveau de la plateforme ou de gestion des secondes intercalaires qui produit un état non géré à cet instant. ^[1]

Comment le corriger

1. Solution de contournement à court terme : évitez d'appeler modifiedTimeRange qui inclut 2026-03-08T02:00:00.000Z. Interrogez des plages qui se terminent à 2026-03-08T01:59:59.999Z ou commencent à 2026-03-08T02:00:00.001Z pour contourner la limite. ^[1]
2. Stratégie de nouvelle tentative : si vous devez couvrir la limite, divisez la requête en deux requêtes (avant et après le timestamp exact) et fusionnez les résultats côté client. Utilisez limit et la pagination pour maintenir chaque requête petite. ^[1]
3. Reproduire et capturer les diagnostics : exécutez les trois cas de test ci-dessous et collectez les paires complètes de requêtes et de réponses (URL, chaîne de requête, en-têtes avec autorisation masquée, corps de réponse et timestamps) :

- Cas de succès avant la limite : modifiedTimeRange=2026-03-08T01:58:00.000Z,2026-03-08T01:59:59.000Z (attendu 204). ^[1]

- Cas d'échec atteignant la limite : modifiedTimeRange=2026-03-08T01:59:59.000Z,2026-03-08T02:00:00.000Z (renvoie 500). ^[1]

- Cas de succès après la limite : modifiedTimeRange=2026-03-08T02:00:00.000Z,2026-03-08T02:00:01.000Z (attendu 204). ^[1]

1. Ouvrez un ticket de support Zoho Desk avec : votre ID d'organisation, les trois requêtes de reproduction ci-dessus, les corps de réponse complets, les timestamps et l'appel API exact (GET /api/v1/tickets/search). Demandez au support de vérifier les journaux du serveur pour ce timestamp UTC et pour toute erreur d'index ou d'analyse. Le post de la communauté documente déjà l'échec reproductible, ce qui accélère l'enquête. ^[1]
2. Surveillez un correctif de plateforme : une fois que le support a confirmé la cause racine, planifiez un retour de la solution de contournement aux requêtes normales après qu'ils aient confirmé la correction.

Quand escalader

Si la limite bloque les flux de production ou si vous ne pouvez pas la contourner en