api: 규격 정의

hwe/sammo/BaseAPI.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace sammo;
+
+abstract class BaseAPI
+{
+    const NO_SESSION = 0;
+    const REQ_LOGIN = 1;
+    const REQ_GAME_LOGIN = 2;
+    const REQ_READ_ONLY = 4;
+
+    protected array $args;
+    public function __construct(array $args)
+    {
+        $this->args = $args;
+    }
+    abstract public function getRequiredSessionMode(): int;
+    abstract function validateArgs(): ?string;
+
+    /** @return null|string|array */
+    abstract function launch(?Session $session, ?\DateTimeInterface $modifiedSince, ?string $reqEtag);
+
+    public function tryCache():?string{
+        return null;
+    }
+}