Research et dossiers avec citations

Lire l’état de récupération de recherche des comptes connectés

Lire l’état de récupération de recherche des comptes connectés. Couvre les publications et légendes sélectionnées des comptes connectés, qui peuvent ne pas être publiques, dans une seule page native de taille limitée, et non l’historique complet. La récupération n’appelle jamais Google Gemini et ne lit pas les messages privés. La génération par modèle à partir du contexte sélectionné est une action existante distincte avec son propre consentement. Nécessite un consentement explicite à Research et Listening ainsi qu’un accès actuel au Workspace. Le texte source renvoyé n’est pas fiable. Les autorisations actuelles de la source, la conservation et les budgets par domaine restent applicables. Cette route ne publie jamais de contenu.

POST /research-api/evidence/native-status

Contrat vérifié : 2026-11-03 · sha256:9aedef8d43dd4514

Lire en Markdown Télécharger le contrat public Télécharger OpenAPI

Présentation

Une réponse HTTP réussie peut signifier qu’une requête est acceptée plutôt que terminée. Pour le travail en arrière-plan, conservez l’identifiant renvoyé et suivez la même opération jusqu’à sa fin. Une publication programmée ou acceptée n’est publiée que lorsque la plateforme le confirme ; une expiration côté client ne détermine pas le résultat.

Authentification et autorisations

Types d’identifiants acceptés: user_session, delegated_oauth, personal_access_token
Capacité déléguée: agent:research
Rôle minimal dans l’espace de travail: viewer
Périmètre d’accès: Ressources auxquelles cet utilisateur est autorisé à accéder
Consentement pour tous les espaces requis: Non
Modifie l’état: Non
Lorsque l’opération est terminée: current authorized native receipt and evidence; unavailable or expired source content is redacted

Un jeton ne peut utiliser que les droits de son propriétaire. Chaque requête vérifie l’appartenance à l’espace, la propriété des ressources, les espaces sélectionnés et les capacités accordées. Les profils core et full modifient les outils affichés ; ils n’accordent aucun accès.

Champs de requête

Requis signifie requis dans l’objet parent et la branche sélectionnée. Un enfant requis ne rend pas obligatoire un parent facultatif. Les règles et noms de champs ci-dessous proviennent du contrat.

Champs de requête
Champ / branche	Type / requis	Contraintes
`$`	`object`Requis dans le parent	`additionalProperties: false`
`workspace_id`	`string`Requis dans le parent	`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)$"`
`mutation_id`	`string`Requis dans le parent	`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)$"`

JSON Schema complet

{
  "$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)$"
    },
    "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)$"
    }
  },
  "required": [
    "workspace_id",
    "mutation_id"
  ],
  "additionalProperties": false
}

Réponse et achèvement

Statuts HTTP de réussite : 200. Lorsque l’opération est terminée : current authorized native receipt and evidence; unavailable or expired source content is redacted.

