Implementation
Technical
Inputs for Glasses Production
User Experience Best Practices
Impact Report
FAQs
Developer References
/customers/{cid}/events/
/customers/
/images/{image-id}/
/recommendations/by-cid/{cid}/
/customers/{cid}/faces/
/customers/{cid}/tastes/
/customers/{cid}/
/clusters/
/clusters/{cluster_id}/
/customers/{cid}/clusters/
/products/{pid}/
/products/
/search/customers/store_id/
Models
Powered by Stoplight

DittoIQ API

  • Version: 1.1.0
  • Host: iq.yourcompany.api.ditto.com/api/1.1
  • Protocols: https

The DittoIQ API is an HTTP-based RESTful API, using JSON-encoded messages to pass arguments and return responses to

  • Manage customer (identified by a cid) and product information
  • Collect customer events from web and native applications
  • Upload customers images for facial analysis
  • Provide personalized product recommendations ranked from high to low score
  • Provide facial analysis information
    • Face width category
    • Facial shapes categories with assigned probabilities per each facial shape
    • Frame type suggestions
  • Provide ability to apply partner-specific business logic to “slice and dice” recommended results, e.g. Return recommendations in a certain price bracket or from a certain brand

The API allows management of stored data via CRUD (CREATE, READ, UPDATE, DELETE) operations and uses the HTTPS protocol only.