~0wx.eu~ :: Skrá hýsingu og önnur gagnleg tól

Allt sem eyðublöðin á þessu vefsvæði gera, fyrir skriftur. Hvert svar er JSON, villur meðtaldar, svo þú þarft aldrei að giska á hvort meginmál sé niðurstaða eða skýring.

Að senda beiðni

Sendu POST á endapunktinn annaðhvort með eyðublaðsstikum eða JSON-meginmáli. Hvort tveggja jafngilt; veldu það sem verkfærin þín gera auðveldara. Stikinn action velur hvað á að gera. Notaðu --data-urlencode fyrir allt sem manneskja sló inn — límdan texta, vefslóð, þýðingu — því -d sendir gildið hrátt og það klippist við fyrsta &. Venjulegt -d dugar fyrir föst gildi eins og action sjálft. wget hefur alls ekkert --data-urlencode, svo með wget verðurðu annaðhvort að prósentukóða slík gildi sjálf(ur) eða senda JSON-meginmál, sem þarf enga kóðun.

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

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

Gildi sem innihalda &

Í eyðublaðsmeginmáli aðskilur & stika, og curl -d kóðar ekki það sem þú gefur því. Vefslóð með fyrirspurnarstreng klippist því við fyrsta & sitt, og afgangurinn berst sem aðskildir stikar. Notaðu --data-urlencode, eða sendu JSON. Villuráfandi stikum er hafnað í stað þess að hunsa þá, svo þetta bregst hávært í stað þess að geyma hálfan tengil.

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

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

Auðkenning

Valfrjálst. Án lykils er beiðni nafnlaus og hegðar sér nákvæmlega eins og nafnlaus gestur — niðurstaðan er opinber hvort sem er, eini munurinn er hvort hún lendir í skráalistanum þínum. Búðu til lykil á reikningssíðunni þinni og sendu hann sem bearer-tóka; að senda hann sem apikey-stika virkar líka, en lykill í fyrirspurnarstreng endar í dagbókum þjónsins og vafraferli.

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

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

Aðgerðir

