REST

Vores REST-interface ligger på https://www.shoporama.dk/REST, og du kan oprette dine API-nøgler via dette link.

Vi understøtter metoderne POST, PATCH og DELETE. Hvor POST bruges til at oprette resourcer, PATCH bruges til at ændre dem, og DELETE bruges til at slette dem.

Alt data der sendes frem og tilbage mellem Shoporama sendes som JSON. Content-Type skal derfor sættes til application/json. Derudover bør du have en meningsfuld User-Agent der beskriver din app.

Login fungerer via Authorization headeren, og har følgende format:

Authorization: Shoporama ade0fe8617b0825996baa9c8a9324ddb

Hvor sidste del er din API-nøgle.

Generelt om kaldene

Et typisk POST-kald vil se sådan ud:

POST /REST/product HTTP/1.1
Host: www.shoporama.dk
Authorization: Shoporama ade0fe8617b0825996baa9c8a9324ddb
User-Agent: Min Shoporama integration
Content-Type: application/json
Content-Length: 29

{
    "name": "Produktnavn"
}

Hvor til Shoporama vil svare noget lignende:

HTTP/1.1 201 Created
Location: https://www.shoporama.dk/REST/product/123
Content-Type: application/json

Samt en body der indeholder en JSON-repræsentation af resourcen.

Bemærk at der er en Location header der peger på den nyoprettede resource.

Skal man efterfølgende redigere resourcen kan man PATCH'e det JSON-svar man fik med sine ændringer. PATCH vil kun ændre de felter man sender med, så hvis man kun sender en headline med, så vil description ikke blive nulstillet.

Hvis man vil slette en resource skal man sende en DELETE til resourcens URL.

Endpoints

category

PATCH

images

weight, description, remove, data

order

PATCH

products

product_id, order_product_id, amount, own_id, attributes, attribute_id, stock, unit_price, unit_vat