API cookbook

const API_KEY = "your-api-key-here";
const SHOP_NAME = "lumen";
const BASE_URL = "https://api.io.droplinked.com";

async function callAPI(endpoint, method = "GET", body = null) {
  const options = {
    method,
    headers: {
      "x-droplinked-api-key": API_KEY,
      "Content-Type": "application/json"
    }
  };
  if (body) options.body = JSON.stringify(body);
  const response = await fetch(`${BASE_URL}${endpoint}`, options);
  return response.json();
}

async function getShop()       { return callAPI(`/shops/v2/public/name/${SHOP_NAME}`); }
async function getProducts()   { return callAPI(`/product-v2/public/shop/${SHOP_NAME}`); }
async function getProductDetails(id) { return callAPI(`/product-v2/public/${id}`); }
async function createCart(shopId)    { return callAPI("/v2/carts", "POST", { shopId }); }
async function addToCart(cartId, skuId, quantity = 1) {
  return callAPI(`/v2/carts/${cartId}/products`, "POST", { skuId, quantity });
}
async function getCart(cartId) { return callAPI(`/v2/carts/${cartId}`); }
async function updateQuantity(cartId, skuId, quantity) {
  return callAPI(`/v2/carts/${cartId}/products/${skuId}`, "PATCH", { quantity });
}
async function removeFromCart(cartId, skuId) {
  return callAPI(`/v2/carts/${cartId}/products/${skuId}`, "DELETE");
}
async function getShipping(cartId) { return callAPI(`/v2/carts/${cartId}/shipping`); }
async function selectShipping(cartId, shipmentId, rateId) {
  return callAPI(`/v2/carts/${cartId}/shipping`, "POST", {
    selectedShippingRate: [{ shipmentId, rateId }]
  });
}
async function getPaymentMethods(cartId) { return callAPI(`/v2/carts/${cartId}/payment-methods`); }
async function createOrder(cartId)       { return callAPI("/v2/orders", "POST", { cartId }); }

async function completeShoppingFlow() {
  try {
    const shop = await getShop();
    const productsData = await getProducts();
    const products = productsData.data;
    const product = await getProductDetails(products[0].id);
    const skuId = product.skus[0].id;

    const cartData = await createCart(shop.id);
    const cartId = cartData.id;
    await addToCart(cartId, skuId, 1);

    const shipping = await getShipping(cartId);
    await selectShipping(cartId, shipping.data[0].shipmentId, shipping.data[0].rateId);

    const order = await createOrder(cartId);
    console.log("Order created:", order.data.orderId);
  } catch (error) {
    console.error("Error:", error);
  }
}

completeShoppingFlow();

import requests

API_KEY = "your-api-key-here"
SHOP_NAME = "lumen"
BASE_URL = "https://api.io.droplinked.com"


class DroplinkedAPI:
    def __init__(self, api_key, shop_name):
        self.api_key = api_key
        self.shop_name = shop_name
        self.headers = {
            "x-droplinked-api-key": api_key,
            "Content-Type": "application/json"
        }

    def get_shop(self):
        return requests.get(
            f"{BASE_URL}/shops/v2/public/name/{self.shop_name}",
            headers=self.headers
        ).json()

    def get_products(self):
        return requests.get(
            f"{BASE_URL}/product-v2/public/shop/{self.shop_name}",
            headers=self.headers
        ).json()

    def get_product_details(self, product_id):
        return requests.get(
            f"{BASE_URL}/product-v2/public/{product_id}",
            headers=self.headers
        ).json()

    def create_cart(self, shop_id):
        return requests.post(
            f"{BASE_URL}/v2/carts",
            headers=self.headers,
            json={"shopId": shop_id}
        ).json()

    def add_to_cart(self, cart_id, sku_id, quantity=1):
        return requests.post(
            f"{BASE_URL}/v2/carts/{cart_id}/products",
            headers=self.headers,
            json={"skuId": sku_id, "quantity": quantity}
        ).json()

    def get_cart(self, cart_id):
        return requests.get(
            f"{BASE_URL}/v2/carts/{cart_id}",
            headers=self.headers
        ).json()

    def update_quantity(self, cart_id, sku_id, quantity):
        return requests.patch(
            f"{BASE_URL}/v2/carts/{cart_id}/products/{sku_id}",
            headers=self.headers,
            json={"quantity": quantity}
        ).json()

    def remove_from_cart(self, cart_id, sku_id):
        return requests.delete(
            f"{BASE_URL}/v2/carts/{cart_id}/products/{sku_id}",
            headers=self.headers
        ).json()

    def get_shipping(self, cart_id):
        return requests.get(
            f"{BASE_URL}/v2/carts/{cart_id}/shipping",
            headers=self.headers
        ).json()

    def select_shipping(self, cart_id, shipment_id, rate_id):
        return requests.post(
            f"{BASE_URL}/v2/carts/{cart_id}/shipping",
            headers=self.headers,
            json={"selectedShippingRate": [
                {"shipmentId": shipment_id, "rateId": rate_id}
            ]}
        ).json()

    def get_payment_methods(self, cart_id):
        return requests.get(
            f"{BASE_URL}/v2/carts/{cart_id}/payment-methods",
            headers=self.headers
        ).json()

    def create_order(self, cart_id):
        return requests.post(
            f"{BASE_URL}/v2/orders",
            headers=self.headers,
            json={"cartId": cart_id}
        ).json()


def main():
    api = DroplinkedAPI(API_KEY, SHOP_NAME)
    shop = api.get_shop()
    products = api.get_products()["data"]
    product = api.get_product_details(products[0]["id"])
    sku_id = product["skus"][0]["id"]

    cart = api.create_cart(shop["id"])
    cart_id = cart["id"]
    api.add_to_cart(cart_id, sku_id, 1)

    shipping = api.get_shipping(cart_id)
    rate = shipping["data"][0]
    api.select_shipping(cart_id, rate["shipmentId"], rate["rateId"])

    order = api.create_order(cart_id)
    print(f"Order created: {order['data']['orderId']}")


if __name__ == "__main__":
    main()