▸ DEVELOPERS / DISCOVERY

واجهات قابلة للاكتشاف، بأسماء يمكن استدعاؤها.

هذه الصفحة تلخّص السجل نفسه الذي يغذي ملفات الاكتشاف العامة. أسماء الأدوات، المصادقة، مسارات REST، وأشكال JSON أدناه تأتي من مصدر واحد.

عدد الأدوات: 6
إصدار البروتوكول: 2025-11-25

نقاط الدخول

MCP عبر HTTP

POST /api/mcp

Agent2Agent

POST /api/a2a

سجل الأدوات

الأداة العامة لا تحتاج مفتاحاً، والأداة المحمية تتطلب مفتاح التوزيع على الخادم. لا تضع مفتاحاً سرياً في المتصفح.

agentic.readiness_probe

Agentic commerce readiness probe (public)

Free multi-surface storefront readiness snapshot (UCP/ACP discovery, product schema, robots, answer-engine maps). Not an attested Store Guard grade. Response includes a Store Guard $149 CTA. No API key required.

المصادقة: عام — بلا مفتاح
REST: POST /api/agentic-commerce/probe

شكل الإدخال المنشور

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Public storefront URL or domain",
      "maxLength": 255
    }
  }
}

dispatch.quote

عرض سعر للتوزيع

يعيد عرض سعر لمهمة خدمة ميدانية وفق الحرفة والموقع والأولوية.

المصادقة: مفتاح خادم مطلوب
REST: POST /api/dispatch/v1/quote

شكل الإدخال المنشور

{
  "type": "object",
  "required": [
    "trade",
    "location"
  ],
  "properties": {
    "trade": {
      "type": "string",
      "description": "Trade code (plumbing, electrical, HVAC, etc.)"
    },
    "location": {
      "type": "object",
      "required": [
        "state"
      ],
      "properties": {
        "state": {
          "type": "string",
          "minLength": 2,
          "maxLength": 2
        },
        "zip": {
          "type": "string",
          "maxLength": 10
        },
        "city": {
          "type": "string",
          "maxLength": 255
        }
      }
    },
    "urgency": {
      "type": "string",
      "enum": [
        "emergency",
        "urgent",
        "routine",
        "scheduled"
      ],
      "default": "routine"
    },
    "nte_cents": {
      "type": "integer",
      "minimum": 1
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

dispatch.estimate

Dispatch estimate (public rate card)

Public modeled field-service price estimate using cited BLS wage data and disclosed model assumptions. Returns wage_basis and billed_estimate so callers can inspect the calculation and geographic basis. The response identifies estimates based on a national baseline and distinguishes model assumptions from observed prices. Use dispatch.quote with an accepted credential to request a quote. No API key required.

المصادقة: عام — بلا مفتاح
REST: POST /api/dispatch/v1/estimate

شكل الإدخال المنشور

{
  "type": "object",
  "required": [
    "trade",
    "location"
  ],
  "properties": {
    "trade": {
      "type": "string",
      "description": "Trade code (plumbing, electrical, HVAC, etc.)"
    },
    "location": {
      "type": "object",
      "required": [
        "state"
      ],
      "properties": {
        "state": {
          "type": "string",
          "minLength": 2,
          "maxLength": 2
        },
        "zip": {
          "type": "string",
          "maxLength": 10
        },
        "city": {
          "type": "string",
          "maxLength": 255
        }
      }
    },
    "urgency": {
      "type": "string",
      "enum": [
        "emergency",
        "urgent",
        "routine",
        "scheduled"
      ],
      "default": "routine"
    }
  }
}

dispatch.order

إنشاء أمر توزيع

ينشئ أمراً متعقباً ويعيد مرجعاً مقنّعاً ومساراً لمتابعة الحالة.

المصادقة: مفتاح خادم مطلوب
REST: POST /api/dispatch/v1/order

شكل الإدخال المنشور

{
  "type": "object",
  "required": [
    "trade",
    "location",
    "description"
  ],
  "properties": {
    "trade": {
      "type": "string"
    },
    "location": {
      "type": "object",
      "required": [
        "state"
      ],
      "properties": {
        "state": {
          "type": "string",
          "minLength": 2,
          "maxLength": 2
        },
        "zip": {
          "type": "string",
          "maxLength": 10
        },
        "city": {
          "type": "string",
          "maxLength": 255
        },
        "address": {
          "type": "string",
          "maxLength": 1000
        },
        "name": {
          "type": "string",
          "maxLength": 500
        }
      }
    },
    "urgency": {
      "type": "string",
      "enum": [
        "emergency",
        "urgent",
        "routine",
        "scheduled"
      ],
      "default": "routine"
    },
    "nte_cents": {
      "type": "integer",
      "minimum": 1
    },
    "description": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000
    },
    "callback_url": {
      "type": "string",
      "format": "uri"
    },
    "reference_id": {
      "type": "string",
      "maxLength": 255
    }
  }
}

dispatch.evals

تقييمات التوزيع العامة

يعيد لوحة التقييمات العامة ضمن نافذة زمنية يحددها الطلب.

المصادقة: عام — بلا مفتاح
REST: GET /api/dispatch/analytics/evals

شكل الإدخال المنشور

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "rolling_7d",
        "rolling_30d",
        "rolling_90d"
      ],
      "default": "rolling_30d"
    }
  }
}

dispatch.index

فهرس الحِرَف المتاحة للتوزيع

يعيد فهرس مجالات التوزيع ومعدلات النموذج الأساسية المنشورة.

المصادقة: عام — بلا مفتاح
REST: GET /api/dispatch/index

شكل الإدخال المنشور

{
  "type": "object",
  "properties": {}
}