Analyse og innsikt

Les egne svar på Threads

Les én offisiell side med egne Threads-svar med nøyaktige lesetillatelser; utelat udokumentert eierskap.

POST /analytics-api/threads-reads/own-replies/query

Kontrakt gjennomgått: 2026-10-23 · sha256:11debf801a5e6096

Les som Markdown Last ned offentlig kontrakt Last ned OpenAPI

Oversikt

Les én offisiell side med egne Threads-svar med nøyaktige lesetillatelser; utelat udokumentert eierskap.

Et vellykket HTTP-svar kan bety at en forespørsel er akseptert fremfor fullført. For bakgrunnsarbeid, lagre returnert ID og kontroller samme operasjon til den er ferdig. Et planlagt eller akseptert innlegg er først publisert når plattformen bekrefter det; et klienttidsavbrudd fastslår ikke resultatet.

Autentisering og tillatelser

Godtatte legitimasjonsklasser: user_session, delegated_oauth, personal_access_token
Delegert funksjon: agent:operate
Minste arbeidsområderolle: viewer
Tilgangsomfang: Ressurser denne brukeren er autorisert til å bruke
Samtykke for alle arbeidsområder kreves: Nei
Endrer tilstand: Nei
Når operasjonen er fullført: bounded official data or explicit unavailable; granted scopes do not establish public App Review approval

Et token kan bare bruke rettighetene eieren har. Hver forespørsel kontrollerer arbeidsområdemedlemskap, ressurseierskap, valgte arbeidsområder og gitte funksjoner. Profilene core og full endrer hvilke verktøy som vises; de gir ikke tilgang.

Forespørselsfelter

Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.

Forespørselsfelter
Felt / gren	Type / påkrevd	Begrensninger
`$`	`object`Påkrevd i forelder	`additionalProperties: false`
`workspace_id`	`string`Påkrevd i forelder	`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`	`string`Påkrevd i forelder	`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)$"`
`since`	`integer`Valgfritt / element	`minimum: 1688540400` `maximum: 9007199254740991`
`until`	`integer`Valgfritt / element	`minimum: 1688540400` `maximum: 9007199254740991`
`limit`	`integer`Valgfritt / element	`minimum: 1` `maximum: 100` `default: 25`
`after`	`string`Valgfritt / element	`minLength: 1` `maxLength: 4096`

Fullstendig JSON Schema

{
  "$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)$"
    },
    "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)$"
    },
    "since": {
      "type": "integer",
      "minimum": 1688540400,
      "maximum": 9007199254740991
    },
    "until": {
      "type": "integer",
      "minimum": 1688540400,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 25,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "after": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096
    }
  },
  "required": [
    "workspace_id",
    "social_account_id"
  ],
  "additionalProperties": false
}

Svar og fullføring

HTTP-statuser ved suksess: 200. Når operasjonen er fullført: bounded official data or explicit unavailable; granted scopes do not establish public App Review approval.

Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.

