Crea un commento | Frame.io API Documentation

import requests
url = "https://api.frame.io/v2/assets/asset_id/comments"
payload = { "text": "string" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "annotation": "[...]",
  "completed": false,
  "completed_at": "2020-07-15T17:30:00.906305Z",
  "completer_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "has_replies": true,
  "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "like_count": 10,
  "owner": {
    "email": "jane@frame.io",
    "name": "Jane Doe",
    "account_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
    "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
  },
  "owner_id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
  "text": "This is a comment.",
  "timestamp": 60
}

Lascia un commento su una risorsa

Autenticazione

AuthorizationBearer

Autenticazione bearer nella forma Bearer <token>, dove token è il tuo token di autenticazione.

Parametri di percorso

asset_idstringObbligatorioformat: "uuid"

Richiesta

Comment to create or update

textstringObbligatorio

The body of the comment.

annotationstringOpzionale

Serialized list of geometry and/or drawing data.

Learn more here

Serialized list of geometry and/or drawing data. Learn more [here](https://developer.frame.io/docs/workflows-assets/working-with-annotations)

pageintegerOpzionale

Page number for a comment (documents only).

timestampdoubleOpzionale

Timestamp for the comment, in frames, starting at 0.

Comments can “global” to an asset in which you don’t provide the timestamp, or if you’re reviewing a “document” like a PDF then you would use page instead of timestamp to identify where the comment belongs.

durationintegerOpzionale

Used to produce range-based comments, this is the duration measured in frames.

privatebooleanOpzionale

Set to true to make your comment a “Team-only Comment” that won’t be visible to anonymous reviewers or Collaborators.

pitchintegerOpzionaleDeprecated

Pitch measurement for the comment (360deg video only).

yawintegerOpzionaleDeprecated

Yaw measurement for the comment (360deg video only).

Risposta

Comment success response

annotationstringOpzionale

completedbooleanOpzionale

completed_atstringOpzionale

completer_idstringOpzionaleformat: "uuid"

has_repliesbooleanOpzionale

idstringOpzionaleformat: "uuid"

like_countintegerOpzionale

ownerobjectOpzionale

Modello utente

owner_idstringOpzionaleformat: "uuid"

textstringOpzionale

timestampintegerOpzionale

Errori

401

Unauthorized Error

404

Not Found Error