बदलाव की पुष्टि करें

दोनों ज़रूरी हेडर के साथ उसी तैयार इनपुट की पुष्टि करें. पब्लिशिंग की अतिरिक्त समीक्षा और इंसान से मंज़ूरी लेने के नियम तब भी लागू होते हैं. 200 वाले जवाब में ok:false हो सकता है; काम स्वीकार या शेड्यूल हो जाने का मतलब यह नहीं है कि वह पब्लिश हो चुका है. JSON अनुरोधों की सीमा 65,536 बाइट है.

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

ऐक्सेस की अनुमति

AuthorizationBearer टोकन · headerज़रूरी

Influence की स्कोप वाली API कुंजी या समर्थित OAuth ऐक्सेस टोकन. URL और टूल के इनपुट में क्रेडेंशियल न डालें.

पाथ पैरामीटर

toolstringज़रूरी

GET /api/v1/tools से मिला टूल का नाम. डिस्कवरी में इस क्रेडेंशियल की अनुमतियों के हिसाब से टूल दिखते हैं; स्कीमा मौजूद होने से टूल की उपलब्धता साबित नहीं होती.

हेडर पैरामीटर

X-Publish-ConfirmationConfirmationCapabilityज़रूरी

prepare से लौटा वही confirmationCapability मान. इसे सिर्फ़ इस हेडर में, उसी इनपुट के साथ, 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
  }
}