Skip to main content

Trustana Portal Overview

The Trustana Portal is the web-based interface where business users configure, manage, and operate the AI-powered product enrichment platform. This is where the actual business logic and user workflows happen, separate from the programmatic OpenAPIs.

Portal vs OpenAPIs: Understanding the Distinction​

Trustana Portal (Web User Interface)​

The portal provides user-friendly interfaces for:

  • Configuration management (categories, attributes, import profiles, export templates)
  • AI enrichment task triggering and monitoring
  • Quality assurance and content review
  • User management

OpenAPIs (Programmatic Interface)​

The APIs provide entry and exit points for developers who need to build their own business logic layer:

  • Product data import (programmatic alternative to portal uploads)
  • Enriched data export (for ETL pipelines)
  • Product CRUD operations (create, read, update, delete)
  • Configuration data retrieval (read-only access to portal settings)

Core Portal Capabilities​

Configuration & Setup​

Category Management

  • Category Tree Builder: Visual hierarchy creation and management

Attributes

  • Attribute Types: Text, number, date, dropdown, multiselect, and measurement types

Mappings to Categories

  • Category Assignment: Map attributes to specific categories in the hierarchy

Content Enrichment Success​

Input and Enrichable Attributes

  • Input Attributes: Define base product data used for context
  • Enrichable Configuration: Mark which attributes can be AI-generated

Locale and Variant Attributes

  • Locale Attributes: Configure language-specific product data
  • Variant Attributes: Set up size, color, and style-specific attributes

Attribute AI Prompt Engineering

  • Custom Prompts: Engineer AI prompts for specific attribute transformation
  • Source Instructions: Guide AI on where and how to find attribute values

HTML Templates

  • Template Builder: Reference your attributes to build web-ready descriptions at scale
  • Dynamic Content: Auto-populate templates with enriched attribute data

Operations & Workflows​

AI Enrichment Management

  • Enrichment Triggering: Initiate AI processing for product batches
  • Source Configuration: Set up preferred data sources and crawling rules
  • Quality Scoring: AI confidence metrics and quality indicators

Review & Quality Assurance

  • AI Summary: Highlighting data sources and their derived attribute values
  • Approve & Reject: Approve & reject attribute values or web sources
  • Set Products as Ready: Mark products ready for export

What's Not in Scope​

Important Limitations:

This API portal focuses on product data integration workflows. The following capabilities require portal access and are not available via API:

  • AI Enrichment Triggering: Enrichment tasks are initiated through the Trustana portal
  • Configuration Management: Category trees and attributes are set up via the web interface
  • Quality Assurance: Content review and approval happens in the portal
  • User Management: Team member access and permissions are portal-managed

Developer ETL Pipeline Responsibilities:​

Your Integration Responsibilities
  • Configuration Prerequisites: Verify that your organization has completed the essential category tree and attribute setup through the Portal interface
  • Destination Formatting: Transform Trustana data to match your target system's schema
  • Syntax Conversion: Convert JSON responses to your required format (XML, CSV, etc.)
  • Field Mapping: Map Trustana attributes to your system's field structure
  • Data Validation: Implement validation rules for your specific business requirements
  • Error Handling: Build retry logic and error recovery for failed transformations
  • Scheduling: Design ETL jobs that sync data according to your business needs

Trustana delivers enriched product data; your ETL pipeline handles the final transformation and destination delivery.

API Architecture Overview​

API Overview​

The OpenAPIs provide four main categories of programmatic access:

  • Configuration APIs - Read-only access to attributes and their category associations (POST /v1/attributes/search)
  • Product CRUD APIs - Full lifecycle management of product data (POST /v1/products, GET /v1/products/{id}, POST /v1/products/bulk)
  • Product Search APIs - Advanced filtering and querying capabilities (POST /v1/products/search)
  • Media APIs - Image upload, retrieval, and product associations (POST /v1/upload/prepare, GET /v1/files/{id})

For detailed endpoint documentation, authentication setup, and code examples, see the Getting Started Guide.

Authentication & Security​

All API access requires authentication and follows enterprise security standards. For complete authentication setup, security guidelines, and API key management, see the Getting Started Guide.

Performance & Limits​

API usage is subject to rate limiting and account-based quotas to ensure platform stability. For detailed rate limits, performance expectations, and optimization guidelines, see the Getting Started Guide.

Development Environment​

Testing and development practices are covered in detail in the Getting Started Guide.

Next Steps​

Understanding both the Portal's business logic capabilities and the OpenAPIs' programmatic access points is essential for successful integration:

  1. Getting Started - Set up authentication and make your first API calls
  2. Configuration Flow - Understand how categories and attributes drive the system
  3. Creating Products - Learn product creation workflows and best practices
  4. Enrichment Service - Deep dive into AI-powered content generation

For comprehensive API endpoint documentation, visit our API Reference.