ドキュメンテーション

シークレットキー

あなたのAPIキーは、許可されたドメインで保護されているブラウザで機能する。サーバーにはチェックするドメインがないので、React SSR、Next.js、Angular の事前レンダリングを使用してサーバー上で翻訳したコンテンツは、代わりに秘密鍵を使用する。

秘密鍵は p- で始まる。あなたのものはサーバーに置いておき、ブラウザで実行されるコードには絶対に入れないでください。

秘密鍵を作る

アカウントページを開いて、「シークレットキー」の下の「シークレットキーを作成する」をクリックする。キーは一度しか表示されないので、すぐにコピーして。その後、アカウントページには最後の4文字しか表示されない。

あなたは一度に1つの秘密鍵を持っている。漏れたり紛失したりした場合は、「秘密鍵を再生する」をクリックする。古いキーはすぐに機能しなくなる。

サーバーで使う

ホスティングプロバイダーの設定やCIシークレットなど、アプリがレンダリングまたはビルドされるときはいつでも MAGIC_TRANSLATE_SECRET_KEY 環境変数としてキーを設定して。

MAGIC_TRANSLATE_SECRET_KEY=p-...

サーバーでは、Magic Translate クライアントがAPIキーの代わりにこのキーを送信する。コードを変更する必要はない。明示的に渡すこともできる:

import { setupT } from '@magic-translate/react-ssr';
export const translate = setupT({
secretKey: process.env.MAGIC_TRANSLATE_SECRET_KEY
});

ブラウザでは、apiKey として渡されたものであっても、クライアントは秘密鍵を送信しない。代わりにエラーを記録する。

秘密鍵には @magic-translate/react-ssr 1.3.0または @magic-translate/angular 1.2.0以降が必要だ。

必要なときに

あなたの API キー秘密鍵なしのサーバーリクエスト
許可されたドメインはない仕事を続けて
ドメインを許可しているエラー SECRET_KEY_REQUIRED を返す

ブラウザから秘密鍵を送信するリクエストは、エラー SECRET_KEY_IN_BROWSER を返す。秘密鍵は許可されたドメインを無視し、どのサーバーからでも機能する。