47 lines
2.3 KiB
Markdown
47 lines
2.3 KiB
Markdown
|
# Protocol Format
|
||
|
|
|
||
|
|
All data-types bigger than 1 byte are stored in network endian (big-endian) unless stated otherwise.
|
||
|
|
|
||
|
|
## Request Base
|
||
|
|
| Name | Size (bytes) | Description |
|
||
|
|
|-----------|--------------|--------------------------------------|
|
||
|
|
|opcode | 1 | The operation code to perform, A list of operations currently supported (and their data) can be found in the **Operations** chapter |
|
||
|
|
|request_id | 4 | The ID for the current request, Used to distinguish responses in the current connection |
|
||
|
|
|
||
|
|
The data afterwards depends on the supplied opcode, Please consult the **Operations** chapter for more information.
|
||
|
|
|
||
|
|
## Response Base
|
||
|
|
| Name | Size (bytes) | Description |
|
||
|
|
|------------|--------------|---------------------------------------|
|
||
|
|
|request_id | 4 | The ID for the request that this response is meant for |
|
||
|
|
|
||
|
|
The data afterwards depends on the supplied opcode, Please consult the **Operations** chapter for more information.
|
||
|
|
|
||
|
|
## Operations
|
||
|
|
### `FORCE_UPDATE` (0x00)
|
||
|
|
Forces the server to re-fetch the YouTube player, and extract the necessary components from it (`nsig` function code, `sig` function code, signature timestamp).
|
||
|
|
|
||
|
|
#### Request
|
||
|
|
*No additional data required*
|
||
|
|
|
||
|
|
#### Response
|
||
|
|
| Name | Size (bytes) | Description |
|
||
|
|
|------|--------------|-------------|
|
||
|
|
|status| 4 | The status code of the request: `0xF44F` if successful, `0xFFFF` if no updating is required (YouTube's player ID is equal to the server's current player ID), `0x0000` if an error occurred |
|
||
|
|
|
||
|
|
### `DECRYPT_N_SIGNATURE` (0x01)
|
||
|
|
Decrypt a provided `n` signature using the server's current `nsig` function code, and return the result (or an error).
|
||
|
|
|
||
|
|
#### Request
|
||
|
|
| Name | Size (bytes) | Description |
|
||
|
|
|------|--------------|-------------------------------------|
|
||
|
|
|size | 2 | The size of the encrypted signature |
|
||
|
|
|string| *`size`* | The encrypted signature |
|
||
|
|
|
||
|
|
#### Response
|
||
|
|
| Name | Size (bytes) | Description |
|
||
|
|
|------|--------------|------------------------------------------------------------------|
|
||
|
|
|size | 2 | The size of the decrypted signature, `0x0000` if an error occurred |
|
||
|
|
|string| *`size`* | The decrypted signature |
|
||
|
|
|