hosting

POST /v1/sites/{siteId}/databases

Create a database on a site.

Bütün hosting 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. Açar sites.view icazəsinə malik olmalıdır; bu icazəsi olmayan açar 404 deyil, 403 xətası ilə rədd edilir.

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/sites/{siteId}/databases \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "name": <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

Creates a database and its user, and returns the generated password exactly once. The password is generated by this platform rather than chosen by the caller, because it is a machine-to-machine credential that nobody types and a human-chosen one is the weakest link in a stack the customer cannot patch. It is not stored in our records, not logged, and cannot be read back by any endpoint — a customer who loses it creates another database. The effective ceiling is applied before the vendor is called: a package type that does not permit databases, and an allowance that is already spent, are both 422 with a sentence the customer can act on. A name the package already carries is 409. The vendor prefixes names per package, so the returned name is rarely the name that was asked for and the client must show the returned value. 404 for a site with no vendor hosting package. Requires sites.view and sites.panel_access.

Parametrlər

AdTipTələb olunurNədir
siteId (path)UuidBəliSite ID (UUIDv7).

Sorğu gövdəsi

AdTipTələb olunurNədir
namestringBəliThe name to ask for. The server's own name is returned in SiteHostingDatabase.name and may differ; there is deliberately no password field here, because the platform generates…

Cavab

AdTipTələb olunurNədir
databaseSiteHostingDatabaseBəliThe created database, exactly as listSiteDatabases will report it.
passwordstringBəliThe generated password, shown once. Deliberately carries no example — a documented example of a credential field is the shape people copy.

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

401 · 403 · 404 · 409 · 422 · 429 · 503