Aller au contenu
Sursa Developers

Codes d’erreur

Toutes les réponses d’erreur ont la même forme. Fiez-vous au statut HTTP et à error.code ; error.message est un texte lisible en anglais, susceptible de changer.

Format des erreurs

{
  "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 est le code indiqué sur cette page ; error.request_id correspond à l’en-tête X-Request-Id ; error.doc_url renvoie vers cette page.

access_requests

analytics

announcements

answers

api

api_keys

api_logs

  • 404api_logs.not_foundrequête introuvable dans le journal de l’API ou antérieure à 14 jours

auth

authz

billing

  • 402billing.seats_exceededLes {purchased} licences de l’abonnement sont toutes attribuées ({reserved} utilisateurs actifs et invitations en attente). Ajoutez des licences sur la page « Billing » (facturation) pour inviter d’autres personnes.

cards

catalog

categories

collections

comments

conversations

drafts

events

files

finance

folders

insights

internal

jobs

limits

  • 402limits.cardsL’organisation a atteint sa limite de {limit} fiches{plan}. Supprimez les fiches dont vous n’avez plus besoin ou demandez à l’administrateur système de relever la limite.
  • 429limits.concurrent_answersl’organisation a déjà {used} réponses en cours (limite {limit}) ; réessayez dans quelques secondes
  • 429limits.questionsL’organisation a utilisé sa limite de {limit} questions par 24 heures{plan}. Les questions seront de nouveau disponibles dans environ {wait}. Demandez à l’administrateur système de relever la limite si vous avez besoin de davantage.
  • 402limits.sourcesL’organisation a atteint sa limite de {limit} sources{plan}. Supprimez les sources dont vous n’avez plus besoin ou demandez à l’administrateur système de relever la limite.
  • 402limits.sources_instantLes mises à jour instantanées ne sont pas incluses dans l’offre de l’organisation{plan} ; la source reste sur son calendrier.
  • 402limits.storageStockage insuffisant : l’organisation utilise {used} sur {limit} Go{plan}, et ce fichier nécessite {amount} de plus. Supprimez les fiches ou les fichiers dont vous n’avez plus besoin ou demandez à l’administrateur système de relever la limite.
  • 402limits.usersL’organisation a atteint sa limite de {limit} utilisateurs{plan}, utilisateurs actifs et invitations en attente compris. Désactivez des comptes ou révoquez des invitations dont vous n’avez plus besoin, ou demandez à l’administrateur système de relever la limite.

notifications

oauth

oauth_apps

oauth_authorizations

org

  • 403org.deletedcette organisation a été supprimée
  • 404org.not_foundorganisation introuvable
  • 403org.suspendedcette organisation est suspendue : la connexion est fermée, les données sont conservées ; contactez votre administrateur

profiles

quality

query

questions

sources

tasks

uploads

users

users_import

validation

verification

view_as

  • 403view_as.admin_key_requiredX-View-As exige une clé API dotée du rôle admin
  • 400view_as.invalid_headerX-View-As doit avoir la forme <profile>[:viewer|verifier|editor] avec un profil existant
  • 403view_as.read_onlymode « View as » : les modifications sont désactivées pendant la consultation en tant qu’autre profil

webhooks