API-referentie: Topics endpoints

• GET /api/Topics – Bearer JWT (TicketAccessOrPhoneAuth)
  Toon topics met paginering en sortering. Optionele query channelId beperkt de resultaten tot topics toegestaan voor dat kanaal; aanvragen met telefoon-auth gebruiken het tokenkanaal.
• GET /api/Topics/{id} – Bearer JWT (TicketAccessOrPhoneAuth)
  Lees één topic. Optionele channelId past dezelfde kanaaltoegangsfilter toe en geeft 404 terug wanneer het topic niet is toegestaan voor dat kanaal.
• POST /api/Topics – Bearer JWT (ManageSettings)
  Maak een topic aan. De server stelt de klantscope in en valideert model-overrides voor telefoon voor het opslaan.
• PUT /api/Topics/{id} – Bearer JWT (ManageSettings)
  Werk topicnaam, beschrijving en telefooninstellingen bij. Invoer voor customFieldRequirements in legacy wordt genegeerd omdat de vereisten nu worden afgeleid van gekoppelde documenten.
• DELETE /api/Topics/{id} – Bearer JWT (ManageSettings)
  Verwijder een eigen topic. Geeft 204 bij succes of 404 wanneer het topic ontbreekt.

• GET /api/TopicChannels – Bearer JWT (ManageSettings)
  Toon koppelingen tussen topics en kanalen. Query ondersteunt topicId, channelId, pageNumber, pageSize, sortBy en sortOrder. pageNumber wordt genormaliseerd en pageSize wordt beperkt tot 1-100.
• GET /api/TopicChannels/{id} – Bearer JWT (ManageSettings)
  Lees één koppeling tussen topic en kanaal binnen de gescopeerde klant.
• POST /api/TopicChannels – Bearer JWT (ManageSettings)
  Maak een standaardrelevantie-koppeling tussen een topic en een specifiek kanaal of een speciaal kanaaltype. Dubbele combinaties geven 409 Conflict.
• POST /api/TopicChannels/bulk – Bearer JWT (ManageSettings)
  Maak meerdere koppelingen tussen topics en kanalen. Dubbele invoerrijen en reeds bestaande combinaties worden door de service overgeslagen.
• DELETE /api/TopicChannels/{id} – Bearer JWT (ManageSettings)
  Verwijder een koppeling tussen topic en kanaal.
• DELETE /api/TopicChannels/bulk – Bearer JWT (ManageSettings)
  Verwijder meerdere koppelingen tussen topics en kanalen. De request body is een array van TopicChannelID-waarden; een lege body geeft 400 terug.

• GET /api/TopicActions – Bearer JWT
  Toon koppelingen tussen topics en acties. Filters zijn onder andere topicId, actionId, hookName, channelId, isActive, paginering en sortering.
• GET /api/TopicActions/{id} – Bearer JWT
  Lees één koppeling tussen topic en actie met opgeloste topic-, actie- en kanaalnamen.
• POST /api/TopicActions – Bearer JWT
  Maak een koppeling tussen topic en actie. Gebruik actionID voor de herbruikbare actiedefinitie en priority voor de uitvoeringsvolgorde.
• POST /api/TopicActions/bulk – Bearer JWT
  Maak meerdere koppelingen tussen topics en acties. Bestaande overeenkomende combinaties worden overgeslagen.
• PUT /api/TopicActions/{id} – Bearer JWT
  Werk enkel het veld priority van een bestaande koppeling bij.
• DELETE /api/TopicActions/{id} – Bearer JWT
  Verwijder één koppeling tussen topic en actie.

• GET /api/TopicDocuments – Bearer JWT
  Toon koppelingen tussen topics en documenten. Filters omvatten topicId, documentId, channelId, hookName, isHook, paginering en sortering.
• GET /api/TopicDocuments/{id} – Bearer JWT
  Lees één koppeling tussen topic en document binnen de gescopeerde klant.
• POST /api/TopicDocuments – Bearer JWT
  Maak een koppeling tussen een document en een topic, speciaal topic, kanaal of speciaal kanaal. Dubbele combinaties geven 409 Conflict.
• POST /api/TopicDocuments/bulk – Bearer JWT
  Maak meerdere koppelingen tussen topics en documenten. De huidige bulk create geeft een serverfout als de database dubbele combinaties weigert.
• PUT /api/TopicDocuments/{id} – Bearer JWT
  Werk document, topic/speciaal topic en kanaal/speciaal kanaal velden bij voor één koppeling.
• DELETE /api/TopicDocuments/{id} – Bearer JWT
  Verwijder één koppeling tussen topic en document.

• GET /api/PageTopicMappings – Bearer JWT
  Toon URL-naar-topic koppelingen met de gedeelde pagineringsparameters.
• GET /api/PageTopicMappings/{id} – Bearer JWT
  Lees één page-topic mapping binnen de gescopeerde klant.
• POST /api/PageTopicMappings – Bearer JWT
  Maak een mapping van een URL-patroon en pathscope naar een topic of speciaal topic. De server slaat aanmaker en aanmaakdatum op.
• PUT /api/PageTopicMappings/{id} – Bearer JWT
  Werk URL-patroon, matchtype, pathscope, topic/speciaal topic en kanaalscope bij. De server registreert de metadata van de laatste wijziging.
• DELETE /api/PageTopicMappings/{id} – Bearer JWT
  Verwijder één page-topic mapping.

• POST /api/ConditionalRules/from-text – Bearer JWT
  Gerelateerde automatiseringshelper. Zet een natuurlijke taalinstructie om naar JSON conditionele regels. De geauthenticeerde klant moet een OpenAI API-sleutel geconfigureerd hebben.

Beschermde AnswerPal API endpoints gebruiken JWT Bearer-authenticatie. De lijst- en detailroutes voor topics aanvaarden ook telefonische-authenticatiecontext via TicketAccessOrPhoneAuth; instellingenroutes vereisen ManageSettings.

• Lijstroutes geven PaginatedResult<T> met items, totalCount en totalPages terug.
• Succesvolle create-routes geven gewoonlijk 201 Created of 200 OK terug bij bulk create. Succesvolle update- en delete-routes geven meestal 204 No Content.
• 400 wordt gebruikt voor validatiefouten, 403 voor verboden combinaties van phone-auth/kanaal, 404 voor ontbrekende of ontoegankelijke resources en 409 voor dubbele single-link creates waarbij de API conflicten behandelt.
• Telefonische authenticatie topic reads zijn verbonden aan het tokenkanaal. Een andere channelId meegeven resulteert in 403.