Svar og fullføring
Felt / gren	Type / påkrevd	Begrensninger
`$`	`object`Påkrevd i forelder	—
`contract_version`	`string`Påkrevd i forelder	`const: "threads-reads/v1"`
`operation`	`string`Påkrevd i forelder	`const: "own_replies"`
`source`	`string`Påkrevd i forelder	`const: "official_threads_api"`
`workspace_id`	`string`Påkrevd i forelder	`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`	`string`Påkrevd i forelder	`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_account_id`	`string`Påkrevd i forelder	`pattern: "^\\d{2,20}$"`
`provider_app_identity`	`string \| null`Påkrevd i forelder	—
`provider_app_identity`anyOf 1	`string`Påkrevd i forelder	`minLength: 1` `maxLength: 100`
`provider_app_identity`anyOf 2	`null`Påkrevd i forelder	—
`oauth_snapshot_id`	`string \| null`Påkrevd i forelder	—
`oauth_snapshot_id`anyOf 1	`string`Påkrevd i forelder	`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)$"`
`oauth_snapshot_id`anyOf 2	`null`Påkrevd i forelder	—
`fetched_at`	`string`Påkrevd i forelder	`format: "date-time"` `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)))$"`
`status`	`string`Påkrevd i forelder	`enum: ["available","partial","unavailable"]`
`unavailable_reason`	`string \| null`Påkrevd i forelder	—
`unavailable_reason`anyOf 1	`string`Påkrevd i forelder	`enum: ["grant_inventory_unknown","missing_permissions","issuing_app_unknown","credential_unavailable","credential_expired","account_unhealthy","provider_denied","provider_rate_limited","provider_unavailable","provider_response_invalid"]`
`unavailable_reason`anyOf 2	`null`Påkrevd i forelder	—
`access`	`object`Påkrevd i forelder	—
`access.required_permissions`	`array`Påkrevd i forelder	`maxItems: 4`
`access.required_permissions[]`	`string`Valgfritt / element	`pattern: "^[a-z][a-z0-9_]{0,99}$"`
`access.missing_permissions`	`array`Påkrevd i forelder	`maxItems: 4`
`access.missing_permissions[]`	`string`Valgfritt / element	`pattern: "^[a-z][a-z0-9_]{0,99}$"`
`access.permission_state`	`string`Påkrevd i forelder	`enum: ["granted","missing","unknown"]`
`access.grant_evidence`	`string`Påkrevd i forelder	`enum: ["exact","unknown"]`
`access.app_access`	`string`Påkrevd i forelder	`const: "unverified"`
`data`	`array`Påkrevd i forelder	`maxItems: 100`
`data[]`	`object`Valgfritt / element	—
`data[].id`	`string`Påkrevd i forelder	`pattern: "^\\d{2,20}$"`
`data[].text`	`string \| null`Påkrevd i forelder	—
`data[].text`anyOf 1	`string`Påkrevd i forelder	`maxLength: 30000`
`data[].text`anyOf 2	`null`Påkrevd i forelder	—
`data[].username`	`string \| null`Påkrevd i forelder	—
`data[].username`anyOf 1	`string`Påkrevd i forelder	`pattern: "^[A-Za-z0-9._]{1,30}$"`
`data[].username`anyOf 2	`null`Påkrevd i forelder	—
`data[].permalink`	`string \| null`Påkrevd i forelder	—
`data[].permalink`anyOf 1	`string`Påkrevd i forelder	`format: "uri"`
`data[].permalink`anyOf 2	`null`Påkrevd i forelder	—
`data[].timestamp`	`string \| null`Påkrevd i forelder	—
`data[].timestamp`anyOf 1	`string`Påkrevd i forelder	`format: "date-time"` `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)))$"`
`data[].timestamp`anyOf 2	`null`Påkrevd i forelder	—
`data[].media_type`	`string \| null`Påkrevd i forelder	—
`data[].media_type`anyOf 1	`string`Påkrevd i forelder	`enum: ["TEXT","TEXT_POST","IMAGE","VIDEO","CAROUSEL_ALBUM","AUDIO","REPOST_FACADE"]`
`data[].media_type`anyOf 2	`null`Påkrevd i forelder	—
`data[].is_reply`	`boolean \| null`Påkrevd i forelder	—
`data[].is_quote_post`	`boolean \| null`Påkrevd i forelder	—
`data[].has_replies`	`boolean \| null`Påkrevd i forelder	—
`data[].root_post_id`	`string \| null`Valgfritt / element	—
`data[].root_post_id`anyOf 1	`string`Valgfritt / element	`pattern: "^\\d{2,20}$"`
`data[].root_post_id`anyOf 2	`null`Valgfritt / element	—
`data[].replied_to_id`	`string \| null`Valgfritt / element	—
`data[].replied_to_id`anyOf 1	`string`Valgfritt / element	`pattern: "^\\d{2,20}$"`
`data[].replied_to_id`anyOf 2	`null`Valgfritt / element	—
`profile`	`object \| null`Påkrevd i forelder	—
`profile`anyOf 1	`object`Påkrevd i forelder	—
`profile.username`anyOf 1	`string`Påkrevd i forelder	`pattern: "^[A-Za-z0-9._]{1,30}$"`
`profile.name`anyOf 1	`string \| null`Påkrevd i forelder	—
`profile.name`anyOf 1 / anyOf 1	`string`Påkrevd i forelder	`maxLength: 200`
`profile.name`anyOf 1 / anyOf 2	`null`Påkrevd i forelder	—
`profile.biography`anyOf 1	`string \| null`Påkrevd i forelder	—
`profile.biography`anyOf 1 / anyOf 1	`string`Påkrevd i forelder	`maxLength: 2000`
`profile.biography`anyOf 1 / anyOf 2	`null`Påkrevd i forelder	—
`profile.is_verified`anyOf 1	`boolean \| null`Påkrevd i forelder	—
`profile.follower_count`anyOf 1	`integer \| null`Påkrevd i forelder	—
`profile.follower_count`anyOf 1 / anyOf 1	`integer`Påkrevd i forelder	`minimum: 0` `maximum: 9007199254740991`
`profile.follower_count`anyOf 1 / anyOf 2	`null`Påkrevd i forelder	—
`profile`anyOf 2	`null`Påkrevd i forelder	—
`locations`	`array`Valgfritt / element	`maxItems: 100`
`locations[]`	`object`Valgfritt / element	—
`locations[].id`	`string`Påkrevd i forelder	`pattern: "^\\d{2,20}$"`
`locations[].name`	`string \| null`Påkrevd i forelder	—
`locations[].name`anyOf 1	`string`Påkrevd i forelder	`maxLength: 200`
`locations[].name`anyOf 2	`null`Påkrevd i forelder	—
`locations[].address`	`string \| null`Påkrevd i forelder	—
`locations[].address`anyOf 1	`string`Påkrevd i forelder	`maxLength: 500`
`locations[].address`anyOf 2	`null`Påkrevd i forelder	—
`locations[].city`	`string \| null`Påkrevd i forelder	—
`locations[].city`anyOf 1	`string`Påkrevd i forelder	`maxLength: 200`
`locations[].city`anyOf 2	`null`Påkrevd i forelder	—
`locations[].country`	`string \| null`Påkrevd i forelder	—
`locations[].country`anyOf 1	`string`Påkrevd i forelder	`maxLength: 200`
`locations[].country`anyOf 2	`null`Påkrevd i forelder	—
`locations[].postal_code`	`string \| null`Påkrevd i forelder	—
`locations[].postal_code`anyOf 1	`string`Påkrevd i forelder	`maxLength: 100`
`locations[].postal_code`anyOf 2	`null`Påkrevd i forelder	—
`root_post_id`	`string`Valgfritt / element	`pattern: "^\\d{2,20}$"`
`target_username`	`string`Valgfritt / element	`pattern: "^[A-Za-z0-9._]{1,30}$"`
`coverage`	`object`Påkrevd i forelder	—
`coverage.complete`	`boolean`Påkrevd i forelder	`const: false`
`coverage.next_cursor`	`string \| null`Påkrevd i forelder	—
`coverage.next_cursor`anyOf 1	`string`Påkrevd i forelder	`minLength: 1` `maxLength: 4096`
`coverage.next_cursor`anyOf 2	`null`Påkrevd i forelder	—
`coverage.omitted_rows`	`integer`Påkrevd i forelder	`minimum: 0` `maximum: 9007199254740991`
`coverage.reasons`	`array`Påkrevd i forelder	`maxItems: 8`
`coverage.reasons[]`	`string`Valgfritt / element	`maxLength: 400`
`quota`	`array`Påkrevd i forelder	`maxItems: 1`
`quota[]`	`object`Valgfritt / element	—
`quota[].provider`	`string`Påkrevd i forelder	`const: "meta"`
`quota[].usage`	`object`Påkrevd i forelder	—
`quota[].usage.call_count`	`number`Valgfritt / element	—
`quota[].usage.total_cputime`	`number`Valgfritt / element	—
`quota[].usage.total_time`	`number`Valgfritt / element	—
`quota[].usage.estimated_time_to_regain_access`	`number`Valgfritt / element	—
`quota[].sources`	`array`Påkrevd i forelder	`maxItems: 2`
`quota[].sources[]`	`string`Valgfritt / element	`enum: ["x-app-usage","x-business-use-case-usage"]`

