Semua yang dilakukan formulir di situs ini, untuk skrip. Setiap balasan berupa JSON, termasuk kesalahan, jadi Anda tidak pernah harus menebak apakah isinya hasil atau penjelasan.

Membuat permintaan

POST ke endpoint dengan parameter formulir atau isi JSON. Keduanya setara; pilih yang paling mudah untuk perkakas Anda. Parameter action memilih apa yang dilakukan. Gunakan --data-urlencode untuk apa pun yang diketik orang — teks paste, URL, terjemahan — karena -d mengirim nilai mentah dan akan terpotong di & pertama. -d biasa cukup untuk nilai tetap seperti action itu sendiri. wget sama sekali tidak punya --data-urlencode, jadi dengan wget Anda harus mengodekan nilai seperti itu dengan persen sendiri atau mengirim isi JSON, yang tidak perlu pengodean.

curl -X POST https://0wx.cat/api.cgi \
     -d action=paste --data-urlencode 'content=hello & world'

curl -X POST https://0wx.cat/api.cgi \
     -H 'Content-Type: application/json' \
     -d '{"action":"paste","content":"hello & world"}'

wget -qO- --header='Content-Type: application/json' \
     --post-data '{"action":"paste","content":"hello & world"}' https://0wx.cat/api.cgi

Nilai yang berisi &

Dalam isi formulir, & memisahkan parameter, dan curl -d tidak mengodekan apa yang Anda berikan. URL dengan query string karenanya terpotong di & pertamanya, dan sisanya tiba sebagai parameter terpisah. Gunakan --data-urlencode, atau kirim JSON. Parameter nyasar ditolak, bukan diabaikan, jadi ini gagal dengan jelas alih-alih menyimpan setengah link.

# wrong -- the value is cut at the &
curl -X POST https://0wx.cat/api.cgi \
     -d action=tinyurl -d 'url=https://example.com/?a=1&b=2'

# right
curl -X POST https://0wx.cat/api.cgi \
     -d action=tinyurl --data-urlencode 'url=https://example.com/?a=1&b=2'

# also right -- JSON needs no escaping
curl -X POST https://0wx.cat/api.cgi -H 'Content-Type: application/json' \
     -d '{"action":"tinyurl","url":"https://example.com/?a=1&b=2"}'

# wget has no --data-urlencode, so percent-encode it yourself...
wget -qO- --post-data 'action=tinyurl&url=https%3A%2F%2Fexample.com%2F%3Fa%3D1%26b%3D2' https://0wx.cat/api.cgi

# ...or send JSON, which needs no encoding at all
wget -qO- --header='Content-Type: application/json' \
     --post-data '{"action":"tinyurl","url":"https://example.com/?a=1&b=2"}' https://0wx.cat/api.cgi

Autentikasi

Opsional. Tanpa kunci, permintaan bersifat anonim dan berperilaku persis seperti pengunjung anonim — hasilnya publik bagaimanapun juga, satu-satunya perbedaan adalah apakah ia masuk ke daftar file Anda. Buat kunci di halaman akun Anda dan kirimkan sebagai token bearer; memberikannya sebagai parameter apikey juga bisa, tetapi kunci di query string berakhir di log server dan riwayat browser.

curl -X POST https://0wx.cat/api.cgi \
     -H 'Authorization: Bearer YOUR_KEY' \
     -d action=whoami

wget -qO- --header='Authorization: Bearer YOUR_KEY' \
     --post-data 'action=whoami' https://0wx.cat/api.cgi

Aksi

* Aksi-aksi ini memerlukan kunci API. Mereka membaca atau mengubah data milik satu akun, jadi tidak ada bentuk anonimnya.

Beberapa sekaligus

share dan g menerima field berulang, array JSON, atau daftar yang dipisah koma — mana pun yang paling mudah untuk perkakas Anda. Duplikat diabaikan.

