المطورون / Tools

عرض أداة

GET https://api.echonova.ai/v1/tools/{toolId}

تُعيد أداة واحدة من مساحة عمل هذا المفتاح. استخدام هذه النقطة مجاني. يحتاج المفتاح إلى النطاق `tools:write`.

Headers

Authorization string مطلوب

كلمة ⁦Bearer⁩ ثم مسافة ثم مفتاح ⁦API⁩ الذي يبدأ بـ ⁦ek_⁩. أنشئ المفاتيح في البوابة من المطورون، ثم مفاتيح واجهة برمجة التطبيقات.

معاملات المسار

toolId string مطلوب

معرّف الأداة، كما أعادته `GET /v1/tools`.

الاستجابة

200 application/json كل استجابة تستخدم هذا الغلاف.

data object

النتيجة.

success boolean

قيمته ⁦true⁩ عند نجاح الطلب.

statusCode integer

يكرر رمز حالة ⁦HTTP⁩.

errorMessage string or null

قيمته ⁦null⁩ عند النجاح.

الأخطاء

الغلاف نفسه، مع ⁦success⁩ بقيمة ⁦false⁩ و ⁦data⁩ بقيمة ⁦null⁩. كل الأخطاء

GET /v1/tools/{toolId}

curl "https://api.echonova.ai/v1/tools/{toolId}" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "id": "6650a1b2c3d4e5f6a7b8c9d0",
    "name": "Order lookup",
    "type": "webhook",
    "description": "Finds an order by its number.",
    "createdAt": "2026-11-01T10:00:00.000Z",
    "updatedAt": "2026-11-01T10:00:00.000Z",
    "webhook": {
      "url": "https://api.example.com/orders/{orderId}",
      "method": "GET",
      "timeoutMs": 10000,
      "connectionId": "6650a1b2c3d4e5f6a7b8c9d0",
      "parameters": [
        {
          "location": "header",
          "name": "orderId",
          "dataType": "string",
          "required": true,
          "description": "Finds an order by its number.",
          "valueType": "llm",
          "secretId": "YOUR_SECRET_ID"
        }
      ]
    },
    "openapi": {
      "apiTitle": "Orders API",
      "operationCount": 12,
      "status": "ready",
      "baseUrl": "https://api.example.com",
      "includeOperations": [
        "getOrder"
      ],
      "authConnectionId": "YOUR_AUTH_CONNECTION_ID",
      "error": null
    },
    "integration": {
      "provider": "slack",
      "key": "add_reaction"
    }
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}