~0wx.es~ :: Óstáil comhad agus uirlisí úsáideacha eile

Gach rud a dhéanann na foirmeacha ar an suíomh seo, do scripteanna. Is JSON gach freagra, earráidí san áireamh, mar sin ní bhíonn ort tomhas riamh an toradh nó míniú atá i gcorp.

Iarratas a dhéanamh

POST chuig an gcríochphointe le paraiméadair fhoirme nó le corp JSON. Tá an dá cheann coibhéiseach; roghnaigh cibé ceann is éasca do d'uirlisí. Roghnaíonn an paraiméadar action cad atá le déanamh. Úsáid --data-urlencode d'aon rud a chlóscríobh duine — téacs greamáin, URL, aistriúchán — mar seolann -d an luach amh agus gearrfar é ag an gcéad &. Tá -d simplí ceart go leor do luachanna seasta cosúil le action féin. Níl --data-urlencode ag wget ar chor ar bith, mar sin le wget déan céatadán-ionchódú ar luachanna den sórt sin tú féin nó seol corp JSON, nach dteastaíonn aon ionchódú uaidh.

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

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

Luachanna ina bhfuil &

I gcorp foirme scarann & paraiméadair, agus ní ionchódaíonn curl -d an rud a thugann tú dó. Gearrtar URL le teaghrán iarratais dá bhrí sin ag a chéad &, agus sroicheann an chuid eile mar pharaiméadair ar leithligh. Úsáid --data-urlencode, nó seol JSON. Diúltaítear do pharaiméadair fhánacha seachas neamhaird a dhéanamh díobh, mar sin teipeann sé seo go glórach in ionad leath naisc a stóráil.

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

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

Fíordheimhniú

Roghnach. Gan eochair tá iarratas gan ainm agus iompraíonn sé go díreach mar a iompraíonn cuairteoir gan ainm — tá an toradh poiblí ar aon nós, is é an t-aon difríocht ná an dtagann sé isteach i do liosta comhad. Gin eochair ar leathanach do chuntais agus seol í mar chomhartha bearer; oibríonn sé freisin í a thabhairt mar pharaiméadar apikey, ach críochnaíonn eochair i dteaghrán iarratais i logaí freastalaí agus i stair an bhrabhsálaí.

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

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

Gníomhartha