curl -X POST https://0wx.cat/api.cgi -H 'Authorization: Bearer YOUR_KEY' \
     -d action=move -d share=Ab3xK9pQ -d share=Zz7yT2mN --data-urlencode 'gallery=Holiday 2026'

curl -X POST https://0wx.cat/api.cgi -H 'Authorization: Bearer YOUR_KEY' \
     -d action=delete -d 'share=Ab3xK9pQ,Zz7yT2mN'

curl -X POST https://0wx.cat/api.cgi -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer YOUR_KEY' \
     -d '{"action":"move","share":["Ab3xK9pQ","Zz7yT2mN"],"g":7}'

wget -qO- --header='Authorization: Bearer YOUR_KEY' \
     --post-data 'action=delete&share=Ab3xK9pQ,Zz7yT2mN' https://0wx.cat/api.cgi

Galeri

Di mana pun galeri disebut — pada upload atau pada move — ia diberikan dengan dua cara yang sama: g untuk id yang sudah ada, atau gallery untuk nama, yang dibuat jika baru. Jika keduanya dikirim, g menang. Balasan membawa id galeri. Perhatikan bahwa menghapus galeri hanya menghapus galerinya, dan membiarkan file-nya di daftar utama — berbeda dengan formulir web, yang menghapusnya setelah bertanya. Berikan withfiles=true untuk menghapus file-nya juga: skrip yang merapikan pengelompokannya tidak semestinya kehilangan unggahan secara tak sengaja.

curl -X POST https://0wx.cat/api.cgi -H 'Authorization: Bearer YOUR_KEY' \
     -F action=upload -F file=@photo.jpg --form-string 'gallery=Holiday 2026'

curl -X POST https://0wx.cat/api.cgi -H 'Authorization: Bearer YOUR_KEY' \
     -d action=gallery -d g=7 -d publish=true

wget -qO- --header='Authorization: Bearer YOUR_KEY' \
     --post-data 'action=gallery&g=7&publish=true' https://0wx.cat/api.cgi

Mengunggah file

Unggahan tidak bisa memakai isi JSON, karena file harus dikirim sebagai multipart. Ulangi bagian file untuk mengirim beberapa sekaligus. Setiap file dilaporkan terpisah: balasan membawa daftar files yang diterima dan daftar rejected yang ditolak, jadi keberhasilan sebagian tetap keberhasilan.

curl -X POST https://0wx.cat/api.cgi \
     -H 'Authorization: Bearer YOUR_KEY' \
     -F action=upload \
     -F file=@photo.jpg \
     -F file=@notes.txt \
     -F lifetime=7d

Tidak ada bentuk wget untuk yang ini. wget tidak bisa membangun isi multipart/form-data — ia tidak punya padanan -F milik curl — dan unggahan harus multipart. Gunakan curl, atau rakit sendiri isi dan boundary-nya lalu kirim dengan --post-file.

Masa hidup

Opsional pada setiap aksi yang menyimpan sesuatu. Menerima detik polos, atau angka yang diikuti m, h, atau d — bentuk yang sama dengan formulir web. Hilangkan atau berikan 0 untuk menyimpan item tanpa batas waktu.

Balasan

Setiap balasan adalah objek JSON dengan field ok. Saat berhasil ia membawa hasil; saat gagal ia membawa kode error yang stabil dan message yang terbaca manusia. Bercabanglah berdasarkan kode, catat pesannya.

{"ok":true,"type":"paste","share":"Ab3xK9pQ",
 "url":"https://0wx.cat/p/Ab3xK9pQ","bytes":11}

{"ok":false,"error":"url_too_long",
 "message":"URL exceeds the maximum length."}

Tag audio

