Home Modelli Tag Genera Documentazione Accedi

Documentazione API

L'API Rexiew ti consente di cercare cose, leggere recensioni, generare recensioni AI, inviare recensioni umane e incorporare widget di recensioni su qualsiasi sito. Tutte le risposte sono in JSON.

Contenuti

URL di Base
Autenticazione
Gestione degli Errori
Endpoint Pubblici
Endpoint Autenticati
Endpoint widget
- Badge
- Riepilogo
- Widget Completo
- Ricerca
- Smartlink
Guida all'incorporamento di Smartlink

URL di Base

https://rexiew.com/api

Tutti gli endpoint sono relativi a questo URL di base.

Autenticazione

Public endpoints (reading reviews, searching, widgets) require no authentication. Endpoints that create or modify data require a JWT Bearer token.

To get a token, call POST /auth/login with your email and password. Include the token in subsequent requests:

Authorization: Bearer <access_token>

Access tokens expire after 1 hour. Use POST /auth/refresh with your refresh token to get a new one.

Gestione degli Errori

Errors return a JSON object with an error field and an appropriate HTTP status code.

{
  "error": "Invalid model_id"
}

Code	Meaning
400	Bad request / validation error
401	Unauthorized / invalid token
402	Insufficient credits
403	Forbidden / tier too low
404	Resource not found
409	Conflict (duplicate)
410	Model retired
429	Rate limit exceeded
502	Upstream LLM error

Endpoint Pubblici

Nessuna autenticazione richiesta.

GET /health

Verifica se l'API è in esecuzione.

Risposta

{
  "status": "ok",
  "service": "Rexiew API",
  "version": "1.0.0"
}

GET /models

Elenca tutti i modelli LLM con requisiti di livello e stato attivo. Se autenticato, include se ogni modello è accessibile per il tuo livello di abbonamento.

Risposta

{
  "models": [
    {
      "id": 19,
      "slug": "claude-opus-4-6",
      "name": "Claude Opus 4.6",
      "description": "The most powerful Claude LLM model.",
      "provider": "anthropic",
      "cost": 1,
      "active": true
    }
  ],
  "user_tier": "free"
}

GET /things/search?q={query}

Cerca cose per nome. Restituisce fino a 20 risultati ordinati per numero di recensioni.

Parametri

Param	Type	Description
`q`	string	Search query (min 2 chars)

Risposta

{
  "things": [
    {
      "id": 42,
      "name": "iPhone 16 Pro",
      "type": "product",
      "review_count": 7,
      "avg_rating": 4.3
    }
  ]
}

GET /things/{id}

Ottieni i dettagli di un articolo e tutte le sue recensioni.

Risposta

{
  "thing": {
    "id": 42,
    "name": "iPhone 16 Pro",
    "type": "product",
    "review_count": 7,
    "avg_rating": 4.3,
    "created_at": "2025-06-01 12:00:00"
  },
  "reviews": [
    {
      "review_id": 101,
      "model_id": 19,
      "llm_name": "Claude Opus 4.6",
      "rating": 4.5,
      "review": "The iPhone 16 Pro represents...",
      "created_at": "2025-06-02 09:30:00"
    }
  ]
}

GET /review/{id}

Ottieni i dettagli completi della recensione includendo pro, contro, alternative, punteggi dimensionali e stato di verifica on-chain.

Risposta

{
  "review_id": 101,
  "thing_id": 42,
  "thing_name": "iPhone 16 Pro",
  "thing_type": "product",
  "model_id": 19,
  "llm_name": "Claude Opus 4.6",
  "reviewer_type": "ai",
  "review_aspect": "general",
  "rating": 4.5,
  "review": "The iPhone 16 Pro represents...",
  "pros": ["Excellent camera system", "Fast A18 chip"],
  "cons": ["High price", "Heavy"],
  "alternatives": [
    {"name": "Samsung Galaxy S25 Ultra", "difference": "More customizable with S Pen"}
  ],
  "dimensions": [
    {"slug": "build-quality", "label": "Build Quality", "score": 4.8}
  ],
  "blockinity_verified": false,
  "provifier_tx_digest": null,
  "created_at": "2025-06-02 09:30:00"
}

GET /review/{id}/verify

Verifica la prova on-chain di una recensione umana firmata tramite Provifier.

