Créer un commentaire depuis un appareil C2C

import requests
url = "https://api.frame.io/v2/devices/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": "string",
  "completed": false,
  "completed_at": "string",
  "completer_id": "string",
  "has_replies": false,
  "id": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
  "like_count": 0,
  "owner": {
    "digest_frequency": "0 * * * *",
    "features_seen": "string",
    "profile_image_original": "string",
    "image_32": "string",
    "image_128": "string",
    "from_google": false,
    "mfa_enforced_at": "string",
    "email": "jane@frame.io",
    "bio": "string",
    "name": "Jane Doe",
    "image_64": "string",
    "timezone_value": "America/New_York",
    "account_id": "string",
    "updated_at": "2025-12-19T14:55:05.324848Z",
    "image_256": "string",
    "_type": "user",
    "context": {
      "company_name": "string",
      "id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "industry": "string",
      "job_title": "string",
      "role": "string",
      "team_size": 2
    },
    "upload_url": "string",
    "location": "string",
    "phone": "string",
    "deleted_at": "string",
    "profile_image": "https://static-assets.frame.io/app/anon.jpg",
    "first_login_at": "2025-09-17T18:09:39.768640Z",
    "joined_via": "organic",
    "email_confirm_by": "string",
    "id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
    "next_digest_date": "2025-09-17T18:09:35.668306Z",
    "email_preferences": "string",
    "last_seen": "string",
    "inserted_at": "2025-09-17T18:09:35.685694Z",
    "from_adobe": true,
    "avatar_color": "yellow",
    "highest_account_role": "string",
    "integrations": [
      "string"
    ],
    "roles": {
      "admin": false,
      "id": "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
      "sales": true,
      "support": true,
      "service_desk": false
    },
    "user_default_color": "#ff409f"
  },
  "owner_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "text": "This is a comment from the camera",
  "timestamp": 33,
  "_type": "comment",
  "anonymous_user_id": "string",
  "aspect_ratio": 1.777778,
  "asset_id": "dddddddd-dddd-dddd-dddd-dddddddddddd",
  "comment_entities": [],
  "deleted_at": "string",
  "device_channel_input_id": "string",
  "duration": 1,
  "fov": 65,
  "frame": 33,
  "inserted_at": "2026-01-28T19:31:40.501158Z",
  "page": 1,
  "parent_id": "string",
  "pitch": 1,
  "private": true,
  "read_count": 0,
  "review_link_id": "string",
  "target_asset_id": "string",
  "text_edited_at": "string",
  "thumb": "string",
  "timestamp_microseconds": 1,
  "updated_at": "2026-01-28T19:31:40.523368Z",
  "yaw": 1
}

Laissez un commentaire sur un asset depuis un appareil C2C associé.

Authentification

AuthorizationBearer

Authentification bearer de la forme Bearer <token>, où token est votre jeton d’authentification.

Paramètres de chemin

asset_idstringRequisformat: "uuid"

Asset ID

Requête

Comment to create or update

textstringRequis

The body of the comment.

timestampdoubleOptionnel

Timestamp for the comment, in frames, starting at 0. Comments can be "global" to an asset in which you don't provide the timestamp.

Réponse

C2C Comment success response

annotationstringOptionnel

completedbooleanOptionnel

completed_atstringOptionnel

completer_idstringOptionnelformat: "uuid"

has_repliesbooleanOptionnel

idstringOptionnelformat: "uuid"

like_countintegerOptionnel

ownerobjectOptionnel

Modèle d’utilisateur

owner_idstringOptionnelformat: "uuid"

textstringOptionnel

timestampintegerOptionnel

_typestringOptionnel

anonymous_user_idstringOptionnelformat: "uuid"

aspect_ratiodoubleOptionnel

asset_idstringOptionnelformat: "uuid"

comment_entitieslist of anyOptionnel

deleted_atstringOptionnel

device_channel_input_idstringOptionnel

durationintegerOptionnel

fovintegerOptionnel

framedoubleOptionnel

inserted_atstringOptionnel

pageintegerOptionnel

parent_idstringOptionnelformat: "uuid"

pitchintegerOptionnel

privatebooleanOptionnel

read_countintegerOptionnel

review_link_idstringOptionnelformat: "uuid"

target_asset_idstringOptionnelformat: "uuid"

text_edited_atstringOptionnel

thumbstringOptionnel

timestamp_microsecondsintegerOptionnel

updated_atstringOptionnel

yawintegerOptionnel

Erreurs

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error