Jika file membawanya, listfiles menambahkan file_tags ke entrinya: artis, judul, dan album, dibaca dari ID3, komentar Vorbis, atau atom MP4 saat file diunggah. Kuncinya tidak ada, bukan null, jika tidak ada yang dilaporkan, yang berlaku pada kebanyakan file, jadi uji keberadaannya sebelum membacanya. Field tunggal juga bisa hilang — sebuah file bisa punya judul tanpa album. Tidak ada lagi dari metadata file yang diungkap: pembelian iTunes merekam nama dan Apple ID pembeli, dan itu sengaja tidak pernah dibaca.

{"ok":true,"type":"files","total":2,"page":1,"pages":1,"files":[
  {"share":"Ab3xK9pQ","name":"autobahn.mp3","mime":"audio/mpeg",
   "bytes":8123456,"url":"https://0wx.cat/i/Ab3xK9pQ",
   "file_tags":{"artist":"Kraftwerk","title":"Autobahn","album":"Autobahn"}},
  {"share":"Zz7yT2mN","name":"photo.jpg","mime":"image/jpeg",
   "bytes":204800,"url":"https://0wx.cat/i/Zz7yT2mN"}
]}

Kode kesalahan

Batas

Panggil whoami untuk membaca nilai yang berlaku alih-alih menuliskannya secara tetap — nilai itu diatur oleh operator server dan bisa berubah. Ukuran dalam byte UTF-8.

Klien shell

0wx.sh membungkus semua yang di atas. Ini shell POSIX murni dan tidak butuh apa pun selain curl, dan cukup pendek untuk dibaca sebelum Anda menjalankannya — yang memang seharusnya dilakukan pada skrip yang akan memegang kunci API Anda. Taruh kunci di OWX_KEY alih-alih memberikan --key, dan kunci tetap di luar riwayat shell Anda.

wget https://0wx.cat/clients/0wx.sh
chmod +x 0wx.sh
export OWX_KEY=YOUR_KEY
./0wx.sh help
./0wx.sh paste --content 'hello & world'

Klien Python

0wx.py melakukan hal yang sama dengan klien shell, tetapi mengurai balasan dan mencetak arti field-nya alih-alih menyodorkan JSON mentah — tambahkan --json jika Anda ingin bentuk mentahnya. Hanya pustaka standar: tanpa requests, tidak ada yang perlu dipasang. Jika Anda menulis klien sendiri, fungsi send() dan report()-nya adalah bagian yang layak dibaca: keduanya menunjukkan cara membangun permintaan, cara mengambil pesan dari permintaan yang gagal, dan apa isi balasannya.

wget https://0wx.cat/clients/0wx.py
chmod +x 0wx.py
export OWX_KEY=YOUR_KEY
./0wx.py listfiles
./0wx.py listfiles --json | jq '.files[].url'

Klien Perl

0wx.pl melakukan hal yang sama dengan yang Python dan mencetak keluaran yang sama. Hanya modul inti — HTTP::Tiny dan JSON::PP sudah disertakan bersama Perl sejak 5.14, jadi tidak ada yang perlu dipasang. Layak dibaca berdampingan dengan klien Python jika Anda menulis klien sendiri: kedua bahasa gagal dengan cara berbeda pada permintaan yang rusak, dan kedua skrip menunjukkan di mana.

wget https://0wx.cat/clients/0wx.pl
chmod +x 0wx.pl
export OWX_KEY=YOUR_KEY
./0wx.pl listfiles

Klien PowerShell

0wx.ps1 adalah padanan klien Python untuk Windows: perintah yang sama, keluaran yang sama, dan mengurai balasan alih-alih menyodorkan JSON mentah — tambahkan --json untuk itu. Ditulis untuk Windows PowerShell yang sudah ada di mesin, jadi tidak ada yang perlu dipasang, dan berjalan tanpa perubahan di PowerShell 7. Anda mungkin perlu Set-ExecutionPolicy -Scope Process Bypass di jendela tempat Anda menjalankannya, yaitu Windows bertanya apakah Anda memang ingin menjalankan skrip yang Anda unduh — pertanyaan yang wajar, dan filenya cukup pendek untuk dibaca lebih dulu.

