~0wx.org~ :: Uhifadhi wa mafaili na zana nyingine muhimu

Kila kitu ambacho fomu za tovuti hii hufanya, kwa hati. Kila jibu ni JSON, ikiwa ni pamoja na hitilafu, hivyo huna haja ya kukisia kamwe kama mwili ni matokeo au maelezo.

Kufanya ombi

POST kwa kituo cha mwisho kwa vigezo vya fomu au mwili wa JSON. Zote ni sawa; chagua kile ambacho zana zako hurahisisha. Kigezo cha action huchagua cha kufanya. Tumia --data-urlencode kwa chochote alichoandika mtu — maandishi ya bandiko, URL, tafsiri — kwa sababu -d hutuma thamani ghafi na itakatwa kwenye & ya kwanza. -d tupu inafaa kwa thamani zisizobadilika kama action yenyewe. wget haina --data-urlencode kabisa, hivyo kwa wget ama simba thamani hizo kwa asilimia mwenyewe au tuma mwili wa JSON, ambao hauhitaji usimbaji.

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

curl -X POST https://0wx.org/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.org/api.cgi

Thamani zenye &

Kwenye mwili wa fomu & hutenganisha vigezo, na curl -d haisimbi unachoipa. URL yenye mfuatano wa hoja hivyo hukatwa kwenye & yake ya kwanza, na zilizobaki hufika kama vigezo tofauti. Tumia --data-urlencode, au tuma JSON. Vigezo vilivyopotea hukataliwa badala ya kupuuzwa, hivyo hili hushindwa kwa sauti badala ya kuhifadhi nusu kiungo.

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

# right
curl -X POST https://0wx.org/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.org/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.org/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.org/api.cgi

Uthibitishaji

Si lazima. Bila ufunguo ombi halijulikani na hufanya kazi sawa kabisa na mgeni asiyejulikana — matokeo ni ya umma kwa vyovyote, tofauti pekee ni kama linaingia kwenye orodha yako ya mafaili. Tengeneza ufunguo kwenye ukurasa wa akaunti yako na uutume kama tokeni ya bearer; kuupitisha kama kigezo cha apikey pia hufanya kazi, lakini ufunguo kwenye mfuatano wa hoja huishia kwenye kumbukumbu za seva na historia ya kivinjari.

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

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

Vitendo

