databases

POST /v1/databases

Validate a managed database, and say where to buy it.

Bütün databases nöqtələri

Bütün tərtibatçı sənədləri

Doğrulama

API açarını bearer token kimi göndərin. Bu səhifə spresifikasiyada xüsusi icazə tələb etmir, buna görə də açarınıza ehtiyac duyduğu minimum səviyyədə icazə verin və güman etmək əvəzinə cavabı yoxlayın.

Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.

Sınaqdan keçir

Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.

curl -X POST https://api.zinndigital.com/v1/databases \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "label": <string>, "size": <string> }'

Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın

Təfərrüatlar

This endpoint no longer creates a database — it always answers 422 (docs/497 §8). Until 2026-09-05 it created a real cluster for nothing: no order, no invoice, no subscription and no charge, so a customer could run a highly-available database that never appeared on any bill. A managed database is bought: POST /v1/carts/{cartId}/lines with kind=managed_database and a database block, then checkout. Fulfilment creates the instance in provisioning and starts the Temporal workflow that builds it. The request is still validated first, so a caller learns why it would be refused before it goes to the basket and pays: the account is not in good standing, the label is blank or already used in this organisation, the size is not on sale, the engine or version is not one we run, the size belongs to a different engine, or the organisation already holds the self-service maximum. Only when all of that passes does it answer with the PURCHASE_REQUIRED code that names the basket. Gated on databases.manage in addition to databases.view.

Sorğu gövdəsi

AdTipTələb olunurNədir
labelstringBəli
sizestringBəliA size code from GET /v1/databases/catalogue.
enginestring<postgres, mysql>XeyrOptional. Omitted uses PostgreSQL. ⛔ Must match the engine the size code belongs to — a MySQL request carrying a db_pg_* size is refused, because it would run one engine and…
engine_versionstringXeyrOptional engine version — "18", "8.4". Omitted uses the newest we offer for the chosen engine. ⛔ A version too close to end of life is refused by name rather than silently…

Bu son nöqtənin qaytara biləcəyi xətalar

401 · 403 · 422