Public API

API pengelolaan server-ke-server untuk akun Submeto Anda.

Tersedia untuk setiap pengguna Submeto yang aktif, termasuk pengguna Free. Akses Public API dinonaktifkan secara default dan harus diaktifkan di Dashboard setelah meninjau risikonya.

Dibuat untuk server, bukan browser

Public API ditujukan untuk otomatisasi yang berjalan di infrastruktur yang Anda kendalikan — cron job, backend, dan pipeline CI. API ini mengelola Form dan field serta membaca dan memproses kiriman. API ini terpisah dari Form Submission API, yang menerima data formulir dari pengunjung situs Anda; jika itu yang Anda perlukan, mulai dari dokumentasi Form Submission API.

Yang dapat Anda lakukan

Setiap operasi diotorisasi oleh scope pada API Key Anda dan Form yang diberikan kepada key tersebut.

• Kelola Form — daftar, buat, perbarui, dan hapus Form, semuanya diatur oleh scope forms:read, forms:create, forms:update, dan forms:delete.
• Tentukan field — baca dan perbarui konfigurasi field Form dengan scope forms:read dan forms:update.
• Baca kiriman — tampilkan daftar kiriman per Form dan tandai sebagai telah dibaca dengan scope submissions:read dan submissions:mark_read.
• Akses file — dapatkan akses unduhan terotorisasi dan berumur pendek untuk file yang terlampir pada kiriman.
• Operasikan workflow — tinjau dan edit draf, validasi dan terbitkan versi, jalankan uji kering, tinjau proses, dan coba ulang kegagalan yang memenuhi syarat.

Batas keamanan

• API Key mengautentikasi server Anda, bukan browser atau aplikasi mobile. Gunakan hanya runtime server-ke-server melalui HTTPS.
• Key membawa scope yang dipilih dan hanya dapat diberikan ke Form tertentu. Resource yang tidak diberikan tidak terlihat oleh Key.
• Respons tidak menyertakan secret, token Form, konfigurasi integrasi, atau payload kiriman mentah.
• Operasi destruktif memerlukan konfirmasi tingkat aplikasi selain scope yang diberikan.