API referansı · 6 uç nokta
Admin · Users
Müşteri dizini ve transfer partneri hesapları. ADMIN rolü gerekir.
GET
/v1/admin/customers Bearer Müşteri dizini
Salt okunur — müşterinin kendi profilini düzenlemek yönetici işlemi değildir.
Parametreler
| Ad | Yer | Tip | Açıklama |
|---|---|---|---|
page | query | integer ≥ 1 · varsayılan 1 | |
perPage | query | integer 1–100 · varsayılan 24 | |
search | query | string en fazla 64 karakter | %, _ ve \ karakterleri sunucuda temizlenir. |
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 200 | PageMeta + { items: AdminCustomerDto[] } | Müşteri sayfası. |
| 400 | ApiError | validation_failed — gövde veya query şemaya uymuyor (details). |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
GET
/v1/admin/customers/{id} Bearer Müşteri detayı
Parametreler
| Ad | Yer | Tip | Açıklama |
|---|---|---|---|
id * | path | string |
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 200 | AdminCustomerDetailDto | Fatura profili, tekneler ve adresler dahil. |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
| 404 | ApiError | customer_not_found. |
GET
/v1/admin/transfers Bearer Transfer partneri hesapları
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 200 | TransferDto[] | Hesap listesi. |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
POST
/v1/admin/transfers Bearer Transfer partneri hesabı oluşturur
password gönderilmezse sunucu bir parola üretir ve yalnızca bu yanıtta generatedPassword alanında döner. Bir daha okunamaz.
İstek gövdesi CreateTransferRequest
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 201 | CreateTransferResponse | Oluşturuldu. |
| 400 | ApiError | validation_failed — gövde veya query şemaya uymuyor (details). |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
| 409 | ApiError | email_taken. |
PATCH
/v1/admin/transfers/{id} Bearer Transfer partnerini günceller
İstek gövdesi UpdateTransferRequest
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 200 | TransferDto | Güncel hesap. |
| 400 | ApiError | validation_failed — gövde veya query şemaya uymuyor (details). |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
| 404 | ApiError | transfer_not_found. |
DELETE
/v1/admin/transfers/{id} Bearer Transfer partnerini siler
Yanıtlar
| Durum | Gövde | Açıklama |
|---|---|---|
| 204 | — | Silindi. |
| 401 | ApiError | missing_token, invalid_token veya unauthenticated. |
| 403 | ApiError | insufficient_role — kimlik doğru, rol yetkili değil. |
| 404 | ApiError | transfer_not_found. |