Authenticatie

Het gebruik van de Meshy API vereist authenticatie. Deze gids laat zien hoe je een account en API-sleutels aanmaakt.

API Keys

Een Meshy-account aanmaken

Voor de Meshy API heb je een Meshy-account nodig om API-sleutels aan te maken en te beheren. Als een verzoek naar de API wordt gestuurd zonder API-sleutel, reageert de API met een foutmelding over ongeldige inloggegevens.

Je kunt een Meshy-account aanmaken door de officiële Meshy-website te bezoeken en je aan te melden.

API-sleutels aanmaken

Zodra je een Meshy-account hebt aangemaakt, kun je API-sleutels aanmaken op de pagina API Keys in het Developer Platform.

Je kunt meerdere API-sleutels aanmaken voor verschillende doeleinden. Je kunt bijvoorbeeld één API-sleutel aanmaken voor je iOS-app en een andere voor je web-app. Het gebruik van elke API-sleutel wordt apart bijgehouden, en je kunt ze op elk moment intrekken.

Je kunt ook een maandelijkse creditlimiet instellen op elke sleutel, waarmee je begrenst hoeveel die kan verbruiken, ongeacht het totale gebruik van je account — handig om een sleutel te beperken die je aan een contractor of een specifieke omgeving geeft.

Om een API-sleutel aan te maken, klik je op de knop Create API Key op de API-pagina en voer je vervolgens een naam voor je API-sleutel in.

Zodra je een API-sleutel hebt aangemaakt, krijg je de waarde van de API-sleutel te zien. Je kunt de waarde van de API-sleutel kopiëren en op een veilige locatie bewaren.

Je kunt deze API-sleutelwaarde niet nogmaals bekijken.

API-sleutels gebruiken

Zodra je een API-sleutel hebt aangemaakt, kun je deze gebruiken om je verzoeken aan de Meshy API te authenticeren. Je kunt je API-sleutel aan de API doorgeven in de header Authorization, hieronder zie je een voorbeeldheader.

{
  "Authorization": "Bearer msy_sOmEbOgUsApIkEyFoReXaMpLe1234567890"
}

Security

Bij Meshy nemen we beveiliging zeer serieus en we werken hard om ervoor te zorgen dat de Meshy API veilig is. We hopen dat jouw gegevens en die van je gebruikers veilig bij ons zijn. Hier zijn enkele algemene richtlijnen om je gegevens en verzoeken veilig te houden bij het gebruik van de Meshy API, maar zorg er ook voor dat je de richtlijnen volgt die binnen jouw team of op je werkplek worden gehanteerd.

Beveiliging van de transportlaag

Hoewel je gegevens versleuteld zijn opgeslagen zodra ze bij Meshy zijn opgeslagen, gebruikt en handhaaft de Meshy API TLS om gegevens tijdens overdracht te versleutelen. Dit betekent dat alle verzoeken van en naar de Meshy API via HTTPS worden verstuurd, en elk verzoek dat via HTTP wordt gedaan krijgt een statuscode 301 Moved Permanently. Hoewel het niet wordt aanbevolen, moet je in sommige gevallen, als je toch via HTTP moet communiceren, je HTTP-client expliciet vertellen om HTTP-naar-HTTPS-omleidingen te volgen. Hier zijn enkele voorbeelden:

# use `-L` to follow HTTP to HTTPS redirections
curl -L https://api.meshy.ai/openapi/v1/balance \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Omleidingen werken alleen voor GET-verzoeken: HTTP-clients sturen een omgeleide POST opnieuw als een GET zonder de bijbehorende body, dus roep bij het aanmaken van taken altijd rechtstreeks https:// aan.

Veiligheid van API-sleutels

Eenmaal aangemaakt, zijn API-sleutels niet meer zichtbaar in het dashboard, dus download en bewaar deze veilig en beveiligd, aangezien iedereen die hem in handen krijgt hiermee namens jou met de Meshy API kan communiceren. Als je vermoedt dat je API-sleutel is gecompromitteerd, kun je deze op elk moment vanuit het dashboard intrekken, zodra hij is ingetrokken, is hij niet langer geldig.

Beveiligingsmelding

Als je denkt een beveiligingsprobleem in de Meshy API te hebben ontdekt, neem dan contact met ons op. We waarderen je verantwoorde openbaarmaking en zullen ons uiterste best doen om je bijdrage te erkennen.