Introducción a la API
Aprende a autenticarte en la API pública de Audeo con claves API, límites de uso y buenas prácticas de integración.
Aprende a autenticarte en la API pública de Audeo con claves API, límites de uso y buenas prácticas de integración.
La API pública documentada aquí pertenece al producto Audeo (datos de reuniones, llamadas, contactos, etc.). La autenticación usa API keys creadas en la organización Recordari a la que pertenece tu tenant de Audeo.
El host técnico actual de la API es https://api.salescaling.com/api/v1/ (nombre heredado del producto). La cuenta y las claves se gestionan desde Audeo; la facturación de la organización, desde Recordari Identity.
Esta guía cubre autenticación, límites de uso y buenas prácticas de integración.
Las API keys son tokens seguros que autentican tus peticiones a la API Pública. Cada clave es única y está vinculada a tu cuenta, permitiéndote acceder a tus datos de forma programática.
x-api-key para todas las peticioneshttps://api.salescaling.com/api/v1/x-api-key: tu-api-key-aquiLas API keys utilizan un sistema de scopes para controlar qué acciones pueden realizar. Al crear una API key, debes seleccionar al menos un scope:
Voice Agents:
voice-agents:webhook - Permite iniciar llamadas mediante webhookvoice-agents:read - Permite leer información de voice agentsvoice-agents:write - Permite crear y modificar voice agentsContactos:
contacts:read - Permite leer información de contactoscontacts:write - Permite crear y modificar contactosEmpresas:
companies:read - Permite leer información de empresascompanies:write - Permite crear y modificar empresasLlamadas:
calls:read - Permite leer información de llamadascalls:write - Permite crear y modificar llamadasReuniones:
meetings:read - Permite leer información de reunionesmeetings:write - Permite crear y modificar reunionesOportunidades:
opportunities:read - Permite leer información de oportunidadesopportunities:write - Permite crear y modificar oportunidadesCalendario:
calendar:read - Permite leer información de calendarioscalendar:write - Permite crear y modificar eventos de calendarioUsuarios:
users:read - Permite leer información de usuariosSi solo necesitas iniciar llamadas mediante webhook, selecciona únicamente el scope voice-agents:webhook. Esto sigue el principio de privilegio mínimo, otorgando solo los permisos necesarios.
Para asegurar un uso justo y la estabilidad del sistema, la API implementa limitación de velocidad en todos los endpoints.
Tres límites concurrentes se aplican a tus peticiones:
Cuando recibas una respuesta 429 (Demasiadas Peticiones):
Retry-After para saber cuándo reintentarcurl -X GET \
'https://api.salescaling.com/api/v1/users' \
-H 'x-api-key: tu-api-key-aqui'
const response = await fetch("https://api.salescaling.com/api/v1/users", {
headers: {
"x-api-key": "tu-api-key-aqui",
"Content-Type": "application/json",
},
});
const data = await response.json();
console.log(data);
import requests
headers = {
'x-api-key': 'tu-api-key-aqui',
'Content-Type': 'application/json'
}
response = requests.get(
'https://api.salescaling.com/api/v1/users',
headers=headers
)
data = response.json()
print(data)
const axios = require("axios");
const config = {
headers: {
"x-api-key": "tu-api-key-aqui",
},
};
axios
.get("https://api.salescaling.com/api/v1/users", config)
.then((response) => {
console.log(response.data);
})
.catch((error) => {
console.error("Error:", error.message);
});