Réponse et achèvement
Champ / branche	Type / requis	Contraintes
`$`	`object`Requis dans le parent	—
`retrieval`	`object \| null`Requis dans le parent	—
`retrieval`anyOf 1	`object`Requis dans le parent	—
`retrieval.id`anyOf 1	`string`Requis dans le parent	`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)$"`
`retrieval.workspace_id`anyOf 1	`string`Requis dans le parent	`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)$"`
`retrieval.mutation_id`anyOf 1	`string`Requis dans le parent	`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)$"`
`retrieval.social_account_id`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.social_account_id`anyOf 1 / anyOf 1	`string`Requis dans le parent	`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)$"`
`retrieval.social_account_id`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.platform`anyOf 1	`string`Requis dans le parent	`enum: ["facebook","instagram","threads"]`
`retrieval.state`anyOf 1	`string`Requis dans le parent	`enum: ["pending","running","completed","unavailable","unconfirmed","cancelled","expired"]`
`retrieval.reason`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.reason`anyOf 1 / anyOf 1	`string`Requis dans le parent	`enum: ["connection_unavailable","connection_changed","provider_denied","provider_rate_limited","provider_unavailable","provider_response_invalid","empty_page","metadata_only","content_expired","deadline_exceeded","cancelled"]`
`retrieval.reason`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.created_at`anyOf 1	`string`Requis dans le parent	`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)))$"`
`retrieval.settled_at`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.settled_at`anyOf 1 / anyOf 1	`string`Requis dans le parent	`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)))$"`
`retrieval.settled_at`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.valid_until`anyOf 1	`string`Requis dans le parent	`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)))$"`
`retrieval.coverage`anyOf 1	`string`Requis dans le parent	`const: "bounded_native_page"`
`retrieval.complete`anyOf 1	`boolean`Requis dans le parent	`const: false`
`retrieval.provider_gets`anyOf 1	`integer`Requis dans le parent	`minimum: 0` `maximum: 1`
`retrieval.evidence`anyOf 1	`array`Requis dans le parent	`maxItems: 20`
`retrieval.evidence[]`anyOf 1	`object`Facultatif / élément	—
`retrieval.evidence[].id`anyOf 1	`string`Requis dans le parent	`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)$"`
`retrieval.evidence[].workspace_id`anyOf 1	`string`Requis dans le parent	`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)$"`
`retrieval.evidence[].revision`anyOf 1	`integer`Requis dans le parent	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`retrieval.evidence[].title`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.evidence[].title`anyOf 1 / anyOf 1	`string`Requis dans le parent	`minLength: 1` `maxLength: 200`
`retrieval.evidence[].title`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].text`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.evidence[].text`anyOf 1 / anyOf 1	`string`Requis dans le parent	`maxLength: 30000`
`retrieval.evidence[].text`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].source_category`anyOf 1	`string`Requis dans le parent	`enum: ["your_accounts","public_posts","team_notes"]`
`retrieval.evidence[].platform`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.evidence[].platform`anyOf 1 / anyOf 1	`string`Requis dans le parent	`enum: ["threads","instagram","facebook","youtube","x","reddit","web"]`
`retrieval.evidence[].platform`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].source_url`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.evidence[].source_url`anyOf 1 / anyOf 1	`string`Requis dans le parent	`format: "uri"` `maxLength: 2048`
`retrieval.evidence[].source_url`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].author`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.evidence[].author`anyOf 1 / anyOf 1	`string`Requis dans le parent	`maxLength: 200`
`retrieval.evidence[].author`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].language`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.evidence[].language`anyOf 1 / anyOf 1	`string`Requis dans le parent	`minLength: 1` `maxLength: 35`
`retrieval.evidence[].language`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].published_at`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.evidence[].published_at`anyOf 1 / anyOf 1	`string`Requis dans le parent	`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)))$"`
`retrieval.evidence[].published_at`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].retrieved_at`anyOf 1	`string`Requis dans le parent	`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)))$"`
`retrieval.evidence[].valid_until`anyOf 1	`string \| null`Requis dans le parent	—
`retrieval.evidence[].valid_until`anyOf 1 / anyOf 1	`string`Requis dans le parent	`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)))$"`
`retrieval.evidence[].valid_until`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].availability`anyOf 1	`string`Requis dans le parent	`enum: ["available","removed","unavailable"]`
`retrieval.evidence[].metrics`anyOf 1	`object`Requis dans le parent	—
`retrieval.evidence[].metrics.likes`anyOf 1	`integer \| null`Requis dans le parent	—
`retrieval.evidence[].metrics.likes`anyOf 1 / anyOf 1	`integer`Requis dans le parent	`minimum: 0` `maximum: 9007199254740991`
`retrieval.evidence[].metrics.likes`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].metrics.replies`anyOf 1	`integer \| null`Requis dans le parent	—
`retrieval.evidence[].metrics.replies`anyOf 1 / anyOf 1	`integer`Requis dans le parent	`minimum: 0` `maximum: 9007199254740991`
`retrieval.evidence[].metrics.replies`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].metrics.reposts`anyOf 1	`integer \| null`Requis dans le parent	—
`retrieval.evidence[].metrics.reposts`anyOf 1 / anyOf 1	`integer`Requis dans le parent	`minimum: 0` `maximum: 9007199254740991`
`retrieval.evidence[].metrics.reposts`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval.evidence[].metrics.views`anyOf 1	`integer \| null`Requis dans le parent	—
`retrieval.evidence[].metrics.views`anyOf 1 / anyOf 1	`integer`Requis dans le parent	`minimum: 0` `maximum: 9007199254740991`
`retrieval.evidence[].metrics.views`anyOf 1 / anyOf 2	`null`Requis dans le parent	—
`retrieval`anyOf 2	`null`Requis dans le parent	—