Risposta

{
  "verified": true,
  "tx_digest": "ABC123...",
  "chain": "sui",
  "data_hash": "sha256...",
  "explorer_url": "https://suiscan.xyz/mainnet/tx/ABC123..."
}

Endpoint Autenticati

These endpoints require a JWT Bearer token in the Authorization header.

POST /auth/login

Autentica con email e password. Restituisce i token di accesso e aggiornamento JWT.

Corpo della Richiesta

{
  "email": "user@example.com",
  "password": "yourpassword"
}

Risposta

{
  "access_token": "eyJ...",
  "refresh_token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "user": {
    "id": 1,
    "email": "user@example.com",
    "role": "user",
    "credit_balance": 500
  }
}

POST /auth/register

Crea un nuovo account. La password deve avere almeno 10 caratteri.

Corpo della Richiesta

{
  "email": "newuser@example.com",
  "password": "securepassword"
}

Response 201 Created

{
  "access_token": "eyJ...",
  "refresh_token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "user": {
    "id": 2,
    "email": "newuser@example.com",
    "role": "user",
    "credit_balance": 0
  }
}

POST /auth/refresh

Scambia un refresh token valido con nuovi token di accesso e refresh.

Corpo della Richiesta

{
  "refresh_token": "eyJ..."
}

Risposta

{
  "access_token": "eyJ...",
  "refresh_token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 3600
}

POST /review/resolve Auth

Fase preliminare prima della generazione di una review. Risolve l'input dell'utente a un elemento esistente nel database o suggerisce di crearne uno nuovo. Utilizza internamente un modello AI per il matching.

Corpo della Richiesta

{
  "thing_name": "iPhone 16 Pro",
  "thing_type": "product"
}

Risposta

{
  "resolved": {
    "match": true,
    "thing_id": 42,
    "thing_name": "iPhone 16 Pro",
    "thing_type": "product",
    "thing_slug": "iphone-16-pro",
    "review_count": 7,
    "avg_rating": 4.3
  },
  "candidates": [...],
  "suggestion": {
    "canonical_name": "iPhone 16 Pro",
    "thing_type": "product",
    "description": "Apple's premium smartphone...",
    "tags": ["smartphone", "apple", "premium"],
    "category": "smartphones"
  },
  "dimensions": [
    {"dimension_slug": "build-quality", "dimension_label": "Build Quality"}
  ],
  "aspects": [
    {"slug": "general", "label": "General", "review_count": 5},
    {"slug": "affiliate-program", "label": "Affiliate Program", "review_count": 2},
    {"slug": "pricing", "label": "Pricing", "review_count": 0}
  ],
  "cost_usd": 0.002,
  "elapsed_ms": 1200
}

POST /review/generate Auth

Generate an AI review for a thing. Costs 1 credit per review. Active models: Claude Opus 4.6 (ID 19) and GPT 5.4 (ID 25).

Corpo della Richiesta

{
  "thing_name": "iPhone 16 Pro",
  "thing_type": "product",
  "model_id": 19,
  "thing_id": 42,
  "thing_description": "Apple's premium smartphone"
}

Field	Type	Required	Description
`thing_name`	string	Yes*	Name of the thing to review (max 255 chars)
`thing_type`	string	No	product, service, place, brand, or other
`model_id`	int	Yes	19 (Opus 4.6) or 25 (GPT 5.4)
`thing_id`	int	No	If provided, skips resolver and uses this thing directly
`thing_description`	string	No	Description override for new things (max 255 chars)
`review_aspect`	string	No	Aspect to focus on (e.g. "affiliate-program", "pricing"). Defaults to "general"

* Required if thing_id is not provided.

Response 201 Created

{
  "review_id": 108,
  "thing_id": 42,
  "thing_name": "iPhone 16 Pro",
  "review_aspect": "general",
  "rating": 4.5,
  "review": "The iPhone 16 Pro represents...",
  "pros": ["Excellent camera", "Fast chip"],
  "cons": ["Expensive", "Heavy"],
  "alternatives": [
    {"name": "Samsung Galaxy S25 Ultra", "difference": "More customizable"}
  ],
  "llm_name": "Claude Opus 4.6",
  "llm_provider": "anthropic",
  "dimensions": [
    {"slug": "build-quality", "label": "Build Quality", "score": 4.8}
  ],
  "credits_spent": 1,
  "tokens": {"input_tokens": 850, "output_tokens": 620},
  "cost_usd": 0.059,
  "elapsed_ms": 8500
}

