Semua yang dilakukan borang di laman ini, untuk skrip. Setiap balasan ialah JSON, termasuk ralat, jadi anda tidak perlu meneka sama ada badan itu hasil atau penjelasan.

Membuat permintaan

POST ke titik akhir dengan parameter borang atau badan JSON. Kedua-duanya setara; pilih yang paling mudah dengan alatan anda. Parameter action memilih apa yang hendak dilakukan. Gunakan --data-urlencode untuk apa sahaja yang ditaip orang — teks tampal, URL, terjemahan — kerana -d menghantar nilai mentah dan ia akan dipotong pada & pertama. -d biasa memadai untuk nilai tetap seperti action itu sendiri. wget langsung tiada --data-urlencode, jadi dengan wget sama ada anda mengekod peratus nilai sedemikian sendiri atau menghantar badan JSON, yang tidak memerlukan pengekodan.

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 mengandungi &

Dalam badan borang, & memisahkan parameter, dan curl -d tidak mengekod apa yang anda beri. URL dengan rentetan pertanyaan oleh itu dipotong pada & pertamanya, dan selebihnya tiba sebagai parameter berasingan. Gunakan --data-urlencode, atau hantar JSON. Parameter sesat ditolak dan bukannya diabaikan, jadi ini gagal dengan jelas dan bukannya menyimpan separuh pautan.

# 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

Pengesahan

Pilihan. Tanpa kunci, permintaan adalah tanpa nama dan berkelakuan sama seperti pelawat tanpa nama — hasilnya tetap umum, satu-satunya perbezaan ialah sama ada ia masuk ke senarai fail anda. Jana kunci di halaman akaun anda dan hantar sebagai token bearer; menghantarnya sebagai parameter apikey juga berfungsi, tetapi kunci dalam rentetan pertanyaan berakhir dalam log pelayan dan sejarah pelayar.

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

Tindakan

* Tindakan ini memerlukan kunci API. Ia membaca atau mengubah data satu akaun sendiri, jadi tiada bentuk tanpa nama untuknya.

Beberapa sekali gus

share dan g menerima medan berulang, tatasusunan JSON, atau senarai dipisahkan koma — mana-mana yang paling mudah dengan alatan anda. Pendua 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 sahaja galeri dinamakan — pada upload atau pada move — ia diberi dengan dua cara yang sama: g untuk id sedia ada, atau gallery untuk nama, yang dicipta jika baharu. Jika kedua-duanya dihantar, g menang. Balasan membawa id galeri. Ambil perhatian bahawa memadam galeri hanya membuang galeri itu, meninggalkan failnya dalam senarai utama — tidak seperti borang web, yang memadamnya selepas bertanya. Beri withfiles=true untuk memadamnya juga: skrip yang mengemaskan pengelompokannya tidak sepatutnya kehilangan muat naik secara tidak 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

Memuat naik fail

Muat naik tidak boleh menggunakan badan JSON, kerana fail perlu dihantar sebagai multipart. Ulang bahagian file untuk menghantar beberapa sekali gus. Setiap fail dilaporkan berasingan: balasan membawa senarai files yang diterima dan senarai rejected yang ditolak, jadi kejayaan separa tetap kejayaan.

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

Tiada bentuk wget untuk yang ini. wget tidak boleh membina badan multipart/form-data — ia tiada padanan dengan -F curl — dan muat naik mesti multipart. Gunakan curl, atau himpunkan sendiri badan dan sempadan lalu hantar dengan --post-file.

Jangka hayat

Pilihan pada setiap tindakan yang menyimpan sesuatu. Menerima saat kosong, atau nombor diikuti m, h atau d — bentuk yang sama seperti borang web. Tinggalkan atau beri 0 untuk menyimpan item selama-lamanya.

Balasan

Setiap balasan ialah objek JSON dengan medan ok. Apabila berjaya ia membawa hasil; apabila gagal ia membawa kod error yang stabil dan message yang boleh dibaca manusia. Bercabang mengikut kod, log mesejnya.

{"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

Apabila fail membawanya, listfiles menambah file_tags pada entrinya: artis, tajuk dan album, dibaca daripada ID3, ulasan Vorbis atau atom MP4 semasa fail dimuat naik. Kunci itu tiada dan bukannya null apabila tiada apa untuk dilaporkan, iaitu kebanyakan fail, jadi uji kewujudannya sebelum membacanya. Medan individu juga mungkin hilang — fail mungkin ada tajuk tetapi tiada album. Tiada apa lagi daripada metadata fail yang didedahkan: pembelian iTunes merekodkan 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"}
]}

Kod ralat

Had

Panggil whoami untuk membaca nilai semasa dan bukannya mengekodkannya secara tetap — ia ditetapkan oleh pengendali pelayan dan boleh berubah. Saiz ialah bait UTF-8.

Klien shell