Fullstendig JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "threads-reads/v1"
    },
    "operation": {
      "type": "string",
      "const": "own_replies"
    },
    "source": {
      "type": "string",
      "const": "official_threads_api"
    },
    "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)$"
    },
    "provider_account_id": {
      "type": "string",
      "pattern": "^\\d{2,20}$"
    },
    "provider_app_identity": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ]
    },
    "oauth_snapshot_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"
        }
      ]
    },
    "fetched_at": {
      "type": "string",
      "format": "date-time",
      "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)))$"
    },
    "status": {
      "type": "string",
      "enum": [
        "available",
        "partial",
        "unavailable"
      ]
    },
    "unavailable_reason": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "grant_inventory_unknown",
            "missing_permissions",
            "issuing_app_unknown",
            "credential_unavailable",
            "credential_expired",
            "account_unhealthy",
            "provider_denied",
            "provider_rate_limited",
            "provider_unavailable",
            "provider_response_invalid"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "access": {
      "type": "object",
      "properties": {
        "required_permissions": {
          "maxItems": 4,
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_]{0,99}$"
          }
        },
        "missing_permissions": {
          "maxItems": 4,
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9_]{0,99}$"
          }
        },
        "permission_state": {
          "type": "string",
          "enum": [
            "granted",
            "missing",
            "unknown"
          ]
        },
        "grant_evidence": {
          "type": "string",
          "enum": [
            "exact",
            "unknown"
          ]
        },
        "app_access": {
          "type": "string",
          "const": "unverified"
        }
      },
      "required": [
        "required_permissions",
        "missing_permissions",
        "permission_state",
        "grant_evidence",
        "app_access"
      ]
    },
    "data": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^\\d{2,20}$"
          },
          "text": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 30000
              },
              {
                "type": "null"
              }
            ]
          },
          "username": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^[A-Za-z0-9._]{1,30}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "permalink": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "null"
              }
            ]
          },
          "timestamp": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time",
                "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)))$"
              },
              {
                "type": "null"
              }
            ]
          },
          "media_type": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "TEXT",
                  "TEXT_POST",
                  "IMAGE",
                  "VIDEO",
                  "CAROUSEL_ALBUM",
                  "AUDIO",
                  "REPOST_FACADE"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "is_reply": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "is_quote_post": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "has_replies": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "root_post_id": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{2,20}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "replied_to_id": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{2,20}$"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "text",
          "username",
          "permalink",
          "timestamp",
          "media_type",
          "is_reply",
          "is_quote_post",
          "has_replies"
        ]
      }
    },
    "profile": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "username": {
              "type": "string",
              "pattern": "^[A-Za-z0-9._]{1,30}$"
            },
            "name": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ]
            },
            "biography": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 2000
                },
                {
                  "type": "null"
                }
              ]
            },
            "is_verified": {
              "type": [
                "boolean",
                "null"
              ]
            },
            "follower_count": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "username",
            "name",
            "biography",
            "is_verified",
            "follower_count"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "locations": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^\\d{2,20}$"
          },
          "name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "null"
              }
            ]
          },
          "address": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 500
              },
              {
                "type": "null"
              }
            ]
          },
          "city": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "null"
              }
            ]
          },
          "country": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 200
              },
              {
                "type": "null"
              }
            ]
          },
          "postal_code": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 100
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "address",
          "city",
          "country",
          "postal_code"
        ]
      }
    },
    "root_post_id": {
      "type": "string",
      "pattern": "^\\d{2,20}$"
    },
    "target_username": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._]{1,30}$"
    },
    "coverage": {
      "type": "object",
      "properties": {
        "complete": {
          "type": "boolean",
          "const": false
        },
        "next_cursor": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 4096
            },
            {
              "type": "null"
            }
          ]
        },
        "omitted_rows": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "reasons": {
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 400
          }
        }
      },
      "required": [
        "complete",
        "next_cursor",
        "omitted_rows",
        "reasons"
      ]
    },
    "quota": {
      "maxItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "provider": {
            "type": "string",
            "const": "meta"
          },
          "usage": {
            "type": "object",
            "properties": {
              "call_count": {
                "type": "number"
              },
              "total_cputime": {
                "type": "number"
              },
              "total_time": {
                "type": "number"
              },
              "estimated_time_to_regain_access": {
                "type": "number"
              }
            }
          },
          "sources": {
            "maxItems": 2,
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "x-app-usage",
                "x-business-use-case-usage"
              ]
            }
          }
        },
        "required": [
          "provider",
          "usage",
          "sources"
        ]
      }
    }
  },
  "required": [
    "contract_version",
    "operation",
    "source",
    "workspace_id",
    "social_account_id",
    "provider_account_id",
    "provider_app_identity",
    "oauth_snapshot_id",
    "fetched_at",
    "status",
    "unavailable_reason",
    "access",
    "data",
    "profile",
    "coverage",
    "quota"
  ]
}