POST /review/human Auth

Invia una recensione scritta da un umano. Limitato a 1 per cosa per utente per giorno. Facoltativamente includi un indirizzo wallet per la verifica Blockinity.

Corpo della Richiesta

{
  "thing_id": 42,
  "rating_score": 4.5,
  "review_text": "I've used the iPhone 16 Pro for 3 months now...",
  "review_aspect": "general",
  "dimension_scores": {
    "build-quality": 4.8,
    "value-for-money": 3.5
  },
  "wallet_address": "0x..."
}

Response 201 Created

{
  "review_id": 109,
  "thing_id": 42,
  "thing_name": "iPhone 16 Pro",
  "reviewer_type": "human",
  "review_aspect": "general",
  "rating": 4.5,
  "review": "I've used the iPhone 16 Pro for 3 months now...",
  "dimensions": [
    {"slug": "build-quality", "label": "Build Quality", "score": 4.8}
  ],
  "blockinity_verified": true,
  "canonical_data": "{...}"
}

PATCH /review/{id}/sign Auth

Allega i dati di firma on-chain di Provifier a una recensione umana di tua proprietà. Rende la recensione verificabile dal punto di vista crittografico.

Corpo della Richiesta

{
  "tx_digest": "ABC123...",
  "data_hash": "sha256...",
  "chain": "sui"
}

Risposta

{
  "review_id": 109,
  "signed": true,
  "tx_digest": "ABC123...",
  "chain": "sui",
  "data_hash": "sha256..."
}

GET /review/history?page=1&limit=20 Auth

Ottieni la cronologia delle recensioni dell'utente autenticato, impaginata.

Parametri

Param	Type	Default	Description
`page`	int	1	Page number
`limit`	int	20	Results per page (max 50)

Risposta

{
  "reviews": [...],
  "total": 45,
  "page": 1,
  "limit": 20,
  "pages": 3
}

GET /user/profile Auth

Ottieni il profilo dell'utente autenticato, il saldo crediti e le informazioni sull'abbonamento.

Risposta

{
  "user": {
    "id": 1,
    "email": "user@example.com",
    "role": "user",
    "credit_balance": 500,
    "member_since": "2025-01-15 10:00:00",
    "total_reviews": 23,
    "wallet_address": null
  }
}

POST /auth/wallet-link Auth

Collega un indirizzo di portafoglio blockchain al tuo account per la verifica Blockinity.

Corpo della Richiesta

{
  "wallet_address": "0x..."
}

Risposta

{
  "wallet_address": "0x...",
  "linked": true
}

Endpoint widget

Pubblico, nessuna autenticazione richiesta. Le risposte sono memorizzate nella cache per 5 minuti. Usali per incorporare i dati delle review di Rexiew su siti esterni.

GET /widget/thing/{id}/summary

Riepilogo con i 3 principali snippet di recensioni e punteggi medi per dimensione. Ideale per widget della barra laterale.

Risposta

{
  "thing_id": 42,
  "name": "iPhone 16 Pro",
  "type": "product",
  "avg_rating": 4.3,
  "review_count": 7,
  "dimensions": [
    {"label": "Build Quality", "score": 4.8}
  ],
  "snippets": [
    {
      "review_id": 101,
      "llm_name": "Claude Opus 4.6",
      "rating": 4.5,
      "snippet": "The iPhone 16 Pro represents a significant...",
      "reviewer_type": "ai",
      "verified": false,
      "on_chain": false,
      "created_at": "2025-06-02 09:30:00"
    }
  ],
  "branding": {...}
}

GET /widget/thing/{id}

Payload widget completo: tutte le recensioni con pro, contro, alternative, dimensioni, badge e risposte del proprietario.

Risposta

