-9XXX, -10XXX (Callback/Network Curl Errors)
This document is a machine-translated draft and is currently undergoing review. Some content may be inaccurate or differ from the original Korean version. For the most precise information, refer to the Korean documentation.
The -9xxx and -10xxx error codes are network communication errors defined based on the libcurl error code specification.
The last digits of each error code represent Curl's unique error number. If an exception occurs during the DRM download callback process, it is returned in the form -90XX; if an exception occurs during the playback callback process, it is mapped and returned as a code in the form -10XXX.
Error code callback mapping table
| DRM download callback | Playback callback | Curl error type | Description |
|---|---|---|---|
| -9001 | -10001 | CURLE_UNSUPPORTED_PROTOCOL (1) | Unsupported protocol (callback URL format error) |
| -9006 | -10006 | CURLE_COULDNT_RESOLVE_HOST (6) | DNS resolution failure (unable to resolve domain to IP address) |
| -9007 | -10007 | CURLE_COULDNT_CONNECT (7) | Connection refused or specific port blocked after successfully reaching the server |
| -9028 | -10028 | CURLE_OPERATION_TIMEDOUT (28) | Callback target server response timeout |
| -9056 | -10056 | CURLE_RECV_ERROR (56) | Network connection forcibly terminated while receiving data |
-9001 / -10001
- Error code: -9001, -10001
- Summary: Use of a protocol not supported by libcurl
Cause
| Cause | Description | Example |
|---|---|---|
| Missing protocol | https:// or similar prefix is omitted. | example.com/callback |
| Invalid protocol | An external protocol format not supported for media communication is specified. | ftp://example.com/callback, file:///... |
| URL format error | Normal address parsing is impossible due to a typo in a special character. | http:/example.com (missing slash), https//... (missing colon) |
| Whitespace/special characters included | A subtle whitespace was included when entering the address in the Kollus console settings. | - |
Diagnosis
Copy the callback URL registered in the Kollus VOD console system as-is, then verify that it is in the correct format.
Confirm that the call address starts with https:// or http://.
curl -v "YOUR_CALLBACK_URL"
-9006 / -10006
- Error code: -9006, -10006
- Summary: DNS resolution failure for the callback server domain
Cause
- Temporary network instability: Immediately after switching Wi-Fi networks, or when the cellular data signal is temporarily weak.
- DNS server error: A temporary failure has occurred in the ISP or internal intranet DNS server equipment.
- Internal network firewall blocking: In corporate, school, or public institution internal network environments, certain external domain communications are arbitrarily blocked by security policies.
- Callback URL domain typo: A non-existent domain address was entered incorrectly.
Resolution
Method a: reconnect to the network (basic action)
- Turn off and on the Wi-Fi settings on your device, or switch to a cellular data network to refresh the connection status.
- This clears outdated DNS cache data in the current environment.
Method b: validate the callback URL domain
Run the following command to trace the resolution path of the currently configured callback target server domain.
nslookup your-callback-domain.com
# or
dig your-callback-domain.com
- Interpreting results: If the command returns no response or an
NXDOMAINerror, there is either a typo in the domain address or an issue with the DNS registration process.
Method c: add a firewall exception for the internal network
Since Kollus servers send requests to the callback URL, the customer's server (callback receiving server) must allow requests coming from Kollus server IPs.
- See Also: Network whitelist settings
Method d: contact technical support
If the error continues to be detected after following the above steps in order, collect specific data such as the device OS environment where the error is observed, the type of network connection, and the frequency of errors recorded in the service page logs, then contact Technical Support(tech_support@catenoid.net).
-9007 / -10007
- Error code: -9007, -10007
- Summary: DNS resolution succeeded but connection to the target server failed
Diagnosis
- Verify that the customer's callback receiving server is running normally.
- Check that port 80 (HTTP) or 443 (HTTPS) is open in the network firewall settings.
- Confirm that the Kollus server IP is allowed in the customer's callback server firewall.
- See Also: Network whitelist settings
-9028 / -10028
- Error code: -9028, -10028
- Summary: Callback server response timeout
Diagnosis and resolution
- Performance standard: The callback server must be structurally optimized to complete its response within a maximum of 3 seconds.
- Bottleneck tracing: If timeouts recur, debug the source code logic to check whether a bottleneck is occurring due to database (DB) queries, external API calls, or similar issues.