Feil og trygge nye forsøk

Kontroller HTTP-status og svarinnhold. En 400-valideringsfeil kan inneholde en ZodError; håndteringsfeil bruker feltene error, message og code. Behold request_id eller x-request-id for feilsøking, uten påloggingsopplysninger. Rett 401/403-tilgangsfeil før nye forsøk, og følg Retry-After ved 429. Hvis en skriveoperasjon er usikker eller returnerer 5xx, les det eksisterende resultatet først. Gjenbruk bare en idempotensnøkkel der det støttes; virkemåten ved nye forsøk varierer mellom operasjoner og garanterer ikke levering nøyaktig én gang.

Feilsøkingsveiledning

Eksempler

Disse eksemplene bruker fiktive verdier kontrollert mot skjemaene. Erstatt ID-ene med noen du har lov til å bruke, mediene med klare ressurser og datoene med bekreftet publiseringstidspunkt. Kontroller kontoens kvalifikasjon før en skriveoperasjon sendes inn. Siden sender ingen API-forespørsler.

Angi SOSOAPI_ACCESS_TOKEN på serveren din til legitimasjon som operasjonen godtar, og hold den unna nettleserkode. For en KI-agent, bruk sosoapi auth login for innlogging gjennom nettleseren, og la CLI-et fornye legitimasjonen.

