{"info":{"_postman_id":"c0122ef0-60c4-44ef-8499-38920cf17c32","name":"PhotoManager","description":"

Introduction

This API allows you to upload images to your Dropbox account and organize them into categories.

Overview

In order to use this API you must have a Dropbox account.

Authentication

This API uses a bearer authentication scheme.

Error Codes

400 - The payload is not well formed.\n400 - Bad parameters.\n400 - Duplicate image.\n400 - Invalid image format.\n401 - Not authorized.\n404 - Document not found.\n

","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Introduction","slug":"introduction"},{"content":"Overview","slug":"overview"},{"content":"Authentication","slug":"authentication"},{"content":"Error Codes","slug":"error-codes"}],"owner":"412470","collectionId":"c0122ef0-60c4-44ef-8499-38920cf17c32","publishedId":"S11BzN24","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2019-02-17T20:47:59.000Z"},"item":[{"name":"Authentication","item":[{"name":"Auth URL","id":"f67c269f-4c3e-44d2-81ea-ea23480b2b4a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8080/v1/auth/url","description":"

Gets the authentication URL from Dropbox.

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","auth","url"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"b85eeb0e-45a1-4e3e-bbef-366013eacd75","name":"Auth URL","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/v1/auth/url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Sun, 17 Feb 2019 20:43:55 GMT"},{"key":"Content-Length","value":"161"}],"cookie":[],"responseTime":null,"body":"\"https://api.dropbox.com/oauth2/authorize?client_id=1234567890&redirect_uri=http%3A%2F%2Flocalhost%3A8080%2Fv1%2Fauth%2Flogin&response_type=code\""}],"_postman_id":"f67c269f-4c3e-44d2-81ea-ea23480b2b4a"},{"name":"Auth Login","id":"73325ffa-a0d5-42cb-b5cd-42b51da7d406","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:8080/v1/auth/login?code={{code}}","description":"

Logs into the system.

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","auth","login"],"host":["localhost"],"query":[{"key":"code","value":"{{code}}"}],"variable":[]}},"response":[{"id":"b177802b-34bd-4808-a039-fd3d584bb98f","name":"Auth Login","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://localhost:8080/v1/auth/login?code={{code}}","protocol":"http","host":["localhost"],"port":"8080","path":["v1","auth","login"],"query":[{"key":"code","value":"{{code}}"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"text/plain; charset=utf-8"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Date","value":"Sun, 17 Feb 2019 20:44:42 GMT"},{"key":"Content-Length","value":"16"}],"cookie":[],"responseTime":null,"body":"{\n \"token\": \"1234567890\",\n \"uid\": \"dbid:1234567890\"\n}"}],"_postman_id":"73325ffa-a0d5-42cb-b5cd-42b51da7d406"}],"id":"83473d20-fcc2-47d1-9417-a8717f190075","_postman_id":"83473d20-fcc2-47d1-9417-a8717f190075","description":""},{"name":"Categories","item":[{"name":"Get Categories","event":[{"listen":"test","script":{"id":"1777e71f-3dd3-478f-a842-aacfca501ab1","exec":[""],"type":"text/javascript"}},{"listen":"prerequest","script":{"id":"0ee0d95b-e76e-4340-bef2-16ec2dcf2914","exec":["pm.environment.set(\"columnName\", \"name\");"],"type":"text/javascript"}}],"id":"053ec2dd-979e-417c-91ff-71af8be928ee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:8080/v1/categories?sort={{columnName}}","description":"

Gets the categories. For example:

# Order by name:\nhttp://localhost:8080/v1/categories?sort=name\n\n# Order by name in reverse order:\nhttp://localhost:8080/v1/categories?sort=-name\n

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","categories"],"host":["localhost"],"query":[{"key":"sort","value":"{{columnName}}"}],"variable":[]}},"response":[{"id":"aacade2d-3965-4a51-a6c0-8845eb5c5e6e","name":"Get Categories","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/v1/categories"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Sun, 17 Feb 2019 20:36:20 GMT"},{"key":"Content-Length","value":"337"}],"cookie":[],"responseTime":null,"body":"{\n \"items\": [\n {\n \"id\": \"5c668587c840077322455015\",\n \"userId\": \"5c668587c840077322455014\",\n \"name\": \"Category 1\",\n \"imageIds\": []\n },\n {\n \"id\": \"5c668587c840077322455019\",\n \"userId\": \"5c668587c840077322455014\",\n \"name\": \"Category 2\",\n \"imageIds\": []\n },\n {\n \"id\": \"5c668587c84007732245501c\",\n \"userId\": \"5c668587c840077322455014\",\n \"name\": \"Category 3\",\n \"imageIds\": []\n }\n ],\n \"numPages\": 1\n}"}],"_postman_id":"053ec2dd-979e-417c-91ff-71af8be928ee"},{"name":"Get Subcategories","event":[{"listen":"prerequest","script":{"id":"2c97d106-ab28-4a32-9cf5-c5caa1756a96","exec":["pm.environment.set(\"categoryId\", \"5c6c4f99cccaab5a97b75905\");","pm.environment.set(\"columnName\", \"name\");",""],"type":"text/javascript"}}],"id":"764f0dd4-8d78-412d-9942-c6cca50cbd1c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:8080/v1/categories/{{categoryId}}/categories?sort={{columnName}}","description":"

Gets the subcategories of a given category. For example:

# Order by name:\nhttp://localhost:8080/v1/categories/5c6da2106798e1f9a1950096/categories?sort=name\n\n# Order by name in reverse order:\nhttp://localhost:8080/v1/categories/5c6da2106798e1f9a1950096/categories?sort=-name\n

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","categories","{{categoryId}}","categories"],"host":["localhost"],"query":[{"key":"sort","value":"{{columnName}}"}],"variable":[]}},"response":[{"id":"17ba25a5-7872-4dff-b161-a05ad7b6f741","name":"Get Subcategories","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/v1/categories/{{categoryId}}/categories"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Sun, 17 Feb 2019 20:38:08 GMT"},{"key":"Content-Length","value":"235"}],"cookie":[],"responseTime":null,"body":"{\n \"items\": [\n {\n \"id\": \"5c668587c84007732245501a\",\n \"userId\": \"5c668587c840077322455014\",\n \"name\": \"Category 21\",\n \"imageIds\": []\n },\n {\n \"id\": \"5c668587c84007732245501b\",\n \"userId\": \"5c668587c840077322455014\",\n \"name\": \"Category 22\",\n \"imageIds\": []\n }\n ],\n \"numPages\": 1\n}"}],"_postman_id":"764f0dd4-8d78-412d-9942-c6cca50cbd1c"},{"name":"Create Category","event":[{"listen":"prerequest","script":{"id":"cc7bbf54-8f6e-4e72-bd0f-f83fdf39a06b","exec":[""],"type":"text/javascript"}},{"listen":"test","script":{"id":"f5aa671b-379d-46ce-a120-a55896c48411","exec":[""],"type":"text/javascript"}}],"id":"910cea02-bde5-4f41-ada8-127b19c5d0c9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n\t\"Name\": \"New Category\"\n}"},"url":"http://localhost:8080/v1/categories","description":"

