APIリファレンス
概要

API概要

TWP公開APIを使用して、TWPで管理しているコンテンツや問い合わせ機能を外部のWebサイトやアプリケーションに統合できます。

提供API

API説明主な用途
コンテンツAPIコンテンツの取得・検索コーポレートサイト、メディアサイト
問い合わせAPI問い合わせの作成お問い合わせフォーム

ベースURL

https://{your-tenant}.api.tocca.systems

実際のURLはTWP管理画面のAPI設定からご確認いただけます。

APIの特徴

  • RESTful API
  • JSON形式のリクエスト/レスポンス
  • APIキー認証
  • レート制限あり
  • CORS対応

認証方式

TWP公開APIは、APIキー認証を使用します。

X-API-Key: your_api_key_here

詳細は認証をご覧ください。

レスポンス形式

成功時

{
  "items": [...],
  "pagination": {
    "count": 10,
    "has_more": true
  }
}

エラー時

{
  "error": {
    "code": "ERROR_CODE",
    "message": "エラーメッセージ"
  }
}

HTTPステータスコード

コード説明
200成功
201作成成功
400リクエストエラー
401認証エラー(APIキー不正)
403権限エラー
404リソースが見つからない
422バリデーションエラー
429レート制限超過
500サーバーエラー

レート制限

APIにはレート制限が設けられています。制限を超えた場合、429エラーが返されます。

プラン制限
スタンダード100リクエスト/分
プロフェッショナル500リクエスト/分
エンタープライズカスタム

API使用量の確認

API使用量はTWP管理画面の「組織設定」→「API使用量」から確認できます。

サポート

APIに関するお問い合わせは、TWP管理画面内のサポート機能からご連絡ください。