API 접근

Tona는 간단한 REST API를 제공하므로 지시를 만들고 프로젝트 정보를 프로그래밍 방식으로 가져올 수 있습니다. Tona를 자체 워크플로, 스크립트, 서드파티 도구와 통합하고 싶을 때 유용합니다.

API 자격 증명 확인하기

1. 프로젝트로 이동해 사이드바에서 Manual 을 클릭합니다.
2. 페이지 오른쪽 상단의 Use API 링크를 클릭합니다.
3. API Key, Base URL, Authorization Header 가 표시됩니다.

API 키는 프로젝트마다 고유합니다. 외부에 공개하지 말고 안전하게 보관하세요.

사용 가능한 엔드포인트

프로젝트 정보 가져오기

프로젝트 이름, 설명, 크레딧, 연결된 플랫폼 계정을 포함한 상세 정보를 가져옵니다.

Request:

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

지시 만들기

대시보드에서 하듯이 Tona에 새 지시를 보냅니다. 어떤 플랫폼에 게시할지, 어떤 프롬프트를 사용할지 지정하고 필요하면 이미지를 첨부할 수 있습니다.

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

플랫폼 계정 ID는 Get Project 엔드포인트를 호출해 확인할 수 있습니다.

Markdown으로 복사하기

API 페이지에서 Copy as Markdown 을 클릭하면 실제 API 키를 포함한 전체 API 문서를 클립보드에 복사할 수 있습니다. 개인 노트에 붙여 넣거나 팀의 개발자와 공유할 때 유용합니다.

팁

• API 키를 안전하게 보관하세요. 비밀번호처럼 취급해야 합니다. 유출되었을 가능성이 있다면 지원팀에 문의하세요.
• 먼저 하나의 플랫폼으로 테스트하세요. 통합 시에는 먼저 하나의 플랫폼 계정만 대상으로 동작을 확인한 뒤 범위를 넓히는 것이 안전합니다.