action	Stikar	Lýsing
`whoami`	—	Staðfestir að lykill virki og skilar gildandi mörkum. Kostar ekkert; kallaðu á hana fyrst.
`ip`	—	Skilar vistfanginu þínu, PTR þess, landinu, svæðinu og borginni sem það staðsetst í, hnitunum og user agent sem þú sendir. Þarf engan lykil og svarar eins með eða án. Viljandi þrengra en vefsíðan: ekkert WHOIS, ekkert DNS-svæði og engar uppflettingar í bannlistum, svo kall kostar þjóninn ekkert nema staðbundinn gagnagrunnslestur.
`upload`	`file` (endurtakanlegt), `resize`, `lifetime`, `gallery` eða `g` *	Hleður upp einni eða fleiri skrám. Verður að vera multipart/form-data. Sé myndasafn nefnt eru þær settar beint í það og auðkenni þess skilað.
`tinyurl`	`url`, `lifetime`	Styttir vefslóð.
`hugeurl`	`url`, `lifetime`	Lengir vefslóð, fáránlega mikið, viljandi.
`paste`	`content`, `lifetime`	Geymir textablokk og skilar tengli á hana.
`translate`	`content`, `to`, `from`	Þýðir texta. `to` og `from` eru kóðar úr aðgerðinni `langs` — athugaðu að þeir eru ekki alltaf landskóðar: danska er `da`, ekki `dk`. `from` má sleppa eða gefa sem `auto`, sem biður bakendann að greina tungumálið; að tilgreina það gefur betri niðurstöðu á stuttum texta.
`langs`		Listar tungumálin sem `translate` tekur við, sem `supported_langs`: einn hlutur á tungumál, kóði að nafni, í þeirri röð sem vefsvæðið býður þau. Þarf engan API-lykil.
`dyndns`	`key`, `ip`, `format`	Uppfærir kvikt DNS-nafn. Eina aðgerðin sem þarf ekki API-lykil: beinir kallar á hana, sem hefur einn reit fyrir vefslóð og enga leið til að senda haus. `key` er uppfærslulykill hvers nafns sem sýndur er á reikningnum þínum, ekki API-lykillinn þinn. Slepptu `ip` og vistfangið sem þú kallar frá er notað. Svarið er de facto dyndns2-orðið — `good`, `nochg`, `badauth`, `abuse` eða `dnserr` — sem hreinn texti, því það er það sem beinar þátta; bættu við `format=json` fyrir venjulegt JSON.
`listfiles` *	`page`, `g`	Listar skrárnar þínar með öllu sem upplýsingaglugginn sýnir, auk smámyndar og beins tengils. `g` takmarkar við eitt myndasafn, eða `none` við skrár í engu myndasafni.
`listpastes` *	`page`	Listar textana þína með 200 stafa forsýn af hverjum í stað alls meginmálsins.
`listurls` *	`page`	Listar stuttu og risavöxnu vefslóðirnar þínar með vistfanginu sem hver vísar á.
`otl` *	`share`	Býr til einnota tengil á eina af skránum þínum. Hvert kall slær nýjan, svo að gefa tveimur sömu skrána gefur tvo tengla.
`listotl` *	`page`	Listar virku einnota tenglana þína, skrána sem hver vísar á, og hvort sú skrá hafi runnið út síðan.
`listgalleries` *	—	Listar myndasöfnin þín með auðkennum, nöfnum, skráafjölda og útgáfustöðu.
`gallery` *	`g`, `publish`	Skilar útgáfustöðu myndasafns og breytir henni þegar `publish` er gefið.
`move` *	`share` (endurtakanlegt), `gallery` eða `g`	Færir skrár í myndasafn, eftir nafni (búið til ef nýtt) eða eftir auðkenni. Sé báðum sleppt fara þær aftur í aðallistann.
`delete` *	`share` (endurtakanlegt), `g`, `otl`, `withfiles`	Eyðir skrám, textum, stuttum vefslóðum, myndasöfnum, einnota tenglum eða hvaða blöndu sem er. Share er fyrst borið saman við skrárnar þínar og svo við textana og tenglana þína, svo kallandinn þarf ekki að flokka þau eftir gerð. Einnota tenglar fara sér í `otl`: að fjarlægja tengil má ekki vera hægt að rugla saman við að eyða skránni sem hann vísar á.

* Þessar aðgerðir þurfa API-lykil. Þær lesa eða breyta gögnum eins reiknings, svo engin nafnlaus mynd er til af þeim.

Mörg í einu

share og g taka við endurteknu svæði, JSON-fylki eða kommuaðgreindum lista — hvað sem verkfærin þín gera auðveldast. Tvítök eru hunsuð.

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

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

Myndasöfn

Hvar sem myndasafn er nefnt — í upload eða move — er það gefið á sömu tvo vegu: g fyrir auðkenni sem er til, eða gallery fyrir nafn, sem er búið til ef það er nýtt. Séu bæði send vinnur g. Svarið ber auðkenni myndasafnsins. Athugaðu að að eyða myndasafni fjarlægir aðeins myndasafnið og skilur skrárnar eftir í aðallistanum — ólíkt vefeyðublaðinu, sem eyðir þeim eftir að hafa spurt. Sendu withfiles=true til að eyða þeim líka: skrifta sem tekur til í hópunum sínum ætti ekki að tapa upphali fyrir slysni.

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

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

Að hlaða upp skrám

Upphal getur ekki notað JSON-meginmálið, því skrá verður að senda sem multipart. Endurtaktu file-hlutann til að senda fleiri í einu. Hver skrá er tilkynnt sér: svarið ber files-lista yfir þær sem var tekið við og rejected-lista yfir þær sem var hafnað, svo hlutaárangur er samt árangur.

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

Það er ekkert wget-form af þessari. wget getur ekki smíðað multipart/form-data-meginmál — það á sér enga hliðstæðu við -F í curl — og upphal verður að vera multipart. Notaðu curl, eða settu saman meginmál og mörk sjálf(ur) og sendu með --post-file.

Líftími

