A Tulip sebességkorlátozásokat alkalmaz a táblázati API-kra, hogy konzisztens és megbízható felhasználói élményt nyújtson, valamint biztosítsa a magas teljesítményt és rendelkezésre állást a Tulip platformon. A sebességkorlátozás bevezetése 2026 tavaszán, szakaszosan történik az összes Tulip-példányon.
Táblázati sebességkorlátozások
Az Essentials, Professional és Enterprise csomagok esetében a következő sebességkorlátozások vonatkoznak a munkaterületen belüli táblákra.
| API-kategória | Folyamatkorlátozási érték | Végpontok |
|---|---|---|
| Rekordírás | 10 írás másodpercenként táblánként | POST /api/v3/tables/:tableId/records (createRecord) PUT /api/v3/tables/:tableId/records/:recordId (updateRecord) PATCH /api/v3/tables/:tableId/records/:recordId/increment (incrementRecord) |
| Rekord törlés | 10 törlés másodpercenként táblánként | DELETE /api/v3/tables/:tableId/records (deleteRecords) DELETE /api/v3/tables/:tableId/records/:recordId (deleteRecord) |
| Rekord olvasás (egyedi) | Táblánként 50 olvasás másodpercenként | GET /api/v3/tables/:tableId/records/:recordId (getRecord) |
| Rekordolvasás (többszörös) | Táblánként 10 olvasás másodpercenként | GET /api/v3/tables/:tableId/runAggregation (runAggregation) GET /api/v3/tables/:tableId/records (listRecords) POST /api/v3/tables/:tableId/exportDataset (exportDataset) GET /api/v3/tables/:tableId/count (countRecords) |
:::(Info) NOTE: Some account plans will have custom configurations. This will be communicated to customers by Tulip Support or Customer Success Managers (CSM)
when applicable. If you are unsure, please contact support@tulip.co
:::
Prior to r383, Service Accounts were called "API Tokens".
Hogyan számolják a korlátot?
A sebességkorlátozások (példány, táblázat, művelet) alapján kerülnek érvényesítésre. Egy adott példányon lévő összes szolgáltatási fiók ugyanazt a tárolót használja egy adott táblához és művelethez — további szolgáltatási fiókok létrehozása nem növeli a tényleges sebességkorlátozást.
Honnan tudom, hogy elértem-e a korlátot?
A táblákra vonatkozó sebességkorlátokról szóló értesítések az egyes táblák oldalainak tetején jelennek meg.
Amikor eléri a korlát 80%-át, a következő figyelmeztető sáv jelenik meg:
{height="" width=""}Amikor eléri a korlátot, a következő hibaüzenet jelenik meg:
{height="" width=""}A figyelmeztető/hibaüzenetek egy 7 napos gördülő időszakra vonatkoznak. Amint elérte a küszöbértéket, a sáv akkor is látható marad, ha a felhasználás már újra a küszöbérték alá csökkent, legfeljebb 7 napig. A sávokon megjelenik a „legutóbbi túllépés” dátuma, amely jelzi, mikor lépte túl utoljára a küszöbértéket
Mit tegyek, ha túllépem a sebességkorlátot?
- Ellenőrizze a 429-es hibát. A táblázat és a segítségével azonosíthatja, hogy egy adott szolgáltatási fiók miért ütközik a sebességkorlátokba.
- Ha lehetséges, csoportosítsa a kéréseket. Tegyük fel például, hogy van egy alkalmazása, amelynek adatokat kell lekérnie egy táblázati rekordkészletből. Ahelyett, hogy minden egyes rekordra külön kérést küldene, célszerűbb egyetlen lekérdezést küldeni, amely tartalmazza az összes szükséges rekord-azonosítót (vagy szűrési feltételt) – majd az eredményeket helyileg feldolgozni az alkalmazásban.
- Tárolja az eredményeket a gyorsítótárban. Ahelyett, hogy gyakran küldene kéréseket, tárolja a korábbi kérések adatait a gyorsítótárban. Ezután frissítse az adatokat kérésre (például amikor egy felhasználó kifejezetten frissíteni szeretné az adatokat az alkalmazásban), vagy olyan időközönként, amely megfelel a sebességkorlátozásoknak.
- Győződjön meg arról, hogy a szkriptje megfelelően kezeli a sebességkorlátozás alá eső kéréseket. Győződjön meg arról, hogy a szkriptje a 429-es hiba után újra megpróbálja feldolgozni a felhasználói kéréseket.
:::(Info) NOTE: When calling an API via a connector function, the connector will automatically handle 429 responses, so no additional retry logic is required. External clients — scripts, automations hosted outside Tulip, or connectors calling Tulip's API from other platforms — must implement retry logic themselves.
:::
{{snippet.Megtalálta, amit keresett?}}