Reference
Protocol Spec
Full Surf protocol specification and error codes
Protocol Spec#
The full Surf protocol specification is available on GitHub:
Error Codes
| Code | HTTP | Meaning |
|------|------|---------|
| UNKNOWN_COMMAND | 404 | Command not found in manifest |
| INVALID_PARAMS | 400 | Missing required param or wrong type |
| AUTH_REQUIRED | 401 | Command requires auth but none provided |
| AUTH_FAILED | 403 | Token is invalid or expired |
| SESSION_EXPIRED | 410 | Session ID no longer valid |
| RATE_LIMITED | 429 | Too many requests (check Retry-After) |
| INTERNAL_ERROR | 500 | Unexpected server error |
| NOT_SUPPORTED | 501 | Feature not available |