Hopp til innhold
skribbskribb

Utviklere

Filer

Plattform

Bilder og nedlastingsfiler.

Alle sidene

Referanse

Kodeeksemplene kaller en skribb-funksjon. Hent klienten for språket ditt →

POST/v1/media

media:write

Last opp et bilde eller en nedlastingsfil

Alle filene lagres hos publikasjonen selv og vises derfra. Publikasjonen må ha nettbutikk for delivery.

Bodyen du sender

Sendes som multipart/form-data, ikke som JSON.

purposestringpåkrevd
image for et produktbilde, post for et forsidebilde til et innlegg, delivery for en fil kjøperen laster ned.
filebinarypåkrevd
Selve filen. Et produktbilde (image) kan være inntil 5 MB og må være PNG, JPG, WebP eller GIF. En nedlastingsfil (delivery) kan være inntil 50 MB.

Svaret · 201

mediaMedia
Filen slik den ble lagret.
Svar
{
  "media": {
    "id": "01JB7Q…",
    "url": "https://butikk.skribb.no/_emdash/api/media/file/01JB7Q….jpg",
    "purpose": "image"
  }
}
# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/media" \
  -X POST \
  -F purpose=post \
  -F file=@bilde.png

POST/v1/media/from-url

media:write

Hent et bilde fra en adresse

Ligger bildet allerede på en adresse, henter vi det og legger det der du sier. Svaret er det samme som fra opplastingsruta, pluss source. purpose er post eller image; delivery tar ruta ikke. Vi henter bare over https, følger inntil tre videresendinger og sjekker hver adresse på veien, tar PNG, JPG, WebP og GIF, og aldri SVG. Det er innholdstypen som avgjør, ikke hva adressen slutter på, og vi leser aldri mer enn 5 MB. Adresser som peker inn i vårt eget eller ditt eget nett, blir avvist.

Idempotency-Key:
Sender du den, henter vi bildet én gang selv om kallet kommer to ganger. Svaret på det andre kallet er det samme som på det første.

Bodyen du sender

urlstringpåkrevd
https-adressen bildet ligger på.
purposestring
post for et forsidebilde til et innlegg, image for et produktbilde. Standard er post.

Svaret · 201

mediaMedia
Bildet slik det ble lagret.
Svar
{
  "media": {
    "id": "med_9f2…",
    "url": "https://bitvis.skribb.no/media/bankid.jpg",
    "purpose": "post",
    "source": "https://cdn.example.com/bilder/bankid.jpg"
  }
}
# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/media/from-url" \
  -X POST \
  -H "content-type: application/json" \
  -d '{
    "url": "https://example.no/side"
  }'

Objekter

Media

En opplastet fil.

Felter

idstringikke alltid med
For image og post: id-en filen har i mediebiblioteket til publikasjonen. Den du setter som featured_image.id på et innlegg. Utelatt for delivery.
urlstringikke alltid med
Adressen filen vises fra. For image er den full, med vertsnavnet til publikasjonen, så den kan legges i images på et produkt. For post er den relativ til publikasjonen, som i et innlegg. Utelatt for delivery, fordi en fil kjøperen betaler for ikke skal ha en adresse som virker uten et kjøp.
keystringikke alltid med
Bare for delivery: nøkkelen filen ligger under, den du setter som delivery_file_key.
purposestring
image, delivery eller post, som du sendte inn.
sourcestringikke alltid med
Bare fra from-url: adressen bildet faktisk ble hentet fra. Den er ikke alltid den du sendte, for en adresse kan sende oss videre, og da er det denne som sier hvor bildet ligger.

← Alle rutene