# Avbryt hämtning av en offentlig källa från sociala medier Kanonisk URL: https://sosoapi.ai/sv/docs/api/research-api-evidence-social-cancel Kontrakt: sha256:dadbfeb34d10743d Avbryt den exakta hämtningen från sociala medier via mutation_id; sent innehåll kan inte sparas. Returnerad källtext är inte betrodd. Kräver agent:research. POST /research-api/evidence/social-cancel ## Autentisering och behörigheter - **Godtagna typer av autentiseringsuppgifter:** user_session, delegated_oauth, personal_access_token - **Delegerad funktion:** agent:research - **Lägsta arbetsyteroll:** editor - **Åtkomstomfång:** Resurser som denna användare har behörighet att komma åt - **Samtycke för alla arbetsytor krävs:** Nej - **Ändrar tillstånd:** Ja - **När åtgärden är slutförd:** Sparad avbrottsgräns; sena läsresultat från sociala medier kasseras En token får endast använda ägarens rättigheter. Varje anrop kontrollerar arbetsytemedlemskap, resursägarskap, valda arbetsytor och beviljade funktioner. Profilerna core och full ändrar vilka verktyg som visas; de ger ingen åtkomst. ## Anropsfält ```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)$" }, "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 } ``` ## Svar och slutförande HTTP-status vid framgång: 200 Ett lyckat HTTP-svar kan betyda att en begäran accepterats snarare än slutförts. Spara returnerat ID för bakgrundsarbete och kontrollera samma åtgärd tills den är klar. Ett schemalagt eller accepterat inlägg är publicerat först när plattformen bekräftar det; en klienttimeout fastställer inte resultatet. ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "retrieval": { "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)$" }, "kind": { "type": "string", "const": "public_social" }, "state": { "type": "string", "enum": [ "pending", "running", "completed", "cancelled", "unconfirmed", "expired" ] }, "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" }, "result": { "anyOf": [ { "type": "object", "properties": { "source": { "type": "string", "enum": [ "facebook_public_web", "instagram_public_web", "threads_public_web" ] }, "platform": { "type": "string", "enum": [ "facebook", "instagram", "threads" ] }, "canonical_url": { "type": "string", "maxLength": 2048, "format": "uri" }, "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" }, "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" }, "upstream_updated_at": { "type": "null" }, "status": { "type": "string", "enum": [ "available", "partial", "unavailable" ] }, "profile": { "anyOf": [ { "type": "object", "properties": { "source_account_id": { "type": "string", "pattern": "^[0-9]{1,30}$" }, "id_namespace": { "type": "string", "const": "public_web" }, "username": { "type": "string", "minLength": 1, "maxLength": 50 }, "name": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 200 }, { "type": "null" } ] }, "followers": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "source_account_id", "id_namespace", "username", "name", "followers" ] }, { "type": "null" } ] }, "posts": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "source_post_id": { "type": "string", "pattern": "^[0-9]{1,30}$" }, "id_namespace": { "type": "string", "const": "public_web" }, "shortcode": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 64 }, { "type": "null" } ] }, "source_account_id": { "type": "string", "pattern": "^[0-9]{1,30}$" }, "author": { "type": "string", "minLength": 1, "maxLength": 50 }, "canonical_url": { "type": "string", "maxLength": 2048, "format": "uri" }, "text": { "type": "string", "maxLength": 30000 }, "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" } ] }, "media_kind": { "type": "string", "enum": [ "text", "image", "video", "carousel", "unknown" ] }, "metrics": { "type": "object", "properties": { "likes": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "comments": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "reactions": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "shares": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "views": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] } }, "required": [ "likes", "comments", "reactions", "shares", "views" ] } }, "required": [ "source_post_id", "id_namespace", "shortcode", "source_account_id", "author", "canonical_url", "text", "published_at", "media_kind", "metrics" ] } }, "coverage": { "type": "object", "properties": { "complete": { "type": "boolean", "const": false }, "reasons": { "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "initial_page_only", "public_web_ids", "metrics_unavailable", "profile_only", "no_attributable_posts", "foreign_or_malformed_rows", "parser_limit", "unsupported_payload", "blocked", "rate_limited", "upstream_http_error", "redirect_rejected", "unsupported_content_type", "response_too_large", "timeout", "aborted", "network_error", "inconsistent_identity", "research_limit", "source_removed" ] } }, "omitted_rows": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "next_cursor": { "type": "null" } }, "required": [ "complete", "reasons", "omitted_rows", "next_cursor" ] } }, "required": [ "source", "platform", "canonical_url", "fetched_at", "expires_at", "upstream_updated_at", "status", "profile", "posts", "coverage" ] }, { "type": "null" } ] }, "evidence": { "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "evidence_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 } }, "required": [ "evidence_id", "revision" ] } } }, "required": [ "id", "workspace_id", "mutation_id", "kind", "state", "created_at", "settled_at", "valid_until", "result", "evidence" ] } }, "required": [ "retrieval" ] } ``` ## Fel och säkra nya försök Kontrollera HTTP-status och svarskropp. Ett valideringsfel med 400 kan innehålla ZodError; hanterarfel använder fälten error, message och code. Spara request_id eller x-request-id för felsökning, utan inloggningsuppgifter. Åtgärda åtkomstfel med 401/403 innan du försöker igen och följ Retry-After vid 429. Om en skrivning är osäker eller returnerar 5xx, läs först det befintliga resultatet. Återanvänd en idempotensnyckel endast där det stöds; försöksbeteendet varierar mellan åtgärder och garanterar inte leverans exakt en gång. ## Exempel Exemplen använder fiktiva värden som kontrollerats mot schemana. Ersätt ID:n med sådana du får använda, medier med färdiga mediefiler och datum med din bekräftade publiceringstid. Kontrollera kontots behörighet före en skrivning. Denna sida skickar inga API-anrop. Sätt SOSOAPI_ACCESS_TOKEN på servern till en autentiseringsuppgift som åtgärden godtar och håll den borta från webbläsarkod. För en AI-agent använder du sosoapi auth login för att logga in via webbläsaren och låter CLI förnya sina uppgifter. request.json ```json { "workspace_id": "11111111-1111-4111-8111-111111111111", "mutation_id": "40000000-0000-4000-8000-000000000005" } ``` cURL ```bash curl --request POST \ "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/research-api/evidence/social-cancel" \ -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/research-api/evidence/social-cancel", { 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-000000000005" }) }); const result = await response.json(); // Check response.ok, the operation-specific body and completion state before continuing. ``` CLI ```bash # 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/social-cancel < request.json ``` Syntetiskt svarsexempel ```json { "retrieval": { "id": "30000000-0000-4000-8000-000000000007", "workspace_id": "11111111-1111-4111-8111-111111111111", "mutation_id": "40000000-0000-4000-8000-000000000005", "kind": "public_social", "state": "cancelled", "created_at": "2099-01-15T09:00:00Z", "settled_at": "2099-01-15T09:00:01Z", "valid_until": "2099-01-16T09:00:00Z", "evidence": [], "result": null } } ``` ## Relaterade verktyg och guider MCP: sosoapi_research_evidence_social-cancel [API-referens](https://sosoapi.ai/sv/docs/api)