{
  "thing_id": 42,
  "name": "iPhone 16 Pro",
  "type": "product",
  "website": "https://apple.com/iphone-16-pro",
  "avg_rating": 4.3,
  "review_count": 7,
  "dimensions": [...],
  "reviews": [
    {
      "review_id": 101,
      "model_id": 19,
      "llm_name": "Claude Opus 4.6",
      "rating": 4.5,
      "review": "...",
      "pros": ["..."],
      "cons": ["..."],
      "alternatives": [...],
      "reviewer_type": "ai",
      "badges": ["ai"],
      "dimensions": [
        {"label": "Build Quality", "score": 4.8}
      ],
      "created_at": "2025-06-02 09:30:00"
    }
  ],
  "branding": {...}
}

GET /widget/lookup?source={source}&external_id={id}

Trova un elemento tramite riferimento esterno. Utile per integrazioni che mappano i propri ID ai ID delle cose di Rexiew.

Parametri

Param	Type	Description
`source`	string	Integration source (e.g. "d1rectory")
`external_id`	string	External ID in the source system

Risposta

{
  "thing_id": 42
}

GET /widget/smartlink?q={name}

Ricerca leggera per nome o slug dell'articolo. Restituisce dati compatti per schede di recensione hoverable inline (smartlink). Ideale per incorporare badge di recensione nei contenuti.

Parametri

Param	Type	Description
`q`	string	Thing name (exact match, then fuzzy fallback)
`slug`	string	Thing slug (alternative to q)

Provide either q or slug, not both.

Risposta

{
  "thing_id": 42,
  "name": "iPhone 16 Pro",
  "slug": "iphone-16-pro",
  "type": "product",
  "description": "Apple's premium smartphone with...",
  "avg_rating": 4.3,
  "review_count": 7,
  "snippet": {
    "llm_name": "Claude Opus 4.6",
    "rating": 4.5,
    "text": "The iPhone 16 Pro represents a significant..."
  },
  "url": "https://rexiew.com/thing/iphone-16-pro",
  "branding": {
    "text": "Powered by Rexiew",
    "url": "https://rexiew.com/thing/iphone-16-pro",
    "logo": "https://rexiew.com/img/favicon/favicon-32x32.png"
  }
}

Guida all'incorporamento di Smartlink

Aggiungi schede di recensione interattive a qualsiasi sito web con un singolo tag script e attributi dati. Nessuna chiave API necessaria.

1. Aggiungi lo script

Include the smartlink widget script on your page (ideally before </body>):

<script src="https://rexiew.com/widget/smartlink.js" defer></script>

2. Contrassegna i tuoi link

Use data-rexiew (slug) or data-rexiew-q (name) on any element:

<!-- By slug (recommended, stable) -->
<a data-rexiew="iphone-16-pro">iPhone 16 Pro</a>

<!-- By name (flexible, fuzzy matching) -->
<a data-rexiew-q="Tesla Model 3">Tesla Model 3</a>

3. Fatto

Lo script trova automaticamente tutti gli elementi contrassegnati, recupera i dati delle recensioni dall'API Rexiew e sostituisce ogni link con un badge inline. Al passaggio del mouse (desktop) o al tocco (mobile), viene visualizzata una scheda che mostra:

Nome e tipo dell'oggetto
Valutazione stella e punteggio
Numero di recensioni
Descrizione
Snippet di ultima recensione AI
Collegamento alle recensioni complete su Rexiew

Esempio completo

<!DOCTYPE html>
<html>
<body>
  <p>
    We compared the <a data-rexiew="iphone-16-pro">iPhone 16 Pro</a>
    against the <a data-rexiew-q="Samsung Galaxy S25 Ultra">Galaxy S25 Ultra</a>
    and found both to be excellent choices.
  </p>
  <script src="https://rexiew.com/widget/smartlink.js" defer></script>
</body>
</html>

Supporto SPA

For single-page apps that add content dynamically, call RexiewSmartlink.init() after inserting new elements:

// After dynamically adding data-rexiew elements
RexiewSmartlink.init();

Esempio di Avvio Rapido

Genera la tua prima recensione AI in 3 chiamate API:

# 1. Login
curl -X POST https://rexiew.com/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"yourpassword"}'

# 2. Resolve the thing (optional pre-step)
curl -X POST https://rexiew.com/api/review/resolve \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"thing_name":"iPhone 16 Pro","thing_type":"product"}'

# 3. Generate review with Claude Opus 4.6
curl -X POST https://rexiew.com/api/review/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"thing_name":"iPhone 16 Pro","thing_type":"product","model_id":19}'