密钥
您的 API 密钥可在浏览器中使用,允许的域名对其进行保护。服务器没有域名可供检查,因此你在服务器上翻译的内容,使用 React SSR、Next.js 或 Angular 预渲染,会改用密钥。
密钥以 p- 开头。将您的文件保存在服务器上,切勿将其放入在浏览器中运行的代码中。
创建密钥
打开您的账户页面,点击 “您的密钥” 下的 “创建密钥”。密钥仅显示一次,因此请立即复制。之后,账户页面只显示其最后四个字符。
你一次只能有一把密钥。如果密钥泄露或丢失,请单击 “重新生成密钥”。旧钥匙立即停止工作。
在你的服务器上使用它
无论您的应用程序在何处呈现或构建,例如在托管服务提供商的设置或 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。密钥会忽略您允许的域名,可在任何服务器上使用。