Filer

Last opp et bilde eller en nedlastingsfil

purpose=image legger filen i det åpne mediebiblioteket og svarer med en url du kan legge inn i images på et produkt. purpose=post legger den i publikasjonens eget mediebibliotek og svarer med en id du kan sette som featured_image.id på et innlegg. De to er ikke samme sted, og det er derfor det er to: et innlegg viser til forsidebildet sitt med en id fra sitt eget bibliotek, så en url herfra er ikke noe featured_image kan holde. purpose=delivery legger filen i den private butikkbøtta og svarer med en key du kan sette som delivery_file_key, og med vilje uten url: filen er det kjøperen betaler for, og den serveres bare gjennom nedlastingsruta etter et betalt kjøp.

{
  "media": {
    "url": "https://media.skribb.no/…/krus.jpg",
    "key": "…/krus.jpg",
    "purpose": "image"
  }
}

# Kaller skribb-klienten: https://skribb.no/utviklere/autentisering#klient
skribb "/media" \
  -X POST \
  -F purpose=post \
  -F file=@bilde.png

Hent et bilde fra en adresse

Ligger bildet allerede på en adresse, henter vi det og legger det der du sier, så du slipper å laste det ned selv for å laste det opp igjen. Svaret er det samme som fra opplastingsruta, pluss source. purpose er post eller image, ikke delivery: å hente en adresse inn i den private butikkbøtta er noe annet enn å gi et innlegg et forsidebilde. Vi henter bare over https, følger inntil tre videresendinger og sjekker hver eneste adresse på veien, tar bare PNG, JPG, WebP og GIF, og aldri SVG, som er et dokument som kan kjøre kode. 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.

{
  "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"
  }'