action	Paraiméadair	Cur síos
`whoami`	—	Deimhníonn sé go n-oibríonn eochair agus tuairiscíonn sé na teorainneacha reatha. Ní chosnaíonn sé rud ar bith; glaoigh air ar dtús.
`ip`	—	Tuairiscíonn sé do sheoladh, a PTR, an tír, an réigiún agus an chathair a ngeoshuítear é iontu, na comhordanáidí, agus an user agent a sheol tú. Ní theastaíonn eochair uaidh agus freagraíonn sé mar an gcéanna le ceann nó gan cheann. Níos cúinge ná an leathanach gréasáin d'aon ghnó: gan WHOIS, gan chrios DNS agus gan chuardaigh liostaí bloic, mar sin ní chosnaíonn sé rud ar bith ar an bhfreastalaí ach léamh bunachair sonraí áitiúil.
`upload`	`file` (in-athdhéanta), `resize`, `lifetime`, `gallery` nó `g` *	Uaslódálann sé comhad amháin nó níos mó. Caithfidh sé a bheith ina multipart/form-data. Má ainmnítear gailearaí cuirtear díreach isteach ann iad agus seoltar a aitheantas ar ais.
`tinyurl`	`url`, `lifetime`	Giorraíonn sé URL.
`hugeurl`	`url`, `lifetime`	Fadaíonn sé URL, go háiféiseach, d'aon ghnó.
`paste`	`content`, `lifetime`	Stórálann sé bloc téacs agus seolann sé nasc chuige ar ais.
`translate`	`content`, `to`, `from`	Aistríonn sé téacs. Is cóid ón ngníomh `langs` iad `to` agus `from` — tabhair faoi deara nach cóid tíre iad seo i gcónaí: is é `da` an Danmhairgis, ní `dk`. Is féidir `from` a fhágáil ar lár nó `auto` a thabhairt, a iarrann ar an inneall cúil an teanga a bhrath; má thugtar é faightear toradh níos fearr ar théacs gearr.
`langs`		Liostaíonn sé na teangacha a nglacann `translate` leo, mar `supported_langs`: réad amháin in aghaidh na teanga, cód go hainm, san ord a thairgeann an suíomh iad. Ní theastaíonn eochair API uaidh.
`dyndns`	`key`, `ip`, `format`	Nuashonraíonn sé ainm DNS dinimiciúil. An t-aon ghníomh nach dteastaíonn eochair API uaidh: glaonn ródaire air, a bhfuil réimse amháin aige do URL agus gan aon bhealach chun ceanntásc a sheoladh. Is é `key` an eochair nuashonraithe in aghaidh an ainm a thaispeántar i do chuntas, ní d'eochair API. Fág `ip` ar lár agus úsáidtear an seoladh a bhfuil tú ag glaoch uaidh. Is é an freagra an focal dyndns2 de facto — `good`, `nochg`, `badauth`, `abuse` nó `dnserr` — mar ghnáth-théacs, mar sin é a pharsálann ródairí; cuir `format=json` leis don ghnáth-JSON.
`listfiles` *	`page`, `g`	Liostaíonn sé do chomhaid le gach rud a thaispeánann an painéal Eolais, chomh maith leis an mionsamhail agus an nasc díreach. Teorannaíonn `g` é do ghailearaí amháin, nó `none` do chomhaid nach bhfuil in aon ghailearaí.
`listpastes` *	`page`	Liostaíonn sé do ghreamáin, le réamhamharc 200 carachtar ar gach ceann seachas an corp iomlán.
`listurls` *	`page`	Liostaíonn sé do URLanna gearra agus ollmhóra, leis an seoladh a bhfuil gach ceann ag pointeáil chuige.
`otl` *	`share`	Cruthaíonn sé nasc aonuaire chuig ceann de do chomhaid. Gineann gach glao ceann nua, mar sin má thugtar an comhad céanna do bheirt faightear dhá nasc.
`listotl` *	`page`	Liostaíonn sé do naisc aonuaire ghníomhacha, an comhad a bhfuil gach ceann ag pointeáil chuige, agus cé acu an ndeachaigh an comhad sin in éag ó shin.
`listgalleries` *	—	Liostaíonn sé do ghailearaithe lena n-aitheantais, a n-ainmneacha, a líon comhad agus a staid fhoilsithe.
`gallery` *	`g`, `publish`	Tuairiscíonn sé staid fhoilsithe gailearaí, agus athraíonn sé í nuair a thugtar `publish`.
`move` *	`share` (in-athdhéanta), `gallery` nó `g`	Bogann sé comhaid isteach i ngailearaí, de réir ainm (cruthaithe más nua) nó de réir aitheantais. Má fhágtar an dá cheann ar lár bogtar ar ais chuig an bpríomhliosta iad.
`delete` *	`share` (in-athdhéanta), `g`, `otl`, `withfiles`	Scriosann sé comhaid, greamáin, URLanna gearra, gailearaithe, naisc aonuaire, nó aon mheascán. Meaitseáiltear comhroinnt in aghaidh do chomhad ar dtús agus ansin in aghaidh do ghreamán agus do nasc, mar sin ní gá don ghlaoiteoir iad a shórtáil de réir cineáil. Téann naisc aonuaire in `otl`, ar leithligh: níor chóir go mbeadh nasc a bhaint inmheasctha le scriosadh an chomhaid a bhfuil sé ag pointeáil chuige.

