المطورون / Tools

عرض قائمة الأدوات

GET https://api.echonova.ai/v1/tools

تعرض الأدوات في مساحة عمل هذا المفتاح، وتُقسَّم الصفحات بـ `offset` و`limit`. تعرض الأدوات عناوين URL الخاصة بها ومعرّفات الأسرار وروابط المصادقة التي تستخدمها، ولا تعرض قيم الأسرار أبدًا. استخدام هذه النقطة مجاني. يحتاج المفتاح إلى النطاق `tools:write`.

Headers

Authorization string مطلوب

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

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

offset integer اختياري

عدد العناصر التي تُتخطّى.

من 0 إلى 10000الافتراضي 0
limit integer اختياري

عدد العناصر التي تُعاد.

من 1 إلى 50الافتراضي 20

الاستجابة

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

data object

النتيجة.

success boolean

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

statusCode integer

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

errorMessage string or null

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

الأخطاء

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

GET /v1/tools

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

{
  "data": {
    "items": [
      {
        "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"
        }
      }
    ],
    "total": 1
  },
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}