Introductie

Het verzenden van afdrukbestellingen gebeurt via een REST API. Voordat u verzoeken naar de API kunt doen, moet u eerst authentificeren met de ontvangen referenties om een authenticatietoken te verkrijgen. Dit token moet worden opgenomen in de "Authorization" header van elke daaropvolgende API-aanroep:

Authorization: Bearer <your-authentication-token>

Live API URL https://api.bephoto.be

Inloggen

Authenticeer door de /user/login endpoint aan te roepen met uw inloggegevens:

POST /user/login { "email": "<string>", "password": "<string>" }

Succes antwoord:

{ "status": 1, "token": "<string>" }

Fout antwoord:

{ "error": "Unauthorized" }

Paramètres envoyés à l'API

• email: L'adresse email de l'utilisateur.
• password: Le mot de passe de l'utilisateur.

Bestelling aanmaken

Maak een nieuwe bestelling aan door /orders aan te roepen met optionele metadata. Nadat u een bestelling heeft aangemaakt, ontvangt u een unieke idorder die in de volgende aanroepen moet worden gebruikt:

POST /orders { "metadata": "<string>" }

Succes antwoord:

{ "status": 1, "order": [{ "idorder": "<integer>", "datestart": "<timestamp>", "totalorder": "<float>", "totalcost": "<float>", "dateconfirmation": "<timestamp>", "dateprocessed": "<timestamp>", "shippingmethod": "<string>", "metadata": "<string>" }] }

Paramètres envoyés à l'API

• metadata: Métadonnées personnalisées associées à la commande. Max. longueur : 255 caractères.

Bestelling ophalen

Haal informatie op over een bestelling door /orders/{IDORDER} aan te roepen:

GET /orders/{IDORDER}

Succes antwoord:

{ "status": 1, "order": [{ "idorder": "<integer>", "datestart": "<timestamp>", "totalorder": "<float>", "totalcost": "<float>", "dateconfirmation": "<timestamp>", "dateprocessed": "<timestamp>", "shippingmethod": "<string>", "metadata": "<string>" }] }

Paramètres envoyés à l'API

• idorder: L'ID unique de la commande.

Producten ophalen

Haal een lijst op van beschikbare afdrukproducten door /products aan te roepen:

GET /products

Succes antwoord:

{ "status": 1, "products": [{ "idproduct": "<integer>", "product": "<string>", "dimensions": "<string>", "prices": [{ "price": "<float>", "idpaper": "<integer>" }] }] }

Paramètres envoyés à l'API

• idproduct: L'ID unique du produit.
• dimensions: Les dimensions du produit (en millimètres).
• prices: Les prix associés au produit, avec l'ID du type de papier.

Producten toevoegen

Voeg producten toe aan uw bestelling door een POST-verzoek naar /orders/{IDORDER}/products te sturen:

POST /orders/{IDORDER}/products { "idproduct": "<integer>", "idpaper": "<integer>", "quantity": "<integer>", "fileurl": "<string>", "filename": "<string>", "filesize": "<integer>" }

Succes antwoord:

{ "status": 1 }

Paramètres envoyés à l'API

• idproduct: L'ID unique du produit à ajouter.
• idpaper: ID du type de papier (1 pour brillant, 2 pour lustre).
• quantity: Quantité de produit à ajouter.
• fileurl: URL publique du fichier image à imprimer. Le fichier doit être au format JPEG et rester disponible pendant le traitement de la commande.
• filename: Nom du fichier image à imprimer.
• filesize: Taille du fichier en octets.

Bestelling bevestigen

Sluit de bestelling door /orders/{IDORDER}/close aan te roepen nadat alle producten zijn toegevoegd:

POST /orders/{IDORDER}/close {}

Succes antwoord:

{ "status": 1 }

Paramètres envoyés à l'API

• idorder: L'ID unique de la commande.