{"info":{"_postman_id":"e9f0cfa0-679f-4849-8106-e87dfae562d2","name":"Blippar CV Sample","description":"The Blippar Computer Vision Platform uses ai to enable businesses to easily add image processing and tagging to their apps, websites and products. Our API's allow for your users to upload images or scan objects in the real world through the phone’s camera, so your platform can provide relevant information/content on what is seen in real time. \n\nThe Blippar CV API's include: General Word Cloud, 3k Ojbect Labels, Brand Logos, Automobiles, Public Figures/Celebrities, Athletes, Facial (_Individuals_), Dogs/Birds/Flowers, General Food, Video Games, Movies, Art/Artists, Food Packages, and Landmarks.\n> Join our Developer program and build Computer Vision into your own Apps! The Blippar CV APIs allow you to harnesses the power of artificial intelligence and deep learning to make your products more powerful!\n\nRegister for your API keys within the [Blippar Computer Vision Developer Portal](https://developer.blippar.com/portal/vs-api/index/)\n\n# Getting Started\n\nWelcome to Blippar Computer Vision API. Here you will find the step-by-step guide to help you build an application using the Blippar Computer Vision APIs. This API documentation includes what query parameters the API will accept with an example JSON response.\n\n###### Follow Below Steps\n\n* Step 1 : Register for a developer account\n* Step 2 : Get your API key\n* Step 3 : Generating Auth tokens\n* Step 4 : Sending images and recieving a response\n\n> ### Disclaimer:\n> You cannot run the sample requests in this guide as-is. Replace call-specific parameters such as tokens and IDs with your own values.\n\n\n### Step 1 : Register for a developer account \n###### (if you already have a developer account: skip to Step 2)\n\n\nRegister for a developer account [click here](https://accounts.blippar.com/signup/free?next=https:%2F%2Fdeveloper.blippar.com%2Fportal%2Fvs-api%2Findex%2F%3Fview_api_key%3Dtrue)\n\nPlease provide all necessary information to register an account. \n\nAfter successful registration you will recieve an email to confirm your account. Click the button (or copy/paste the link into your browser). Once confirmed you will be brought to the Blippar HUB backend. \n\n### Step 2 : Get your API key\nRequest your API keys:\n- Visit [https://developer.blippar.com/portal/vs-api/index](https://developer.blippar.com/portal/vs-api/index) and click the \"View your API key\" button. If you are not logged in it will ask you to login, otherwise it will load the \"Plans\" section of your account settings. For security purposes only your Client ID is available here. \n\nOnce your API key is enabled, you will recieve an email with your Client ID & Client Secret application keys. Keep these keys safe as they will be required authorize your session to fetch the data from the Blippar server endpoints. \n\nTo view API key within the Blippar HUB, click the icon with your initials in the upper right hand corner. Click \"My Account\", then click into the \"Plans\" Section finally click the \"View your API key\" button. For security purposes this will only load your Client ID.\n\n>Note : Do not disclose your keys.\n\n### Step 3 : Generating Auth tokens\n\nBlippar uses oAuth 2.0, a protocol that lets your app make API calls using your developer account by generating an access token. The Client ID and Client Secret obtained during Step 2 will be used in the OAuth flow. \n\n###### The oAuth Flow : Authorization Request\n\nYour app will need to use the following URL to make a GET request for an Auth Token:\n\nhttps://bauth.blippar.com/token?grant_type=client_credentials&client_id=CLIENT_ID&client_secret=CLIENT_SECRET\n\n\nThe following values are required to be passed as GET parameters:\n\n* grant_type = client\\_credentials \n * _(the type of access being requested)_\n* client\\_id = _(Client ID issued in step 2.)_ \n* client\\_secret = _(Client Secret issued in step 2.)_\n\n\n###### The oAuth Flow : Token Response\n\nA succussful Authorization Request will receive a JSON response containing the Access Token, Expiration time, and the token type.\n\n**Response :**\n```javascript\n{\n    \"access_token\": \"<ACCESS_TOKEN_HASH>\",\n    \"expires_in\": 86400,\n    \"token_type\": \"Bearer\"\n}\n```\n\n**Token expiration**\n\nAccess tokens/request_keys expire 24 hours after they are issued. Once a token expires your app must request a new access token, using the method above. \n\n### Step 4 : Sending images and recieving a response\n\n> Note: Bearer token used in example below is the access_token issued in step 3\n\nYour app will need to use the following URL to make a POST request sending an image file in the body:\n\nhttps://bapi-vs.blippar.com/v1/imageLookup\n\nThe following values are required to be passed as HEADER parameters:\n\n* \"Authorization\": \"Bearer ACCESS\\_TOKEN\\_HASH\" \n\nWithin the BODY of the request set the content type to _\"multipart/form-data\"_ and send:\n* input\\_image = FILE\\_PATH TO IMAGE FILE","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json"},"item":[{"name":"Auth Request","id":"de603f79-ca37-4b57-a56a-db5998793284","request":{"method":"GET","header":[],"url":{"raw":"https://bauth.blippar.com/token?grant_type=client_credentials&client_id=CLIENT_ID&client_secret=CLIENT_SECRET","protocol":"https","host":["bauth","blippar","com"],"path":["token"],"query":[{"key":"grant_type","value":"client_credentials"},{"key":"client_id","value":"CLIENT_ID"},{"key":"client_secret","value":"CLIENT_SECRET"}]},"description":"An example oAuth request using Blippar CV Client ID and Client Secret"},"response":[],"_postman_id":"de603f79-ca37-4b57-a56a-db5998793284"},{"name":"Visual Search - File","id":"a13e5753-e3cb-4b5d-aeee-123e66bf3390","request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer <ACCESS_TOKEN_HASH>"},{"key":"LatLong","value":""},{"key":"LatLongAccuracy","value":""},{"key":"Language","value":""},{"key":"DeviceOS","value":""},{"key":"DeviceType","value":""},{"key":"DeviceVersion","value":""},{"key":"UniqueID","value":"sampleTestID"},{"key":"Accelerometer","value":""},{"key":"DeviceOrientation","value":""},{"key":"CameraSensorOrientation","value":""},{"key":"Gyro","value":""}],"body":{"mode":"formdata","formdata":[{"key":"input_image","type":"file","src":{},"value":null}]},"url":"https://bapi-vs.blippar.com/v1/imageLookup","description":"An example request using the auto api endpoint, requires a Bearer token generated using Auth Request"},"response":[],"_postman_id":"a13e5753-e3cb-4b5d-aeee-123e66bf3390"}]}