0wx.sh membalut semua di atas. Ia shell POSIX tulen dan tidak memerlukan apa-apa selain curl, dan cukup pendek untuk dibaca sebelum anda menjalankannya — itulah yang wajar dilakukan dengan skrip yang akan memegang kunci API anda. Letakkan kunci dalam OWX_KEY dan bukannya memberi --key, dan ia kekal di luar sejarah 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 perkara yang sama seperti klien shell, tetapi menghurai balasan dan mencetak maksud medan dan bukannya menyerahkan JSON mentah kepada anda — tambah --json apabila anda mahukan bentuk mentah. Perpustakaan standard sahaja: tiada requests, tiada apa untuk dipasang. Jika anda menulis klien sendiri, fungsi send() dan report() ialah bahagian yang patut dibaca: bersama-sama ia menunjukkan cara membina permintaan, cara mengeluarkan mesej daripada permintaan yang gagal, dan kandungan balasan.

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 perkara yang sama seperti yang Python dan mencetak output yang sama. Modul teras sahaja — HTTP::Tiny dan JSON::PP telah disertakan bersama Perl sejak 5.14, jadi tiada apa untuk dipasang. Patut dibaca di sebelah klien Python jika anda menulis klien sendiri: kedua-dua bahasa gagal dengan cara berbeza pada permintaan yang rosak, dan kedua-dua skrip menyatakan 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 ialah padanan klien Python untuk Windows: arahan yang sama, output yang sama, dan ia menghurai balasan dan bukannya menyerahkan JSON mentah kepada anda — tambah --json untuk itu. Ia ditulis untuk Windows PowerShell yang sudah ada pada mesin, jadi tiada apa untuk dipasang, dan ia berjalan tanpa perubahan pada PowerShell 7. Anda mungkin memerlukan Set-ExecutionPolicy -Scope Process Bypass dalam tetingkap tempat anda menjalankannya, iaitu Windows bertanya sama ada anda benar-benar mahu menjalankan skrip yang anda muat turun — soalan yang wajar, dan failnya cukup pendek untuk dibaca dahulu.

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

Tetingkap dalam pelayar anda

0wx.html ialah set tab yang sama seperti klien desktop, sebagai tiga fail — halaman, helaian gaya dan skrip — tanpa pemasangan, tanpa rangka kerja, dan tiada apa yang dimuatkan dari mana-mana selain laman ini. Tiga dan bukannya satu kerana Content-Security-Policy laman melarang skrip dan gaya sebaris, yang patut dikekalkan. Fail boleh dijatuhkan ke atasnya. Ia perlu dibuka dari sini dan bukannya disimpan dan dibuka dari cakera anda: API tidak menghantar pengepala cross-origin, jadi salinan tempatan akan menyebabkan setiap permintaan ditolak oleh pelayar anda sebelum ia keluar. Kunci dipegang dalam memori melainkan anda menanda kotak untuk mengingatinya.

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

Tetingkap di Windows

0wx-gui.ps1 ialah set tab yang sama seperti klien desktop, dilukis dengan WinForms — yang bermakna tiada apa langsung untuk dipasang, kerana ia sudah menjadi sebahagian daripada Windows. Letakkannya dalam folder yang sama dengan 0wx.ps1: tetingkap meminjam pengendalian permintaan fail itu dan bukannya membawa salinan kedua, jadi kedua-duanya diperlukan. Windows akan bertanya sebelum menjalankan skrip yang bukan ditulisnya, yang merupakan soalan wajar; kedua-dua fail cukup pendek untuk dibaca sebelum anda menjawab.

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

Tetingkap di Linux dengan GTK

0wx-gtk.pl ialah tetingkap GTK kecil dengan tab untuk memuat naik, menampal, memendekkan dan melayari fail anda — sebagai senarai atau galeri lakaran kecil, ditapis mengikut galeri. Ia satu-satunya klien di sini yang memerlukan sesuatu dipasang — ikatan GTK3 Perl — yang patut diketahui di sebelah tetingkap Windows di atas, memandangkan yang itu tidak memerlukan apa-apa. Semua yang lain yang digunakannya disertakan bersama Perl. Kunci hanya dipegang dalam memori: menutup tetingkap melupakannya, dan menetapkan OWX_KEY mengisinya pada permulaan. Apa sahaja yang ditunjukkannya, balasan mentah pelayan hanya satu klik 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

Apl Android

0wx-android.apk melakukan apa yang klien lain lakukan, dari telefon: memuat naik, menampal, memendekkan, menterjemah, dan melayari fail anda sebagai senarai atau galeri. Berkongsi fail kepadanya dari mana-mana apl lain memuat naiknya, dan berkongsi teks menyimpannya sebagai teks. Ia tiada di mana-mana gedung apl, jadi peranti anda akan meminta anda membenarkan pemasangannya — soalan yang patut diambil serius secara umum, dan sebab keseluruhan sumbernya juga ada di sini: bukanya dalam Android Studio dan bina sendiri dan bukannya mempercayai fail itu. Membina memerlukan JDK 21; BUILDING.md di dalamnya menerangkan sebabnya.

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

Nota

Sengaja tiada tindakan ambil jauh. Ia akan membuat pelayan mengambil URL pilihan pemanggil, yang merupakan permukaan pemalsuan permintaan, dan skrip boleh memacunya jauh lebih kuat daripada borang. Muat naik sahaja fail itu sendiri.