# 사용자 지정 지표 버전 저장 표준 URL: https://sosoapi.ai/ko/docs/api/analytics-api-reporting-metrics-save 계약: sha256:d6e85a113e8fb367 사용자 지정 지표 버전 저장. 명시적으로 지정된 검토 완료 데이터셋과 버전을 사용하며, 데이터 소스를 자동으로 새로 고치지 않습니다. 렌더링 입력은 파이프를 통해 sosoapi report render --output FILE 명령으로 전달할 수 있습니다. POST /analytics-api/reporting/metrics/save ## 인증 및 권한 - **허용 자격 증명 유형:** user_session, delegated_oauth, personal_access_token - **위임된 기능:** agent:operate - **최소 Workspace 역할:** editor - **접근 범위:** 이 사용자에게 접근 권한이 있는 리소스 - **모든 Workspace 동의 필요:** 아니요 - **상태 변경:** 예 - **작업 완료 시:** synchronous_http_response 토큰은 소유자의 권한만 사용할 수 있습니다. 각 요청은 Workspace 멤버십, 리소스 소유권, 선택 Workspace, 부여 기능을 확인합니다. core와 full 프로필은 표시 도구를 바꾸며 접근 권한은 부여하지 않습니다. ## 요청 필드 ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "workspace_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "formula": { "type": "object", "properties": { "contractVersion": { "type": "string", "const": "analytics-metric/v1" }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "workspaceId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "version": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "expression": { "type": "string", "minLength": 1, "maxLength": 1000 }, "fields": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" }, "selector": { "type": "object", "properties": { "platform": { "type": "string", "enum": [ "facebook", "instagram", "threads", "youtube" ] }, "key": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$" }, "definition": { "type": "string", "minLength": 1, "maxLength": 500 }, "unit": { "type": "string", "enum": [ "count", "seconds", "minutes", "percent", "ratio" ] }, "grain": { "type": "string", "enum": [ "post", "account" ] }, "measurementKind": { "type": "string", "enum": [ "lifetime", "snapshot", "period", "unknown" ] }, "nativePeriod": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "platform", "key", "definition", "unit", "grain", "measurementKind", "nativePeriod", "timezone" ], "additionalProperties": false }, "aggregation": { "type": "string", "enum": [ "single", "sum" ] } }, "required": [ "identifier", "selector", "aggregation" ], "additionalProperties": false } }, "rounding": { "type": "object", "properties": { "decimalPlaces": { "type": "integer", "minimum": 0, "maximum": 8 }, "mode": { "type": "string", "const": "half_away_from_zero" } }, "required": [ "decimalPlaces", "mode" ], "additionalProperties": false } }, "required": [ "contractVersion", "id", "workspaceId", "name", "version", "expression", "fields", "rounding" ], "additionalProperties": false }, "dataset": { "type": "object", "properties": { "contractVersion": { "type": "string", "const": "analytics-report/v1" }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reviewedAt": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "selection": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "accountIds": { "minItems": 1, "maxItems": 50, "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "platforms": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "string", "enum": [ "facebook", "instagram", "threads", "youtube" ] } }, "startDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "endDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "timezone": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "workspaceId", "accountIds", "platforms", "startDate", "endDate", "timezone" ], "additionalProperties": false }, "accounts": { "maxItems": 50, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "workspaceId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "platform": { "type": "string", "enum": [ "facebook", "instagram", "threads", "youtube" ] }, "name": { "type": "string", "maxLength": 500 }, "connectionStatus": { "type": "string", "maxLength": 100 }, "healthMessage": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "workspaceId", "platform", "name" ], "additionalProperties": false } }, "posts": { "maxItems": 1000, "type": "array", "items": { "type": "object", "properties": { "social_post_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "workspace_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "social_account_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "platform": { "type": "string", "enum": [ "instagram", "facebook", "threads", "youtube" ] }, "provider_post_id": { "type": "string", "minLength": 1, "maxLength": 512 }, "provider_published_at": { "anyOf": [ { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, { "type": "null" } ] }, "content_format": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100 }, { "type": "null" } ] }, "permalink": { "anyOf": [ { "type": "string", "maxLength": 2048, "format": "uri" }, { "type": "null" } ] }, "provider_state": { "type": "string", "enum": [ "available", "deleted", "unavailable", "unknown" ] }, "first_seen_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "last_seen_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "scheduled_post_id": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "provenance": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "instagram", "facebook", "threads", "youtube" ] }, "source": { "type": "string", "enum": [ "provider_api", "provider_webhook", "publication_outcome", "backfill" ] }, "source_job_id": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "provider_api_version": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 200 }, { "type": "null" } ] }, "schema_version": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 200 }, { "type": "null" } ] } }, "required": [ "provider", "source", "source_job_id", "provider_api_version", "schema_version" ], "additionalProperties": false } }, "required": [ "social_post_id", "workspace_id", "social_account_id", "platform", "provider_post_id", "provider_published_at", "content_format", "permalink", "provider_state", "first_seen_at", "last_seen_at", "scheduled_post_id", "provenance" ], "additionalProperties": false } }, "sources": { "maxItems": 30, "type": "array", "items": { "type": "object", "properties": { "accountId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "platform": { "type": "string", "enum": [ "facebook", "instagram", "threads", "youtube" ] }, "resourceKind": { "type": "string", "enum": [ "account", "post" ] }, "providerResourceId": { "anyOf": [ { "type": "string", "maxLength": 512 }, { "type": "null" } ] }, "requestId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "status": { "type": "string", "enum": [ "available", "partial", "not_returned", "unsupported", "permission_required", "threshold_not_met", "no_data", "failed", "pending", "stale" ] }, "reason": { "anyOf": [ { "type": "string", "maxLength": 8000 }, { "type": "null" } ] }, "envelope": { "anyOf": [ { "type": "object", "properties": { "contract_version": { "type": "string", "const": "provider-insights/v1" }, "request_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "platform": { "type": "string", "enum": [ "facebook", "instagram", "threads", "youtube" ] }, "resource": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "account", "post" ] }, "social_account_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "provider_resource_id": { "type": [ "string", "null" ] } }, "required": [ "kind", "social_account_id", "provider_resource_id" ], "additionalProperties": false }, "provider_api_version": { "type": "string", "minLength": 1, "maxLength": 100 }, "fetched_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "status": { "type": "string", "enum": [ "available", "partial", "unavailable" ] }, "availability": { "minItems": 1, "maxItems": 64, "type": "array", "items": { "type": "object", "properties": { "scope": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "type": "string", "enum": [ "available", "partial", "not_returned", "unsupported", "permission_required", "threshold_not_met", "no_data", "failed" ] }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 }, "diagnostics": { "type": "object", "properties": { "http_status": { "type": "integer", "minimum": 0, "maximum": 599 }, "failed_step": { "type": "string", "minLength": 1, "maxLength": 200 }, "provider_code": { "anyOf": [ { "type": "number" }, { "type": "string", "maxLength": 100 } ] }, "provider_subcode": { "anyOf": [ { "type": "number" }, { "type": "string", "maxLength": 100 } ] }, "provider_type": { "type": "string", "maxLength": 200 }, "is_transient": { "type": "boolean" }, "provider_request_id": { "type": "string", "maxLength": 200 }, "access": { "type": "object", "properties": { "login_mode": { "type": "string", "enum": [ "instagram_login", "facebook_login", "threads_user" ] }, "provider_host": { "type": "string", "maxLength": 200 }, "required_permissions": { "maxItems": 16, "type": "array", "items": { "type": "string", "maxLength": 100 } }, "current_connection_policy_permissions": { "maxItems": 16, "type": "array", "items": { "type": "string", "maxLength": 100 } }, "granted_permissions": { "anyOf": [ { "maxItems": 128, "type": "array", "items": { "type": "string", "maxLength": 100 } }, { "type": "null" } ] }, "grant_evidence": { "type": "string", "enum": [ "exact", "unknown" ] }, "permission_state": { "type": "string", "enum": [ "granted", "missing", "unknown" ] }, "grant_observed_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "app_access": { "type": "string", "const": "unverified" }, "next_step": { "type": "string", "maxLength": 1500 } }, "required": [ "login_mode", "provider_host", "required_permissions", "current_connection_policy_permissions", "granted_permissions", "grant_evidence", "permission_state", "app_access", "next_step" ], "additionalProperties": false } }, "required": [ "http_status" ], "additionalProperties": false } }, "required": [ "scope", "status" ], "additionalProperties": false } }, "provider_data": { "anyOf": [ {}, { "type": "null" } ] }, "requested_date_range": { "anyOf": [ { "type": "object", "properties": { "start_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "end_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false }, { "type": "null" } ] }, "cache": { "type": "object", "properties": { "authoritative": { "type": "boolean", "const": false }, "status": { "type": "string", "enum": [ "stored", "hit", "bypassed" ] }, "expires_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" } }, "required": [ "authoritative", "status", "expires_at" ], "additionalProperties": false } }, "required": [ "contract_version", "request_id", "platform", "resource", "provider_api_version", "fetched_at", "status", "availability", "provider_data", "requested_date_range", "cache" ], "additionalProperties": false }, { "type": "null" } ] }, "metrics": { "maxItems": 5000, "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "minLength": 1, "maxLength": 150 }, "definition": { "type": "string", "minLength": 1, "maxLength": 1000 }, "unit": { "type": "string", "minLength": 1, "maxLength": 100 }, "grain": { "type": "string", "enum": [ "post", "account" ] }, "value": { "type": [ "number", "null" ] }, "availability": { "type": "string", "enum": [ "available", "partial", "not_returned", "unsupported", "permission_required", "threshold_not_met", "no_data", "failed", "pending", "stale" ] }, "reason": { "anyOf": [ { "type": "string", "maxLength": 4000 }, { "type": "null" } ] }, "measurement": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "lifetime", "snapshot", "period", "unknown" ] }, "period": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "start": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "end": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "kind", "period", "start", "end", "timezone" ], "additionalProperties": false }, "sourcePath": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "key", "definition", "unit", "grain", "value", "availability", "reason", "measurement", "sourcePath" ], "additionalProperties": false } } }, "required": [ "accountId", "platform", "resourceKind", "providerResourceId", "requestId", "status", "reason", "envelope", "metrics" ], "additionalProperties": false } }, "coverage": { "type": "object", "properties": { "population": { "type": "string", "const": "discovered_posts" }, "postsComplete": { "type": "boolean" }, "nextCursor": { "anyOf": [ { "type": "string", "maxLength": 16384 }, { "type": "null" } ] }, "postLimit": { "type": "integer", "minimum": 0, "maximum": 1000 }, "postInsightsLimit": { "type": "integer", "minimum": 0, "maximum": 20 }, "omittedPostInsights": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "notes": { "maxItems": 50, "type": "array", "items": { "type": "string", "maxLength": 2000 } } }, "required": [ "population", "postsComplete", "nextCursor", "postLimit", "postInsightsLimit", "omittedPostInsights", "notes" ], "additionalProperties": false }, "customMetrics": { "maxItems": 50, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "version": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expression": { "type": "string", "minLength": 1, "maxLength": 1000 }, "definition": { "type": "string", "maxLength": 1000 }, "unit": { "type": "string", "maxLength": 100 }, "grain": { "type": "string", "enum": [ "post", "account", "compatible_sum" ] }, "rounding": { "type": "object", "properties": { "decimalPlaces": { "type": "integer", "minimum": 0, "maximum": 8 }, "mode": { "type": "string", "const": "half_away_from_zero" } }, "required": [ "decimalPlaces", "mode" ], "additionalProperties": false }, "inputs": { "maxItems": 5000, "type": "array", "items": { "type": "object", "properties": { "requestId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "sourcePath": { "type": "string", "maxLength": 2000 }, "value": { "type": [ "number", "null" ] }, "availability": { "type": "string", "enum": [ "available", "partial", "not_returned", "unsupported", "permission_required", "threshold_not_met", "no_data", "failed", "pending", "stale" ] } }, "required": [ "requestId", "sourcePath", "value", "availability" ], "additionalProperties": false } }, "value": { "type": [ "number", "null" ] }, "availability": { "type": "string", "enum": [ "available", "partial", "not_returned", "unsupported", "permission_required", "threshold_not_met", "no_data", "failed", "pending", "stale" ] }, "reason": { "anyOf": [ { "type": "string", "maxLength": 4000 }, { "type": "null" } ] }, "formula": { "type": "object", "properties": { "contractVersion": { "type": "string", "const": "analytics-metric/v1" }, "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "workspaceId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "version": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "expression": { "type": "string", "minLength": 1, "maxLength": 1000 }, "fields": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" }, "selector": { "type": "object", "properties": { "platform": { "type": "string", "enum": [ "facebook", "instagram", "threads", "youtube" ] }, "key": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$" }, "definition": { "type": "string", "minLength": 1, "maxLength": 500 }, "unit": { "type": "string", "enum": [ "count", "seconds", "minutes", "percent", "ratio" ] }, "grain": { "type": "string", "enum": [ "post", "account" ] }, "measurementKind": { "type": "string", "enum": [ "lifetime", "snapshot", "period", "unknown" ] }, "nativePeriod": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "platform", "key", "definition", "unit", "grain", "measurementKind", "nativePeriod", "timezone" ], "additionalProperties": false }, "aggregation": { "type": "string", "enum": [ "single", "sum" ] } }, "required": [ "identifier", "selector", "aggregation" ], "additionalProperties": false } }, "rounding": { "type": "object", "properties": { "decimalPlaces": { "type": "integer", "minimum": 0, "maximum": 8 }, "mode": { "type": "string", "const": "half_away_from_zero" } }, "required": [ "decimalPlaces", "mode" ], "additionalProperties": false } }, "required": [ "contractVersion", "id", "workspaceId", "name", "version", "expression", "fields", "rounding" ], "additionalProperties": false }, "calculation": { "type": "object", "properties": { "contractVersion": { "type": "string", "const": "analytics-metric/v1" }, "workspaceId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "datasetId": { "type": "string", "minLength": 1, "maxLength": 100 }, "formulaId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "version": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expression": { "type": "string", "maxLength": 1000 }, "rounding": { "type": "object", "properties": { "decimalPlaces": { "type": "integer", "minimum": 0, "maximum": 8 }, "mode": { "type": "string", "const": "half_away_from_zero" } }, "required": [ "decimalPlaces", "mode" ], "additionalProperties": false }, "value": { "type": [ "number", "null" ] }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "type": "string", "enum": [ "available", "not_returned" ] }, "code": { "type": "string", "enum": [ "ok", "invalid_expression", "missing_input", "incompatible_input", "zero_denominator", "numeric_limit", "workspace_mismatch", "ambiguous_input", "unknown_exclusion" ] }, "reason": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 500 }, { "type": "null" } ] }, "excludedInputIds": { "maxItems": 5000, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1500 } }, "inputs": { "maxItems": 5000, "type": "array", "items": { "type": "object", "properties": { "inputId": { "type": "string", "minLength": 1, "maxLength": 1500 }, "selector": { "type": "object", "properties": { "platform": { "type": "string", "enum": [ "facebook", "instagram", "threads", "youtube" ] }, "key": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$" }, "definition": { "type": "string", "minLength": 1, "maxLength": 500 }, "unit": { "type": "string", "enum": [ "count", "seconds", "minutes", "percent", "ratio" ] }, "grain": { "type": "string", "enum": [ "post", "account" ] }, "measurementKind": { "type": "string", "enum": [ "lifetime", "snapshot", "period", "unknown" ] }, "nativePeriod": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "platform", "key", "definition", "unit", "grain", "measurementKind", "nativePeriod", "timezone" ], "additionalProperties": false }, "value": { "type": [ "number", "null" ] }, "availability": { "type": "string", "enum": [ "available", "partial", "not_returned", "unsupported", "permission_required", "threshold_not_met", "no_data", "failed", "pending", "stale" ] }, "reason": { "anyOf": [ { "type": "string", "maxLength": 8000 }, { "type": "null" } ] }, "measurement": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "lifetime", "snapshot", "period", "unknown" ] }, "period": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "start": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "end": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "kind", "period", "start", "end", "timezone" ], "additionalProperties": false }, "requestId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "sourcePath": { "type": "string", "minLength": 1, "maxLength": 1000 }, "accountId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "providerResourceId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 512 }, { "type": "null" } ] }, "fetchedAt": { "anyOf": [ { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, { "type": "null" } ] }, "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" }, "included": { "type": "boolean" } }, "required": [ "inputId", "selector", "value", "availability", "reason", "measurement", "requestId", "sourcePath", "accountId", "providerResourceId", "fetchedAt", "identifier", "included" ], "additionalProperties": false } } }, "required": [ "contractVersion", "workspaceId", "datasetId", "formulaId", "name", "version", "expression", "rounding", "value", "unit", "status", "code", "reason", "excludedInputIds", "inputs" ], "additionalProperties": false } }, "required": [ "id", "name", "version", "expression", "definition", "unit", "grain", "rounding", "inputs", "value", "availability", "reason" ], "additionalProperties": false } } }, "required": [ "contractVersion", "id", "reviewedAt", "selection", "accounts", "posts", "sources", "coverage", "customMetrics" ], "additionalProperties": false }, "excluded_input_ids": { "maxItems": 5000, "type": "array", "items": { "type": "string", "maxLength": 4000 } }, "expected_version": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 1000000 }, { "type": "null" } ] }, "mutation_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "calculation": { "type": "object", "properties": { "contractVersion": { "type": "string", "const": "analytics-metric/v1" }, "workspaceId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "datasetId": { "type": "string", "minLength": 1, "maxLength": 100 }, "formulaId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "version": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "expression": { "type": "string", "maxLength": 1000 }, "rounding": { "type": "object", "properties": { "decimalPlaces": { "type": "integer", "minimum": 0, "maximum": 8 }, "mode": { "type": "string", "const": "half_away_from_zero" } }, "required": [ "decimalPlaces", "mode" ], "additionalProperties": false }, "value": { "type": [ "number", "null" ] }, "unit": { "type": "string", "minLength": 1, "maxLength": 200 }, "status": { "type": "string", "enum": [ "available", "not_returned" ] }, "code": { "type": "string", "enum": [ "ok", "invalid_expression", "missing_input", "incompatible_input", "zero_denominator", "numeric_limit", "workspace_mismatch", "ambiguous_input", "unknown_exclusion" ] }, "reason": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 500 }, { "type": "null" } ] }, "excludedInputIds": { "maxItems": 5000, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1500 } }, "inputs": { "maxItems": 5000, "type": "array", "items": { "type": "object", "properties": { "inputId": { "type": "string", "minLength": 1, "maxLength": 1500 }, "selector": { "type": "object", "properties": { "platform": { "type": "string", "enum": [ "facebook", "instagram", "threads", "youtube" ] }, "key": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_]{0,100}$" }, "definition": { "type": "string", "minLength": 1, "maxLength": 500 }, "unit": { "type": "string", "enum": [ "count", "seconds", "minutes", "percent", "ratio" ] }, "grain": { "type": "string", "enum": [ "post", "account" ] }, "measurementKind": { "type": "string", "enum": [ "lifetime", "snapshot", "period", "unknown" ] }, "nativePeriod": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "platform", "key", "definition", "unit", "grain", "measurementKind", "nativePeriod", "timezone" ], "additionalProperties": false }, "value": { "type": [ "number", "null" ] }, "availability": { "type": "string", "enum": [ "available", "partial", "not_returned", "unsupported", "permission_required", "threshold_not_met", "no_data", "failed", "pending", "stale" ] }, "reason": { "anyOf": [ { "type": "string", "maxLength": 8000 }, { "type": "null" } ] }, "measurement": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "lifetime", "snapshot", "period", "unknown" ] }, "period": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "start": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "end": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "timezone": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "kind", "period", "start", "end", "timezone" ], "additionalProperties": false }, "requestId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] }, "sourcePath": { "type": "string", "minLength": 1, "maxLength": 1000 }, "accountId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "providerResourceId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 512 }, { "type": "null" } ] }, "fetchedAt": { "anyOf": [ { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, { "type": "null" } ] }, "identifier": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" }, "included": { "type": "boolean" } }, "required": [ "inputId", "selector", "value", "availability", "reason", "measurement", "requestId", "sourcePath", "accountId", "providerResourceId", "fetchedAt", "identifier", "included" ], "additionalProperties": false } } }, "required": [ "contractVersion", "workspaceId", "datasetId", "formulaId", "name", "version", "expression", "rounding", "value", "unit", "status", "code", "reason", "excludedInputIds", "inputs" ], "additionalProperties": false } }, "required": [ "workspace_id", "formula", "dataset", "expected_version", "mutation_id" ], "additionalProperties": false } ``` ## 응답 및 완료 성공 HTTP 상태: 200 HTTP 성공 응답은 완료가 아닌 접수를 뜻할 수 있습니다. 백그라운드 작업은 반환 ID를 저장하고 완료까지 같은 작업을 확인하세요. 예약 또는 접수 게시물은 플랫폼이 확인해야 게시 완료입니다. 클라이언트 시간 초과로 결과를 판단할 수 없습니다. ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "definition": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "kind": { "type": "string", "enum": [ "metric", "template" ] }, "workspace_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "definition_id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "version": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "name": { "type": "string", "maxLength": 100 }, "payload": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} }, "source_object_key": { "type": [ "string", "null" ] }, "source_sha256": { "type": [ "string", "null" ] }, "created_at": { "type": "string", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$", "format": "date-time" }, "archived": { "type": "boolean" } }, "required": [ "id", "kind", "workspace_id", "definition_id", "version", "name", "payload", "source_object_key", "source_sha256", "created_at", "archived" ] }, "replayed": { "type": "boolean" } }, "required": [ "definition", "replayed" ] } ``` ## 오류 및 안전한 재시도 HTTP 상태와 응답 본문을 확인하세요. 400 검증 오류에는 ZodError가 포함될 수 있으며, 핸들러 오류는 error, message, code 필드를 사용합니다. 진단용 request_id 또는 x-request-id를 자격 증명 없이 보관하세요. 401/403 접근 오류는 재시도 전에 해결하고 429에는 Retry-After를 따르세요. 쓰기 결과가 불확실하거나 5xx를 반환하면 먼저 기존 결과를 읽으세요. 지원하는 작업에서만 멱등성 키를 재사용하세요. 재시도 동작은 작업마다 다르며 정확히 한 번 전송을 보장하지 않습니다. ## 예제 예제는 스키마로 확인한 가상 값을 사용합니다. ID를 사용 권한이 있는 값으로, 미디어를 준비된 에셋으로, 날짜를 확인된 게시 시각으로 바꾸세요. 쓰기 제출 전에 계정 적격성을 확인하세요. 이 페이지는 API 요청을 보내지 않습니다. 서버에서 SOSOAPI_ACCESS_TOKEN에 이 작업이 허용하는 자격 증명을 설정하고 브라우저 코드에 넣지 마세요. 에이전트는 sosoapi auth login으로 브라우저 로그인하며 CLI가 자격 증명을 갱신하게 하세요. request.json ```json { "workspace_id": "11111111-1111-4111-8111-111111111111", "formula": { "contractVersion": "analytics-metric/v1", "id": "11111111-1111-4111-8111-111111111111", "workspaceId": "11111111-1111-4111-8111-111111111111", "name": "example", "version": 1, "expression": "example", "fields": [], "rounding": { "decimalPlaces": 0, "mode": "half_away_from_zero" } }, "dataset": { "contractVersion": "analytics-report/v1", "id": "11111111-1111-4111-8111-111111111111", "reviewedAt": "2099-01-15T09:00:00Z", "selection": { "workspaceId": "11111111-1111-4111-8111-111111111111", "accountIds": [ "11111111-1111-4111-8111-111111111111" ], "platforms": [ "facebook" ], "startDate": "2099-01-15", "endDate": "2099-01-15", "timezone": "UTC" }, "accounts": [ { "id": "11111111-1111-4111-8111-111111111111", "workspaceId": "11111111-1111-4111-8111-111111111111", "platform": "facebook", "name": "Fictional report account" } ], "posts": [], "sources": [], "coverage": { "population": "discovered_posts", "postsComplete": false, "nextCursor": null, "postLimit": 0, "postInsightsLimit": 0, "omittedPostInsights": 0, "notes": [] }, "customMetrics": [] }, "expected_version": null, "mutation_id": "11111111-1111-4111-8111-111111111111" } ``` cURL ```bash curl --request POST \ "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/analytics-api/reporting/metrics/save" \ -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ --data-binary @request.json ``` JavaScript ```js // Server-side JavaScript. Do not print tokens or credential-bearing responses. const token = process.env.SOSOAPI_ACCESS_TOKEN; if (!token) throw new Error("Set an accepted credential for this operation"); const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/analytics-api/reporting/metrics/save", { method: "POST", headers: { "Content-Type": "application/json", Authorization: "Bearer " + token }, body: JSON.stringify({ "workspace_id": "11111111-1111-4111-8111-111111111111", "formula": { "contractVersion": "analytics-metric/v1", "id": "11111111-1111-4111-8111-111111111111", "workspaceId": "11111111-1111-4111-8111-111111111111", "name": "example", "version": 1, "expression": "example", "fields": [], "rounding": { "decimalPlaces": 0, "mode": "half_away_from_zero" } }, "dataset": { "contractVersion": "analytics-report/v1", "id": "11111111-1111-4111-8111-111111111111", "reviewedAt": "2099-01-15T09:00:00Z", "selection": { "workspaceId": "11111111-1111-4111-8111-111111111111", "accountIds": [ "11111111-1111-4111-8111-111111111111" ], "platforms": [ "facebook" ], "startDate": "2099-01-15", "endDate": "2099-01-15", "timezone": "UTC" }, "accounts": [ { "id": "11111111-1111-4111-8111-111111111111", "workspaceId": "11111111-1111-4111-8111-111111111111", "platform": "facebook", "name": "Fictional report account" } ], "posts": [], "sources": [], "coverage": { "population": "discovered_posts", "postsComplete": false, "nextCursor": null, "postLimit": 0, "postInsightsLimit": 0, "omittedPostInsights": 0, "notes": [] }, "customMetrics": [] }, "expected_version": null, "mutation_id": "11111111-1111-4111-8111-111111111111" }) }); const result = await response.json(); // Check response.ok, the operation-specific body and completion state before continuing. ``` CLI ```bash npx sosoapi api post /analytics-api/reporting/metrics/save < request.json ``` 합성 응답 예제 ```json { "definition": { "id": "11111111-1111-4111-8111-111111111111", "kind": "metric", "workspace_id": "11111111-1111-4111-8111-111111111111", "definition_id": "11111111-1111-4111-8111-111111111111", "version": 1, "name": "example", "payload": {}, "source_object_key": "example", "source_sha256": "example", "created_at": "2099-01-15T09:00:00Z", "archived": false }, "replayed": false } ``` ## 관련 도구 및 안내 MCP: sosoapi_save_custom_metric [API 참조](https://sosoapi.ai/ko/docs/api)