אישור פעולה שמשנה מצב

אשרו את אותו קלט שהוכן, עם שתי כותרות הבקשה הנדרשות. כללי הבדיקה הנוספים לפרסום והדרישה לאישור אנושי עדיין חלים. תגובה בקוד 200 יכולה להכיל ok:false; פעולה שהתקבלה או תוזמנה אינה הוכחה לפרסום. בקשות JSON מוגבלות ל־65,536 בתים.

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

הרשאה

Authorizationאסימון Bearer · headerחובה

מפתח API של Influence עם הרשאות מוגדרות, או אסימון גישה נתמך של OAuth. אל תכללו פרטי גישה בכתובות URL או בקלט לכלי.

פרמטרים בנתיב

toolstringחובה

שם הכלי שהוחזר ב־GET /api/v1/tools. גילוי הכלים מסונן לפי ההרשאות של פרטי הגישה האלה; עצם הופעת הסכמה אינה מוכיחה שהכלי זמין.

פרמטרים בכותרות הבקשה

X-Publish-ConfirmationConfirmationCapabilityחובה

ערך confirmationCapability המדויק שהוחזר מ־prepare. שלחו אותו רק בכותרת הזאת, עם אותו קלט, לפני expiresAt.

אורך מזערי: 32 · אורך מרבי: 4096 · תואם לתבנית ^[A-Za-z0-9._~-]+$

Idempotency-KeyIdempotencyKeyחובה

מזהה לניסיון חוזר שנוצר בצד הלקוח. לאחר תגובה לא ודאית, שמרו על אותו מפתח, אותו ערך אישור ואותו קלט.

אורך מזערי: 16 · אורך מרבי: 200 · תואם לתבנית ^[A-Za-z0-9._:-]+$

גוף הבקשה

חובהapplication/json

inputobjectחובה

תגובות

200

תוצאת הכלי; בדקו את ok ואת error.

אחת בלבד מהאפשרויות:

object

okbooleanחובה

outputJsonValue | nullחובה

הצגת מאפיינים

אחת או יותר מהאפשרויות:

string

string

number

number

boolean

boolean

null

null

JsonValue[]

מערך של JsonValue

הפניה מעגלית אל JsonValue.

object

object

toolNamestringחובה

ערכים מותרים:adAuditQuoteadAuditStartadAuditGetadAuditListsearchfetchprofileGetconnectionStatusGetaccountListcampaignGetcampaignListcampaignDraftSavemediaListmediaImportmediaUploadCreatemediaUploadPartmediaUploadCompletemediaUploadGetmediaUploadAbortmediaGetcampaignReviewcampaignReviewGetcampaignReviewExecutecampaignScheduleBatchReviewcampaignScheduleBatchExecutescheduleListbrandContextGetinsightsAccountListinsightsPostListinsightsRefreshcampaignPlanGetcampaignPlanGenerateimageGenerationQuoteimageGenerationStartimageGenerationListintegrationListgroupListintegrationSchemadevtoOrganizationListdevtoTagListdiscordChannelListdiscourseCategoryListdiscourseTagListdiscourseTopicSearchdribbbleTeamListghostAuthorListghostNewsletterListghostTagListghostTierListhashnodePublicationListlemmyCommunitySearchlistmonkListsGetlistmonkTemplateListmattermostChannelListmeweGroupListpinterestBoardListredditSubredditRequirementsGetredditSubredditSearchslackChannelListteamsChannelListtiktokCreatorInfoGetvkDestinationListwhopCompanyListwhopExperienceListwordpressCategoryListwordpressPostTypeListwordpressTagListwrapcastChannelSearchintegrationSchedulePostToolpostsListToolpostSettingsTool

ToolError

errorobjectחובה

הצגת מאפיינים

codestringחובה

ערכים מותרים:AI_SCHEDULING_LIMIT_REACHEDAI_SCHEDULING_UNAVAILABLEINVALID_INPUTFORBIDDENNOT_FOUNDCONFLICTFEATURE_DISABLEDCONFIRMATION_REQUIREDCONFIRMATION_INVALIDUPSTREAM_FAILEDNEEDS_REVIEWINTERNAL

messagestringחובה

אורך מזערי: 1 · אורך מרבי: 2048

retryablebooleanחובה

okbooleanחובה

toolNamestringחובה

400

בקשה לא תקפה. פרמטרים בשאילתה אינם מתקבלים. כשלי בדיקת תקינות ברמת הכלי עשויים לחזור במעטפת שגיאה של כלי.

אחת או יותר מהאפשרויות:

TransportError

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

ToolError

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

אורך מזערי: 1 · אורך מרבי: 2048

retryablebooleanחובה

okbooleanחובה

toolNamestringחובה

401

פרטי הגישה מסוג Bearer חסרים, אינם תקפים או שפג תוקפם.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

403

לפרטי הגישה חסרות ההרשאות הנדרשות.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

404

ממשק ה־API למערכות או הכלי המבוקש אינם זמינים.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

413

הבקשה חורגת ממגבלת הגודל בבתים.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

אורך מזערי: 1 · אורך מרבי: 2048

retryablebooleanחובה

okbooleanחובה

toolNamestringחובה

429

חריגה ממגבלת קצב הבקשות. אפשר לנסות שוב.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

503

ה־API או ביצוע הפעולה במערכת שעליה הוא מסתמך אינם זמינים.

errorobjectחובה

הצגת מאפיינים

codestringחובה

messagestringחובה

retryablebooleanחובה

בקשה

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}",
)

תגובה

{
  "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
  }
}