Consultar empresa

Servicio para consultar los datos de tu empresa: nombre, logo, opciones de personalización visual (marca blanca) y los webhooks configurados.

GET /v1.5/ext/company HTTP/1.1
HOST: {{api_auco}}
Authorization: {{public_key}}

Autenticación

Incluye tu llave publica en el encabezado Authorization.

Authorization: puk_xxx...

Parámetros de consulta

Este servicio no recibe parámetros. La empresa se identifica a partir de la llave pública enviada en el encabezado Authorization.

Estructura de la respuesta

Campo	Tipo	Descripción
id	String	Identificador de la empresa.
name	String	Nombre de la empresa.
webhooks	Array	Lista de webhooks configurados. Cada elemento contiene id, description, url y header. Ver Webhooks.
uxOptions	Object	Opciones de personalización visual (marca blanca), por ejemplo primaryColor y alternateColor.
image	String	URL del logo de la empresa.
webhook	String	(Legacy) URL del webhook único. Se mantiene por compatibilidad; usa webhooks.
webhookHeader	Object	(Legacy) Header { key, value } del webhook único. Se mantiene por compatibilidad; usa webhooks.

Campos legacy

webhook y webhookHeader se devuelven solo para integraciones antiguas. La configuración actual de notificaciones se realiza mediante el arreglo webhooks (ver Webhooks).

🧪 Ejemplo de uso

Curl

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

Python

import requests

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

Node.js

const axios = require('axios');

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

📥 Ejemplo de respuesta

{
  "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": {}
}

⚠️ Respuestas de error

Código	Descripción
401	Autenticación inválida o ausente