* Teastaíonn eochair API ó na gníomhartha seo. Léann nó athraíonn siad sonraí cuntais amháin féin, mar sin níl aon fhoirm gan ainm díobh ann.

Roinnt ag an am céanna

Glacann share agus g le réimse athdhéanta, le heagar JSON, nó le liosta scartha le camóga — cibé ceann is éasca do d'uirlisí. Déantar neamhaird de dhúbláin.

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

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

Gailearaithe

Cibé áit a n-ainmnítear gailearaí — ar upload nó ar move — tugtar ar an dá bhealach céanna é: g d'aitheantas atá ann cheana, nó gallery d'ainm, a chruthaítear más nua é. Má sheoltar an dá cheann, buann g. Iompraíonn an freagra aitheantas an ghailearaí. Tabhair faoi deara nach mbaineann scriosadh gailearaí ach an gailearaí, ag fágáil a chomhad sa phríomhliosta — murab ionann agus an fhoirm ghréasáin, a scriosann iad tar éis fiafraí. Tabhair withfiles=true chun iad a scriosadh freisin: níor chóir do script atá ag glanadh a grúpálacha na huaslódálacha a chailleadh de thimpiste.

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

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

Comhaid a uaslódáil

Ní féidir le huaslódálacha an corp JSON a úsáid, mar caithfear comhad a sheoladh mar multipart. Athdhéan an chuid file chun roinnt a sheoladh ag an am céanna. Tuairiscítear gach comhad ar leithligh: iompraíonn an freagra liosta files díobh siúd ar glacadh leo agus liosta rejected díobh siúd nár glacadh leo, mar sin is rath fós é rath páirteach.

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

Níl aon fhoirm wget den cheann seo ann. Ní féidir le wget corp multipart/form-data a thógáil — níl aon choibhéis aige ar -F curl — agus caithfidh uaslódálacha a bheith ina multipart. Úsáid curl, nó cuir an corp agus an teorainn le chéile tú féin agus seol é le --post-file.

Saolré

Roghnach ar gach gníomh a stórálann rud éigin. Glacann sé le soicindí loma, nó le huimhir agus m, h nó d ina diaidh — na foirmeacha céanna a ghlacann na foirmeacha gréasáin leo. Fág ar lár é nó tabhair 0 chun an mhír a choinneáil gan teorainn ama.

Freagraí

Is réad JSON gach freagra le réimse ok. Ar rath iompraíonn sé an toradh; ar theip iompraíonn sé cód error seasmhach agus message atá inléite ag daoine. Brainseáil ar an gcód, logáil an teachtaireacht.

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

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

Clibeanna fuaime

Nuair a iompraíonn comhad iad, cuireann listfiles file_tags lena iontráil: ealaíontóir, teideal agus albam, léite ó ID3, ó thráchtanna Vorbis nó ó adaimh MP4 nuair a uaslódáladh an comhad. Tá an eochair as láthair seachas null nuair nach bhfuil rud ar bith le tuairisciú, is é sin an chuid is mó de na comhaid, mar sin tástáil í sula léann tú í. B'fhéidir go mbeadh réimsí aonair in easnamh freisin — b'fhéidir go mbeadh teideal ag comhad agus gan albam. Ní nochtar rud ar bith eile ó mheiteashonraí an chomhaid: taifeadann ceannach iTunes ainm agus Apple ID an cheannaitheora, agus ní léitear iad sin riamh d'aon ghnó.

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

Cóid earráide