Valfrjálst í hverri aðgerð sem geymir eitthvað. Tekur við berum sekúndum, eða tölu með m, h eða d á eftir — sömu formum og vefeyðublöðin. Slepptu því eða sendu 0 til að geyma hlutinn ótímabundið.

Svör

Hvert svar er JSON-hlutur með ok-svæði. Þegar vel tekst til ber það niðurstöðuna; þegar illa fer ber það stöðugan error-kóða og læsilegt message. Greindu eftir kóðanum, skráðu skilaboðin.

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

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

Hljóðmerki

Þar sem skrá ber þau bætir listfiles file_tags við færslu hennar: flytjanda, titli og plötu, lesnum úr ID3, Vorbis-athugasemdum eða MP4-atómum þegar skránni var hlaðið upp. Lykillinn vantar frekar en að vera null þegar ekkert er að tilkynna, sem á við um flestar skrár, svo prófaðu hvort hann sé til áður en þú lest hann. Einstök svæði geta líka vantað — skrá getur haft titil en enga plötu. Ekkert annað úr lýsigögnum skrárinnar er afhjúpað: iTunes-kaup skrá nafn kaupanda og Apple-auðkenni, og þau eru viljandi aldrei lesin.

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

Villukóðar

error	HTTP	Lýsing
`unknown_action`	400	Engin slík aðgerð.
`bad_json`	400	Meginmálið var ekki gilt JSON, eða svæði innihélt faldaða uppbyggingu.
`unexpected_parameter`	400	Stiki barst sem þessi aðgerð tekur ekki við — yfirleitt ókóðað `&` í gildi. Skilaboðin nefna stikana.
`bad_key`	401	Lykillinn þekktist ekki. Röngum lykli er hafnað í stað þess að hann sé þegjandi meðhöndlaður sem nafnlaus.
`bad_url`	400	Vefslóðin er gölluð eða notar annað skema en http(s), ftp eða gopher.
`bad_lifetime`	400	Líftíminn var hvorki tala né tala með m, h eða d á eftir.
`no_content`	400	Ekkert var sent til geymslu.
`url_too_long`	413	Vefslóðin er lengri en mörkin.
`paste_too_long`	413	Textinn er stærri en límimörkin. Mörk eru mæld í UTF-8-bætum, svo ólatneskur texti telur meira en stafafjöldinn gefur til kynna.
`too_many_files`	413	Fleiri skrár en eitt kall tekur við.
`no_usable_files`	415	Öllum skrám var hafnað. Sjá listann `rejected` fyrir ástæðuna.
`backend_unavailable`	502	Þýðingarbakendinn svaraði ekki.
`internal`	500	Eitthvað brást óvænt. Það hefur verið skráð.

Mörk

Kallaðu á whoami til að lesa gildandi gildi í stað þess að harðkóða þau — rekstraraðili þjónsins stillir þau og þau geta breyst. Stærðir eru UTF-8-bæti.

Skeljarbiðlari

0wx.sh pakkar öllu hér að ofan inn. Það er hrein POSIX-skel, þarf ekkert nema curl og er nógu stutt til að lesa áður en þú keyrir það — sem er rétt að gera við skriftu sem mun geyma API-lykilinn þinn. Settu lykilinn í OWX_KEY í stað þess að senda --key, og hann helst utan skeljarferilsins þíns.

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

Python-biðlari

0wx.py gerir það sama og skeljarbiðlarinn, en þáttar svarið og prentar hvað svæðin þýða í stað þess að rétta þér hrátt JSON — bættu við --json þegar þú vilt hráa formið. Aðeins staðalsafn: ekkert requests, ekkert til að setja upp. Ef þú skrifar eigin biðlara eru föllin send() og report() hlutarnir sem vert er að lesa: saman sýna þau hvernig beiðnin er byggð, hvernig skilaboðin eru dregin úr misheppnaðri beiðni og hvað svörin innihalda.

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

Perl-biðlari

0wx.pl gerir það sama og Python-biðlarinn og prentar sömu úttök. Aðeins kjarnaeiningar — HTTP::Tiny og JSON::PP hafa fylgt Perl síðan 5.14, svo það er ekkert að setja upp. Vert að lesa við hlið Python-biðlarans ef þú skrifar þinn eigin: málin tvö bregðast ólíkt við brotinni beiðni, og báðar skrifturnar segja hvar.

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

