For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
C2C API は、いくつかの重要なテクノロジーに依存しており、ユーザーは、統合プロジェクトを開始する前に、これらのテクノロジーを理解しておく必要があります。この記事の見出しを参照してください。よく知らない用語がある場合は、このガイドを参考にして、知識のギャップに対処してください。特定の概念に関する課題に直面した場合は、当社チームが追加のリソースとサポートを提供することができます。
知っておくべきこと
C2C API と正常に統合させるには、次の基本的な知識が必要です。
Networking
TLS/SSL, TCP/IP protocols and networking fundamentals
HTTPS
Implementation of secure HTTPS requests
Auth
Authentication and Authorization methodologies
ネットワークの基本と用語集
Frame.io API は、その中核で Frame.io のサーバーとお客様のデバイスやアプリケーションとの通信を実現しますが、そのためにはすべての操作でネットワークでのやり取りが必要です。
C2C API を実装する際には、サードパーティのライブラリを使用してネットワークの詳細を処理する場合もあるかもしれません。しかし、ネットワークコンポーネントは実環境でのエラーの原因となる場合が多く、Frame.io のサーバーとやり取りする際には、基盤となるプロセスを理解することが重要です。重要な用語を簡潔にまとめた用語集を以下に示します。
TCP/IP
Transmission Control Protocol / Internet Protocol - standardized components and layers that enable global data transfer. For more information, we recommend this accessible, high-level resource.
TLS/SSL
Transport Layer Security / Secure Socket Layer - while technically different, they’re commonly referenced interchangeably today. TLS represents the evolution of SSL, though the original acronym remains widely used. For more information about TLS, consult this overview.
A computer that provides or stores information for other computers. When you access Frame.io through a web browser, your browser requests content from Frame.io’s server, which responds accordingly. Every action within Frame.io triggers a communication between your browser and our server, which processes your request and returns appropriate results. When uploading media to Frame.io, you’re sending it to our servers.
Client
A client application requests information from or sends data to a server. When implementing the C2C API, you’ll be developing a C2C client.
HTTP/S
Hypertext Transfer Protocol / Secure - operates within the application layer of the TCP/IP model. The difference between HTTP and HTTPS is security—HTTPS incorporates TLS/SSL verification into network communications. HTTP has evolved through various versions, establishing new standards over time. Version 1.1 remains the global standard and should be used for Frame.io API communications.
RESTful API
REST (Representational State Transfer) is a design methodology for developing APIs based on HTTP request-response patterns. REST often serves as shorthand for the general approach of using HTTP for program-to-program interaction—as distinguished from browser-webpage communication—even when the API doesn’t strictly adhere to REST principles.
JSON
JavaScript Object Notation - a standardized data exchange format. Though initially developed for JavaScript objects, it has become a universal standard for networked communications. The C2C API delivers responses as JSON data.
AWS S3
Amazon’s Simple Storage Service provides cloud-based data storage solutions. S3 stores Frame.io’s video and audio media, and serves as the destination for integration uploads.
HTTP/S 要求
HTTP は web 閲覧に広く使用されており、ほぼすべての web サイトアドレスの先頭に表記されています。HTTP(Hypertext Transfer Protocol)は、標準化されたコンピューター間通信プロトコルを確立します。
Authentication verifies that requests come from claimed sources. When you log into websites with username/password credentials, you’re authenticating yourself by demonstrating password knowledge. Multi-factor authentication—such as receiving verification codes via text message—represents additional authentication mechanisms.
Authorization
Authorization confirms permission to perform specific actions. When you add collaborators to Frame.io projects or Google documents, you’re authorizing their access. Frame.io or Google have previously authenticated these users’ identities, enabling you to confidently authorize their participation.
OAuth
OAuth (Open Authorization) provides a standardized framework for authorization management by integrating with third-party authentication services.
Scopes
Scopes define the authorized actions available to users. When connecting devices to Frame.io, you’ll request and receive specific scopes that authorize particular operations. For example, the asset_create scope permits asset creation and uploading. Conceptually, scopes function as permission sets.