مستندات توسعه دهندگان

فهرست سایت ها

GET/sites
Scope
sites:read
ابزار MCP
list_sites

Websites this key can read A website key lists its one website; a workspace key every website it covers.

توضیح ها از سند OpenAPI می آیند و انگلیسی اند.

پارامترها

پارامتری ندارد.

پاسخ

200 · application/json

فیلدتوضیح
siteslist of object · required
sites[].idstring · required; Website id
sites[].namestring · required; Website name
sites[].urladdress (URL) · required; Home page address
sites[].platformwordpress | astro | shopify | webflow | other | unknown · required; What the website runs on
sites[].linkaddress (URL) · required; The website in the app

خطاها

کدمعنی
401Missing, unknown or revoked key. Codes: missing_key, invalid_key.
403The key lacks the scope, covers another website, or its owner lost access. Codes: missing_scope, other_site, owner_left, no_owner, forbidden.
429Too many requests this hour for this key. Codes: rate_limited.

نمونه درخواست

curl \
  -H "Authorization: Bearer mr_ws_…" \
  "https://app.monoranks.com/api/v1/sites"

نمونه پاسخ

{
  "sites": [
    {
      "id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13",
      "name": "Acme Bikes",
      "url": "https://acmebikes.com/",
      "platform": "wordpress",
      "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/overview"
    }
  ]
}

سرور MCP همین کار را با ابزار list_sites انجام می دهد.