action	Vigezo	Maelezo
`whoami`	—	Huthibitisha kwamba ufunguo unafanya kazi na kuripoti vikomo vya sasa. Hakigharimu chochote; kiite kwanza.
`ip`	—	Huripoti anwani yako, PTR yake, nchi, mkoa na jiji inapopatikana, viwianishi, na user agent uliotuma. Hakihitaji ufunguo na hujibu sawa na au bila ufunguo. Kwa makusudi ni finyu kuliko ukurasa wa wavuti: hakuna WHOIS, hakuna eneo la DNS na hakuna utafutaji wa orodha za kuzuia, hivyo kukiita hakigharimu seva chochote ila usomaji wa hifadhidata ya ndani.
`upload`	`file` (kinaweza kurudiwa), `resize`, `lifetime`, `gallery` au `g` *	Hupakia faili moja au zaidi. Lazima iwe multipart/form-data. Kutaja matunzio huyaweka moja kwa moja ndani yake na kurudisha id yake.
`tinyurl`	`url`, `lifetime`	Hufupisha URL.
`hugeurl`	`url`, `lifetime`	Hurefusha URL, kwa upuuzi, kwa makusudi.
`paste`	`content`, `lifetime`	Huhifadhi kipande cha maandishi na kurudisha kiungo chake.
`translate`	`content`, `to`, `from`	Hutafsiri maandishi. `to` na `from` ni misimbo kutoka kitendo cha `langs` — kumbuka hii si misimbo ya nchi kila mara: Kidenmaki ni `da`, si `dk`. `from` inaweza kuachwa au kutolewa kama `auto`, ambayo huomba mfumo wa nyuma kutambua lugha; kuitoa hutoa matokeo bora kwa maandishi mafupi.
`langs`		Huorodhesha lugha ambazo `translate` hukubali, kama `supported_langs`: kitu kimoja kwa kila lugha, msimbo hadi jina, kwa mpangilio ambao tovuti huzitoa. Hakihitaji ufunguo wa API.
`dyndns`	`key`, `ip`, `format`	Husasisha jina la DNS linalobadilika. Kitendo pekee kisichohitaji ufunguo wa API: huitwa na ruta, ambayo ina sehemu moja ya URL na hakuna njia ya kutuma kichwa. `key` ni ufunguo wa kusasisha wa kila jina unaoonyeshwa kwenye akaunti yako, si ufunguo wako wa API. Acha `ip` na anwani unayoita kutoka hutumika. Jibu ni neno la dyndns2 la kawaida — `good`, `nochg`, `badauth`, `abuse` au `dnserr` — kama maandishi tupu, kwa sababu ndicho ruta huchambua; ongeza `format=json` kwa JSON ya kawaida.
`listfiles` *	`page`, `g`	Huorodhesha mafaili yako na kila kitu ambacho paneli ya Taarifa huonyesha, pamoja na kijipicha na kiungo cha moja kwa moja. `g` hukiweka kwenye matunzio moja, au `none` kwa mafaili yasiyo kwenye matunzio yoyote.
`listpastes` *	`page`	Huorodhesha mabandiko yako, na hakikisho la herufi 200 la kila moja badala ya mwili mzima.
`listurls` *	`page`	Huorodhesha URL zako fupi na kubwa mno, na anwani ambayo kila moja huelekeza.
`otl` *	`share`	Huunda kiungo cha mara moja kwa mojawapo ya mafaili yako. Kila wito hutengeneza kipya, hivyo kumpa faili lile lile watu wawili hutoa viungo viwili.
`listotl` *	`page`	Huorodhesha viungo vyako vya mara moja vinavyotumika, faili ambalo kila kimoja huelekeza, na kama faili hilo limekwisha muda tangu wakati huo.
`listgalleries` *	—	Huorodhesha matunzio yako na id zake, majina, idadi ya mafaili na hali ya uchapishaji.
`gallery` *	`g`, `publish`	Huripoti hali ya uchapishaji ya matunzio, na kuibadilisha wakati `publish` inatolewa.
`move` *	`share` (kinaweza kurudiwa), `gallery` au `g`	Huhamishia mafaili kwenye matunzio, kwa jina (huundwa kama ni mapya) au kwa id. Yote yakiachwa huyarudisha kwenye orodha kuu.
`delete` *	`share` (kinaweza kurudiwa), `g`, `otl`, `withfiles`	Hufuta mafaili, mabandiko, URL fupi, matunzio, viungo vya mara moja, au mchanganyiko wowote. Share hulinganishwa na mafaili yako kwanza kisha na mabandiko na viungo vyako, hivyo mwitaji hana haja ya kuvipanga kwa aina. Viungo vya mara moja huenda kwenye `otl`, kando: kuondoa kiungo hakupaswi kuchanganywa na kufuta faili linalolengwa.

* Vitendo hivi vinahitaji ufunguo wa API. Husoma au kubadilisha data ya akaunti moja yenyewe, hivyo hakuna muundo usiojulikana wake.

Kadhaa kwa wakati mmoja

share na g hukubali sehemu inayorudiwa, safu ya JSON, au orodha iliyotenganishwa kwa koma — chochote ambacho zana zako hurahisisha zaidi. Nakala zinazojirudia hupuuzwa.

curl -X POST https://0wx.org/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.org/api.cgi -H 'Authorization: Bearer YOUR_KEY' \
     -d action=delete -d 'share=Ab3xK9pQ,Zz7yT2mN'

curl -X POST https://0wx.org/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.org/api.cgi

Matunzio

Popote matunzio yanapotajwa — kwenye upload au kwenye move — hutolewa kwa njia zile zile mbili: g kwa id iliyopo, au gallery kwa jina, ambalo huundwa kama ni jipya. Zote zikitumwa, g hushinda. Jibu hubeba id ya matunzio. Kumbuka kwamba kufuta matunzio huondoa matunzio pekee, na kuacha mafaili yake kwenye orodha kuu — tofauti na fomu ya wavuti, ambayo huyafuta baada ya kuuliza. Pitisha withfiles=true kuyafuta pia: hati inayopanga makundi yake haipaswi kupoteza upakiaji kwa bahati mbaya.

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

curl -X POST https://0wx.org/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.org/api.cgi

Kupakia mafaili

Upakiaji hauwezi kutumia mwili wa JSON, kwa sababu faili lazima litumwe kama multipart. Rudia sehemu ya file kutuma kadhaa kwa wakati mmoja. Kila faili huripotiwa peke yake: jibu hubeba orodha ya files ya yaliyokubaliwa na orodha ya rejected ya yaliyokataliwa, hivyo mafanikio ya sehemu bado ni mafanikio.

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

Hakuna muundo wa wget wa hiki. wget haiwezi kujenga mwili wa multipart/form-data — haina kilinganishi cha -F ya curl — na upakiaji lazima uwe multipart. Tumia curl, au jenga mwili na mpaka mwenyewe na uutume kwa --post-file.

