Rujukan API · AuthBeta

Autentikasi

Buat kunci di Akun → Kunci API, lalu kirim sebagai bearer token. X-API-Key dan ?api_key= juga bisa dipakai untuk uji cepat.

curl -s https://authbeta.com/api/v1/status \
  -H "Authorization: Bearer ab_xxxxxxxxxxxxxxxxxxxx"

Alamat dasar: https://authbeta.com/api/v1 · Setiap respons berupa JSON dengan penanda ok.

Batas laju

Setiap kunci punya jatah per menit sendiri (bawaan 120). Respons membawa X-RateLimit-Limit, X-RateLimit-Remaining dan X-RateLimit-Reset; bila lewat batas akan mengembalikan 429 beserta header Retry-After.

Galat

Status	Arti
400	Ada kolom wajib yang kosong.
401	Kunci tidak ada, tidak sah, dinonaktifkan atau kedaluwarsa.
403	Kunci tidak punya cakupan yang diminta endpoint ini.
404	Endpoint tidak dikenal, atau entri brankas tidak ada.
422	Masukan terbaca, tetapi tidak bisa dipakai.
429	Melewati batas jumlah permintaan.
503	API dimatikan oleh administrator.

{"ok": false, "error": "The \"secret\" field must be a valid base32 string."}

Endpoint

POST /totp scope: totp

Buat kode dari kunci rahasia, tautan otpauth, atau teks bebas.

Parameter	Jenis	Wajib	Keterangan
secret \| uri \| input	string	ya	Kunci rahasia base32, tautan otpauth://, atau teks yang memuatnya.
digits	int	tidak	4-10, bawaan 6
period	int	tidak	Detik, bawaan 30
algorithm	string	tidak	SHA1 \| SHA256 \| SHA512 \| STEAM
counter	int	tidak	Ada = mode HOTP
timestamp	int	tidak	Waktu Unix untuk menghitung kode
include_secret	bool	tidak	Kembalikan juga kunci rahasianya, bawaan false

POST /totp/verify scope: totp

Periksa apakah sebuah kode cocok dengan kunci rahasia.

Parameter	Jenis	Wajib	Keterangan
secret	string	ya	Kunci rahasia base32
code	string	ya	Kode yang akan diperiksa
window	int	tidak	Selisih langkah yang diizinkan, 0-10, bawaan 1

POST /totp/secret scope: totp

Buat kunci rahasia acak baru beserta tautan otpauth-nya.

Parameter	Jenis	Wajib	Keterangan
bytes	int	tidak	10-64, bawaan 20 (160 bit)
label	string	tidak	Nama akun
issuer	string	tidak	Nama layanan

POST /totp/qr scope: totp

Gambar kode QR sebagai PNG atau SVG.

Parameter	Jenis	Wajib	Keterangan
text \| secret	string	ya	Teks bebas, atau kunci rahasia untuk menyusun tautan otpauth
format	string	tidak	png (bawaan) atau svg
scale	int	tidak	2-20, piksel per modul
ecc	string	tidak	L \| M \| Q \| H
raw	bool	tidak	Kembalikan gambarnya langsung, bukan JSON

POST /totp/decode scope: totp

Baca gambar QR dan kembalikan data 2FA di dalamnya.

Parameter	Jenis	Wajib	Keterangan
image	string	ya	Data gambar base64, dengan atau tanpa awalan data:

POST /totp/bulk scope: totp

Kode untuk satu daftar penuh sekaligus.

Parameter	Jenis	Wajib	Keterangan
text	string	ya	Satu entri per baris
delimiter	string	tidak	auto (bawaan), pipe, comma, tab, …
include_secret	bool	tidak	Kembalikan juga kunci rahasianya, bawaan false

POST /password scope: password

Buat satu atau beberapa kata sandi.

Parameter	Jenis	Wajib	Keterangan
mode	string	tidak	random \| memorable \| pin \| hex \| base64 \| uuid
length	int	tidak	4-256
quantity	int	tidak	1-50
lowercase, uppercase, digits, symbols	bool	tidak	Kumpulan karakter untuk mode random
exclude_ambiguous, no_repeat, no_sequential	bool	tidak	Aturan tambahan
words	int	tidak	2-12 untuk mode memorable

POST /password/strength scope: password

Beri nilai pada sebuah kata sandi.

Parameter	Jenis	Wajib	Keterangan
password	string	ya	Kata sandi yang akan dianalisis

GET /ip/{ip} scope: ip

Rincian sebuah alamat IP. Tanpa {ip}, alamat Anda sendiri yang dipakai.

GET /dns scope: ip

Catatan DNS untuk sebuah nama host.

Parameter	Jenis	Wajib	Keterangan
host	string	ya	Nama domain
type	string	tidak	Daftar dipisah koma, bawaan A,AAAA,MX,NS,TXT

GET /whois scope: ip

Data WHOIS untuk sebuah domain atau IP.

Parameter	Jenis	Wajib	Keterangan
query	string	ya	Domain atau IP

POST /ports scope: ip

Periksa apakah port TCP atau UDP menerima lalu lintas. TCP mengembalikan open/closed/filtered. UDP mengembalikan open, closed (ICMP tak terjangkau), likely_open (diam tetapi host melaporkan port tertutup) atau open|filtered, beserta kolom icmp yang menyatakan apakah host melaporkan port tertutup.

Parameter	Jenis	Wajib	Keterangan
host	string	ya	Nama host atau alamat IP
protocol	string	tidak	tcp (bawaan) atau udp
ports	array\|string	tidak	Daftar port, atau "53,123,161". Bila kosong, dipakai port umum untuk protokol yang dipilih.

GET /email-security scope: ip

SPF, DMARC, MX, MTA-STS dan TLS-RPT untuk sebuah domain.

Parameter	Jenis	Wajib	Keterangan
domain	string	ya	Nama domain

POST /text scope: text

Jalankan satu operasi teks.

Parameter	Jenis	Wajib	Keterangan
text	string	ya	Teks masukan
operation	string	ya	Lihat daftar operasi di bawah
…	mixed	tidak	Parameter khusus tiap operasi (delimiter, column, find, replace…)

GET /vault scope: vault

Daftar akun 2FA tersimpan beserta kode terkininya.

GET /vault/{id}/code scope: vault

Kode terkini untuk satu entri brankas. Entri HOTP akan menaikkan penghitung.

GET /status

Rincian tentang kunci yang sedang Anda pakai.

Contoh

curl -s https://authbeta.com/api/v1/totp \
  -H "Authorization: Bearer ab_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"secret":"JBSWY3DPEHPK3PXP","digits":6}'

{
  "ok": true,
  "result": {
    "issuer": "", "label": "", "digits": 6, "period": 30,
    "algorithm": "SHA1", "type": "totp",
    "code": "123456", "next_code": "654321",
    "expires_in": 17, "server_time": 1771200000
  }
}

Operasi teks

Nilai yang diterima kolom operation pada POST /text:

trim_lines remove_empty remove_duplicates sort_asc sort_desc sort_natural sort_length shuffle reverse_lines reverse_text number_lines unique_count extract_column replace_delimiter add_prefix_suffix wrap_lines find_replace regex_replace upper lower title sentence camel snake kebab toggle_case remove_spaces collapse_spaces remove_accents slugify base64_encode base64_decode url_encode url_decode html_encode html_decode hex_encode hex_decode json_escape json_pretty json_minify extract_emails extract_urls extract_ips extract_numbers extract_secrets hash_md5 hash_sha1 hash_sha256 hash_sha512 hash_crc32 join_lines split_length count_stats