Acceso API

Tona ofrece una API REST simple para que puedas crear instrucciones y obtener información del proyecto de forma programática. Es útil si quieres integrar Tona en tus propios flujos de trabajo, scripts o herramientas de terceros.

Encontrar tus credenciales API

1. Ve a tu proyecto y haz clic en Manual en la barra lateral.
2. Haz clic en el enlace Use API en la esquina superior derecha de la página.
3. Verás tu API Key, Base URL y Authorization Header.

Tu clave API es única para cada proyecto. Mantenla privada y no la compartas públicamente.

Endpoints disponibles

Obtener información del proyecto

Recupera los detalles del proyecto, incluyendo nombre, descripción, créditos y cuentas de plataforma conectadas.

Request:

GET /v1/project
Authorization: Bearer <your-api-key>

Crear una instrucción

Envía una nueva instrucción a Tona, igual que lo harías desde el panel. Especifica las plataformas donde publicar, el prompt del contenido y, si quieres, imágenes adjuntas.

Request:

POST /v1/instructions
Authorization: Bearer <your-api-key>
Content-Type: application/json

{
  "platformAccountIds": ["<account-id>"],
  "content": "Post a tweet about our new product launch",
  "images": ["https://example.com/image.webp"]
}

Puedes encontrar los IDs de las cuentas de plataforma llamando al endpoint Get Project.

Copiar como Markdown

En la página de API, haz clic en Copy as Markdown para copiar toda la documentación de la API, incluida tu clave real, al portapapeles. Es útil cuando quieres pegar esos detalles en tus notas o compartirlos con un desarrollador de tu equipo.

Consejos

• Mantén segura tu API key. Trátala como una contraseña. Si crees que se ha visto comprometida, contacta al soporte.
• Prueba primero con una sola plataforma. Al integrar, empieza apuntando a una sola cuenta para asegurarte de que todo funciona antes de escalar.