Integrations: Figma

🔒 Create Figma integration from OAuth callback.

Create Figma integration from OAuth callback.

Access: authorized (10 ) · Scope: write

Allows: integration:design (все обязательны; без ресурса)

TypeScript (copy-paste)

POST /integration/figma/create

<details open><summary><b>Params</b></summary>
export interface IntegrationFigmaCreateParams {
  code: string
  state: string
}
</details> <details open><summary><b>Body (Partial)</b></summary>
// Patch-body: все поля опциональны (Valid.Patch)
export type IntegrationFigmaCreateBody = Partial<Resp_integration_figma_create>

export interface IntegrationFigmaCreateBodyFields {
  ID?: string
  cID?: string
  status?: MeetingIntegration_Status
  account?: {
  id: string
  email?: string | null
  name?: string | null
  handle?: string | null
} | null
  credentials?: {
  accessToken: string
  refreshToken: string
  expirationTimeIso: string
  scopes: Array<string>
} | null
  errorCode?: FigmaIntegration_ErrorCode | null
  createdDT?: string
  createdUID?: string
  /** Unix timestamp in milliseconds */
  updTS?: number
  updUID?: string
}
</details> <details open><summary><b>Response</b></summary>
export type IntegrationFigmaCreateResponse = IServerResponse<Resp_integration_figma_create>

export interface IServerResponse<T = any> {
  code: number
  data: T
  srvTS: number
  rkey: string
}
</details>

Полный файл типов: /docs/types · raw: /docs/api-types.ts

post/integration/figma/create

Request

  • Base URL: http://localhost
  • URL: http://localhost/integration/figma/create
  • Auth: one of:
    • API key in header sid and API key in header rts and API key in header sig
    • HTTP bearer

Query parameters

codestring required

Можно передать header code (сервер мержит headers+query)

statestring required

Можно передать header state (сервер мержит headers+query)

Headers

devIDstring uuid required

UUID устройства клиента

tzstring required
Example:Europe/Moscow

Таймзона клиента (IANA или offset)

appstring required
Example:kosmodrom-web

Имя клиентского приложения

appVerstring required
Example:1.0.0

Версия клиента

rKeystring

Уникальный ключ запроса для логов/саппорта

Request body

IDstring uuid
cIDstring uuid
status1 | -1

enabled = 1, warn = -1

errorCode1 | 2

IntegrationStatusError = 1, AlreadyConnectedError = 2

createdDTstring date-time
createdUIDstring uuid
updTSinteger

Unix timestamp in milliseconds

updUIDstring

Response

OK — IServerResponse<Resp_integration_figma_create>

codeinteger required
dataRespIntegrationFigmaCreate required

Empty response object

srvTSinteger required

Server timestamp (ms)

rkeystring required

Request key

Example response

{
  "code": 200
}

Changes

No recorded changes to this operation across all 1 revision of this API.