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管理画面内のサポート機能からご連絡ください。