Confirmă o modificare

Confirmă aceleași date de intrare pregătite, cu ambele antete obligatorii. Se aplică în continuare regulile suplimentare de verificare a publicării și aprobare umană. Un răspuns 200 poate conține ok:false; o operațiune acceptată sau programată nu dovedește publicarea. Cererile JSON sunt limitate la 65.536 de octeți.

POST/api/v1/tools/{tool}/confirm

Autorizare

AuthorizationToken Bearer · headerobligatoriu

Cheie API Influence cu permisiuni limitate sau token de acces OAuth acceptat. Nu include datele de acces în URL-uri sau în datele de intrare ale instrumentelor.

Parametri de cale

toolstringobligatoriu

Numele instrumentului returnat de GET /api/v1/tools. Descoperirea este filtrată după permisiunile acestor date de acces; prezența schemei nu confirmă disponibilitatea.

Parametri de antet

X-Publish-ConfirmationConfirmationCapabilityobligatoriu

Valoarea exactă confirmationCapability returnată de prepare. Trimite-o doar în acest antet, cu aceleași date de intrare, înainte de expiresAt.

lungime minimă: 32 · lungime maximă: 4096 · corespunde modelului ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyobligatoriu

Identificator de reîncercare generat de apelant. Păstrează împreună această cheie, permisul și datele de intrare după un răspuns incert.

lungime minimă: 16 · lungime maximă: 200 · corespunde modelului ^[A-Za-z0-9._:-]+$

Corpul cererii

obligatoriuapplication/json

inputobjectobligatoriu

Răspunsuri

200

Rezultatul instrumentului; verifică ok și error.

Exact una dintre variante:

object

okbooleanobligatoriu

outputJsonValue | nullobligatoriu

Afișează proprietățile

Una sau mai multe variante:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

Tablou cu elemente de tip JsonValue

Referință circulară la JsonValue.

object

object

toolNamestringobligatoriu

Valori permise:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

Valori permise:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringobligatoriu

lungime minimă: 1 · lungime maximă: 2048

retryablebooleanobligatoriu

okbooleanobligatoriu

toolNamestringobligatoriu

400

Cerere nevalidă. Parametrii de interogare nu sunt acceptați. Erorile de validare ale instrumentelor pot folosi structura unui răspuns de eroare al instrumentului.

Una sau mai multe variante:

TransportError

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

ToolError

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

lungime minimă: 1 · lungime maximă: 2048

retryablebooleanobligatoriu

okbooleanobligatoriu

toolNamestringobligatoriu

401

Datele de acces bearer lipsesc, sunt nevalide sau au expirat.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

403

Datele de acces nu au permisiunile necesare.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

404

API-ul pentru acces programatic sau instrumentul solicitat nu este disponibil.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

413

Cererea depășește limita de octeți.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

lungime minimă: 1 · lungime maximă: 2048

retryablebooleanobligatoriu

okbooleanobligatoriu

toolNamestringobligatoriu

429

Limita de frecvență a cererilor a fost depășită. Eroarea permite reîncercarea.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

503

API-ul sau serviciul din amonte care îl execută nu este disponibil.

errorobjectobligatoriu

Afișează proprietățile

codestringobligatoriu

messagestringobligatoriu

retryablebooleanobligatoriu

Cerere

curl -X POST 'https://influence.so/api/v1/tools/string/confirm' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Publish-Confirmation: stringstringstringstringstringst' \
  -H 'Idempotency-Key: stringstringstri' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "property1": "string",
    "property2": "string"
  }
}'

const response = await fetch("https://influence.so/api/v1/tools/string/confirm", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "X-Publish-Confirmation": "stringstringstringstringstringst",
    "Idempotency-Key": "stringstringstri",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"input\": {\n    \"property1\": \"string\",\n    \"property2\": \"string\"\n  }\n}"
});

import requests

response = requests.post(
    "https://influence.so/api/v1/tools/string/confirm",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "X-Publish-Confirmation": "stringstringstringstringstringst",
        "Idempotency-Key": "stringstringstri",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"input\": {\n    \"property1\": \"string\",\n    \"property2\": \"string\"\n  }\n}",
)

Răspuns

{
  "ok": true,
  "output": "string",
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "AI_SCHEDULING_LIMIT_REACHED",
    "message": "string",
    "retryable": true
  },
  "ok": false,
  "toolName": "adAuditQuote"
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true
  }
}