Consulter l'organisation

Service permettant de consulter les données de votre organisation : nom, logo, options de personnalisation visuelle (marque blanche) et webhooks configurés.

GET/companyclé publiquepuk_

Authentification

Incluez votre clé publique dans l'en-tête Authorization.

Authorization: puk_xxx...

Paramètres de requête

Ce service ne reçoit aucun paramètre. L'organisation est identifiée à partir de la clé publique envoyée dans l'en-tête Authorization.

Structure de la réponse

Champ	Type	Description
id	String	Identifiant de l'organisation.
name	String	Nom de l'organisation.
webhooks	Array	Liste des webhooks configurés. Chaque élément contient id, description, url et header. Voir Webhooks.
uxOptions	Object	Options de personnalisation visuelle (marque blanche), par exemple primaryColor et alternateColor.
image	String	URL du logo de l'organisation.
webhook	String	(Hérité) URL du webhook unique. Conservé pour des raisons de compatibilité ; utilisez webhooks.
webhookHeader	Object	(Hérité) En-tête { key, value } du webhook unique. Conservé pour des raisons de compatibilité ; utilisez webhooks.

Champs hérités

webhook et webhookHeader ne sont renvoyés que pour les intégrations héritées. La configuration actuelle des notifications se fait via le tableau webhooks (voir Webhooks).

🧪 Exemple d'utilisation

Curl

curl -X GET 'https://api.auco.ai/v1.5/ext/company' \
  -H 'Authorization: puk_public_key_company'

Python

import requests

response = requests.get(
  'https://api.auco.ai/v1.5/ext/company',
  headers={'Authorization': 'puk_public_key_company'}
)
print(response.json())

Node.js

const axios = require('axios');

axios
  .get('https://api.auco.ai/v1.5/ext/company', {
    headers: { Authorization: 'puk_public_key_company' }
  })
  .then((response) => console.log(response.data));

📥 Exemple de réponse

{
  "id": "61ba073970df523d9d232a27",
  "name": "Auco",
  "webhooks": [
    {
      "id": "default",
      "description": "Webhook principal",
      "url": "https://miempresa.com/webhooks/auco",
      "header": {
        "key": "Authorization",
        "value": "Bearer ..."
      }
    }
  ],
  "uxOptions": {
    "primaryColor": "#021C30",
    "alternateColor": "#A557F2"
  },
  "image": "https://static.micontrato.co/companies/61ba073970df523d9d232a27/logo.png",
  "webhook": "",
  "webhookHeader": {}
}

⚠️ Réponses d'erreur

Code	Description
401	Authentification invalide ou absente