Muda wa kuishi

Si lazima kwa kila kitendo kinachohifadhi kitu. Hukubali sekunde tupu, au nambari ikifuatiwa na m, h au d — muundo ule ule ambao fomu za wavuti huchukua. Iache au pitisha 0 ili kuweka kipengee bila kikomo.

Majibu

Kila jibu ni kitu cha JSON chenye sehemu ya ok. Kwa mafanikio hubeba matokeo; kwa kushindwa hubeba msimbo thabiti wa error na message inayosomeka na binadamu. Tawi kwa msimbo, rekodi ujumbe.

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

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

Vitambulisho vya sauti

Faili linapokuwa navyo, listfiles huongeza file_tags kwenye ingizo lake: msanii, kichwa na albamu, vilivyosomwa kutoka ID3, maoni ya Vorbis au atomu za MP4 wakati faili lilipopakiwa. Ufunguo haupo badala ya null wakati hakuna cha kuripoti, ambayo ni mafaili mengi, hivyo ujaribu kabla ya kuusoma. Sehemu binafsi zinaweza kukosekana pia — faili linaweza kuwa na kichwa bila albamu. Hakuna kingine kutoka metadata ya faili kinachofichuliwa: ununuzi wa iTunes hurekodi jina la mnunuzi na Apple ID, na hizo kwa makusudi hazisomwi kamwe.

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

Misimbo ya hitilafu

error	HTTP	Maelezo
`unknown_action`	400	Hakuna kitendo kama hicho.
`bad_json`	400	Mwili haukuwa JSON sahihi, au sehemu ilikuwa na muundo uliofungwa ndani.
`unexpected_parameter`	400	Kigezo ambacho kitendo hiki hakichukui kimefika — kwa kawaida `&` isiyosimbwa kwenye thamani. Ujumbe hutaja vigezo.
`bad_key`	401	Ufunguo haukutambuliwa. Ufunguo usio sahihi hukataliwa badala ya kutendewa kimya kimya kama usiojulikana.
`bad_url`	400	URL imeharibika, au inatumia mpango tofauti na http(s), ftp au gopher.
`bad_lifetime`	400	Muda wa kuishi haukuwa nambari au nambari ikifuatiwa na m, h au d.
`no_content`	400	Hakuna kilichotumwa kuhifadhiwa.
`url_too_long`	413	URL ni ndefu kuliko kikomo.
`paste_too_long`	413	Maandishi ni makubwa kuliko kikomo cha bandiko. Vikomo hupimwa kwa baiti za UTF-8, hivyo maandishi yasiyo ya Kilatini huhesabiwa zaidi kuliko idadi ya herufi zake inavyodokeza.
`too_many_files`	413	Mafaili mengi kuliko wito mmoja unavyokubali.
`no_usable_files`	415	Kila faili limekataliwa. Angalia orodha ya `rejected` kwa sababu.
`backend_unavailable`	502	Mfumo wa nyuma wa tafsiri haukujibu.
`internal`	500	Kuna kitu kimeshindwa bila kutarajia. Kimerekodiwa.

Vikomo

Ita whoami kusoma thamani za sasa badala ya kuziandika moja kwa moja kwenye msimbo — huwekwa na mwendeshaji wa seva na zinaweza kubadilika. Ukubwa ni baiti za UTF-8.

Mteja wa shell

0wx.sh hufunga yote yaliyo hapo juu. Ni shell ya POSIX tupu na haihitaji chochote ila curl, na ni fupi vya kutosha kuisoma kabla ya kuiendesha — ambalo ndilo jambo sahihi kufanya na hati itakayoshika ufunguo wako wa API. Weka ufunguo kwenye OWX_KEY badala ya kupitisha --key, na hubaki nje ya historia ya shell yako.

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

Mteja wa Python

0wx.py hufanya sawa na mteja wa shell, lakini huchambua jibu na kuchapisha maana ya sehemu badala ya kukupa JSON ghafi — ongeza --json unapotaka muundo ghafi urudishwe. Maktaba ya kawaida pekee: hakuna requests, hakuna cha kusakinisha. Kama unaandika mteja wako mwenyewe, kazi zake send() na report() ndizo sehemu zinazostahili kusomwa: kwa pamoja zinaonyesha jinsi ya kujenga ombi, jinsi ya kupata ujumbe kutoka lililoshindwa, na majibu yana nini.

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

Mteja wa Perl