PowerShell-biðlari

0wx.ps1 er hliðstæða Python-biðlarans fyrir Windows: sömu skipanir, sömu úttök, og hann þáttar svarið í stað þess að rétta þér hrátt JSON — bættu við --json fyrir það. Hann er skrifaður fyrir Windows PowerShell sem er þegar á vélinni, svo það er ekkert að setja upp, og hann keyrir óbreyttur á PowerShell 7. Þú gætir þurft Set-ExecutionPolicy -Scope Process Bypass í glugganum sem þú keyrir hann úr; það er Windows að spyrja hvort þú hafir raunverulega ætlað að keyra skriftu sem þú sóttir — sanngjörn spurning, og skráin er nógu stutt til að lesa fyrst.

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

Gluggi í vafranum þínum

0wx.html er sama flipasett og skjáborðsbiðlarinn, sem þrjár skrár — síða, stílblað og skrifta — án uppsetningar, án umgjarðar, og ekkert hlaðið annars staðar frá en þessu vefsvæði. Þrjár í stað einnar því Content-Security-Policy vefsvæðisins bannar innfellda skriftu og stíl, sem er vert að halda í. Skrám má sleppa á hana. Hana verður að opna héðan frekar en að vista og opna af disknum þínum: API-ið sendir enga cross-origin-hausa, svo vafrinn þinn myndi hafna hverri beiðni frá staðbundnu eintaki áður en hún færi af stað. Lykillinn er geymdur í minni nema þú hakir við reitinn til að muna hann.

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

Gluggi á Windows

0wx-gui.ps1 er sama flipasett og skjáborðsbiðlarinn, teiknað með WinForms — sem þýðir alls ekkert að setja upp, þar sem það er þegar hluti af Windows. Settu hana í sömu möppu og 0wx.ps1: glugginn fær beiðnimeðhöndlun þeirrar skrár að láni í stað þess að bera annað eintak, svo báðar þarf. Windows spyr áður en það keyrir skriftu sem það skrifaði ekki sjálft, sem er sanngjörn spurning; báðar skrárnar eru nógu stuttar til að lesa áður en þú svarar.

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

Gluggi á Linux með GTK

0wx-gtk.pl er lítill GTK-gluggi með flipum til að hlaða upp, líma, stytta og skoða skrárnar þínar — sem lista eða sem smámyndasafn, síað eftir myndasafni. Hann er eini biðlarinn hér sem þarf eitthvað uppsett — GTK3-bindingar Perl — sem er vert að vita við hlið Windows-gluggans hér að ofan, sem þarf alls ekkert. Allt annað sem hann notar fylgir Perl. Lykillinn er aðeins geymdur í minni: að loka glugganum gleymir honum, og að stilla OWX_KEY fyllir hann inn við ræsingu. Hvað sem hann sýnir þér er hrátt svar þjónsins einum smelli í burtu undir “Server reply”.

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

Android-forrit

0wx-android.apk gerir það sem hinir biðlararnir gera, úr síma: hlaða upp, líma, stytta, þýða og skoða skrárnar þínar sem lista eða myndasafn. Að deila skrá til þess úr hvaða öðru forriti sem er hleður henni upp, og að deila texta geymir hann sem texta. Það er ekki í neinni forritabúð, svo tækið þitt spyr hvort þú leyfir uppsetningu — spurning sem vert er að taka alvarlega almennt, og ástæðan fyrir því að allur frumkóðinn er líka hér: opnaðu hann í Android Studio og byggðu sjálf(ur) í stað þess að treysta skránni. Bygging þarf JDK 21; BUILDING.md þar inni segir hvers vegna.

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

Athugasemdir

Það er viljandi engin aðgerð til að sækja af fjarlægum stað. Hún léti þjóninn sækja vefslóð að vali kallandans, sem er árásarflötur fyrir beiðnafölsun, og skrifta getur keyrt það miklu harðar en eyðublað. Hladdu skránni upp sjálf(ur) í staðinn.