Mae API v1 Freeimage.host yn caniatáu llwytho lluniau i fyny.
Allwedd API
Galwad API
Dull cais
Gellir gwneud galwadau API v1 gan ddefnyddio'r dulliau cais POST neu GET, ond gan fod ceisiadau GET yn gyfyngedig gan yr uchafswm hyd a ganiateir i URL, dylech ffafrio'r dull cais POST.
URL y cais
Paramedrau
- allwedd (gofynnol) Yr allwedd API.
- gweithred Yr hyn rydych am ei wneud [gwerthoedd: upload].
- ffynhonnell Naill ai URL delwedd neu linyn delwedd wedi'i amgodio base64. Gallwch hefyd ddefnyddio FILES["source"] yn eich cais.
- fformat Yn gosod y fformat dychwelyd [gwerthoedd: json (rhagosodedig), redirect, txt].
Enghraifft o alwad
Nodyn: Defnyddiwch bob amser POST wrth lwytho ffeiliau lleol i fyny. Gall amgodio URL newid y ffynhonnell base64 oherwydd nodau wedi'u hamgodio neu oherwydd terfyn hyd y cais URL gyda GET.
Ymateb API
Mae ymatebion API v1 yn dangos yr holl wybodaeth delwedd a lwythwyd i fyny mewn fformat JSON.
Yn JSON bydd yr ymateb yn cynnwys codau statws penawdau i ganiatáu i chi sylwi'n hawdd a oedd y cais yn IAWN ai peidio. Bydd hefyd yn allbynnu'r statws priodweddau.