Creates a category.

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","categories"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"910cea02-bde5-4f41-ada8-127b19c5d0c9"},{"name":"Read Category","event":[{"listen":"prerequest","script":{"id":"70a59fb3-fd9a-4ce1-8e3e-d89b2a94e047","exec":["pm.environment.set(\"categoryId\", \"5c6c4f99cccaab5a97b75905\");"],"type":"text/javascript"}}],"id":"014e6f31-23e2-408f-9d67-6d01b6bfc049","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:8080/v1/categories/{{categoryId}}","description":"

Reads a category.

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","categories","{{categoryId}}"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"6840a432-526c-4884-863c-e080e1b6e745","name":"Read Category","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/v1/categories/{{categoryId}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Sun, 17 Feb 2019 20:43:00 GMT"},{"key":"Content-Length","value":"104"}],"cookie":[],"responseTime":null,"body":"{\n \"id\": \"5c668587c840077322455015\",\n \"userId\": \"5c69b2af1af1513d13bd5b03\",\n \"name\": \"Category 1\",\n \"imageIds\": []\n}"}],"_postman_id":"014e6f31-23e2-408f-9d67-6d01b6bfc049"},{"name":"Update Category","event":[{"listen":"prerequest","script":{"id":"4a638a22-ded4-43fb-8636-552c36995d19","exec":["pm.environment.set(\"categoryId\", \"5c6d834641cd2241524de87a\");"],"type":"text/javascript"}}],"id":"4b1253cc-4385-4e21-864d-e2bbeae25832","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\t\"name\": \"Edited category\"\r\n}"},"url":"http://localhost:8080/v1/categories/{{categoryId}}","description":"