error	HTTP	Cur síos
`unknown_action`	400	Níl aon ghníomh den sórt sin ann.
`bad_json`	400	Níor JSON bailí é an corp, nó bhí struchtúr neadaithe i réimse.
`unexpected_parameter`	400	Tháinig paraiméadar nach nglacann an gníomh seo leis — de ghnáth `&` neamh-ionchódaithe i luach. Ainmníonn an teachtaireacht na paraiméadair.
`bad_key`	401	Níor aithníodh an eochair. Diúltaítear d'eochair mhícheart seachas caitheamh léi go ciúin mar cheann gan ainm.
`bad_url`	400	Tá an URL míchumtha, nó úsáideann sé scéim seachas http(s), ftp nó gopher.
`bad_lifetime`	400	Níor uimhir í an saolré ná uimhir agus m, h nó d ina diaidh.
`no_content`	400	Níor seoladh rud ar bith le stóráil.
`url_too_long`	413	Tá an URL níos faide ná an teorainn.
`paste_too_long`	413	Tá an téacs níos mó ná teorainn na ngreamán. Tomhaistear teorainneacha i mbearta UTF-8, mar sin comhaireann téacs neamh-Laidineach níos mó ná mar a thugann a líon carachtar le tuiscint.
`too_many_files`	413	Níos mó comhad ná mar a ghlacann glao amháin leis.
`no_usable_files`	415	Diúltaíodh do gach comhad. Féach ar an liosta `rejected` le fáil amach cén fáth.
`backend_unavailable`	502	Níor fhreagair inneall cúil an aistriúcháin.
`internal`	500	Theip ar rud éigin gan choinne. Logáladh é.

Teorainneacha

Glaoigh ar whoami chun na luachanna reatha a léamh seachas iad a chruachódú — socraíonn oibreoir an fhreastalaí iad agus is féidir leo athrú. Is bearta UTF-8 iad na méideanna.

Cliant blaoisce

Cumhdaíonn 0wx.sh gach rud thuas. Is blaosc POSIX shimplí é agus ní theastaíonn uaidh ach curl, agus tá sé gearr go leor le léamh sula rithfidh tú é — sin an rud ceart le déanamh le script a choinneoidh d'eochair API. Cuir an eochair in OWX_KEY seachas --key a thabhairt, agus fanann sí amach as stair do bhlaoisce.

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

Cliant Python

Déanann 0wx.py an rud céanna leis an gcliant blaoisce, ach parsálann sé an freagra agus priontálann sé cad a chiallaíonn na réimsí seachas JSON amh a thabhairt duit — cuir --json leis nuair is mian leat an fhoirm amh a fháil ar ais. Leabharlann chaighdeánach amháin: gan requests, gan rud ar bith le suiteáil. Má tá do chliant féin á scríobh agat, is iad a fheidhmeanna send() agus report() na codanna is fiú a léamh: eatarthu taispeánann siad conas an t-iarratas a thógáil, conas an teachtaireacht a fháil as ceann teipthe, agus cad atá sna freagraí.

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

Cliant Perl

Déanann 0wx.pl an rud céanna leis an gceann Python agus priontálann sé an t-aschur céanna. Croímhodúil amháin — tá HTTP::Tiny agus JSON::PP seolta le Perl ó 5.14, mar sin níl rud ar bith le suiteáil. Is fiú é a léamh in aice leis an gcliant Python má tá do cheann féin á scríobh agat: teipeann an dá theanga ar bhealaí éagsúla ar iarratas briste, agus deir an dá script cá háit.

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

Cliant PowerShell

Is é 0wx.ps1 macasamhail an chliaint Python do Windows: na horduithe céanna, an t-aschur céanna, agus parsálann sé an freagra seachas JSON amh a thabhairt duit — cuir --json leis chuige sin. Tá sé scríofa don Windows PowerShell atá ar an meaisín cheana, mar sin níl rud ar bith le suiteáil, agus ritheann sé gan athrú ar PowerShell 7. B'fhéidir go dteastóidh Set-ExecutionPolicy -Scope Process Bypass uait san fhuinneog ina ritheann tú é, is é sin Windows ag fiafraí ar theastaigh uait i ndáiríre script a d'íoslódáil tú a rith — ceist chóir, agus tá an comhad gearr go leor le léamh ar dtús.

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

