Criar um comentário | 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
}

Deixar comentário em um ativo

Autenticação

AuthorizationBearer

Autenticação bearer na forma Bearer <token>, onde token é seu token de autenticação.

Parâmetros de caminho

asset_idstringObrigatórioformat: "uuid"

Solicitação

Comment to create or update

textstringObrigatório

The body of the comment.

annotationstringOpcional

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)

pageintegerOpcional

Page number for a comment (documents only).

timestampdoubleOpcional

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.

durationintegerOpcional

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

privatebooleanOpcional

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

pitchintegerOpcionalDeprecated

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

yawintegerOpcionalDeprecated

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

Resposta

Comment success response

annotationstringOpcional

completedbooleanOpcional

completed_atstringOpcional

completer_idstringOpcionalformat: "uuid"

has_repliesbooleanOpcional

idstringOpcionalformat: "uuid"

like_countintegerOpcional

ownerobjectOpcional

Modelo de usuário

owner_idstringOpcionalformat: "uuid"

textstringOpcional

timestampintegerOpcional

Erros

401

Unauthorized Error

404

Not Found Error