Aller au contenu

list_managed_companies

Énumérer les entreprises que l’utilisateur connecté est autorisé à gérer en tant qu’émetteur. C’est le point d’entrée de tous les autres outils pour émetteurs — les valeurs companyId retournées sont ce que shareholder_registry, export_shareholder_registry, list_proposals, et sign_proposal attendent en entrée.

Nécessite une connexion. Appelez d’abord sign_in si la session est anonyme. L’utilisateur connecté doit avoir au moins une autorisation d’émetteur sur le backend Aktionariat.

Aucune.

Un tableau récapitulatif. Chaque ligne contient les champs nécessaires pour appeler les outils issus en aval :

ChampTypeDescription
companyIdintegerIdentifiant numérique de l’entreprise gérée.
companyNamestringNom complet de l’entreprise.
tokenNamestringNom de la classe d’actions tokenisée.
registerTickerstringTicker de la classe d’actions enregistrée.
tradedTickerstringTicker de la classe d’actions échangeable.
chainstringBlockchain (mainnet, optimism).

L’adresse du portefeuille de l’utilisateur et l’identifiant interne de GET /authorizations sont intentionnellement exclus de la réponse — ils ne sont pas utiles à l’agent.

  • « Quelles entreprises puis-je gérer sur Aktionariat ? »
  • « Quel est l’identifiant d’entreprise de mon entreprise gérée ? »
  • « Montrez-moi la chaîne et les tickers des entreprises que je gère. »
  • Appelez toujours cet outil avant tout autre outil pour émetteurs. Ne devinez pas les valeurs companyIdshareholder_registry, export_shareholder_registry, list_proposals, et sign_proposal rejetteront les identifiants pour lesquels l’utilisateur n’est pas autorisé.
  • Si la réponse est vide, l’utilisateur connecté n’a pas d’accès émetteur — informez-le et n’appelez pas les outils issus en aval.