Bir web sitesinin rotalarını, etkin blok kimlikleriyle birlikte sayfalandırılmış şekilde listeleyin.
Bir web sitesinin rotalarını sayfalandırılmış şekilde ve isteğe bağlı olarak duruma ve desene göre filtreleyerek listeleyin. Boş block_ids değerine sahip rotalar, eşleşen dinamik varsayılan rotadan tamamlanır, bu nedenle döndürülen block_ids render edilecek etkin bloklardır.
Kimlik doğrulama: API anahtarı (x-api-key üstbilgisi veya api_key sorgu parametresi).
| Parametre | Tür | Gerekli | Notlar |
|---|---|---|---|
websiteId | uuid | evet | Hedef web sitesi. |
api_key | string | hayır | x-api-key üstbilgisine alternatif. |
state | string | hayır | Rota durumuna göre filtrele (tam eşleşme). |
pattern | string | hayır | Rota deseninde alt dize eşleşmesi (LIKE, joker karakterler kaçışlı). |
limit | integer | hayır | Sayfa boyutu, varsayılan 50, 1–100 aralığına sınırlandırılır. |
offset | integer | hayır | Atlanacak satırlar, varsayılan 0. |
Sonuçlar updated_at DESC sırasına göre düzenlenir.
{
"routes": [
{
"website_id": "...",
"path": "/docs/getting-started",
"pattern": "/docs/getting-started",
"label": "Başlarken",
"tags": [],
"block_ids": ["..."],
"template_block_ids": ["..."],
"override_mode": "merge",
"state": "Live",
"param_bindings": {},
"created_at": "2026-06-23T18:34:16Z",
"updated_at": "2026-06-23T20:36:55Z"
}
],
"total": 42,
"hasMore": true
}
total, filtrelenmiş toplam sayıdır; hasMore, offset + limit < total ifadesinin sonucudur. label, param_bindings, template_block_ids ve override_mode ayarlanmadığında atlanır veya null olur.
curl '{CMS_API_URL}/routes?websiteId=<uuid>&limit=20' \
-H 'x-api-key: <key>'
400 — eksik veya geçersiz websiteId401 — geçersiz API anahtarı (veya sunucu gerektirdiğinde eksik)