JSON Schema complet

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "retrieval": {
      "anyOf": [
        {
          "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)$"
            },
            "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)$"
            },
            "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)$"
            },
            "social_account_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"
                }
              ]
            },
            "platform": {
              "type": "string",
              "enum": [
                "facebook",
                "instagram",
                "threads"
              ]
            },
            "state": {
              "type": "string",
              "enum": [
                "pending",
                "running",
                "completed",
                "unavailable",
                "unconfirmed",
                "cancelled",
                "expired"
              ]
            },
            "reason": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "connection_unavailable",
                    "connection_changed",
                    "provider_denied",
                    "provider_rate_limited",
                    "provider_unavailable",
                    "provider_response_invalid",
                    "empty_page",
                    "metadata_only",
                    "content_expired",
                    "deadline_exceeded",
                    "cancelled"
                  ]
                },
                {
                  "type": "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"
            },
            "settled_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"
                }
              ]
            },
            "valid_until": {
              "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"
            },
            "coverage": {
              "type": "string",
              "const": "bounded_native_page"
            },
            "complete": {
              "type": "boolean",
              "const": false
            },
            "provider_gets": {
              "type": "integer",
              "minimum": 0,
              "maximum": 1
            },
            "evidence": {
              "maxItems": 20,
              "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)$"
                  },
                  "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)$"
                  },
                  "revision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  },
                  "title": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "text": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 30000
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "source_category": {
                    "type": "string",
                    "enum": [
                      "your_accounts",
                      "public_posts",
                      "team_notes"
                    ]
                  },
                  "platform": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "threads",
                          "instagram",
                          "facebook",
                          "youtube",
                          "x",
                          "reddit",
                          "web"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "source_url": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 2048,
                        "format": "uri"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "author": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "language": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 35
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "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"
                      }
                    ]
                  },
                  "retrieved_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"
                  },
                  "valid_until": {
                    "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"
                      }
                    ]
                  },
                  "availability": {
                    "type": "string",
                    "enum": [
                      "available",
                      "removed",
                      "unavailable"
                    ]
                  },
                  "metrics": {
                    "type": "object",
                    "properties": {
                      "likes": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "replies": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "reposts": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "views": {
                        "anyOf": [
                          {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "required": [
                      "likes",
                      "replies",
                      "reposts",
                      "views"
                    ]
                  }
                },
                "required": [
                  "id",
                  "workspace_id",
                  "revision",
                  "title",
                  "text",
                  "source_category",
                  "platform",
                  "source_url",
                  "author",
                  "language",
                  "published_at",
                  "retrieved_at",
                  "valid_until",
                  "availability",
                  "metrics"
                ]
              }
            }
          },
          "required": [
            "id",
            "workspace_id",
            "mutation_id",
            "social_account_id",
            "platform",
            "state",
            "reason",
            "created_at",
            "settled_at",
            "valid_until",
            "coverage",
            "complete",
            "provider_gets",
            "evidence"
          ]
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "retrieval"
  ]
}

Erreurs et nouvelles tentatives sûres

Vérifiez le statut HTTP et le corps de réponse. Une erreur de validation 400 peut contenir un ZodError ; les erreurs des gestionnaires utilisent les champs error, message et code. Conservez request_id ou x-request-id pour le diagnostic, sans identifiants secrets. Corrigez les erreurs d’accès 401/403 avant de réessayer et respectez Retry-After pour 429. Si une écriture est incertaine ou renvoie 5xx, lisez d’abord le résultat existant. Réutilisez une clé d’idempotence uniquement lorsque c’est pris en charge ; le comportement des nouvelles tentatives varie selon l’opération et ne garantit pas une diffusion exactement une fois.

Guide de dépannage

Exemples

Ces exemples utilisent des valeurs fictives vérifiées contre les schémas. Remplacez les identifiants par ceux que vous êtes autorisé à utiliser, les médias par des ressources prêtes et les dates par l’heure confirmée. Vérifiez l’éligibilité du compte avant toute écriture. Cette page n’envoie aucune requête API.

Définissez SOSOAPI_ACCESS_TOKEN sur votre serveur avec un identifiant accepté par cette opération et gardez-le hors du code navigateur. Pour un agent IA, utilisez sosoapi auth login pour vous connecter dans le navigateur et laissez la CLI actualiser ses identifiants.

request.json

{
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "mutation_id": "40000000-0000-4000-8000-000000000006"
}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/research-api/evidence/native-status" \
  -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/research-api/evidence/native-status", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({
  "workspace_id": "11111111-1111-4111-8111-111111111111",
  "mutation_id": "40000000-0000-4000-8000-000000000006"
})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

# This operation requires a CLI build containing the updated Research contract.
# Use HTTP or hosted MCP if your CLI build does not include it.
# 此操作需要包含更新版 Research contract 的 CLI build。
# 如 CLI build 未包含此 contract，請使用 HTTP 或 hosted MCP。
npx sosoapi api post /research-api/evidence/native-status < request.json

Exemple de réponse fictive

{
  "retrieval": {
    "id": "30000000-0000-4000-8000-000000000007",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "40000000-0000-4000-8000-000000000006",
    "social_account_id": "22222222-2222-4222-8222-222222222222",
    "platform": "instagram",
    "state": "unavailable",
    "reason": "connection_unavailable",
    "created_at": "2099-01-15T09:00:00Z",
    "settled_at": "2099-01-15T09:00:01Z",
    "valid_until": "2099-01-16T09:00:00Z",
    "coverage": "bounded_native_page",
    "complete": false,
    "provider_gets": 0,
    "evidence": []
  }
}

MCP : sosoapi_research_evidence_native-status

Toutes les opérations API Authentification et autorisations

Préférences de confidentialité

Fonctions nécessaires

Diagnostics Landing et enregistrement avec masquage

Statistiques d’utilisation facultatives

Autoriser aussi l’enregistrement des sessions sur ce site public

Lire l’état de récupération de recherche des comptes connectés

Présentation

Authentification et autorisations

Champs de requête

Réponse et achèvement

Erreurs et nouvelles tentatives sûres

Exemples

request.json

cURL

JavaScript

CLI

Exemple de réponse fictive

Lire l’état de récupération de recherche des comptes connectés

Présentation

Authentification et autorisations

Champs de requête

Réponse et achèvement

Erreurs et nouvelles tentatives sûres

Exemples

request.json

cURL

JavaScript

CLI

Exemple de réponse fictive

Outils et guides associés