API

API

New Listing

/listings POST

Parameters

param	description	data type	examples	required
title	The title of the listing	String	City Scapes	true
description	The description of the listing	String	A beautiful set from the latest collection...	false
condition	The condition of the listing	String	Used	false
category	The category of the listing	String	Batman	true
email	The email address of the user that created the listing	String	me@example.com	true
category	The collection name from the manufacturer	String	Star Wars	false
zipCode	The zip code of where the lego set is located	String	20000	true
legoSetCode	The Lego set code for the listing	String	P42F36	false
imageUrl	An image URL of the listing	String	http://aws.com/bucket/images/listing/1/1.jpg	false

Request Format

{
    "title": "Star Wars Boba Fett",
    "description": "Brand new. My kid wanted Batman.",
    "condition": "New",
    "category": "Star Wars",
    "username": "SuburbanDad",
    "email": "bob@bob.com",
    "zipCode": "52645",
    "legoSetCode": "4D1F56",
    "imageUrl": "http://aws.com/bucket/images/listing/1/3.jpg"
}

Response Format

status: 201

{
  "listingId": "1234"
}

Get Listings

/listings GET returns an array of listings. The results can be filtered by userId, category, zip code, or legoSetCode

Parameters

param	description	data type	examples	required
:userId	The id of the user that created the listing	String	1000	false
category	The category name from the manufacturer	String	Star Wars	false
location	The zip code of where the lego sets are located	String	20000	false
legoSetCode	The Lego set code for the listing	String	P42F36	false

Request Format to get a user's listings

{
  "userId": "1000"
}

Response Format

status: 200

[
    {
      "userId": "1000",
      "listingId": "1",
      "title": "City Scapes",
      "description": "A beautiful set from the latest collection...",
      "imageUrl": "http://aws.com/bucket/images/listing/1/1.jpg",
      "collection": "City",
      "location": "2030",
      "legoSetCode: "XP#BN2",
      "email": "me@example.com",
      "createAt: 
    }
]

Request Format to get listings from a category

{
  "collection": "Star Wars"
}

Response Format

status: 200

[
    {
      "userId": "1002",
      "listingId": "2",
      "title": "Luke",
      "description": "Luke Skywalker's...",
      "imageUrl": "http://aws.com/bucket/images/listing/1/1.jpg",
      "collection": "City",
      "location": 2000,
      "email": "me2@example.com"
    },
     {
      "userId": "1003",
      "listingId": "4",
      "title": "Death Star",
      "description": "One of the first...",
      "imageUrl": "http://aws.com/bucket/images/listing/4/1.jpg",
      "collection": "Star Wars",
      "location": 2000,
      "email": "me2@example.com"
    }
]

Delete a Listing

/listings DELETE

Parameters

param	description	data type	examples	required
:listingId	The id of the listing to be deleted	String	1000	true

Request Format

{
  "listingId": "1000"
}

Response Format

status: 201