Autenticação

Utilizar a Meshy API requer autenticação. Este guia mostra-lhe como criar uma conta e chaves de API.

Chaves de API

Criar uma Conta Meshy

A Meshy API requer que tenha uma conta Meshy para criar e gerir chaves de API. Se for feito um pedido à API sem uma chave de API, a API responderá com um erro de credenciais inválidas.

Pode criar uma conta Meshy visitando o site oficial da Meshy e efetuando o registo.

Criar Chaves de API

Depois de criar uma conta Meshy, pode criar chaves de API na página de Chaves de API na Plataforma de Programadores.

Pode criar várias chaves de API para diferentes finalidades. Por exemplo, pode criar uma chave de API para a sua aplicação iOS e outra para a sua aplicação web. A utilização de cada chave de API é monitorizada separadamente, e pode revogá-las a qualquer momento.

Também pode definir um limite mensal de créditos em qualquer chave, limitando o quanto esta pode gastar independentemente da utilização geral da sua conta — útil para limitar uma chave que entrega a um contratado ou a um ambiente específico.

Para criar uma chave de API, clique no botão Create API Key na página da API e, em seguida, introduza um nome para a sua chave de API.

Depois de criar uma chave de API, ser-lhe-á mostrado o valor da chave de API. Pode copiar o valor da chave de API e armazená-lo num local seguro.

Não poderá voltar a ver este valor da chave de API.

Utilizar Chaves de API

Depois de criar uma chave de API, pode utilizá-la para autenticar os seus pedidos à Meshy API. Pode transmitir a sua chave de API à API no cabeçalho Authorization, sendo apresentado abaixo um exemplo de cabeçalho.

{
  "Authorization": "Bearer msy_sOmEbOgUsApIkEyFoReXaMpLe1234567890"
}

Segurança

Na Meshy, levamos a segurança muito a sério e trabalhamos arduamente para garantir que a Meshy API é segura. Esperamos que os seus dados e os dados dos seus utilizadores estejam seguros connosco. Aqui estão algumas diretrizes gerais para ajudar a manter os seus dados e pedidos seguros ao utilizar a Meshy API, mas certifique-se também de seguir as diretrizes praticadas na sua equipa ou local de trabalho.

Segurança da Camada de Transporte

Embora os seus dados sejam encriptados em repouso assim que são armazenados na Meshy, a Meshy API utiliza e impõe o protocolo TLS, para encriptar os dados em trânsito. Isto significa que todos os pedidos de e para a Meshy API são enviados através de HTTPS, e qualquer pedido feito através de HTTP receberá um código de estado 301 Moved Permanently. Embora não seja recomendado, em alguns casos, se tiver de comunicar através de HTTP, terá de indicar explicitamente ao seu cliente HTTP para seguir os redirecionamentos de HTTP para HTTPS. Aqui estão alguns exemplos:

# use `-L` to follow HTTP to HTTPS redirections
curl -L -X 'POST' \
  https://api.meshy.ai/openapi/v1/text-to-texture

Segurança da Chave de API

Uma vez geradas, as chaves de API deixam de estar visíveis no painel, pelo que deve transferi-las e guardá-las de forma segura, uma vez que qualquer pessoa que as obtenha pode utilizá-las para comunicar com a Meshy API em seu nome. Se acreditar que a sua chave de API foi comprometida, pode revogá-la a qualquer momento a partir do painel; uma vez revogada, deixará de ser válida.

Divulgação de Segurança

Se acreditar que descobriu um problema de segurança na Meshy API, por favor entre em contacto connosco. Agradecemos a sua divulgação responsável e faremos todos os esforços para reconhecer o seu contributo.