0wx.pl hufanya sawa na ule wa Python na huchapisha matokeo yale yale. Moduli za msingi pekee — HTTP::Tiny na JSON::PP zimekuja na Perl tangu 5.14, hivyo hakuna cha kusakinisha. Inastahili kusomwa karibu na mteja wa Python kama unaandika wako mwenyewe: lugha hizo mbili hushindwa tofauti kwa ombi lililoharibika, na hati zote mbili husema wapi.

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

Mteja wa PowerShell

0wx.ps1 ni mwenza wa mteja wa Python kwa Windows: amri zile zile, matokeo yale yale, na huchambua jibu badala ya kukupa JSON ghafi — ongeza --json kwa hilo. Umeandikwa kwa Windows PowerShell ambayo tayari iko kwenye mashine, hivyo hakuna cha kusakinisha, na huendeshwa bila mabadiliko kwenye PowerShell 7. Huenda ukahitaji Set-ExecutionPolicy -Scope Process Bypass kwenye dirisha unaloiendesha kutoka, ambalo ni Windows ikiuliza kama kweli ulikusudia kuendesha hati uliyopakua — swali la haki, na faili ni fupi vya kutosha kusomwa kwanza.

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

Dirisha kwenye kivinjari chako

0wx.html ni seti ile ile ya vichupo kama mteja wa kompyuta ya mezani, kama mafaili matatu — ukurasa, laha ya mitindo na hati — bila usakinishaji, bila mfumo, na hakuna kinachopakiwa kutoka popote ila tovuti hii. Matatu badala ya moja kwa sababu Content-Security-Policy ya tovuti inakataza hati na mtindo wa ndani, jambo linalostahili kuhifadhiwa. Mafaili yanaweza kudondoshwa juu yake. Lazima ifunguliwe kutoka hapa badala ya kuhifadhiwa na kufunguliwa kutoka diski yako: API haitumi vichwa vya cross-origin, hivyo nakala ya ndani ingekataliwa kila ombi na kivinjari chako kabla halijaondoka. Ufunguo huwekwa kwenye kumbukumbu isipokuwa utie alama kwenye kisanduku cha kuukumbuka.

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

Dirisha kwenye Windows

0wx-gui.ps1 ni seti ile ile ya vichupo kama mteja wa kompyuta ya mezani, iliyochorwa kwa WinForms — ambayo inamaanisha hakuna cha kusakinisha kabisa, kwani tayari ni sehemu ya Windows. Iweke kwenye folda moja na 0wx.ps1: dirisha huazima ushughulikiaji wa maombi wa faili hilo badala ya kubeba nakala ya pili, hivyo zote mbili zinahitajika. Windows itauliza kabla ya kuendesha hati ambayo haikuiandika, ambalo ni swali la haki; mafaili yote mawili ni mafupi vya kutosha kusomwa kabla ya kulijibu.

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

Dirisha kwenye Linux na GTK

0wx-gtk.pl ni dirisha dogo la GTK lenye vichupo vya kupakia, kubandika, kufupisha, na kuvinjari mafaili yako — kama orodha au kama matunzio ya vijipicha, yakichujwa kwa matunzio. Ndiyo mteja pekee hapa anayehitaji kitu kisakinishwe — vifungo vya GTK3 vya Perl — jambo linalostahili kujulikana karibu na dirisha la Windows hapo juu, kwani lile halihitaji chochote kabisa. Kila kitu kingine anachotumia huja na Perl. Ufunguo hushikwa kwenye kumbukumbu pekee: kufunga dirisha huusahau, na kuweka OWX_KEY huujaza wakati wa kuanza. Chochote kinachokuonyesha, jibu ghafi la seva liko mbofyo mmoja chini ya “Server reply”.

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

Programu ya Android

0wx-android.apk hufanya kile wateja wengine hufanya, kutoka simu: kupakia, kubandika, kufupisha, kutafsiri, na kuvinjari mafaili yako kama orodha au matunzio. Kushiriki faili kwake kutoka programu nyingine yoyote hulipakia, na kushiriki maandishi huyahifadhi kama bandiko. Haiko kwenye duka lolote la programu, hivyo kifaa chako kitakuuliza kuruhusu kuisakinisha — swali linalostahili kuchukuliwa kwa uzito kwa ujumla, na sababu ya chanzo chote kuwa hapa pia: kifungue kwenye Android Studio na ukijenge mwenyewe badala ya kuamini faili. Kujenga kunahitaji JDK 21; BUILDING.md ndani husema kwa nini.

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

Maelezo

Kwa makusudi hakuna kitendo cha kupata kwa mbali. Kingefanya seva ipate URL ya chaguo la mwitaji, ambayo ni eneo la kughushi maombi, na hati inaweza kukiendesha kwa nguvu zaidi kuliko fomu. Pakia faili mwenyewe badala yake.