Fuinneog i do bhrabhsálaí

Is é 0wx.html an tacar céanna cluaisíní leis an gcliant deisce, mar thrí chomhad — leathanach, stílbhileog agus script — gan suiteáil, gan chreatlach, agus gan rud ar bith lódáilte ó áit ar bith ach ón suíomh seo. Trí cinn seachas ceann amháin toisc go gcuireann Content-Security-Policy an tsuímh cosc ar script agus stíl inlíne, rud is fiú a choinneáil. Is féidir comhaid a scaoileadh air. Caithfear é a oscailt ón áit seo seachas é a shábháil agus a oscailt ó do dhiosca: ní sheolann an API aon cheanntásca tras-tionscnaimh, mar sin dhiúltódh do bhrabhsálaí do gach iarratas ó chóip áitiúil sula bhfágfadh sé. Coinnítear an eochair sa chuimhne mura dticeálann tú an bosca chun é a mheabhrú.

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

Fuinneog ar Windows

Is é 0wx-gui.ps1 an tacar céanna cluaisíní leis an gcliant deisce, tarraingthe le WinForms — rud a chiallaíonn nach bhfuil rud ar bith le suiteáil ar chor ar bith, ós rud é gur cuid de Windows é cheana. Cuir sa bhfillteán céanna é le 0wx.ps1: faigheann an fhuinneog láimhseáil iarratas an chomhaid sin ar iasacht seachas dara cóip a iompar, mar sin teastaíonn an dá cheann. Fiafróidh Windows sula rithfidh sé script nár scríobh sé féin, ar ceist chóir í; tá an dá chomhad gearr go leor le léamh sula bhfreagraíonn tú í.

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

Fuinneog ar Linux le GTK

Is fuinneog bheag GTK é 0wx-gtk.pl le cluaisíní le haghaidh uaslódála, greamaithe, giorraithe, agus brabhsála do chomhad — mar liosta nó mar ghailearaí mionsamhlacha, scagtha de réir gailearaí. Is é an t-aon chliant anseo a dteastaíonn rud ar bith suiteáilte uaidh — ceangail GTK3 Perl — rud is fiú a bheith ar eolas in aice leis an bhfuinneog Windows thuas, ós rud é nach dteastaíonn rud ar bith uaithi sin. Seoltar gach rud eile a úsáideann sé le Perl. Ní choinnítear an eochair ach sa chuimhne: má dhúntar an fhuinneog déantar dearmad uirthi, agus má shocraítear OWX_KEY líontar isteach í ag an tosú. Cibé rud a thaispeánann sé duit, tá freagra amh an fhreastalaí cliceáil amháin ar shiúl faoi “Server reply”.

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

Aip Android

Déanann 0wx-android.apk an rud a dhéanann na cliaint eile, ó ghuthán: uaslódáil, greamú, giorrú, aistriú, agus brabhsáil do chomhad mar liosta nó mar ghailearaí. Má chomhroinntear comhad leis ó aon aip eile uaslódáiltear é, agus má chomhroinntear téacs stóráiltear mar ghreamán é. Níl sé ar aon siopa aipeanna, mar sin iarrfaidh do ghléas ort é a cheadú le suiteáil — ceist is fiú a ghlacadh dáiríre go ginearálta, agus an chúis go bhfuil an fhoinse iomlán anseo freisin: oscail in Android Studio í agus tóg í tú féin seachas muinín a chur sa chomhad. Teastaíonn JDK 21 le haghaidh tógála; deir BUILDING.md istigh cén fáth.

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

Nótaí

Níl aon ghníomh cianfhála ann d'aon ghnó. Chuirfeadh sé ar an bhfreastalaí URL de rogha an ghlaoiteora a fháil, ar dromchla brionnaithe iarratais é, agus is féidir le script é sin a thiomáint i bhfad níos deacra ná foirm. Uaslódáil an comhad tú féin ina ionad sin.