docs/templates/pages/sega/index.html

{% extends "base.html" %}
{% block title %}SEGA Games{% endblock %}
{% block body %}
<h1>SEGA Games</h1>
<p>This may get its own micro-site at some point if it grows large enough. For now it's mostly just a rambling of notes.
</p>
<p>In some ways SEGA's protocols are simpler than Konami's (none of that XML mess) but in other ways they're more
    complicated (hardcoded URLs, multiple services required, etc.)</p>

<h2>ALL.Net</h2>
<p>A simple service that exposes two URLs. The hostname must be <code>http://naominet.jp</code>.</p>

<p>Requests should be made with a number of standard HTTP headers, and must be either HTTP version 1.0 or 1.1</p>
<table>
    <tr>
        <td><code>Connection</code></td>
        <td><code>Close</code></td>
    </tr>
    <tr>
        <td><code>Pragma</code></td>
        <td><code>DFI</code></td>
    </tr>
    <tr>
        <td><code>User-Agent</code></td>
        <td><code>ALL.Net_PC_Win2/ver1.0</code></td>
    </tr>
    <tr>
        <td><code>Content-Type</code></td>
        <td><code>application/x-www-form-urlencoded</code></td>
    </tr>
    <tr>
        <td><code>Content-Length</code></td>
        <td><i>variable</i></td>
    </tr>
</table>
<p>Note that the <code>Pragma</code> header is optional, and the <code>Content-Type</code> header is a lie.</p>

<p>Requests and responses should be <code>POST</code>s, and their body should be base64 encoded, zlib compressed,
    <code>x-www-form-urlencoded</code> data. For example, <code>{key: "value", other: "another"}</code> should encode to
    <code>eJwdxcEJACAMA8Bt3CLD5BEQFIXSFtw+4OuWHpq7NG5OBXi+BmwzCRo=</code>.
</p>

<p>Responses are expected to contain <code>stat</code> indicating status:</p>
<table>
    <tr>
        <td><code>1</code></td>
        <td>Success</td>
    </tr>
    <tr>
        <td><code>0</code></td>
        <td>Failure</td>
    </tr>
    <tr>
        <td><code>-1</code></td>
        <td>Failure</td>
    </tr>
    <tr>
        <td><code>-2</code></td>
        <td>Failure</td>
    </tr>
    <tr>
        <td><code>-3</code></td>
        <td>Failure</td>
    </tr>
</table>
<p>This service provides two endpoints, documented below:</p>

<h3><code>/sys/servlet/PowerOn</code></h3>
<h4>Request:</h4>

"game_id=%s&ver=%s&serial=%s&ip=%s&firm_ver=%01d%02d%02d&boot_ver=%02X%02X&encode=%s&format_ver=%s&hops=%d\r\n"
"game_id=%s&ver=%s&serial=%s&ip=%s&firm_ver=%01d%02d%02d&boot_ver=%02X%02X&format_ver=%s&hops=%d\r\n"
"game_id=%s&ver=%s&serial=%s\r\n"
"game_id=%s&ver=%s&serial=%s&encode=%s\r\n"


"keychipid=%s&functype=%u&gameid=%s&gamever=%s&boardid=%s&tenpoip=%s&libalibver=%s&datamax=%s&billingtype=%d&protocolver=%s&operatingfix=%d"
(libalibver = 1.110, protocolver = 1.000)

SDBT: Chunithm
SBXL: Maimai

<table>
    <tr>
        <td><code>game_id</code></td>
        <td>4-character game ID</td>
    </tr>
    <tr>
        <td><code>ver</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>serial</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>ip</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>firm_ver</code></td>
        <td><code>%01d%02d%02d</code></td>
    </tr>
    <tr>
        <td><code>boot_ver</code></td>
        <td><code>%02X%02X</code></td>
    </tr>
    <tr>
        <td><code>format_ver</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>hops</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>encode</code></td>
        <td></td>
    </tr>
</table>
<h4>Response:</h4>
<table>
    <tr>
        <td><code>stat</code></td>
        <td>See above</td>
    </tr>
    <tr>
        <td><code>uri</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>host</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>region0</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>region_name0</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>region_name1</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>region_name2</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>region_name3</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>year</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>month</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>day</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>hour</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>minute</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>second</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>place_id</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>setting</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>country</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>timezone</code></td>
        <td></td>
    </tr>
    <tr>
        <td><code>res_class</code></td>
        <td></td>
    </tr>
</table>

<h3><code>/sys/servlet/DownloadOrder</code></h3>

{% endblock %}