# ライセンス API

現在利用しているライセンス情報の取得や、新しいライセンスの適用を行うための API です。


## GetLicense

*バージョン 18.01.0 で追加。*

**x-sora-target**: Sora_20171218.GetLicense

現在利用しているライセンス情報を取得します。

> **重要**
>
> `signature` は表示されません

```console
$ curl -sS \
    -X POST \
    http://127.0.0.1:3000/ \
    -H "x-sora-target: Sora_20171218.GetLicense" \
    | jq .
{
    "expired_at": "2023-03",
    "max_connections": 100,
    "product_name": "Sora",
    "serial_code": "123ABC-SRA-E001-202303-100",
    "type": "Experimental"
}
```


## UpdateLicense

*バージョン 18.01.0 で追加。*


**x-sora-target**: Sora_20171218.UpdateLicense

ライセンスを更新します。

`sora.conf` の `license_file` に設定したファイルを新規のライセンスとして読み込みます。
ライセンスが壊れていたり、見つからない場合はエラーになります。
いずれの場合も接続中のクライアントへの影響はありません。

> **重要**
>
> `signature` は表示されません

```console
$ curl -sS \
    -X POST \
    http://127.0.0.1:3000/ \
    -H "x-sora-target: Sora_20171218.UpdateLicense" \
    | jq .
{
    "new_license": {
        "expired_at": "2023-03",
        "max_connections": 100,
        "product_name": "Sora",
        "serial_code": "123ABC-SRA-E001-202303-100",
        "type": "Experimental"
    },
    "old_license": {
        "expired_at": "2024-03",
        "max_connections": 100,
        "product_name": "Sora",
        "serial_code": "123ABC-SRA-E002-202403-100",
        "type": "Experimental"
    }
}
```