$env:OWX_KEY = 'YOUR_KEY'
.\0wx.ps1 listfiles
.\0wx.ps1 paste --content 'hello & world'
.\0wx.ps1 upload --file .\holiday.jpg --gallery 'Holiday 2026'

Jendela di browser Anda

0wx.html adalah kumpulan tab yang sama dengan klien desktop, sebagai tiga file — halaman, stylesheet, dan skrip — tanpa pemasangan, tanpa framework, dan tanpa memuat apa pun dari mana pun selain situs ini. Tiga bukan satu karena Content-Security-Policy situs melarang skrip dan style inline, yang layak dipertahankan. File bisa dijatuhkan ke sana. Harus dibuka dari sini, bukan disimpan lalu dibuka dari disk Anda: API tidak mengirim header cross-origin, jadi salinan lokal akan membuat setiap permintaan ditolak browser Anda sebelum sempat keluar. Kunci dipegang di memori kecuali Anda mencentang kotak untuk mengingatnya.

https://0wx.cat/clients/0wx.html

Jendela di Windows

0wx-gui.ps1 adalah kumpulan tab yang sama dengan klien desktop, digambar dengan WinForms — yang berarti tidak ada apa pun yang perlu dipasang, karena itu sudah bagian dari Windows. Taruh di folder yang sama dengan 0wx.ps1: jendela meminjam penanganan permintaan dari file itu alih-alih membawa salinan kedua, jadi keduanya diperlukan. Windows akan bertanya sebelum menjalankan skrip yang bukan buatannya, yang wajar; kedua file cukup pendek untuk dibaca sebelum Anda menjawab.

powershell -ExecutionPolicy Bypass -File .\0wx-gui.ps1

Jendela di Linux dengan GTK

0wx-gtk.pl adalah jendela GTK kecil dengan tab untuk mengunggah, menempel, memendekkan, dan menjelajahi file Anda — sebagai daftar atau galeri thumbnail, disaring per galeri. Ini satu-satunya klien di sini yang butuh sesuatu dipasang — binding GTK3 milik Perl — yang layak diketahui di samping jendela Windows di atas, karena yang itu tidak butuh apa pun. Semua lainnya yang dipakainya disertakan bersama Perl. Kunci hanya dipegang di memori: menutup jendela melupakannya, dan mengatur OWX_KEY mengisinya saat mulai. Apa pun yang ditampilkannya, balasan mentah server hanya satu klik jauhnya di bawah “Server reply”.

apt install libgtk3-perl        # or: dnf install perl-Gtk3
wget https://0wx.cat/clients/0wx-gtk.pl
chmod +x 0wx-gtk.pl
OWX_KEY=YOUR_KEY ./0wx-gtk.pl

Aplikasi Android

0wx-android.apk melakukan yang dilakukan klien lain, dari ponsel: mengunggah, menempel, memendekkan, menerjemahkan, dan menjelajahi file Anda sebagai daftar atau galeri. Membagikan file kepadanya dari aplikasi lain mana pun akan mengunggahnya, dan membagikan teks menyimpannya sebagai teks. Ia tidak ada di toko aplikasi mana pun, jadi perangkat Anda akan meminta izin memasangnya — pertanyaan yang secara umum layak dianggap serius, dan alasan seluruh sumbernya juga ada di sini: buka di Android Studio dan bangun sendiri alih-alih memercayai filenya. Membangunnya butuh JDK 21; BUILDING.md di dalamnya menjelaskan alasannya.

https://0wx.cat/clients/0wx-android.apk        # install it
https://0wx.cat/clients/0wx-android.zip        # build it yourself

Catatan

Sengaja tidak ada aksi ambil-jarak-jauh. Aksi itu akan membuat server mengambil URL pilihan pemanggil, yang merupakan celah pemalsuan permintaan, dan skrip bisa memacunya jauh lebih keras daripada formulir. Unggah saja filenya sendiri.