トラブルシューティング

原因

• 無効なJSON形式
• 必須フィールドの不足
• エンドポイントURLの不一致

解決方法

• JSON形式を検証してください
• APIドキュメントで必須フィールドを確認してください
• エンドポイントURLを確認してください

原因

• Authorizationヘッダーが未指定または空
• 無効なAPIキー形式（tm_test_xxx...またはtm_live_xxx...が正しい形式）
• このエンドポイントに対応しないAPIキー
• エンドポイントオーナーによってAPIキーが無効化されている

解決方法

• Authorizationヘッダーを含めてください（例：Bearer tm_test_xxx...）
• サンドボックスにはtm_test_xxx...、本番にはtm_live_xxx...を使用
• 必要に応じてキーを再生成してください
• エンドポイントオーナーに連絡してAPIキーを再有効化してもらってください

原因

• エンドポイントが無効化されている
• サブスクリプションの期限切れまたは月間クォータの超過
• 本番がデプロイされていない（tm_live_キーを使用）

解決方法

• エンドポイントが有効であることを確認してください
• サブスクリプションの状態を確認してください
• tm_live_キーを使用する場合は本番にデプロイしてください

原因

• Content-Typeヘッダーが未指定または不正
• Content-Typeはapplication/jsonである必要があります

解決方法

• ヘッダーを追加してください：Content-Type: application/json

原因

• 月間リクエスト上限を超過

解決方法

• プランをアップグレードするか、月次リセットをお待ちください
• ダッシュボードで使用量を監視してください

500（Internal Server Error）、502（Bad Gateway）、503（Service Unavailable）などを含みます。

原因

• 一時的なサーバーの問題
• 上流サービス（データベース）が一時的に利用不可
• サービスの一時的な過負荷またはメンテナンス中

解決方法

• 指数バックオフ付きリトライを実装してください（例：1秒 → 2秒 → 4秒、最大3回）
• エラーが続く場合はサービスの状態を確認してください
• 問題が解決しない場合はサポートにお問い合わせください：contact@3minapi.com
• 注意：5xxはリクエストが受信されなかったことを意味します。202 Acceptedを受け取った時点で、データ処理は保証されます。

• Webhook URLが正しいことを確認してください
• HTTPまたはHTTPS URLを使用してください
• エンドポイントはパブリックにアクセス可能である必要があります
• ログでWebhookのステータスを確認してください

• 成功の場合は2xxステータスコードを返してください
• 30秒以内にレスポンスしてください
• システムは自動的に最大3回リトライします
• Webhookのリトライによりデータ処理が遅延する場合があります（最大約3秒）