Pengesahan

Menggunakan Meshy API memerlukan pengesahan. Panduan ini akan menunjukkan cara membuat akaun dan kunci API.

API Keys

Membuat Akaun Meshy

Meshy API memerlukan anda mempunyai akaun Meshy untuk membuat dan menguruskan kunci API. Jika permintaan dibuat kepada API tanpa kunci API, API akan memberikan respons ralat kelayakan tidak sah.

Anda boleh membuat akaun Meshy dengan melawati laman web rasmi Meshy dan mendaftar.

Membuat Kunci API

Setelah anda membuat akaun Meshy, anda boleh membuat kunci API di halaman API Keys dalam Developer Platform.

Anda boleh membuat pelbagai kunci API untuk tujuan yang berbeza. Contohnya, anda boleh membuat satu kunci API untuk aplikasi iOS anda dan satu lagi untuk aplikasi web anda. Penggunaan setiap kunci API dijejaki secara berasingan, dan anda boleh membatalkannya pada bila-bila masa.

Anda juga boleh menetapkan had kredit bulanan pada mana-mana kunci, mengehadkan jumlah yang boleh dibelanjakannya tanpa mengira penggunaan keseluruhan akaun anda — berguna untuk mengehadkan kunci yang anda serahkan kepada kontraktor atau persekitaran tertentu.

Untuk membuat kunci API, klik butang Create API Key pada halaman API, kemudian masukkan nama untuk kunci API anda.

Setelah anda membuat kunci API, nilai kunci API akan dipaparkan kepada anda. Anda boleh menyalin nilai kunci API tersebut dan menyimpannya di lokasi yang selamat.

Anda tidak akan dapat melihat nilai kunci API ini lagi.

Menggunakan Kunci API

Setelah anda membuat kunci API, anda boleh menggunakannya untuk mengesahkan permintaan anda kepada Meshy API. Anda boleh menghantar kunci API anda kepada API dalam header Authorization, contoh header ditunjukkan di bawah.

{
  "Authorization": "Bearer msy_sOmEbOgUsApIkEyFoReXaMpLe1234567890"
}

Security

Kami mengambil keselamatan dengan sangat serius di Meshy, dan kami berusaha keras untuk memastikan Meshy API selamat. Kami berharap data anda dan data pengguna anda selamat bersama kami. Berikut adalah beberapa garis panduan peringkat tinggi untuk membantu anda memastikan data dan permintaan anda selamat semasa menggunakan Meshy API, tetapi sila pastikan juga anda mengikuti garis panduan yang diamalkan di pasukan atau tempat kerja anda.

Transport Layer Security

Walaupun data anda disulitkan semasa rehat (at rest) sebaik sahaja disimpan di Meshy, Meshy API menggunakan dan menguatkuasakan TLS, untuk menyulitkan data semasa transit. Ini bermakna semua permintaan ke dan dari Meshy API dihantar melalui HTTPS, dan sebarang permintaan yang dibuat melalui HTTP akan mendapat kod status 301 Moved Permanently. Walaupun tidak disyorkan, dalam sesetengah kes, jika anda perlu berkomunikasi melalui HTTP, anda perlu memberitahu secara eksplisit kepada klien HTTP anda untuk mengikuti pengalihan HTTP ke HTTPS. Berikut adalah beberapa contoh:

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

Pengalihan hanya berfungsi untuk permintaan GET: klien HTTP akan menghantar semula POST yang dialihkan sebagai GET tanpa kandungan badannya, jadi sentiasa panggil https:// secara terus apabila membuat tugas.

API Key Safety

Setelah dijana, kunci API tidak lagi boleh dilihat dalam papan pemuka, jadi sila muat turun dan simpan dengan selamat dan terjamin kerana sesiapa sahaja yang memperolehnya boleh menggunakannya untuk berkomunikasi dengan Meshy API bagi pihak anda. Jika anda percaya kunci API anda telah terjejas, anda boleh membatalkannya pada bila-bila masa dari papan pemuka, setelah dibatalkan, ia tidak akan sah lagi.

Security Disclosure

Jika anda percaya anda telah menemui isu keselamatan dalam Meshy API, sila hubungi kami. Kami menghargai pendedahan bertanggungjawab anda dan akan berusaha sedaya upaya untuk mengiktiraf sumbangan anda.