request.json

{
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "social_account_id": "22222222-2222-4222-8222-222222222222",
  "limit": 25
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/analytics-api/threads-reads/own-replies/query" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// 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/threads-reads/own-replies/query", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "social_account_id": "22222222-2222-4222-8222-222222222222",
  "limit": 25
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /analytics-api/threads-reads/own-replies/query < request.json

Syntetisk svareksempel

{
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "social_account_id": "22222222-2222-4222-8222-222222222222",
  "contract_version": "threads-reads/v1",
  "operation": "own_replies",
  "source": "official_threads_api",
  "provider_account_id": "12345",
  "provider_app_identity": null,
  "oauth_snapshot_id": null,
  "fetched_at": "2099-01-15T09:00:00Z",
  "status": "unavailable",
  "unavailable_reason": "issuing_app_unknown",
  "access": {
    "required_permissions": [
      "threads_basic",
      "threads_read_replies"
    ],
    "missing_permissions": [],
    "permission_state": "unknown",
    "grant_evidence": "unknown",
    "app_access": "unverified"
  },
  "data": [],
  "profile": null,
  "quota": [],
  "coverage": {
    "complete": false,
    "next_cursor": null,
    "omitted_rows": 0,
    "reasons": [
      "Fictional documentation example: no provider request was made and no account data was read.",
      "App access and any pending permission review remain unverified; this is not successful provider or public-access evidence."
    ]
  }
}

MCP: sosoapi_query_threads_own_replies

Alle API-operasjoner Autentisering og tillatelser