> This page is for Piattaforma, version Versione precedente.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 sperimentale: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Versione precedente: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# Come usare i link di revisione

## Panoramica




I link di revisione sono una funzionalità essenziale di Frame.io per raccogliere risorse e inviarle in modo da ricevere dei feedback tramite un singolo URL, senza richiedere accesso esplicito a team o progetti. In pratica, sono una rappresentazione delle risorse all'interno di un singolo progetto, quindi questa guida presuppone quanto segue:




1. Hai già delle risorse a disposizione o sai come [caricare le risorse tramite API](/workflows-assets/uploading-assets).
2. Conosci l'ID del progetto in cui desideri creare il link di revisione.
3. Il tuo obiettivo è ottenere un URL da distribuire al di fuori di Frame.io (ad esempio tramite e-mail, chat o altri canali).





### Concetti fondamentali

I link di revisione appartengono esclusivamente ai progetti e una risorsa in un link di revisione è rappresentata come tipo di risorsa speciale chiamato **elemento del link di revisione**, che conterrà sempre il `review_link_id` e l'`asset_id` a cui è abbinato, nonché l'intero payload della risorsa associata.

Sebbene gli elementi del link di revisione non debbano essere tracciati o gestiti autonomamente, rappresentano una struttura utile per comprendere l'intero flusso di lavoro descritto in questa guida. Di conseguenza, la gerarchia di un link di revisione ha questo aspetto:





Progetto > Link di revisione > Elemento del link di revisione > Riferimento risorsa





### Ambiti richiesti




Prima di iniziare questa guida, assicurati di avere un token che includa almeno i seguenti ambiti:




| Ambito | Motivo |
| ---------- | ---------- |
| **Progetti:** lettura | Non strettamente necessario, ma serve per recuperare il `root_asset_id` di un progetto. |
| **Risorse:** lettura | Non strettamente necessario, ma serve per navigare verso gli `asset_id` tramite API. |
| **Link di revisione:** creazione, lettura, aggiornamento | Crea il link di revisione, aggiungi risorse e recupera informazioni (soprattutto se il tracciamento avviene in un altro sistema). |



## 1. Raccogli i tuoi ID




Per creare un link di revisione, devi raccogliere:




1. Un ID progetto
2. Gli ID di una o più risorse in quel progetto

Se non hai a portata di mano l'ID progetto, ma hai accesso a Frame.io e sai quale progetto vuoi utilizzare, puoi vedere l'ID nella barra degli indirizzi quando navighi al progetto: `https://app.frame.io/projects/<project-id></project-id>`. Allo stesso modo, se non hai a portata di mano gli ID delle risorse, vai alle risorse che ti interessano e richiama gli ID dalla barra degli indirizzi nel browser: `https://app.frame.io/player/<asset-id></asset-id>`.

## 2. Crea il link di revisione

Per creare la base per il link, devi determinare le opzioni che ti interessano per il link di revisione e generarle in un payload JSON. Come minimo, devi creare un nome (`name`). Ecco un esempio di payload che, per comodità, mostra le impostazioni predefinite per ogni campo se scegli di generare con un solo `name`:

```json
{    
    "name": "New Review Link",
    "allow_approvals": true,
    "current_version_only": false,
    "enable_downloading": true,
    "expires_at": null,
    "has_password": false
}
```

Ora effettua una chiamata `POST` autorizzata `https://api.frame.io/v2/projects/:id/review_links`, utilizzando il payload come corpo della richiesta.

Complimenti!Hai appena creato un link di revisione. Nel corpo della risposta ci sono due attributi importanti:



* **`id`**: si tratta del riferimento al contenitore del link. Conservalo, perché ti servirà quando aggiungerai le risorse nel passaggio successivo.
* **`short_url`**: si tratta dell'URL per il link di revisione che distribuirai. Avrà un aspetto simile a `https://f.io/_aBcDeF`




## 3. Aggiungi risorse al link di revisione

Ora che hai un link di revisione, è il momento di aggiungervi alcune risorse. Per iniziare, prepara un payload JSON con un array di stringhe degli `id` delle tue risorse:

```json
{
    "asset_ids":[
        "<asset-id-1>",
        "<asset-id-2>",
        "<asset-id-3>"
    ]
}
```

Ora esegui una chiamata `POST` autorizzata a `https://api.frame.io/v2/review_links/:id/assets`, utilizzando l'`id` del link di revisione del passaggio 2 nel percorso e gli `id` delle tue risorse nel corpo della richiesta. Fatto! Ora puoi distribuire il tuo `short_url`.