connector-catalog-public@1.0.0
Catalogue public des connecteurs
Consultez le catalogue des types de connecteurs publiés par Apus et leur niveau de disponibilité. Aucune authentification requise.
Construit à partir du contrat figé, version 1.0.0. Une version figée n’est jamais modifiée.
Opérations
get/v1/public/connectors
Renvoie tout le catalogue en une seule réponse, sans pagination. Envoyez If-None-Match avec l’ETag conservé pour obtenir 304 si rien n’a changé.
Aucune authentification requise · getPublicConnectorCatalog
Paramètres
| Nom | Emplacement | Type | Obligatoire |
|---|---|---|---|
| If-None-Match | header | string | Non |
Réponses
200— Le catalogue actuel. Un tableau vide est valide : rien n’a encore été publié.304— Le catalogue n’a pas changé depuis l’ETag envoyé.500— Le catalogue n’a pas pu être construit. Traitez-le comme une absence de données, jamais comme un catalogue vide.
Modèles de données
ConnectorCatalog
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| contract | "connector-catalog-public/1.0.0" | Oui | Version du contrat servie. |
| generated_at | string (date-time) | Oui | Date de construction du catalogue (UTC, RFC 3339). |
| connectors | PublicConnector[] | Oui | Tous les types publiés ; peut être vide. |
PublicConnector
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
| key | string | Oui | Identifiant permanent du type de connecteur ; utilisable comme ancre de lien. |
| name | string | Oui | Nom affiché ; ne pas s’en servir pour comparer. |
| direction | inbound_api | webhook_out | polling_adapter | Oui | Sens des données : entrée par API, sortie par webhooks signés, ou collecte périodique. |
| status | live | beta | roadmap | Oui | Disponibilité : live, beta ou roadmap. |
| summary | string | Non | Courte description facultative. |
| docs_url | string (uri) | Non | Page de documentation publique facultative pour ce type. |