Getting Started with the Web API

The PICTOFiT Content Service provides all the complex logic to generate smart 2D & 3D models and semantic information from images. It is accessible via a REST web service from your client applications or from our content management web application.

The main entity of the service are products. For each item you want us to process, you first have to create a Product object with the correct product or asset type like GARMENT_2D. Product entries can contain one or more Configuration entries. Configurations are for example different colors of the same product. Once you have created the Configuration you can upload data (usually images) to it. As a final step after you’ve finished uploading, the configuration needs to be marked as ready_for_processing. This tells our system that all the information is there and we can start processing the item.

After the processing has finished, you can retrieve the generated assets using the results entry of a Configuration endpoints. We also provide web hooks that notify you when an asset is ready. Please be aware that our system is not intended to host the assets for your applications. More details on the different resulting assets can be found here: Output Asset Type Specification

The REST service can be accessed via api.cs.pictofit.com/v1.5/ . This is only possible if you have a valid access token. How to retrieve one is described in the next section Authentication

Please contact our sales team to get your account for the system.