Updates a category.

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","categories","{{categoryId}}"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"4b1253cc-4385-4e21-864d-e2bbeae25832"},{"name":"Delete Category","event":[{"listen":"prerequest","script":{"id":"d3d91293-7473-4aae-bfd1-962fa30eb08d","exec":[""],"type":"text/javascript"}}],"id":"e087eaad-d0d5-4670-837a-c47be58dc4f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"http://localhost:8080/v1/categories/{{categoryId}}","description":"

Deletes a category.

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","categories","{{categoryId}}"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"e087eaad-d0d5-4670-837a-c47be58dc4f4"}],"id":"eaca3f2e-ef02-40fb-a638-738d41cd2cca","_postman_id":"eaca3f2e-ef02-40fb-a638-738d41cd2cca","description":""},{"name":"Images","item":[{"name":"Upload Image","event":[{"listen":"prerequest","script":{"id":"cc7bbf54-8f6e-4e72-bd0f-f83fdf39a06b","exec":[""],"type":"text/javascript"}},{"listen":"test","script":{"id":"f5aa671b-379d-46ce-a120-a55896c48411","exec":[""],"type":"text/javascript"}}],"id":"c0a16d9f-da7d-47d1-a33b-acea18aefd09","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"

Image file

\n","type":"file","value":null}]},"url":"http://localhost:8080/v1/images","description":"

Uploads an image and adds it to a category.

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","images"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"c0a16d9f-da7d-47d1-a33b-acea18aefd09"},{"name":"Add Image to Category","event":[{"listen":"prerequest","script":{"id":"cc7bbf54-8f6e-4e72-bd0f-f83fdf39a06b","exec":["pm.environment.set(\"categoryId\", \"5c6c4f99cccaab5a97b75905\");","pm.environment.set(\"imageId\", \"5c6d1bd441cd224404618160\");",""],"type":"text/javascript"}},{"listen":"test","script":{"id":"f5aa671b-379d-46ce-a120-a55896c48411","exec":[""],"type":"text/javascript"}}],"id":"0806537d-55b1-4fa8-ac3b-ab7705f13dd2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"PUT","header":[],"url":"http://localhost:8080/v1/categories/{{categoryId}}/images/{{imageId}}","description":"

Adds an image to a given category.

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","categories","{{categoryId}}","images","{{imageId}}"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"0806537d-55b1-4fa8-ac3b-ab7705f13dd2"},{"name":"Remove Image from Category","event":[{"listen":"prerequest","script":{"id":"cc7bbf54-8f6e-4e72-bd0f-f83fdf39a06b","exec":["pm.environment.set(\"catId\", \"5c6c4f99cccaab5a97b75905\");","pm.environment.set(\"imgId\", \"5c6d1bd441cd224404618160\");",""],"type":"text/javascript"}},{"listen":"test","script":{"id":"f5aa671b-379d-46ce-a120-a55896c48411","exec":[""],"type":"text/javascript"}}],"id":"96dcd8a8-4cb8-4946-ac1d-428c648cfe2e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{token}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"http://localhost:8080/v1/categories/{{categoryId}}/images/{{imageId}}","description":"

Removes an image from a given category.

\n","urlObject":{"protocol":"http","port":"8080","path":["v1","categories","{{categoryId}}","images","{{imageId}}"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"96dcd8a8-4cb8-4946-ac1d-428c648cfe2e"}],"id":"c033d2e3-a7d7-4c8a-9625-0647190d498a","_postman_id":"c033d2e3-a7d7-4c8a-9625-0647190d498a","description":""}],"event":[{"listen":"prerequest","script":{"id":"5fc0857e-3d13-4859-985d-ce308304514a","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"e0736768-8497-41bb-bb3d-282f2d802308","type":"text/javascript","exec":[""]}}]}