-9XXX, -10XXX (コールバック/ネットワーク Curl エラー)
お知らせ
このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。
-9xxx と -10xxx のエラーコードは、libcurl エラーコードの仕様を基に定義されたネットワーク通信エラーです。
各エラーコードの末尾の数字は、Curl 固有のエラー番号を意味します。 DRM Download Callback の処理中に例外が発生した場合は -90XX の形式で返され、Play Callback の処理中に例外が発生した場合は -10XXX 形式のコードにマッピングされて対応されます。
エラーコードコールバック対応表
| DRM Download Callback | Play Callback | Curl エラー種別 | 説明 |
|---|---|---|---|
| -9001 | -10001 | CURLE_UNSUPPORTED_PROTOCOL (1) | サポートされていないプロトコル（コールバック URL 形式エラー） |
| -9006 | -10006 | CURLE_COULDNT_RESOLVE_HOST (6) | DNS 解決失敗（ドメインを IP アドレスに変換不可） |
| -9007 | -10007 | CURLE_COULDNT_CONNECT (7) | サーバー到達後に接続拒否、または特定ポートがブロックされている |
| -9028 | -10028 | CURLE_OPERATION_TIMEDOUT (28) | コールバック対象サーバーの応答タイムアウト（Timeout） |
| -9056 | -10056 | CURLE_RECV_ERROR (56) | データ受信中にネットワーク接続が強制終了された |
-9001 / -10001
- エラーコード: -9001, -10001
- 概要: libcurl がサポートし ていないプロトコルの使用
原因
| 原因 | 説明 | 例 |
|---|---|---|
| プロトコルの欠落 | https:// などが省略されている場合です。 | example.com/callback |
| 無効なプロトコル | メディア通信でサポートされていない外部プロトコル形式が指定されている場合です。 | ftp://example.com/callback, file:///... |
| URL 形式エラー | 特殊記号の入力ミスにより、正常なアドレスの解析ができない場合です。 | http:/example.com（スラッシュ欠落）、https//...（コロン欠落） |
| 空白・特殊文字の混入 | Kollus コンソールの設定画面でアドレスを入力する際に、微細な空白が含まれている場合です。 | - |
診断
Kollus VOD コンソールシステムに登録されているコールバック URL をそのままコピーし、正しい形式かどうかを確認してください。
呼び出しアドレスが https:// または http:// から始まっているかを確認してください。
curl -v "YOUR_CALLBACK_URL"
-9006 / -10006
- エラーコード: -9006, -10006
- 概要: コールバックサーバードメインの DNS 解決失敗
原因
- 一時的なネットワーク不安定: Wi-Fi ネットワークの切り替え直後、またはモバイルデータ通信の電波環境が一時的に弱くなっている場合です。
- DNS サーバーエラー: ISP または社内イントラネットの DNS サーバー機器に一時的な障害が発生した場合です。
- 社内ネットワーク内部ファイアウォールによるブロック: 企業・学校・公共機関の内部ネットワーク環境において、セキュリティポリシーにより外部の特定ドメインへの通信が任意にブロックされている場合です。
- コールバック URL ドメインの入力ミス: 存在しないドメインアドレスを誤って入力した場合です。
解決方法
方法 A: ネットワークへの再接続（基本対処）
- ご利用のデバイスの Wi-Fi 設定をオフにしてから再度オンにするか、モバイルデータ通信に切り替えて通信状態を更新してください。
- これにより、現在の環境に蓄積された古い DNS キャッシュデータがクリアされます。
方法 B: コールバック URL ドメインの有効性確認
以下のコマンドを実行して、現在設定されているコールバック対象サーバードメインの解決経路を追跡してください。
nslookup your-callback-domain.com
# or
dig your-callback-domain.com
- 結果の判別: コマンドの実行結果が無応答、または
NXDOMAINエラーが返された場合は、ドメインアドレスに入力ミスがあるか、DNS 登録処理に問題が発生している状態です。
方法 C: 社内ネットワークのセキュリティファイアウォール例外処理
Kollus サーバーがコールバック URL にリクエストを送信する構成のため、お客様のサーバー（コールバック受信サーバー）が Kollus サーバーの IP からのリクエストを許可する必要があります。
- 参考文書: ネットワークホワイトリスト設定
方法 D: 営業担当者へのお問い合わせ
上記の対処を順番に実施した後もエラーが継続して検出される場合は、 エラーが観測されているデバイスの OS 環境、ネットワーク回線の種類、サービスページのログに記録されたエラー発生頻度などの具体的なデータを収集のうえ、営業担当者(jp_sales@catenoid.net)までお問い合わせください。
-9007 / -10007
- エラーコード: -9007, -10007
- 概要: DNS 解決は成功したが対象サーバーへの接続失敗
診断
- お客様のコールバック受信サーバーが正常に稼働しているか確認してください。
- ネットワークファイアウォールの設定で、80（HTTP）または 443（HTTPS）ポートが開放されているか確認してください。
- Kollus サーバーの IP がお客様のコールバックサーバーのファイアウォールで許可されているか確認してください。
- 参考文書: ネットワークホワイトリスト設定
-9028 / -10028
- エラーコード: -9028, -10028
- 概要: コールバックサーバーの応答タイムアウト（Timeout）
診断および解決方法
- パフォーマンス基準: コールバックサーバーの応答完了時間は、最大 3 秒以内に収まるよう、構造的に演算の最適化を行う必要があります。
- ボトルネック箇所の追跡: Timeout が繰り返し発生する場合は、データベース（DB）クエリや外部 API 呼び出しなどによるボトルネックが発生していないか、ソースコードのロジックをデバッグしてください。