認証ガイド

本ドキュメントは RTZR STT OpenAPI の認証方式を説明します。

認証方式

OAuth2 の client_id/client_secret と、JWT ベースの認証を使用します。

• OAuth2 参考: https://oauth.net/2/
• JWT 参考: https://jwt.io/

注意

注意

トークンの有効期限は 6 時間です。定期的に /v1/authenticate で更新してください。

アプリ登録と Secret

RTZR STT OpenAPI を利用するには、アプリを登録し API 認証に必要な Secret を発行します。

1. サインアップ: https://developers.rtzr.ai/signup
2. コンソール: https://developers.rtzr.ai/console/
3. SECRET (client_id, client_secret) を発行

API 一覧

Method	URL	説明
POST	/v1/authenticate	認証トークン取得

1) 認証トークン取得

HTTP リクエスト

POST https://openapi.vito.ai/v1/authenticate

リクエストボディ

application/x-www-form-urlencoded

Field	Type	Required
client_id	string	required
client_secret	string	required

サンプル

cURL

curl.post.auth.sh

curl -X "POST" "https://openapi.vito.ai/v1/authenticate" \
  -H "accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "client_id=${RTZR_CLIENT_ID}&client_secret=${RTZR_CLIENT_SECRET}"

Python

python.post.auth.py

import requests

resp = requests.post(
    "https://openapi.vito.ai/v1/authenticate",
    data={"client_id": "{RTZR_CLIENT_ID}", "client_secret": "{RTZR_CLIENT_SECRET}"},
)
resp.raise_for_status()
print(resp.json())

Java

AuthSample.java

import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.Scanner;

public class AuthSample {
    public static void main(String[] args) throws IOException {
        // Prefer Java system properties; fallback to environment variables
        String clientId = System.getProperty("rtzr.clientId", System.getenv("RTZR_CLIENT_ID"));
        String clientSecret = System.getProperty("rtzr.clientSecret", System.getenv("RTZR_CLIENT_SECRET"));

        if (clientId == null || clientSecret == null || clientId.isEmpty() || clientSecret.isEmpty()) {
            System.err.println("Missing credentials. Provide -Drtzr.clientId and -Drtzr.clientSecret or set RTZR_CLIENT_ID and RTZR_CLIENT_SECRET.");
            System.exit(1);
        }

        URL url = new URL("https://openapi.vito.ai/v1/authenticate");
        HttpURLConnection httpConn = (HttpURLConnection) url.openConnection();
        httpConn.setRequestMethod("POST");
        httpConn.setRequestProperty("accept", "application/json");
        httpConn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
        httpConn.setDoOutput(true);

        String data = "client_id=" + clientId + "&client_secret=" + clientSecret;

        byte[] out = data.getBytes(StandardCharsets.UTF_8);

        try (OutputStream stream = httpConn.getOutputStream()) {
            stream.write(out);
        }

        int status = httpConn.getResponseCode();
        try (InputStream responseStream = status / 100 == 2 ? httpConn.getInputStream() : httpConn.getErrorStream();
            Scanner s = new Scanner(responseStream).useDelimiter("\\A")) {
            String response = s.hasNext() ? s.next() : "";
            if (status / 100 == 2) {
                System.out.println(response);
            } else {
                System.err.println("HTTP " + status + ": " + response);
                System.exit(2);
            }
        }
    }
}

レスポンス

成功時 200 と以下の JSON を返します。

{
  "access_token": "{YOUR_JWT_TOKEN}",
  "expire_at": 1690377931
}

エラー

HTTP Status	Code	Name	Notes
400	H0001	BadRequest	パラメータ不正
401	H0002	Unauthorized	認証失敗
500	E500	ServerError	サーバーエラー

失敗例:

{
  "code": "H0002",
  "msg": "invalid credential"
}