Kunci API YoozMarket: Pesan dari Panel atau Skrip Sendiri

Diperbarui:

Jika Anda punya panel, bot, atau skrip sendiri, pesanan YoozMarket bisa dibuat lewat kode, bukan dari dasbor. Panduan ini menjelaskan cara kerja kunci, aksi yang tersedia, dan apa yang terjadi pada dompet Anda.

Buat kunci dan simpan dengan aman

Buka API di dasbor lalu buat kunci. Beri nama agar Anda ingat di mana kunci dipakai; Anda bisa punya hingga 5 kunci aktif, jadi pakai kunci terpisah untuk tiap aplikasi. Kunci hanya ditampilkan sekali dan disimpan hanya sebagai hash, jadi salin segera. Jika hilang, cabut lalu buat yang baru.

Apa yang bisa dipanggil

Kirim permintaan JSON (atau form) ke https://yooz.market/api/v1 dengan kunci Anda dan sebuah aksi.

  • balance: saldo dompet Anda.
  • services: layanan yang bisa dipesan, dengan min/maks dan tarif per satuan.
  • add: buat pesanan dengan layanan, tautan, dan jumlah (serta reaksi bila diperlukan).
  • status: status pesanan berdasarkan id-nya.
  • getCountries: negara dengan nomor virtual tersedia dan harga satu nomor.
  • getNumber: beli nomor dengan country_code; mengembalikan nomor dan order_id.
  • getCode: kode login nomor yang Anda beli, atau waiting.

Tagihan, percobaan ulang, dan pengembalian dana

Pesanan lewat API ditagih dari dompet dengan harga yang sama seperti di dasbor, dan pesanan yang gagal dikembalikan otomatis. Tambahkan idempotency_key opsional pada add atau getNumber agar percobaan ulang tidak pernah membuat pesanan kedua. Kesalahan kembali dengan status "error" dan field message_error.

Mencabut kunci

Cabut kunci di halaman yang sama, dan semua yang memakainya langsung berhenti bekerja. Ini tidak bisa dibatalkan, itulah mengapa kunci terpisah per aplikasi bermanfaat.