API-Zugriff

Tona bietet eine einfache REST-API, mit der Sie Anweisungen erstellen und Projektinformationen programmgesteuert abrufen können. Das ist nützlich, wenn Sie Tona in Ihre eigenen Workflows, Skripte oder Drittanbieter-Tools integrieren möchten.

Ihre API-Zugangsdaten finden

1. Öffnen Sie Ihr Projekt und klicken Sie in der Seitenleiste auf Manual.
2. Klicken Sie oben rechts auf den Link Use API.
3. Dort sehen Sie Ihren API Key, die Base URL und den Authorization Header.

Ihr API-Schlüssel ist für jedes Projekt eindeutig. Behandeln Sie ihn vertraulich und teilen Sie ihn nicht öffentlich.

Verfügbare Endpoints

Projektinformationen abrufen

Rufen Sie Details zu Ihrem Projekt ab, einschließlich Name, Beschreibung, Credits und verbundener Plattformkonten.

Request:

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

Eine Anweisung erstellen

Senden Sie eine neue Anweisung an Tona, genau wie aus dem Dashboard heraus. Geben Sie an, auf welchen Plattformen veröffentlicht werden soll, welcher Content-Prompt verwendet wird und hängen Sie optional Bilder an.

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"]
}

Die IDs Ihrer Plattformkonten finden Sie, indem Sie den Get-Project-Endpoint aufrufen.

Als Markdown kopieren

Klicken Sie auf der API-Seite auf Copy as Markdown, um die vollständige API-Dokumentation inklusive Ihres echten API-Schlüssels in die Zwischenablage zu kopieren. Das ist praktisch, wenn Sie die Details in eigene Notizen einfügen oder mit einem Entwickler in Ihrem Team teilen möchten.

Tipps

• Bewahren Sie Ihren API-Schlüssel sicher auf. Behandeln Sie ihn wie ein Passwort. Wenn Sie glauben, dass er kompromittiert wurde, wenden Sie sich an den Support.
• Testen Sie zuerst mit nur einer Plattform. Beginnen Sie bei Integrationen am besten mit einem einzigen Plattformkonto, bevor Sie die Integration ausweiten.