{ "openapi": "3.0.3", "info": { "title": "C2 Cloud API", "version": "1.0.0", "description": "The customer API for the cloud at https://cloud.core.gen.tr.\n\nAuthenticate with a personal access token, created under Settings \u2192 API Tokens\nin the panel, sent as `Authorization: Bearer `.\n\nEvery token carries a set of abilities. A request whose token lacks the ability\nan endpoint requires is rejected with `403`, regardless of what the token's owner\nis otherwise allowed to do.\n\nErrors are RFC 9457 problem details with the media type `application/problem+json`.\n", "x-i18n": { "tr": { "description": "https://cloud.core.gen.tr adresindeki bulutun m\u00fc\u015fteri API'si.\n\nKimlik do\u011frulamas\u0131, panelde Ayarlar \u2192 API Anahtarlar\u0131 alt\u0131nda olu\u015fturulan bir ki\u015fisel\neri\u015fim anahtar\u0131yla yap\u0131l\u0131r; anahtar `Authorization: Bearer ` ba\u015fl\u0131\u011f\u0131yla g\u00f6nderilir.\n\nHer anahtar bir yetki k\u00fcmesi ta\u015f\u0131r. Bir u\u00e7 noktan\u0131n gerektirdi\u011fi yetkiyi ta\u015f\u0131mayan bir\nanahtarla gelen istek, anahtar\u0131n sahibinin ba\u015fka t\u00fcrl\u00fc nelere izinli oldu\u011funa\nbak\u0131lmaks\u0131z\u0131n `403` ile reddedilir.\n\nHatalar, `application/problem+json` ortam t\u00fcr\u00fcyle verilen RFC 9457 problem\nayr\u0131nt\u0131lar\u0131d\u0131r.\n" }, "ar": { "description": "\u0648\u0627\u062c\u0647\u0629 API \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0639\u0645\u0644\u0627\u0621 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0639\u0644\u0649 https://cloud.core.gen.tr.\n\n\u064a\u062c\u0631\u064a \u0627\u0644\u062a\u062d\u0642\u0642 \u0645\u0646 \u0627\u0644\u0647\u0648\u064a\u0629 \u0628\u0631\u0645\u0632 \u0648\u0635\u0648\u0644 \u0634\u062e\u0635\u064a \u064a\u064f\u0646\u0634\u0623 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0636\u0645\u0646 \u0627\u0644\u0625\u0639\u062f\u0627\u062f\u0627\u062a \u2190 \u0631\u0645\u0648\u0632 API\u060c \u0648\u064a\u064f\u0631\u0633\u0644\n\u0641\u064a \u0627\u0644\u062a\u0631\u0648\u064a\u0633\u0629 `Authorization: Bearer `.\n\n\u064a\u062d\u0645\u0644 \u0643\u0644 \u0631\u0645\u0632 \u0645\u062c\u0645\u0648\u0639\u0629 \u0645\u0646 \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0627\u062a. \u0648\u064a\u064f\u0631\u0641\u0636 \u0628\u0627\u0644\u0631\u0645\u0632 `403` \u0643\u0644 \u0637\u0644\u0628 \u0644\u0627 \u064a\u062d\u0645\u0644 \u0631\u0645\u0632\u0647 \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 \u0627\u0644\u062a\u064a\n\u062a\u0634\u062a\u0631\u0637\u0647\u0627 \u0646\u0642\u0637\u0629 \u0627\u0644\u0646\u0647\u0627\u064a\u0629\u060c \u0628\u0635\u0631\u0641 \u0627\u0644\u0646\u0638\u0631 \u0639\u0645\u0627 \u064a\u064f\u0633\u0645\u062d \u0644\u0645\u0627\u0644\u0643 \u0627\u0644\u0631\u0645\u0632 \u0628\u0641\u0639\u0644\u0647 \u062e\u0644\u0627\u0641 \u0630\u0644\u0643.\n\n\u0627\u0644\u0623\u062e\u0637\u0627\u0621 \u0647\u064a \u062a\u0641\u0627\u0635\u064a\u0644 \u0645\u0634\u0643\u0644\u0627\u062a \u0648\u0641\u0642 RFC 9457 \u0628\u0646\u0648\u0639 \u0627\u0644\u0648\u0633\u0627\u0626\u0637 `application/problem+json`.\n" } }, "contact": { "name": "C2 Support", "url": "https://cloud.core.gen.tr" } }, "servers": [ { "url": "https://cloud.core.gen.tr/api/v1", "description": "Production" } ], "security": [ { "bearerAuth": [] } ], "tags": [ { "name": "Identity", "description": "Who the presented token belongs to.", "x-i18n": { "tr": { "description": "Sunulan anahtar\u0131n kime ait oldu\u011fu.\n" }, "ar": { "description": "\u0644\u0645\u0646 \u064a\u0639\u0648\u062f \u0627\u0644\u0631\u0645\u0632 \u0627\u0644\u0645\u064f\u0642\u062f\u064e\u0651\u0645.\n" } } }, { "name": "Compute", "description": "Virtual machines.", "x-i18n": { "tr": { "description": "Sanal makineler.\n" }, "ar": { "description": "\u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629.\n" } } }, { "name": "Storage", "description": "Volumes and ISOs.", "x-i18n": { "tr": { "description": "Diskler ve ISO'lar.\n" }, "ar": { "description": "\u0648\u062d\u062f\u0627\u062a \u0627\u0644\u062a\u062e\u0632\u064a\u0646 \u0648\u0645\u0644\u0641\u0627\u062a ISO.\n" } } }, { "name": "Catalogue", "description": "Templates and offerings \u2014 the global, sellable product catalogue every instance\nand volume is built from. Read-only: see each endpoint's description for why\nreconciliation is never exposed here.\n", "x-i18n": { "tr": { "description": "\u015eablonlar ve teklifler \u2014 her sanal makinenin ve her veri deposunun \u00fczerine kuruldu\u011fu,\nsat\u0131labilir k\u00fcresel \u00fcr\u00fcn katalo\u011fu. Salt okunur: e\u015fitlemenin burada neden hi\u00e7bir zaman\nsunulmad\u0131\u011f\u0131n\u0131 her u\u00e7 noktan\u0131n a\u00e7\u0131klamas\u0131nda bulabilirsiniz.\n" }, "ar": { "description": "\u0627\u0644\u0642\u0648\u0627\u0644\u0628 \u0648\u0627\u0644\u0639\u0631\u0648\u0636 \u2014 \u0643\u062a\u0627\u0644\u0648\u062c \u0627\u0644\u0645\u0646\u062a\u062c\u0627\u062a \u0627\u0644\u0639\u0627\u0644\u0645\u064a \u0627\u0644\u0642\u0627\u0628\u0644 \u0644\u0644\u0628\u064a\u0639 \u0627\u0644\u0630\u064a \u064a\u064f\u0628\u0646\u0649 \u0645\u0646\u0647 \u0643\u0644 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a\n\u0648\u0643\u0644 \u0648\u062d\u062f\u0629 \u062a\u062e\u0632\u064a\u0646. \u0644\u0644\u0642\u0631\u0627\u0621\u0629 \u0641\u0642\u0637: \u0631\u0627\u062c\u0639 \u0648\u0635\u0641 \u0643\u0644 \u0646\u0642\u0637\u0629 \u0646\u0647\u0627\u064a\u0629 \u0644\u0645\u0639\u0631\u0641\u0629 \u0633\u0628\u0628 \u0639\u062f\u0645 \u0625\u062a\u0627\u062d\u0629 \u0627\u0644\u0645\u0632\u0627\u0645\u0646\u0629 \u0647\u0646\u0627\n\u0625\u0637\u0644\u0627\u0642\u064b\u0627.\n" } } }, { "name": "Network", "description": "Firewall rules, public IP addresses, VPN and affinity groups. See each\ncollection endpoint's description for the reconciling sibling it exists to\nkeep off the request path \u2014 network resources are where that reconciliation\ncompounds hardest, since reading firewall rules can also reconcile instances.\n", "x-i18n": { "tr": { "description": "G\u00fcvenlik duvar\u0131 kurallar\u0131, kamusal IP adresleri, VPN ve yak\u0131nl\u0131k gruplar\u0131. Her koleksiyon\nu\u00e7 noktas\u0131n\u0131n a\u00e7\u0131klamas\u0131nda, o u\u00e7 noktan\u0131n istek yolundan uzak tutmak i\u00e7in var oldu\u011fu\ne\u015fitleyen karde\u015fi anlat\u0131l\u0131r \u2014 bu e\u015fitlemenin en a\u011f\u0131r birikti\u011fi yer a\u011f kaynaklar\u0131d\u0131r,\n\u00e7\u00fcnk\u00fc g\u00fcvenlik duvar\u0131 kurallar\u0131n\u0131 okumak sanal makineleri de e\u015fitleyebilir.\n" }, "ar": { "description": "\u0642\u0648\u0627\u0639\u062f \u062c\u062f\u0627\u0631 \u0627\u0644\u062d\u0645\u0627\u064a\u0629 \u0648\u0639\u0646\u0627\u0648\u064a\u0646 IP \u0627\u0644\u0639\u0627\u0645\u0629 \u0648\u0634\u0628\u0643\u0627\u062a VPN \u0648\u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0627\u0644\u062a\u0642\u0627\u0631\u0628. \u0631\u0627\u062c\u0639 \u0648\u0635\u0641 \u0643\u0644 \u0646\u0642\u0637\u0629\n\u0646\u0647\u0627\u064a\u0629 \u062c\u0645\u0627\u0639\u064a\u0629 \u0644\u0645\u0639\u0631\u0641\u0629 \u0627\u0644\u0646\u0638\u064a\u0631 \u0627\u0644\u0645\u064f\u0632\u0627\u0645\u0650\u0646 \u0627\u0644\u0630\u064a \u0648\u064f\u062c\u062f\u062a \u0644\u0625\u0628\u0642\u0627\u0626\u0647 \u062e\u0627\u0631\u062c \u0645\u0633\u0627\u0631 \u0627\u0644\u0637\u0644\u0628 \u2014 \u0641\u0645\u0648\u0627\u0631\u062f \u0627\u0644\u0634\u0628\u0643\u0629\n\u0647\u064a \u0627\u0644\u0645\u0648\u0636\u0639 \u0627\u0644\u0630\u064a \u062a\u062a\u0631\u0627\u0643\u0645 \u0641\u064a\u0647 \u0647\u0630\u0647 \u0627\u0644\u0645\u0632\u0627\u0645\u0646\u0629 \u0623\u0634\u062f\u0651 \u0645\u0627 \u064a\u0643\u0648\u0646\u060c \u0625\u0630 \u0625\u0646 \u0642\u0631\u0627\u0621\u0629 \u0642\u0648\u0627\u0639\u062f \u062c\u062f\u0627\u0631 \u0627\u0644\u062d\u0645\u0627\u064a\u0629 \u0642\u062f\n\u062a\u064f\u0632\u0627\u0645\u0646 \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0623\u064a\u0636\u064b\u0627.\n" } } }, { "name": "DNS", "description": "Zones and records on the panel's DNS integration. `refresh=true` on any\nread here is the widest-blast-radius reconciliation in the whole API \u2014 there\nis no single-zone reconcile primitive, so it always resyncs the caller's\nentire DNS account, not just the resource addressed by the request.\n", "x-i18n": { "tr": { "description": "Panelin DNS t\u00fcmle\u015fi\u011findeki alanlar ve kay\u0131tlar. Buradaki herhangi bir okumada\n`refresh=true`, API'nin tamam\u0131ndaki en geni\u015f etki alan\u0131na sahip e\u015fitlemedir \u2014 tek bir\nalan\u0131 e\u015fitleyen bir i\u015flem yoktur, bu y\u00fczden her seferinde \u00e7a\u011f\u0131ran\u0131n DNS hesab\u0131n\u0131n\ntamam\u0131 yeniden e\u015fitlenir, yaln\u0131zca iste\u011fin adresledi\u011fi kaynak de\u011fil.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0646\u0627\u0637\u0642 \u0648\u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0641\u064a \u062a\u0643\u0627\u0645\u0644 DNS \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u0644\u0648\u062d\u0629. \u0627\u0633\u062a\u062e\u062f\u0627\u0645 `refresh=true` \u0641\u064a \u0623\u064a \u0642\u0631\u0627\u0621\u0629\n\u0647\u0646\u0627 \u0647\u0648 \u0623\u0648\u0633\u0639 \u0645\u0632\u0627\u0645\u0646\u0629 \u0623\u062b\u0631\u064b\u0627 \u0641\u064a \u0648\u0627\u062c\u0647\u0629 API \u0628\u0623\u0633\u0631\u0647\u0627 \u2014 \u0641\u0644\u0627 \u062a\u0648\u062c\u062f \u0639\u0645\u0644\u064a\u0629 \u0623\u0648\u0644\u064a\u0629 \u0644\u0645\u0632\u0627\u0645\u0646\u0629 \u0645\u0646\u0637\u0642\u0629\n\u0648\u0627\u062d\u062f\u0629\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u064f\u0639\u0627\u062f \u062f\u0627\u0626\u0645\u064b\u0627 \u0645\u0632\u0627\u0645\u0646\u0629 \u062d\u0633\u0627\u0628 DNS \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u0645\u064f\u0633\u062a\u062f\u0639\u064a \u0628\u0627\u0644\u0643\u0627\u0645\u0644\u060c \u0644\u0627 \u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0630\u064a\n\u064a\u062e\u0627\u0637\u0628\u0647 \u0627\u0644\u0637\u0644\u0628 \u0641\u062d\u0633\u0628.\n" } } }, { "name": "Billing", "description": "The sellable catalogue, subscriptions and their cancellation, payments, stored\ncredit cards, refunds, the account balance and ordering. `POST /orders` pays\n**only** from the account balance: every card charge in this system requires an\ninteractive 3-D Secure challenge in a browser, which nothing here can complete\nheadlessly, so the order path takes a payment method that has no card to reach\nfor. See each endpoint's description for the reconciling sibling \u2014 if any \u2014 it\ndeliberately keeps off the request path.\n", "x-i18n": { "tr": { "description": "Sat\u0131labilir katalog, abonelikler ve iptalleri, \u00f6demeler, sakl\u0131 kredi kartlar\u0131, iadeler,\nhesap bakiyesi ve sipari\u015f verme. `POST /orders` **yaln\u0131zca** hesap bakiyesinden \u00f6der: bu\nsistemdeki her kart \u00e7ekimi, taray\u0131c\u0131da etkile\u015fimli bir 3-D Secure ad\u0131m\u0131 gerektirir ve\nburadaki hi\u00e7bir u\u00e7 nokta bunu ekrans\u0131z tamamlayamaz; bu y\u00fczden sipari\u015f yolu, uzanaca\u011f\u0131\nbir kart\u0131 olmayan bir \u00f6deme y\u00f6ntemi kullan\u0131r. Her u\u00e7 noktan\u0131n a\u00e7\u0131klamas\u0131nda, o u\u00e7\nnoktan\u0131n istek yolundan bilerek uzak tuttu\u011fu e\u015fitleyen karde\u015fi \u2014 varsa \u2014 anlat\u0131l\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c \u0627\u0644\u0642\u0627\u0628\u0644 \u0644\u0644\u0628\u064a\u0639\u060c \u0648\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0648\u0625\u0644\u063a\u0627\u0624\u0647\u0627\u060c \u0648\u0627\u0644\u0645\u062f\u0641\u0648\u0639\u0627\u062a\u060c \u0648\u0628\u0637\u0627\u0642\u0627\u062a \u0627\u0644\u0627\u0626\u062a\u0645\u0627\u0646 \u0627\u0644\u0645\u062d\u0641\u0648\u0638\u0629\u060c\n\u0648\u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f\u0627\u062a\u060c \u0648\u0631\u0635\u064a\u062f \u0627\u0644\u062d\u0633\u0627\u0628\u060c \u0648\u062a\u0642\u062f\u064a\u0645 \u0627\u0644\u0637\u0644\u0628\u0627\u062a. \u062a\u062f\u0641\u0639 `POST /orders` **\u0645\u0646 \u0631\u0635\u064a\u062f \u0627\u0644\u062d\u0633\u0627\u0628 \u0641\u0642\u0637**:\n\u0641\u0643\u0644 \u062e\u0635\u0645 \u0645\u0646 \u0628\u0637\u0627\u0642\u0629 \u0641\u064a \u0647\u0630\u0627 \u0627\u0644\u0646\u0638\u0627\u0645 \u064a\u062a\u0637\u0644\u0628 \u062e\u0637\u0648\u0629 3-D Secure \u062a\u0641\u0627\u0639\u0644\u064a\u0629 \u0641\u064a \u0627\u0644\u0645\u062a\u0635\u0641\u062d\u060c \u0648\u0644\u0627 \u0634\u064a\u0621 \u0647\u0646\u0627\n\u064a\u0633\u062a\u0637\u064a\u0639 \u0625\u062a\u0645\u0627\u0645\u0647\u0627 \u062f\u0648\u0646 \u0648\u0627\u062c\u0647\u0629\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u0633\u062a\u062e\u062f\u0645 \u0645\u0633\u0627\u0631 \u0627\u0644\u0637\u0644\u0628 \u0648\u0633\u064a\u0644\u0629 \u062f\u0641\u0639 \u0644\u0627 \u0628\u0637\u0627\u0642\u0629 \u0644\u0647\u0627 \u0623\u0635\u0644\u064b\u0627. \u0648\u0631\u0627\u062c\u0639\n\u0648\u0635\u0641 \u0643\u0644 \u0646\u0642\u0637\u0629 \u0646\u0647\u0627\u064a\u0629 \u0644\u0645\u0639\u0631\u0641\u0629 \u0627\u0644\u0646\u0638\u064a\u0631 \u0627\u0644\u0645\u064f\u0632\u0627\u0645\u0650\u0646 \u2014 \u0625\u0646 \u0648\u064f\u062c\u062f \u2014 \u0627\u0644\u0630\u064a \u062a\u064f\u0628\u0642\u064a\u0647 \u0639\u0645\u062f\u064b\u0627 \u062e\u0627\u0631\u062c \u0645\u0633\u0627\u0631\n\u0627\u0644\u0637\u0644\u0628.\n" } } }, { "name": "Tickets", "description": "Your account's own support tickets: read them, open one, reply and close. Every write\nreaches our support staff at once, in the token owner's name, and has no undo. Files\nare attached from the panel only.\n", "x-i18n": { "tr": { "description": "Hesab\u0131n\u0131z\u0131n kendi destek talepleri: okuyun, yeni bir talep a\u00e7\u0131n, yan\u0131t yaz\u0131n ve\nkapat\u0131n. Her yazma, anahtar\u0131n sahibi ad\u0131na hemen destek ekibimize ula\u015f\u0131r ve geri\nal\u0131namaz. Dosyalar yaln\u0131zca panelden eklenir.\n" }, "ar": { "description": "\u062a\u0630\u0627\u0643\u0631 \u0627\u0644\u062f\u0639\u0645 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u062d\u0633\u0627\u0628\u0643: \u0627\u0642\u0631\u0623\u0647\u0627\u060c \u0648\u0627\u0641\u062a\u062d \u062a\u0630\u0643\u0631\u0629\u060c \u0648\u0631\u062f\u0651 \u0639\u0644\u064a\u0647\u0627\u060c \u0648\u0623\u063a\u0644\u0642\u0647\u0627. \u0648\u0643\u0644 \u0643\u062a\u0627\u0628\u0629 \u062a\u0635\u0644 \u0625\u0644\u0649\n\u0641\u0631\u064a\u0642 \u0627\u0644\u062f\u0639\u0645 \u0641\u0648\u0631\u064b\u0627 \u0628\u0627\u0633\u0645 \u0645\u0627\u0644\u0643 \u0627\u0644\u0631\u0645\u0632\u060c \u0648\u0644\u0627 \u064a\u0645\u0643\u0646 \u0627\u0644\u062a\u0631\u0627\u062c\u0639 \u0639\u0646\u0647\u0627. \u0648\u0644\u0627 \u062a\u064f\u0631\u0641\u0642 \u0627\u0644\u0645\u0644\u0641\u0627\u062a \u0625\u0644\u0627 \u0645\u0646\n\u0627\u0644\u0644\u0648\u062d\u0629.\n" } } }, { "name": "Usage", "description": "What your cloud consumed \u2014 machine hours, storage, IP address hours and network\ntraffic. Quantities only; the bill is under Billing.\n", "x-i18n": { "tr": { "description": "Bulutunuzun ne t\u00fcketti\u011fi \u2014 makine saatleri, depolama, IP adresi saatleri ve a\u011f\ntrafi\u011fi. Yaln\u0131zca miktarlar; fatura Faturalama alt\u0131ndad\u0131r.\n" }, "ar": { "description": "\u0645\u0627 \u0627\u0633\u062a\u0647\u0644\u0643\u062a\u0647 \u0633\u062d\u0627\u0628\u062a\u0643 \u2014 \u0633\u0627\u0639\u0627\u062a \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0648\u0627\u0644\u062a\u062e\u0632\u064a\u0646 \u0648\u0633\u0627\u0639\u0627\u062a \u0639\u0646\u0627\u0648\u064a\u0646 IP \u0648\u062d\u0631\u0643\u0629 \u0627\u0644\u0634\u0628\u0643\u0629. \u0643\u0645\u064a\u0627\u062a\n\u0641\u0642\u0637\u061b \u0648\u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0636\u0645\u0646 \u0627\u0644\u0641\u0648\u062a\u0631\u0629.\n" } } }, { "name": "Admin", "description": "Staff reads of the whole install, plus a deliberately small set of\ninstance-lifecycle writes, for a token carrying `admin:read` or `admin:write`\nwhose owner also holds the `admin` or `super-admin` role. The ability alone is\nnever enough: a token outlives the role its holder had when it was minted, so the\nrole is checked on every request.\n\nThe read/write split rests on nothing but the route table. `AdminPolicyTrait::before()`\nreturns `true` for anyone holding the `admin` role, and almost every policy in the\napplication uses it \u2014 so no policy can distinguish an admin's read from an admin's\nwrite; `abilities:admin:read` versus `abilities:admin:write` plus the HTTP verb is\nthe entire enforcement, and a test walks the route table to keep it that way.\n\nWrites are confined to instance lifecycle \u2014 start, stop, restart, attach ISO,\ndetach ISO \u2014 because an admin already has full write over every customer's cloud\nthrough the panel, so refusing it to an `admin:write` token bought no safety; it\nonly meant the one channel that could be scripted was the one nobody could audit\nor rate-limit. Two things are deliberately absent: instance destroy, because\n`subscriptions.instance_id` must be released before an instance is deleted and a\nbare destroy would orphan a live billing row; and volume attach/detach, because it\nneeds a second cross-ownership check with no precedent on this surface. Both are\ncandidates for a later round, not oversights.\n\nEvery customer-scoped read on this surface writes an `.pii_read` row into\nthe audit trail, exactly as the equivalent panel page does, and is charged\nagainst a tighter rate-limit budget than an ordinary read for that reason. Every\nwrite writes its own explicit `cloud.instance_*` row instead \u2014 the access-log\nmiddleware only records a successful GET \u2014 including when idempotency skipped the\nunderlying CloudStack call, because the auditable act is the request an admin\nmade, not whether CloudStack was actually dialled.\n\nInstallation content and the approval queue sit beside those customer routes, with no\n`{user}` in their paths. News drafts are created and edited directly; publishing one is\nonly ever ASKED for \u2014 the request stages it and answers `202` \u2014 and\n`GET /admin/staged-actions` reports what became of it. Nothing on this API approves or\nrejects a staged request: that is a signed-in administrator's click on the panel's\napprovals page, so a token can ask and can never decide. `GET /admin/work-queues` and\n`GET /admin/health` read the operator board's counts and the installation's health;\nneither names a person.\n", "x-i18n": { "tr": { "description": "Kurulumun tamam\u0131 \u00fczerinde personel okumalar\u0131 ve bunun yan\u0131nda, bilerek k\u00fc\u00e7\u00fck tutulmu\u015f\nbir sanal makine ya\u015fam d\u00f6ng\u00fcs\u00fc yazma k\u00fcmesi; `admin:read` veya `admin:write` ta\u015f\u0131yan ve\nsahibi `admin` ya da `super-admin` rol\u00fcn\u00fc de tutan bir anahtar i\u00e7indir. Yetkinin tek\nba\u015f\u0131na olmas\u0131 hi\u00e7bir zaman yetmez: bir anahtar, sahibinin onu ald\u0131\u011f\u0131 s\u0131radaki rol\u00fcnden\ndaha uzun ya\u015far, bu y\u00fczden rol her istekte denetlenir.\n\nOkuma/yazma ayr\u0131m\u0131 yaln\u0131zca y\u00f6nlendirme tablosuna dayan\u0131r. `AdminPolicyTrait::before()`,\n`admin` rol\u00fcn\u00fc tutan herkes i\u00e7in `true` d\u00f6nd\u00fcr\u00fcr ve uygulamadaki neredeyse her ilke bunu\nkullan\u0131r \u2014 dolay\u0131s\u0131yla hi\u00e7bir ilke bir y\u00f6neticinin okumas\u0131n\u0131 yazmas\u0131ndan ay\u0131rt edemez;\nzorlaman\u0131n tamam\u0131 `abilities:admin:read` ile `abilities:admin:write` ayr\u0131m\u0131 ve HTTP\nfiilidir, ve bir test bunu b\u00f6yle tutmak i\u00e7in y\u00f6nlendirme tablosunu dola\u015f\u0131r.\n\nYazmalar sanal makine ya\u015fam d\u00f6ng\u00fcs\u00fcyle s\u0131n\u0131rl\u0131d\u0131r \u2014 ba\u015flatma, durdurma, yeniden\nba\u015flatma, ISO takma, ISO \u00e7\u0131karma \u2014 \u00e7\u00fcnk\u00fc bir y\u00f6netici panel \u00fczerinden zaten her\nm\u00fc\u015fterinin bulutu \u00fczerinde tam yazma yetkisine sahiptir; bunu bir `admin:write`\nanahtar\u0131na yasaklamak hi\u00e7bir g\u00fcvenlik kazand\u0131rm\u0131yordu, yaln\u0131zca betiklenebilen tek\nkanal\u0131n denetlenemeyen ve h\u0131z s\u0131n\u0131r\u0131 konulamayan kanal olmas\u0131 anlam\u0131na geliyordu. \u0130ki \u015fey\nbilerek yoktur: sanal makine silme, \u00e7\u00fcnk\u00fc bir makine silinmeden \u00f6nce\n`subscriptions.instance_id` serbest b\u0131rak\u0131lmal\u0131d\u0131r ve \u00e7\u0131plak bir silme, canl\u0131 bir\nfaturalama sat\u0131r\u0131n\u0131 sahipsiz b\u0131rak\u0131rd\u0131; ve veri deposu takma/\u00e7\u0131karma, \u00e7\u00fcnk\u00fc bu, bu\ny\u00fczeyde \u00f6rne\u011fi bulunmayan ikinci bir \u00e7apraz sahiplik denetimi gerektirir. \u0130kisi de bir\nsonraki turun aday\u0131d\u0131r, g\u00f6zden ka\u00e7m\u0131\u015f de\u011fildir.\n\nBu y\u00fczeydeki, bir m\u00fc\u015fteriyle s\u0131n\u0131rl\u0131 her okuma denetim izine bir `.pii_read`\nsat\u0131r\u0131 yazar \u2014 panelin e\u015fde\u011fer sayfas\u0131n\u0131n yapt\u0131\u011f\u0131 gibi \u2014 ve tam da bu nedenle s\u0131radan bir\nokumadan daha dar bir h\u0131z s\u0131n\u0131r\u0131 b\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr. Her yazma ise kendi a\u00e7\u0131k\n`cloud.instance_*` sat\u0131r\u0131n\u0131 yazar; eri\u015fim g\u00fcnl\u00fc\u011f\u00fc ara katman\u0131 yaln\u0131zca ba\u015far\u0131l\u0131 bir\nGET'i kaydeder. Bu, etkisi yinelenebilirlik sayesinde alttaki CloudStack \u00e7a\u011fr\u0131s\u0131n\u0131n\natland\u0131\u011f\u0131 durumlar\u0131 da kapsar, \u00e7\u00fcnk\u00fc denetlenebilir eylem y\u00f6neticinin yapt\u0131\u011f\u0131 istektir,\nCloudStack'in ger\u00e7ekten aran\u0131p aranmad\u0131\u011f\u0131 de\u011fil.\n\nKurulum i\u00e7eri\u011fi ve onay kuyru\u011fu bu m\u00fc\u015fteri rotalar\u0131n\u0131n yan\u0131nda durur; yollar\u0131nda\n`{user}` yoktur. Duyuru taslaklar\u0131 do\u011frudan olu\u015fturulur ve d\u00fczenlenir; birinin\nyay\u0131mlanmas\u0131 ise yaln\u0131zca \u0130STENEB\u0130L\u0130R \u2014 istek onu kuyru\u011fa al\u0131r ve `202` d\u00f6ner \u2014 ve\nsonunun ne oldu\u011funu `GET /admin/staged-actions` bildirir. Bu API'deki hi\u00e7bir \u015fey kuyru\u011fa\nal\u0131nm\u0131\u015f bir iste\u011fi onaylamaz ya da reddetmez: bu, oturum a\u00e7m\u0131\u015f bir y\u00f6neticinin paneldeki\nonaylar sayfas\u0131nda yapt\u0131\u011f\u0131 bir t\u0131klamad\u0131r; dolay\u0131s\u0131yla bir anahtar isteyebilir ama asla\nkarar veremez. `GET /admin/work-queues` ve `GET /admin/health`, operat\u00f6r panosunun\nsay\u0131lar\u0131n\u0131 ve kurulumun sa\u011fl\u0131k durumunu okur; hi\u00e7biri bir ki\u015finin ad\u0131n\u0131 vermez.\n" }, "ar": { "description": "\u0642\u0631\u0627\u0621\u0627\u062a \u0627\u0644\u0645\u0648\u0638\u0641\u064a\u0646 \u0644\u0643\u0627\u0645\u0644 \u0627\u0644\u062a\u062b\u0628\u064a\u062a\u060c \u0625\u0636\u0627\u0641\u0629 \u0625\u0644\u0649 \u0645\u062c\u0645\u0648\u0639\u0629 \u0635\u063a\u064a\u0631\u0629 \u0639\u0646 \u0642\u0635\u062f \u0645\u0646 \u0639\u0645\u0644\u064a\u0627\u062a \u0627\u0644\u0643\u062a\u0627\u0628\u0629 \u0639\u0644\u0649\n\u062f\u0648\u0631\u0629 \u062d\u064a\u0627\u0629 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u060c \u0648\u0647\u064a \u0645\u062a\u0627\u062d\u0629 \u0644\u0631\u0645\u0632 \u064a\u062d\u0645\u0644 `admin:read` \u0623\u0648 `admin:write` \u0648\u064a\u062d\u0645\u0644\n\u0645\u0627\u0644\u0643\u0647 \u0643\u0630\u0644\u0643 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`. \u0648\u0644\u0627 \u062a\u0643\u0641\u064a \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 \u0648\u062d\u062f\u0647\u0627 \u0623\u0628\u062f\u064b\u0627: \u0641\u0627\u0644\u0631\u0645\u0632 \u064a\u0639\u064a\u0634\n\u0623\u0637\u0648\u0644 \u0645\u0646 \u0627\u0644\u062f\u0648\u0631 \u0627\u0644\u0630\u064a \u0643\u0627\u0646 \u064a\u062d\u0645\u0644\u0647 \u0635\u0627\u062d\u0628\u0647 \u0639\u0646\u062f \u0625\u0635\u062f\u0627\u0631\u0647\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u064f\u0641\u062d\u0635 \u0627\u0644\u062f\u0648\u0631 \u0645\u0639 \u0643\u0644 \u0637\u0644\u0628.\n\n\u0648\u0644\u0627 \u064a\u0633\u062a\u0646\u062f \u0627\u0644\u0641\u0635\u0644 \u0628\u064a\u0646 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0648\u0627\u0644\u0643\u062a\u0627\u0628\u0629 \u0625\u0644\u0649 \u0634\u064a\u0621 \u0633\u0648\u0649 \u062c\u062f\u0648\u0644 \u0627\u0644\u0645\u0633\u0627\u0631\u0627\u062a. \u0625\u0630 \u062a\u064f\u0639\u064a\u062f\n`AdminPolicyTrait::before()` \u0627\u0644\u0642\u064a\u0645\u0629 `true` \u0644\u0643\u0644 \u0645\u0646 \u064a\u062d\u0645\u0644 \u062f\u0648\u0631 `admin`\u060c \u0648\u062a\u0633\u062a\u062e\u062f\u0645\u0647\u0627 \u0643\u0644 \u0633\u064a\u0627\u0633\u0627\u062a\n\u0627\u0644\u062a\u0637\u0628\u064a\u0642 \u062a\u0642\u0631\u064a\u0628\u064b\u0627 \u2014 \u0641\u0644\u0627 \u062a\u0633\u062a\u0637\u064a\u0639 \u0623\u064a \u0633\u064a\u0627\u0633\u0629 \u0623\u0646 \u062a\u0645\u064a\u0651\u0632 \u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0645\u062f\u064a\u0631 \u0645\u0646 \u0643\u062a\u0627\u0628\u062a\u0647\u061b \u0648\u0627\u0644\u062a\u0646\u0641\u064a\u0630 \u0643\u0644\u0647 \u0647\u0648\n`abilities:admin:read` \u0645\u0642\u0627\u0628\u0644 `abilities:admin:write` \u0645\u0639 \u0641\u0639\u0644 HTTP\u060c \u0648\u064a\u0633\u064a\u0631 \u0627\u062e\u062a\u0628\u0627\u0631 \u0639\u0644\u0649 \u062c\u062f\u0648\u0644\n\u0627\u0644\u0645\u0633\u0627\u0631\u0627\u062a \u0644\u064a\u064f\u0628\u0642\u064a \u0627\u0644\u0623\u0645\u0631 \u0643\u0630\u0644\u0643.\n\n\u0648\u062a\u0642\u062a\u0635\u0631 \u0639\u0645\u0644\u064a\u0627\u062a \u0627\u0644\u0643\u062a\u0627\u0628\u0629 \u0639\u0644\u0649 \u062f\u0648\u0631\u0629 \u062d\u064a\u0627\u0629 \u0627\u0644\u062c\u0647\u0627\u0632 \u2014 \u0627\u0644\u062a\u0634\u063a\u064a\u0644 \u0648\u0627\u0644\u0625\u064a\u0642\u0627\u0641 \u0648\u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u062a\u0634\u063a\u064a\u0644 \u0648\u0625\u0631\u0641\u0627\u0642 ISO\n\u0648\u0641\u0635\u0644\u0647 \u2014 \u0644\u0623\u0646 \u0627\u0644\u0645\u062f\u064a\u0631 \u064a\u0645\u0644\u0643 \u0623\u0635\u0644\u064b\u0627 \u0635\u0644\u0627\u062d\u064a\u0629 \u0643\u062a\u0627\u0628\u0629 \u0643\u0627\u0645\u0644\u0629 \u0639\u0644\u0649 \u0633\u062d\u0627\u0628\u0629 \u0643\u0644 \u0639\u0645\u064a\u0644 \u0639\u0628\u0631 \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0641\u0645\u0646\u0639\u0647\u0627\n\u0639\u0646 \u0631\u0645\u0632 `admin:write` \u0644\u0645 \u064a\u0643\u0646 \u0644\u064a\u0636\u064a\u0641 \u0623\u0645\u0627\u0646\u064b\u0627\u061b \u0628\u0644 \u0643\u0627\u0646 \u064a\u0639\u0646\u064a \u0641\u0642\u0637 \u0623\u0646 \u0627\u0644\u0642\u0646\u0627\u0629 \u0627\u0644\u0648\u062d\u064a\u062f\u0629 \u0627\u0644\u0642\u0627\u0628\u0644\u0629\n\u0644\u0644\u0628\u0631\u0645\u062c\u0629 \u0647\u064a \u0627\u0644\u0642\u0646\u0627\u0629 \u0627\u0644\u062a\u064a \u0644\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0623\u062d\u062f \u062a\u062f\u0642\u064a\u0642\u0647\u0627 \u0623\u0648 \u062a\u062d\u062f\u064a\u062f \u0645\u0639\u062f\u0651\u0644\u0647\u0627. \u0648\u0647\u0646\u0627\u0643 \u0623\u0645\u0631\u0627\u0646 \u063a\u0627\u0626\u0628\u0627\u0646 \u0639\u0646\n\u0639\u0645\u062f: \u062d\u0630\u0641 \u0627\u0644\u062c\u0647\u0627\u0632\u060c \u0644\u0623\u0646 `subscriptions.instance_id` \u064a\u062c\u0628 \u062a\u062d\u0631\u064a\u0631\u0647 \u0642\u0628\u0644 \u062d\u0630\u0641 \u0623\u064a \u062c\u0647\u0627\u0632\u060c \u0648\u0627\u0644\u062d\u0630\u0641\n\u0627\u0644\u0645\u062c\u0631\u0651\u062f \u0643\u0627\u0646 \u0633\u064a\u062a\u0631\u0643 \u0633\u0637\u0631 \u0641\u0648\u062a\u0631\u0629 \u062d\u064a\u064b\u0651\u0627 \u0628\u0644\u0627 \u0645\u0627\u0644\u0643\u061b \u0648\u0625\u0631\u0641\u0627\u0642 \u0648\u062d\u062f\u0627\u062a \u0627\u0644\u062a\u062e\u0632\u064a\u0646 \u0648\u0641\u0635\u0644\u0647\u0627\u060c \u0644\u0623\u0646 \u0630\u0644\u0643 \u064a\u062d\u062a\u0627\u062c\n\u0625\u0644\u0649 \u0641\u062d\u0635 \u0645\u0644\u0643\u064a\u0629 \u0645\u062a\u0642\u0627\u0637\u0639 \u062b\u0627\u0646\u064d \u0644\u0627 \u0633\u0627\u0628\u0642\u0629 \u0644\u0647 \u0639\u0644\u0649 \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629. \u0648\u0643\u0644\u0627\u0647\u0645\u0627 \u0645\u0631\u0634\u0651\u062d \u0644\u062c\u0648\u0644\u0629 \u0644\u0627\u062d\u0642\u0629\u060c \u0644\u0627\n\u0633\u0647\u0648.\n\n\u0648\u0643\u0644 \u0642\u0631\u0627\u0621\u0629 \u0645\u062d\u0635\u0648\u0631\u0629 \u0628\u0639\u0645\u064a\u0644 \u0639\u0644\u0649 \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u062a\u0643\u062a\u0628 \u0633\u0637\u0631 `.pii_read` \u0641\u064a \u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642\u060c\n\u062a\u0645\u0627\u0645\u064b\u0627 \u0643\u0645\u0627 \u062a\u0641\u0639\u0644 \u0635\u0641\u062d\u0629 \u0627\u0644\u0644\u0648\u062d\u0629 \u0627\u0644\u0645\u0642\u0627\u0628\u0644\u0629\u060c \u0648\u0644\u0647\u0630\u0627 \u0627\u0644\u0633\u0628\u0628 \u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0645\u0639\u062f\u0651\u0644 \u0623\u0636\u064a\u0642 \u0645\u0646\n\u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0639\u0627\u062f\u064a\u0629. \u0623\u0645\u0627 \u0643\u0644 \u0639\u0645\u0644\u064a\u0629 \u0643\u062a\u0627\u0628\u0629 \u0641\u062a\u0643\u062a\u0628 \u0633\u0637\u0631 `cloud.instance_*` \u0627\u0644\u062e\u0627\u0635 \u0628\u0647\u0627 \u0635\u0631\u0627\u062d\u0629\u064b \u2014 \u0625\u0630\n\u0644\u0627 \u062a\u0633\u062c\u0651\u0644 \u0648\u0633\u064a\u0637\u0629 \u0633\u062c\u0644 \u0627\u0644\u0648\u0635\u0648\u0644 \u0633\u0648\u0649 \u0637\u0644\u0628\u0627\u062a GET \u0627\u0644\u0646\u0627\u062c\u062d\u0629 \u2014 \u0628\u0645\u0627 \u0641\u064a \u0630\u0644\u0643 \u0627\u0644\u062d\u0627\u0644\u0627\u062a \u0627\u0644\u062a\u064a \u062a\u062e\u0637\u0651\u0649 \u0641\u064a\u0647\u0627\n\u0627\u0644\u062a\u0643\u0627\u0641\u0624 \u0627\u0633\u062a\u062f\u0639\u0627\u0621 CloudStack \u0627\u0644\u0623\u0633\u0627\u0633\u064a\u060c \u0644\u0623\u0646 \u0627\u0644\u0641\u0639\u0644 \u0627\u0644\u0642\u0627\u0628\u0644 \u0644\u0644\u062a\u062f\u0642\u064a\u0642 \u0647\u0648 \u0627\u0644\u0637\u0644\u0628 \u0627\u0644\u0630\u064a \u0642\u062f\u0651\u0645\u0647 \u0627\u0644\u0645\u062f\u064a\u0631\u060c\n\u0644\u0627 \u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646 CloudStack \u0642\u062f \u0627\u0633\u062a\u064f\u062f\u0639\u064a \u0641\u0639\u0644\u064b\u0627.\n\n\u0648\u064a\u0642\u0641 \u0645\u062d\u062a\u0648\u0649 \u0627\u0644\u062a\u062b\u0628\u064a\u062a \u0648\u0642\u0627\u0626\u0645\u0629 \u0627\u0646\u062a\u0638\u0627\u0631 \u0627\u0644\u0645\u0648\u0627\u0641\u0642\u0627\u062a \u0625\u0644\u0649 \u062c\u0627\u0646\u0628 \u0645\u0633\u0627\u0631\u0627\u062a \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0647\u0630\u0647\u060c \u0648\u0644\u0627 \u064a\u062d\u062a\u0648\u064a \u0623\u064a\u064c\u0651\n\u0645\u0646 \u0645\u0633\u0627\u0631\u0627\u062a\u0647\u0627 \u0639\u0644\u0649 `{user}`. \u062a\u064f\u0646\u0634\u0623 \u0645\u0633\u0648\u062f\u0627\u062a \u0627\u0644\u0623\u062e\u0628\u0627\u0631 \u0648\u062a\u064f\u0639\u062f\u064e\u0651\u0644 \u0645\u0628\u0627\u0634\u0631\u0629\u061b \u0623\u0645\u0627 \u0646\u0634\u0631 \u0623\u062d\u062f\u0647\u0627 \u0641\u0644\u0627 \u064a\u0643\u0648\u0646 \u0625\u0644\u0627\n\u0637\u0644\u0628\u064b\u0627 \u2014 \u0625\u0630 \u064a\u064f\u062f\u0631\u062c\u0647 \u0627\u0644\u0637\u0644\u0628 \u0641\u064a \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631 \u0648\u064a\u062c\u064a\u0628 \u0628\u0640 `202` \u2014 \u0648\u062a\u064f\u0628\u0644\u063a\n`GET /admin/staged-actions` \u0628\u0645\u0627 \u0622\u0644 \u0625\u0644\u064a\u0647. \u0648\u0644\u0627 \u0634\u064a\u0621 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u064a\u0648\u0627\u0641\u0642 \u0639\u0644\u0649 \u0637\u0644\u0628 \u0645\u064f\u062f\u0631\u064e\u062c \u0623\u0648\n\u064a\u0631\u0641\u0636\u0647: \u0641\u0630\u0644\u0643 \u0646\u0642\u0631\u0629 \u064a\u0624\u062f\u064a\u0647\u0627 \u0645\u062f\u064a\u0631 \u0645\u0633\u062c\u064e\u0651\u0644 \u0627\u0644\u062f\u062e\u0648\u0644 \u0641\u064a \u0635\u0641\u062d\u0629 \u0627\u0644\u0645\u0648\u0627\u0641\u0642\u0627\u062a \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0641\u0627\u0644\u0631\u0645\u0632 \u064a\u0633\u062a\u0637\u064a\u0639\n\u0623\u0646 \u064a\u0637\u0644\u0628 \u0648\u0644\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0623\u0646 \u064a\u0642\u0631\u0651\u0631 \u0623\u0628\u062f\u064b\u0627. \u0648\u062a\u0642\u0631\u0623 `GET /admin/work-queues` \u0648`GET /admin/health`\n\u0623\u0639\u062f\u0627\u062f \u0644\u0648\u062d\u0629 \u0627\u0644\u0645\u0634\u063a\u0651\u0644 \u0648\u062d\u0627\u0644\u0629 \u0633\u0644\u0627\u0645\u0629 \u0627\u0644\u062a\u062b\u0628\u064a\u062a\u061b \u0648\u0644\u0627 \u062a\u0630\u0643\u0631 \u0623\u064a\u064c\u0651 \u0645\u0646\u0647\u0645\u0627 \u0627\u0633\u0645 \u0634\u062e\u0635.\n" } } }, { "name": "Support", "description": "Assignment-scoped reads of one customer's data, for a token carrying\n`support:read` whose owner holds the `support` or `super-admin` role.\n\nA support agent sees only the customers they hold a `support_assignments` row\nfor, and within those only the domains their per-domain capability level covers.\nA `super-admin` short-circuits both checks, matching the panel. Reads are audited\nidentically to the panel's.\n\n`GET` maps to the `view` capability level and mutations to `manage` \u2014 with one\ndeliberate exception on the panel that must never be relaxed if it is ever ported\nhere: minting a VM console session is gated at `manage`, not `view`, because a\nconsole is effective full control of the machine.\n", "x-i18n": { "tr": { "description": "Bir m\u00fc\u015fterinin verileri \u00fczerinde, atamayla s\u0131n\u0131rl\u0131 okumalar; `support:read` ta\u015f\u0131yan ve\nsahibi `support` ya da `super-admin` rol\u00fcn\u00fc tutan bir anahtar i\u00e7indir.\n\nBir destek temsilcisi yaln\u0131zca `support_assignments` sat\u0131r\u0131 bulunan m\u00fc\u015fterileri g\u00f6r\u00fcr ve\no m\u00fc\u015fteriler i\u00e7inde yaln\u0131zca alan bazl\u0131 yetki d\u00fczeyinin kapsad\u0131\u011f\u0131 alanlar\u0131 g\u00f6r\u00fcr. Bir\n`super-admin` her iki denetimi de k\u0131sa devre eder; panelde de \u00f6yledir. Okumalar\npanelinkiyle birebir ayn\u0131 bi\u00e7imde denetlenir.\n\n`GET`, `view` yetki d\u00fczeyine, de\u011fi\u015ftiren \u00e7a\u011fr\u0131lar ise `manage` d\u00fczeyine kar\u015f\u0131l\u0131k gelir \u2014\npanelde bilerek b\u0131rak\u0131lm\u0131\u015f tek bir istisnayla, ki bu u\u00e7 noktalar buraya ta\u015f\u0131n\u0131rsa o\nistisna asla gev\u015fetilmemelidir: bir sanal makine konsolu oturumu a\u00e7mak `view` de\u011fil\n`manage` ile korunur, \u00e7\u00fcnk\u00fc konsol makinenin fiilen tam denetimidir.\n" }, "ar": { "description": "\u0642\u0631\u0627\u0621\u0627\u062a \u0645\u062d\u0635\u0648\u0631\u0629 \u0628\u0627\u0644\u0625\u0633\u0646\u0627\u062f \u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0639\u0645\u064a\u0644 \u0648\u0627\u062d\u062f\u060c \u0648\u0647\u064a \u0645\u062a\u0627\u062d\u0629 \u0644\u0631\u0645\u0632 \u064a\u062d\u0645\u0644 `support:read` \u0648\u064a\u062d\u0645\u0644\n\u0645\u0627\u0644\u0643\u0647 \u062f\u0648\u0631 `support` \u0623\u0648 `super-admin`.\n\n\u0648\u0644\u0627 \u064a\u0631\u0649 \u0648\u0643\u064a\u0644 \u0627\u0644\u062f\u0639\u0645 \u0633\u0648\u0649 \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0627\u0644\u0630\u064a\u0646 \u064a\u0645\u0644\u0643 \u0644\u0647\u0645 \u0633\u0637\u0631\u064b\u0627 \u0641\u064a `support_assignments`\u060c \u0648\u0644\u0627 \u064a\u0631\u0649\n\u0636\u0645\u0646\u0647\u0645 \u0633\u0648\u0649 \u0627\u0644\u0645\u062c\u0627\u0644\u0627\u062a \u0627\u0644\u062a\u064a \u064a\u063a\u0637\u064a\u0647\u0627 \u0645\u0633\u062a\u0648\u0649 \u0635\u0644\u0627\u062d\u064a\u062a\u0647 \u0641\u064a \u0643\u0644 \u0645\u062c\u0627\u0644. \u0623\u0645\u0627 `super-admin` \u0641\u064a\u062a\u062c\u0627\u0648\u0632\n\u0627\u0644\u0641\u062d\u0635\u064a\u0646 \u0645\u0639\u064b\u0627\u060c \u062a\u0645\u0627\u0645\u064b\u0627 \u0643\u0645\u0627 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629. \u0648\u062a\u064f\u062f\u0642\u064e\u0651\u0642 \u0627\u0644\u0642\u0631\u0627\u0621\u0627\u062a \u0647\u0646\u0627 \u0628\u0627\u0644\u0637\u0631\u064a\u0642\u0629 \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u0645\u062a\u0628\u0639\u0629 \u0641\u064a\n\u0627\u0644\u0644\u0648\u062d\u0629.\n\n\u0648\u064a\u0642\u0627\u0628\u0644 `GET` \u0645\u0633\u062a\u0648\u0649 \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 `view`\u060c \u0648\u062a\u0642\u0627\u0628\u0644 \u0639\u0645\u0644\u064a\u0627\u062a \u0627\u0644\u062a\u0639\u062f\u064a\u0644 \u0627\u0644\u0645\u0633\u062a\u0648\u0649 `manage` \u2014 \u0645\u0639 \u0627\u0633\u062a\u062b\u0646\u0627\u0621\n\u0648\u0627\u062d\u062f \u0645\u0642\u0635\u0648\u062f \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u064a\u062c\u0628 \u0623\u0644\u0627 \u064a\u064f\u062e\u0641\u064e\u0651\u0641 \u0623\u0628\u062f\u064b\u0627 \u0625\u0646 \u0646\u064f\u0642\u0644 \u0625\u0644\u0649 \u0647\u0646\u0627: \u0641\u0625\u0646\u0634\u0627\u0621 \u062c\u0644\u0633\u0629 \u0643\u0648\u0646\u0633\u0648\u0644 \u0644\u062c\u0647\u0627\u0632\n\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0645\u062d\u0643\u0648\u0645 \u0628\u0645\u0633\u062a\u0648\u0649 `manage` \u0644\u0627 `view`\u060c \u0644\u0623\u0646 \u0627\u0644\u0643\u0648\u0646\u0633\u0648\u0644 \u064a\u0639\u0627\u062f\u0644 \u0627\u0644\u0633\u064a\u0637\u0631\u0629 \u0627\u0644\u0643\u0627\u0645\u0644\u0629 \u0639\u0644\u0649\n\u0627\u0644\u062c\u0647\u0627\u0632.\n" } } } ], "paths": { "/me": { "get": { "operationId": "getMe", "summary": "The identity behind the presented token", "description": "Returns the authenticated user together with the abilities carried by the token\nused for this request. Call this to discover what a token may do instead of\nprobing endpoints and collecting 403s.\n", "x-i18n": { "tr": { "summary": "Sunulan anahtar\u0131n ard\u0131ndaki kimlik", "description": "Kimli\u011fi do\u011frulanm\u0131\u015f kullan\u0131c\u0131y\u0131, bu istekte kullan\u0131lan anahtar\u0131n ta\u015f\u0131d\u0131\u011f\u0131\nizinlerle birlikte d\u00f6ner. Bir anahtar\u0131n neler yapabilece\u011fini u\u00e7 noktalar\u0131\ndeneyip 403 toplayarak de\u011fil, buradan \u00f6\u011frenin.\n" }, "ar": { "summary": "\u0627\u0644\u0647\u0648\u064a\u0629 \u0627\u0644\u0643\u0627\u0645\u0646\u0629 \u062e\u0644\u0641 \u0627\u0644\u0631\u0645\u0632 \u0627\u0644\u0645\u0645\u064a\u0632 \u0627\u0644\u0645\u0642\u062f\u064e\u0651\u0645", "description": "\u064a\u0639\u064a\u062f \u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645 \u0627\u0644\u0645\u064f\u0648\u062b\u064e\u0651\u0642 \u0645\u0639 \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0627\u062a \u0627\u0644\u062a\u064a \u064a\u062d\u0645\u0644\u0647\u0627 \u0627\u0644\u0631\u0645\u0632 \u0627\u0644\u0645\u0645\u064a\u0632 \u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645 \u0641\u064a \u0647\u0630\u0627\n\u0627\u0644\u0637\u0644\u0628. \u0627\u0633\u062a\u062f\u0639\u0650 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0644\u0645\u0639\u0631\u0641\u0629 \u0645\u0627 \u064a\u062c\u0648\u0632 \u0644\u0644\u0631\u0645\u0632 \u0627\u0644\u0645\u0645\u064a\u0632 \u0641\u0639\u0644\u0647\u060c \u0628\u062f\u0644\u064b\u0627 \u0645\u0646 \u0627\u0633\u062a\u0643\u0634\u0627\u0641\n\u0646\u0642\u0627\u0637 \u0627\u0644\u0646\u0647\u0627\u064a\u0629 \u0648\u062c\u0645\u0639 \u0631\u062f\u0648\u062f 403.\n" } }, "tags": [ "Identity" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "The authenticated user.", "x-i18n": { "tr": { "description": "Kimli\u011fi do\u011frulanm\u0131\u015f kullan\u0131c\u0131." }, "ar": { "description": "\u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645 \u0627\u0644\u0645\u064f\u0648\u062b\u064e\u0651\u0642." } }, "headers": { "RateLimit-Limit": { "description": "Requests permitted in the current window.", "x-i18n": { "tr": { "description": "Ge\u00e7erli pencerede izin verilen istek say\u0131s\u0131." }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u0637\u0644\u0628\u0627\u062a \u0627\u0644\u0645\u0633\u0645\u0648\u062d \u0628\u0647\u0627 \u0641\u064a \u0627\u0644\u0646\u0627\u0641\u0630\u0629 \u0627\u0644\u062d\u0627\u0644\u064a\u0629." } }, "schema": { "type": "integer" } }, "RateLimit-Remaining": { "description": "Requests still permitted in the current window.", "x-i18n": { "tr": { "description": "Ge\u00e7erli pencerede h\u00e2l\u00e2 izin verilen istek say\u0131s\u0131." }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u0637\u0644\u0628\u0627\u062a \u0627\u0644\u062a\u064a \u0645\u0627 \u0632\u0627\u0644\u062a \u0645\u0633\u0645\u0648\u062d\u0629 \u0641\u064a \u0627\u0644\u0646\u0627\u0641\u0630\u0629 \u0627\u0644\u062d\u0627\u0644\u064a\u0629." } }, "schema": { "type": "integer" } }, "RateLimit-Reset": { "description": "Seconds until the window resets.", "x-i18n": { "tr": { "description": "Pencerenin s\u0131f\u0131rlanmas\u0131na kalan saniye." }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u062b\u0648\u0627\u0646\u064a \u062d\u062a\u0649 \u0625\u0639\u0627\u062f\u0629 \u0636\u0628\u0637 \u0627\u0644\u0646\u0627\u0641\u0630\u0629." } }, "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/User" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/instances": { "get": { "operationId": "listInstances", "summary": "List virtual machines", "description": "Database-backed by default. Pass `refresh=true` to reconcile against the provider\nfirst \u2014 that variant is rate-limited far more tightly and must not be used for\npolling.\n", "x-i18n": { "tr": { "summary": "Sanal makinalar\u0131 listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. \u00d6nce sa\u011flay\u0131c\u0131yla e\u015fitlemek i\u00e7in\n`refresh=true` g\u00f6nderin \u2014 bu bi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r ve d\u00fczenli yoklama\ni\u00e7in kullan\u0131lmamal\u0131d\u0131r.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0645\u0631\u0651\u0631 `refresh=true` \u0644\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0623\u0648\u0644\u064b\u0627 \u2014\n\u0641\u0647\u0630\u0647 \u0627\u0644\u0635\u064a\u063a\u0629 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627 \u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a.\n" } }, "tags": [ "Compute" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of virtual machines.", "x-i18n": { "tr": { "description": "Sanal makinalardan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Instance" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/instances/{instance}": { "parameters": [ { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getInstance", "summary": "Read one virtual machine", "x-i18n": { "tr": { "summary": "Tek bir sanal makinay\u0131 oku" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0648\u0627\u062d\u062f" } }, "tags": [ "Compute" ], "parameters": [ { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "The virtual machine.", "x-i18n": { "tr": { "description": "Sanal makina." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "patch": { "operationId": "updateInstance", "summary": "Rename a virtual machine", "description": "The only mutable attribute. Resizing is a billing event (`POST /orders`), and\nlifecycle changes are actions.\n", "x-i18n": { "tr": { "summary": "Bir sanal makinay\u0131 yeniden adland\u0131r", "description": "De\u011fi\u015ftirilebilen tek alan budur. \u00d6l\u00e7eklendirme bir faturalama olay\u0131d\u0131r\n(`POST /orders`), ya\u015fam d\u00f6ng\u00fcs\u00fc de\u011fi\u015fiklikleri ise eylemlerdir.\n" }, "ar": { "summary": "\u0625\u0639\u0627\u062f\u0629 \u062a\u0633\u0645\u064a\u0629 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a", "description": "\u0627\u0644\u0633\u0645\u0629 \u0627\u0644\u0648\u062d\u064a\u062f\u0629 \u0627\u0644\u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u062a\u0639\u062f\u064a\u0644. \u0623\u0645\u0627 \u062a\u063a\u064a\u064a\u0631 \u0627\u0644\u062d\u062c\u0645 \u0641\u0647\u0648 \u062d\u062f\u062b \u0641\u0648\u062a\u0631\u0629\n(`POST /orders`)\u060c \u0648\u062a\u063a\u064a\u064a\u0631\u0627\u062a \u062f\u0648\u0631\u0629 \u0627\u0644\u062d\u064a\u0627\u0629 \u0641\u0639\u0645\u0644\u064a\u0627\u062a.\n" } }, "tags": [ "Compute" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "maxLength": 255 } } } } } }, "responses": { "200": { "description": "The updated virtual machine.", "x-i18n": { "tr": { "description": "G\u00fcncellenen sanal makina." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0628\u0639\u062f \u0627\u0644\u062a\u062d\u062f\u064a\u062b." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/instances/{instance}/actions/start": { "parameters": [ { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "startInstance", "summary": "Start a virtual machine", "description": "Idempotent: starting an already-running machine returns 200 immediately\nwithout contacting the cloud. Terraform and similar tools reconcile desired\nstate rather than issue commands, so asking for a state the machine is\nalready in must never error.\n", "x-i18n": { "tr": { "summary": "Bir sanal makinay\u0131 ba\u015flat", "description": "Idempotent: zaten \u00e7al\u0131\u015fan bir sanal makinay\u0131 ba\u015flatmak, buluta hi\u00e7\nba\u015fvurmadan an\u0131nda 200 d\u00f6nd\u00fcr\u00fcr. Terraform ve benzeri ara\u00e7lar komut vermek\nyerine istenen durumu e\u015fitler; bu nedenle makinan\u0131n zaten i\u00e7inde bulundu\u011fu bir\ndurumu istemek asla hata vermemelidir.\n" }, "ar": { "summary": "\u062a\u0634\u063a\u064a\u0644 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a", "description": "\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u062a\u0634\u063a\u064a\u0644 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u064a\u0639\u0645\u0644 \u0623\u0635\u0644\u064b\u0627 \u064a\u0639\u064a\u062f 200 \u0641\u0648\u0631\u064b\u0627 \u062f\u0648\u0646\n\u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629. \u0641\u0623\u062f\u0648\u0627\u062a \u0645\u062b\u0644 Terraform \u0648\u0645\u0627 \u0634\u0627\u0628\u0647\u0647\u0627 \u062a\u0637\u0627\u0628\u0642 \u0627\u0644\u062d\u0627\u0644\u0629 \u0627\u0644\u0645\u0631\u063a\u0648\u0628\u0629\n\u0628\u062f\u0644 \u0625\u0635\u062f\u0627\u0631 \u0627\u0644\u0623\u0648\u0627\u0645\u0631\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u062c\u0628 \u0623\u0644\u0651\u0627 \u064a\u0624\u062f\u064a \u0637\u0644\u0628 \u062d\u0627\u0644\u0629 \u064a\u0643\u0648\u0646 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0641\u064a\u0647\u0627 \u0623\u0635\u0644\u064b\u0627 \u0625\u0644\u0649\n\u062e\u0637\u0623 \u0623\u0628\u062f\u064b\u0627.\n" } }, "tags": [ "Compute" ], "responses": { "200": { "description": "The virtual machine, started (or already running).", "x-i18n": { "tr": { "description": "Ba\u015flat\u0131lm\u0131\u015f (ya da zaten \u00e7al\u0131\u015fan) sanal makina." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0628\u0639\u062f \u062a\u0634\u063a\u064a\u0644\u0647 (\u0623\u0648 \u0648\u0647\u0648 \u064a\u0639\u0645\u0644 \u0623\u0635\u0644\u064b\u0627)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/instances/{instance}/actions/stop": { "parameters": [ { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "stopInstance", "summary": "Stop a virtual machine", "description": "Idempotent: stopping an already-stopped machine returns 200 immediately\nwithout contacting the cloud, for the same reason as `start`.\n", "x-i18n": { "tr": { "summary": "Bir sanal makinay\u0131 durdur", "description": "Idempotent: zaten durmu\u015f bir sanal makinay\u0131 durdurmak, `start` ile ayn\u0131\nnedenle, buluta hi\u00e7 ba\u015fvurmadan an\u0131nda 200 d\u00f6nd\u00fcr\u00fcr.\n" }, "ar": { "summary": "\u0625\u064a\u0642\u0627\u0641 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a", "description": "\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u0625\u064a\u0642\u0627\u0641 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0645\u062a\u0648\u0642\u0641 \u0623\u0635\u0644\u064b\u0627 \u064a\u0639\u064a\u062f 200 \u0641\u0648\u0631\u064b\u0627 \u062f\u0648\u0646\n\u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629\u060c \u0644\u0644\u0633\u0628\u0628 \u0646\u0641\u0633\u0647 \u0627\u0644\u0645\u0630\u0643\u0648\u0631 \u0641\u064a `start`.\n" } }, "tags": [ "Compute" ], "responses": { "200": { "description": "The virtual machine, stopped (or already stopped).", "x-i18n": { "tr": { "description": "Durdurulmu\u015f (ya da zaten durmu\u015f olan) sanal makina." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0628\u0639\u062f \u0625\u064a\u0642\u0627\u0641\u0647 (\u0623\u0648 \u0648\u0647\u0648 \u0645\u062a\u0648\u0642\u0641 \u0623\u0635\u0644\u064b\u0627)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/instances/{instance}/actions/restart": { "parameters": [ { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "restartInstance", "summary": "Restart a virtual machine", "description": "Not idempotent \u2014 unlike `start`/`stop` there is no target state to compare\nagainst, so this always reaches the cloud regardless of the machine's\ncurrent state.\n", "x-i18n": { "tr": { "summary": "Bir sanal makinay\u0131 yeniden ba\u015flat", "description": "Idempotent de\u011fil \u2014 `start`/`stop` i\u015flemlerinin aksine kar\u015f\u0131la\u015ft\u0131r\u0131lacak bir\nhedef durum yoktur; bu y\u00fczden sanal makinan\u0131n mevcut durumu ne olursa olsun\nher zaman buluta gider.\n" }, "ar": { "summary": "\u0625\u0639\u0627\u062f\u0629 \u062a\u0634\u063a\u064a\u0644 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a", "description": "\u063a\u064a\u0631 \u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent) \u2014 \u0641\u062e\u0644\u0627\u0641\u064b\u0627 \u0644\u0640`start`/`stop` \u0644\u0627 \u062a\u0648\u062c\u062f \u062d\u0627\u0644\u0629 \u0647\u062f\u0641 \u062a\u064f\u0642\u0627\u0631\u064e\u0646 \u0628\u0647\u0627\u060c\n\u0648\u0644\u0630\u0644\u0643 \u064a\u0635\u0644 \u0647\u0630\u0627 \u0627\u0644\u0637\u0644\u0628 \u0625\u0644\u0649 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u062f\u0627\u0626\u0645\u064b\u0627 \u0645\u0647\u0645\u0627 \u0643\u0627\u0646\u062a \u062d\u0627\u0644\u0629 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\n\u0627\u0644\u0631\u0627\u0647\u0646\u0629.\n" } }, "tags": [ "Compute" ], "responses": { "200": { "description": "The virtual machine, restarted.", "x-i18n": { "tr": { "description": "Yeniden ba\u015flat\u0131lm\u0131\u015f sanal makina." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0628\u0639\u062f \u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u062a\u0634\u063a\u064a\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/instances/{instance}/actions/reset-password": { "parameters": [ { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "resetInstancePassword", "summary": "Reset a virtual machine's password", "description": "NOT idempotent: every call generates and stores a brand new password,\nreplacing whatever was there before. Fetch the result from\n`GET /instances/{instance}/password` afterwards, or from this response's\n`data` \u2014 the password itself is never included here (see `Instance`).\n", "x-i18n": { "tr": { "summary": "Bir sanal makinan\u0131n parolas\u0131n\u0131 s\u0131f\u0131rla", "description": "Idempotent DE\u011e\u0130L: her \u00e7a\u011fr\u0131 yepyeni bir parola \u00fcretip saklar ve \u00f6ncekinin\nyerine koyar. Sonucu ard\u0131ndan `GET /instances/{instance}/password` \u00fczerinden\nya da bu yan\u0131t\u0131n `data` alan\u0131ndan al\u0131n \u2014 parolan\u0131n kendisi burada asla yer\nalmaz (bkz. `Instance`).\n" }, "ar": { "summary": "\u0625\u0639\u0627\u062f\u0629 \u062a\u0639\u064a\u064a\u0646 \u0643\u0644\u0645\u0629 \u0645\u0631\u0648\u0631 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a", "description": "\u063a\u064a\u0631 \u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u0643\u0644 \u0627\u0633\u062a\u062f\u0639\u0627\u0621 \u064a\u0648\u0644\u0651\u062f \u0643\u0644\u0645\u0629 \u0645\u0631\u0648\u0631 \u062c\u062f\u064a\u062f\u0629 \u062a\u0645\u0627\u0645\u064b\u0627 \u0648\u064a\u062d\u0641\u0638\u0647\u0627\u060c \u0641\u062a\u062d\u0644\u0651\n\u0645\u062d\u0644 \u0627\u0644\u0633\u0627\u0628\u0642\u0629. \u0627\u062c\u0644\u0628 \u0627\u0644\u0646\u062a\u064a\u062c\u0629 \u0628\u0639\u062f \u0630\u0644\u0643 \u0645\u0646 `GET /instances/{instance}/password` \u0623\u0648\n\u0645\u0646 `data` \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0627\u0633\u062a\u062c\u0627\u0628\u0629 \u2014 \u0623\u0645\u0627 \u0643\u0644\u0645\u0629 \u0627\u0644\u0645\u0631\u0648\u0631 \u0646\u0641\u0633\u0647\u0627 \u0641\u0644\u0627 \u062a\u064f\u062f\u0631\u062c \u0647\u0646\u0627 \u0623\u0628\u062f\u064b\u0627 (\u0627\u0646\u0638\u0631\n`Instance`).\n" } }, "tags": [ "Compute" ], "responses": { "200": { "description": "The virtual machine, after the password reset.", "x-i18n": { "tr": { "description": "Parola s\u0131f\u0131rland\u0131ktan sonraki sanal makina." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0628\u0639\u062f \u0625\u0639\u0627\u062f\u0629 \u062a\u0639\u064a\u064a\u0646 \u0643\u0644\u0645\u0629 \u0627\u0644\u0645\u0631\u0648\u0631." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/instances/{instance}/password": { "parameters": [ { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getInstancePassword", "summary": "Read a virtual machine's password", "description": "Database-backed; never contacts the cloud. Returns `null` rather than 403\nwhen the owning subscription is locked and the caller is not staff \u2014 the\nmachine is visible, its password just is not.\n", "x-i18n": { "tr": { "summary": "Bir sanal makinan\u0131n parolas\u0131n\u0131 oku", "description": "Veritaban\u0131ndan yan\u0131tlan\u0131r; buluta hi\u00e7 ba\u011flanmaz. Sahibi olan abonelik\nkilitliyse ve \u00e7a\u011f\u0131ran personel de\u011filse 403 yerine `null` d\u00f6ner \u2014 sanal makina\ng\u00f6r\u00fcn\u00fcrd\u00fcr, yaln\u0131zca parolas\u0131 g\u00f6r\u00fcnmez.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0643\u0644\u0645\u0629 \u0645\u0631\u0648\u0631 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a\u061b \u0648\u0644\u0627 \u064a\u062a\u0635\u0644 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0625\u0637\u0644\u0627\u0642\u064b\u0627. \u0648\u064a\u0639\u064a\u062f `null` \u0628\u062f\u0644\u064b\u0627 \u0645\u0646\n403 \u0639\u0646\u062f\u0645\u0627 \u064a\u0643\u0648\u0646 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0645\u0627\u0644\u0643 \u0645\u0642\u0641\u0644\u064b\u0627 \u0648\u0644\u0645 \u064a\u0643\u0646 \u0627\u0644\u0637\u0627\u0644\u0628 \u0645\u0646 \u0627\u0644\u0645\u0648\u0638\u0641\u064a\u0646 \u2014 \u0641\u0627\u0644\u062c\u0647\u0627\u0632\n\u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0645\u0631\u0626\u064a\u060c \u0648\u0643\u0644\u0645\u0629 \u0645\u0631\u0648\u0631\u0647 \u0648\u062d\u062f\u0647\u0627 \u0644\u064a\u0633\u062a \u0643\u0630\u0644\u0643.\n" } }, "tags": [ "Compute" ], "responses": { "200": { "description": "The virtual machine's password.", "x-i18n": { "tr": { "description": "Sanal makinan\u0131n parolas\u0131." }, "ar": { "description": "\u0643\u0644\u0645\u0629 \u0645\u0631\u0648\u0631 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/InstancePassword" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/instances/{instance}/console": { "parameters": [ { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getInstanceConsole", "summary": "Open a virtual machine console session", "description": "Mints a fresh, one-time console session in the cloud on every call \u2014 an action\nagainst the provider, not a database read, which is why it requires\n`cloud:write` rather than `cloud:read` and is subject to the same rate limit\nas the lifecycle actions.\n", "x-i18n": { "tr": { "summary": "Bir sanal makina konsol oturumu a\u00e7", "description": "Her \u00e7a\u011fr\u0131da bulutta tek kullan\u0131ml\u0131k, yeni bir konsol oturumu \u00fcretir \u2014 bu,\nveritaban\u0131ndan bir okuma de\u011fil, sa\u011flay\u0131c\u0131 \u00fczerinde bir eylemdir; bu y\u00fczden\n`cloud:read` de\u011fil `cloud:write` gerektirir ve ya\u015fam d\u00f6ng\u00fcs\u00fc eylemleriyle ayn\u0131 istek\ns\u0131n\u0131r\u0131na tabidir.\n" }, "ar": { "summary": "\u0641\u062a\u062d \u062c\u0644\u0633\u0629 \u0643\u0648\u0646\u0633\u0648\u0644 \u0644\u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a", "description": "\u064a\u064f\u0646\u0634\u0626 \u0641\u064a \u0643\u0644 \u0627\u0633\u062a\u062f\u0639\u0627\u0621 \u062c\u0644\u0633\u0629 \u0643\u0648\u0646\u0633\u0648\u0644 \u062c\u062f\u064a\u062f\u0629 \u0644\u0645\u0631\u0629 \u0648\u0627\u062d\u062f\u0629 \u0641\u064a \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u2014 \u0648\u0647\u064a \u0639\u0645\u0644\u064a\u0629 \u0639\u0644\u0649\n\u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0644\u0627 \u0642\u0631\u0627\u0621\u0629 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a\u060c \u0648\u0644\u0647\u0630\u0627 \u062a\u062a\u0637\u0644\u0628 `cloud:write` \u0644\u0627 `cloud:read`\n\u0648\u062a\u062e\u0636\u0639 \u0644\u062d\u062f \u0627\u0644\u0645\u0639\u062f\u0644 \u0646\u0641\u0633\u0647 \u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642 \u0639\u0644\u0649 \u0639\u0645\u0644\u064a\u0627\u062a \u062f\u0648\u0631\u0629 \u0627\u0644\u062d\u064a\u0627\u0629.\n" } }, "tags": [ "Compute" ], "responses": { "200": { "description": "A console session URL.", "x-i18n": { "tr": { "description": "Bir konsol oturumu adresi (URL)." }, "ar": { "description": "\u0639\u0646\u0648\u0627\u0646 URL \u0644\u062c\u0644\u0633\u0629 \u0627\u0644\u0643\u0648\u0646\u0633\u0648\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/InstanceConsole" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/instances/{instance}/actions/attach-iso": { "parameters": [ { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "attachIso", "summary": "Attach an ISO to a virtual machine", "description": "Idempotent: attaching an ISO already mounted on this instance returns 200\nimmediately without contacting the cloud.\n", "x-i18n": { "tr": { "summary": "Bir sanal makinaya ISO ba\u011fla", "description": "Idempotent: bu sanal makinada h\u00e2lihaz\u0131rda ba\u011fl\u0131 olan bir ISO'yu yeniden\nba\u011flamak, buluta hi\u00e7 ba\u015fvurmadan an\u0131nda 200 d\u00f6nd\u00fcr\u00fcr.\n" }, "ar": { "summary": "\u0625\u0631\u0641\u0627\u0642 \u0635\u0648\u0631\u0629 ISO \u0628\u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a", "description": "\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u0625\u0631\u0641\u0627\u0642 \u0635\u0648\u0631\u0629 ISO \u0645\u0631\u0643\u0651\u0628\u0629 \u0623\u0635\u0644\u064b\u0627 \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u062c\u0647\u0627\u0632\n\u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u064a\u0639\u064a\u062f 200 \u0641\u0648\u0631\u064b\u0627 \u062f\u0648\u0646 \u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629.\n" } }, "tags": [ "Compute" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "iso_id" ], "properties": { "iso_id": { "type": "integer", "description": "Must name an ISO visible to the caller (public, or their own). A\nforeign private or missing id fails validation (422) rather than 404\n\u2014 the addressed resource is the instance, not the ISO.\n", "x-i18n": { "tr": { "description": "\u00c7a\u011f\u0131ran\u0131n g\u00f6rebildi\u011fi bir ISO'yu g\u00f6stermelidir (herkese a\u00e7\u0131k ya da kendisine\nait). Ba\u015fkas\u0131na ait \u00f6zel bir ISO ya da var olmayan bir id, 404 de\u011fil do\u011frulama\nhatas\u0131 (422) verir \u2014 adreslenen kaynak ISO de\u011fil, sanal makinad\u0131r.\n" }, "ar": { "description": "\u064a\u062c\u0628 \u0623\u0646 \u064a\u0634\u064a\u0631 \u0625\u0644\u0649 \u0635\u0648\u0631\u0629 ISO \u064a\u0631\u0627\u0647\u0627 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a (\u0639\u0627\u0645\u0629 \u0623\u0648 \u062e\u0627\u0635\u0629 \u0628\u0647). \u0648\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u062e\u0627\u0635\n\u0628\u063a\u064a\u0631\u0647 \u0623\u0648 \u063a\u064a\u0631 \u0627\u0644\u0645\u0648\u062c\u0648\u062f \u064a\u0641\u0634\u0644 \u0641\u064a \u0627\u0644\u062a\u062d\u0642\u0642 (422) \u0644\u0627 \u0628\u0640404 \u2014 \u0641\u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0645\u062e\u0627\u0637\u064e\u0628 \u0647\u0648\n\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u060c \u0644\u0627 \u0635\u0648\u0631\u0629 ISO.\n" } }, "example": 5 } } } } } }, "responses": { "200": { "description": "The virtual machine, with the ISO attached (or already attached).", "x-i18n": { "tr": { "description": "ISO'su ba\u011flanm\u0131\u015f (ya da zaten ba\u011fl\u0131 olan) sanal makina." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0628\u0639\u062f \u0625\u0631\u0641\u0627\u0642 \u0635\u0648\u0631\u0629 ISO (\u0623\u0648 \u0648\u0647\u064a \u0645\u0631\u0641\u0642\u0629 \u0623\u0635\u0644\u064b\u0627)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/instances/{instance}/actions/detach-iso": { "parameters": [ { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "detachIso", "summary": "Detach whatever ISO is mounted on a virtual machine", "description": "Idempotent: detaching an instance with no ISO attached returns 200 immediately\nwithout contacting the cloud.\n", "x-i18n": { "tr": { "summary": "Bir sanal makinada ba\u011fl\u0131 olan ISO'yu \u00e7\u0131kar", "description": "Idempotent: hi\u00e7bir ISO ba\u011fl\u0131 olmayan bir sanal makinada \u00e7\u0131karma i\u015flemi,\nbuluta hi\u00e7 ba\u015fvurmadan an\u0131nda 200 d\u00f6nd\u00fcr\u00fcr.\n" }, "ar": { "summary": "\u0641\u0635\u0644 \u0635\u0648\u0631\u0629 ISO \u0627\u0644\u0645\u0631\u0643\u0651\u0628\u0629 \u0639\u0644\u0649 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a", "description": "\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u0641\u0635\u0644 \u0635\u0648\u0631\u0629 ISO \u0639\u0646 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0627 \u0635\u0648\u0631\u0629 \u0645\u0631\u0641\u0642\u0629 \u0628\u0647\n\u064a\u0639\u064a\u062f 200 \u0641\u0648\u0631\u064b\u0627 \u062f\u0648\u0646 \u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629.\n" } }, "tags": [ "Compute" ], "responses": { "200": { "description": "The virtual machine, with its ISO detached (or already detached).", "x-i18n": { "tr": { "description": "ISO'su \u00e7\u0131kar\u0131lm\u0131\u015f (ya da zaten \u00e7\u0131kar\u0131lm\u0131\u015f olan) sanal makina." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0628\u0639\u062f \u0641\u0635\u0644 \u0635\u0648\u0631\u0629 ISO \u0639\u0646\u0647 (\u0623\u0648 \u0648\u0647\u064a \u0645\u0641\u0635\u0648\u0644\u0629 \u0623\u0635\u0644\u064b\u0627)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/volumes": { "get": { "operationId": "listVolumes", "summary": "List volumes", "description": "Database-backed by default. Pass `refresh=true` to reconcile against the provider\nfirst \u2014 that variant is rate-limited far more tightly and must not be used for\npolling.\n", "x-i18n": { "tr": { "summary": "Diskleri listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. \u00d6nce sa\u011flay\u0131c\u0131yla e\u015fitlemek i\u00e7in\n`refresh=true` g\u00f6nderin \u2014 bu bi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r ve d\u00fczenli yoklama\ni\u00e7in kullan\u0131lmamal\u0131d\u0131r.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u0623\u0642\u0631\u0627\u0635", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0645\u0631\u0651\u0631 `refresh=true` \u0644\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0623\u0648\u0644\u064b\u0627 \u2014\n\u0641\u0647\u0630\u0647 \u0627\u0644\u0635\u064a\u063a\u0629 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627 \u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a.\n" } }, "tags": [ "Storage" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "x-i18n": { "tr": { "description": "Disklerden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0623\u0642\u0631\u0627\u0635." } }, "description": "A page of volumes.", "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Volume" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/volumes/{volume}": { "parameters": [ { "name": "volume", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getVolume", "summary": "Read one volume", "x-i18n": { "tr": { "summary": "Bir diski oku" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0642\u0631\u0635 \u0648\u0627\u062d\u062f" } }, "tags": [ "Storage" ], "parameters": [ { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "The volume.", "x-i18n": { "tr": { "description": "Disk." }, "ar": { "description": "\u0627\u0644\u0642\u0631\u0635." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Volume" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "patch": { "operationId": "updateVolume", "summary": "Rename a volume", "description": "The only mutable attribute. Attach/detach are actions, and resizing is a billing\nevent (`POST /orders`).\n", "x-i18n": { "tr": { "summary": "Bir diski yeniden adland\u0131r", "description": "De\u011fi\u015ftirilebilen tek alan budur. Ba\u011flama ve ay\u0131rma birer eylemdir; boyut de\u011fi\u015ftirmek\nise bir faturalama olay\u0131d\u0131r (`POST /orders`).\n" }, "ar": { "summary": "\u0625\u0639\u0627\u062f\u0629 \u062a\u0633\u0645\u064a\u0629 \u0642\u0631\u0635", "description": "\u0647\u0630\u0647 \u0647\u064a \u0627\u0644\u062e\u0627\u0635\u064a\u0629 \u0627\u0644\u0648\u062d\u064a\u062f\u0629 \u0627\u0644\u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u062a\u0639\u062f\u064a\u0644. \u0623\u0645\u0627 \u0627\u0644\u0631\u0628\u0637 \u0648\u0627\u0644\u0641\u0635\u0644 \u0641\u0647\u0645\u0627 \u0625\u062c\u0631\u0627\u0621\u0627\u0646\u060c\n\u0648\u062a\u063a\u064a\u064a\u0631 \u0627\u0644\u062d\u062c\u0645 \u062d\u062f\u062b \u0641\u0648\u062a\u0631\u0629 (`POST /orders`).\n" } }, "tags": [ "Storage" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "maxLength": 255 } } } } } }, "responses": { "200": { "description": "The updated volume.", "x-i18n": { "tr": { "description": "G\u00fcncellenmi\u015f disk." }, "ar": { "description": "\u0627\u0644\u0642\u0631\u0635 \u0628\u0639\u062f \u0627\u0644\u062a\u062d\u062f\u064a\u062b." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Volume" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/volumes/{volume}/actions/attach": { "parameters": [ { "name": "volume", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "attachVolume", "summary": "Attach a volume to one of the caller's instances", "description": "Idempotent: attaching a volume already attached to the named instance returns 200\nimmediately without contacting the cloud.\n", "x-i18n": { "tr": { "summary": "Bir diski, \u00e7a\u011f\u0131ran\u0131n sanal makinalar\u0131ndan birine ba\u011fla", "description": "Idempotent: ad\u0131 verilen sanal makinaya zaten ba\u011fl\u0131 olan bir diski ba\u011flamak,\nbuluta hi\u00e7 ba\u015fvurmadan an\u0131nda 200 d\u00f6nd\u00fcr\u00fcr.\n" }, "ar": { "summary": "\u0631\u0628\u0637 \u0642\u0631\u0635 \u0628\u0623\u062d\u062f \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0644\u0644\u0645\u0633\u062a\u062f\u0639\u064a", "description": "\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u0641\u0631\u0628\u0637 \u0642\u0631\u0635 \u0645\u0631\u062a\u0628\u0637 \u0623\u0635\u0644\u064b\u0627 \u0628\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0627\u0644\u0645\u0630\u0643\u0648\u0631 \u064a\u064f\u0631\u062c\u0650\u0639 200 \u0641\u0648\u0631\u064b\u0627\n\u062f\u0648\u0646 \u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629.\n" } }, "tags": [ "Storage" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "instance_id" ], "properties": { "instance_id": { "type": "integer", "description": "Must name an instance the caller owns. A foreign or missing id fails\nvalidation (422) rather than 404 \u2014 the addressed resource is the\nvolume, not the instance.\n", "x-i18n": { "tr": { "description": "\u00c7a\u011f\u0131ran\u0131n sahibi oldu\u011fu bir sanal makinay\u0131 g\u00f6stermelidir. Ba\u015fkas\u0131na ait\nya da var olmayan bir id, 404 de\u011fil do\u011frulama hatas\u0131 (422) verir \u2014\nadreslenen kaynak sanal makina de\u011fil, diskin kendisidir.\n" }, "ar": { "description": "\u064a\u062c\u0628 \u0623\u0646 \u064a\u0634\u064a\u0631 \u0625\u0644\u0649 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u064a\u0645\u0644\u0643\u0647 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a. \u0623\u0645\u0627 \u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0639\u0627\u0626\u062f\n\u0644\u063a\u064a\u0631\u0647 \u0623\u0648 \u063a\u064a\u0631 \u0627\u0644\u0645\u0648\u062c\u0648\u062f \u0641\u064a\u064f\u062e\u0641\u0642 \u0641\u064a \u0627\u0644\u062a\u062d\u0642\u0642 (422) \u0644\u0627 \u0628\u0640 404 \u2014 \u0644\u0623\u0646\n\u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0645\u0642\u0635\u0648\u062f \u0647\u0648 \u0627\u0644\u0642\u0631\u0635 \u0644\u0627 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a.\n" } }, "example": 17 } } } } } }, "responses": { "200": { "description": "The volume, attached (or already attached to the named instance).", "x-i18n": { "tr": { "description": "Disk, ba\u011flanm\u0131\u015f (ya da ad\u0131 verilen sanal makinaya zaten ba\u011fl\u0131) h\u00e2liyle." }, "ar": { "description": "\u0627\u0644\u0642\u0631\u0635 \u0628\u0639\u062f \u0631\u0628\u0637\u0647 (\u0623\u0648 \u0648\u0647\u0648 \u0645\u0631\u062a\u0628\u0637 \u0623\u0635\u0644\u064b\u0627 \u0628\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0627\u0644\u0645\u0630\u0643\u0648\u0631)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Volume" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/volumes/{volume}/actions/detach": { "parameters": [ { "name": "volume", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "detachVolume", "summary": "Detach a volume from whatever instance it is attached to", "description": "Idempotent: detaching an already-detached volume returns 200 immediately without\ncontacting the cloud.\n", "x-i18n": { "tr": { "summary": "Bir diski, ba\u011fl\u0131 oldu\u011fu sanal makinadan ay\u0131r", "description": "Idempotent: zaten ayr\u0131lm\u0131\u015f bir diski ay\u0131rmak, buluta hi\u00e7 ba\u015fvurmadan an\u0131nda\n200 d\u00f6nd\u00fcr\u00fcr.\n" }, "ar": { "summary": "\u0641\u0635\u0644 \u0642\u0631\u0635 \u0639\u0646 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0627\u0644\u0645\u0631\u062a\u0628\u0637 \u0628\u0647", "description": "\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u0641\u0641\u0635\u0644 \u0642\u0631\u0635 \u0645\u0641\u0635\u0648\u0644 \u0623\u0635\u0644\u064b\u0627 \u064a\u064f\u0631\u062c\u0650\u0639 200 \u0641\u0648\u0631\u064b\u0627 \u062f\u0648\u0646 \u0627\u0644\u0627\u062a\u0635\u0627\u0644\n\u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629.\n" } }, "tags": [ "Storage" ], "responses": { "200": { "description": "The volume, detached (or already detached).", "x-i18n": { "tr": { "description": "Disk, ayr\u0131lm\u0131\u015f (ya da zaten ayr\u0131lm\u0131\u015f) h\u00e2liyle." }, "ar": { "description": "\u0627\u0644\u0642\u0631\u0635 \u0628\u0639\u062f \u0641\u0635\u0644\u0647 (\u0623\u0648 \u0648\u0647\u0648 \u0645\u0641\u0635\u0648\u0644 \u0623\u0635\u0644\u064b\u0627)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Volume" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/volumes/{volume}/snapshots": { "parameters": [ { "name": "volume", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "listVolumeSnapshots", "summary": "List a volume's snapshots", "description": "Database-backed by default. Pass `refresh=true` to reconcile the volume's snapshots\nagainst the cloud first \u2014 that variant is rate-limited far more tightly, must not be\nused for polling, and deletes local snapshot records the cloud no longer lists. A\nsnapshot moved to the retention queue (after snapshots were dropped from the disk's\nplan) is not listed.\n", "x-i18n": { "tr": { "summary": "Bir diskin anl\u0131k g\u00f6r\u00fcnt\u00fclerini listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. Diskin anl\u0131k g\u00f6r\u00fcnt\u00fclerini \u00f6nce bulutla\ne\u015fitlemek i\u00e7in `refresh=true` g\u00f6nderin \u2014 bu bi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r,\nd\u00fczenli yoklama i\u00e7in kullan\u0131lmamal\u0131d\u0131r ve bulutun art\u0131k listelemedi\u011fi yerel anl\u0131k\ng\u00f6r\u00fcnt\u00fc kay\u0131tlar\u0131n\u0131 siler. Saklama kuyru\u011funa al\u0131nm\u0131\u015f bir anl\u0131k g\u00f6r\u00fcnt\u00fc (diskin\nplan\u0131ndan anl\u0131k g\u00f6r\u00fcnt\u00fcler \u00e7\u0131kar\u0131ld\u0131ktan sonra) listelenmez.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0644\u0642\u0637\u0627\u062a \u0642\u0631\u0635", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0645\u0631\u0651\u0631 `refresh=true` \u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0644\u0642\u0637\u0627\u062a \u0627\u0644\u0642\u0631\u0635 \u0645\u0639\n\u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0623\u0648\u0644\u064b\u0627 \u2014 \u0641\u0647\u0630\u0647 \u0627\u0644\u0635\u064a\u063a\u0629 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631\u060c \u0648\u0644\u0627 \u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627\n\u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a\u060c \u0648\u062a\u062d\u0630\u0641 \u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0644\u0642\u0637\u0627\u062a \u0627\u0644\u0645\u062d\u0644\u064a\u0629 \u0627\u0644\u062a\u064a \u0644\u0645 \u062a\u0639\u062f \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u062a\u0633\u0631\u062f\u0647\u0627. \u0648\u0627\u0644\u0644\u0642\u0637\u0629\n\u0627\u0644\u0645\u0646\u0642\u0648\u0644\u0629 \u0625\u0644\u0649 \u0637\u0627\u0628\u0648\u0631 \u0627\u0644\u0627\u062d\u062a\u0641\u0627\u0638 (\u0628\u0639\u062f \u0625\u0633\u0642\u0627\u0637 \u0627\u0644\u0644\u0642\u0637\u0627\u062a \u0645\u0646 \u062e\u0637\u0629 \u0627\u0644\u0642\u0631\u0635) \u0644\u0627 \u062a\u064f\u0633\u0631\u062f.\n" } }, "tags": [ "Storage" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of the volume's snapshots, newest first.", "x-i18n": { "tr": { "description": "Diskin anl\u0131k g\u00f6r\u00fcnt\u00fclerinden, en yenisi ba\u015fta olmak \u00fczere bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0644\u0642\u0637\u0627\u062a \u0627\u0644\u0642\u0631\u0635\u060c \u0627\u0644\u0623\u062d\u062f\u062b \u0623\u0648\u0644\u064b\u0627." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Snapshot" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "post": { "operationId": "createVolumeSnapshot", "summary": "Take a manual snapshot of a volume", "description": "The snapshot is taken in the background: the response carries it in state `Creating`.\nA manual snapshot counts against the snapshot limit. `409` when the limit is reached\n(only manual snapshots count), when the disk's plan includes no snapshots, or while the\ndisk or its machine is being resized; the body's `detail` says which. Deleting or\nrestoring a snapshot, and retention schedules, are done in the panel.\n", "x-i18n": { "tr": { "summary": "Bir diskin elle anl\u0131k g\u00f6r\u00fcnt\u00fcs\u00fcn\u00fc al", "description": "Anl\u0131k g\u00f6r\u00fcnt\u00fc arka planda al\u0131n\u0131r: yan\u0131t onu `Creating` durumunda ta\u015f\u0131r. Elle al\u0131nan\nanl\u0131k g\u00f6r\u00fcnt\u00fc, anl\u0131k g\u00f6r\u00fcnt\u00fc s\u0131n\u0131r\u0131ndan d\u00fc\u015fer. S\u0131n\u0131ra ula\u015f\u0131ld\u0131\u011f\u0131nda (yaln\u0131zca elle\nal\u0131nanlar say\u0131l\u0131r), diskin plan\u0131 anl\u0131k g\u00f6r\u00fcnt\u00fc i\u00e7ermedi\u011finde ya da disk veya ba\u011fl\u0131\noldu\u011fu makine yeniden boyutland\u0131r\u0131l\u0131rken `409` d\u00f6ner; hangisi oldu\u011funu g\u00f6vdedeki\n`detail` s\u00f6yler. Anl\u0131k g\u00f6r\u00fcnt\u00fc silme, geri y\u00fckleme ve saklama planlar\u0131 panelden\nyap\u0131l\u0131r.\n" }, "ar": { "summary": "\u0623\u062e\u0630 \u0644\u0642\u0637\u0629 \u064a\u062f\u0648\u064a\u0629 \u0644\u0642\u0631\u0635", "description": "\u062a\u064f\u0624\u062e\u0630 \u0627\u0644\u0644\u0642\u0637\u0629 \u0641\u064a \u0627\u0644\u062e\u0644\u0641\u064a\u0629: \u0648\u064a\u062d\u0645\u0644\u0647\u0627 \u0627\u0644\u062c\u0648\u0627\u0628 \u0641\u064a \u0627\u0644\u062d\u0627\u0644\u0629 `Creating`. \u0648\u062a\u064f\u062d\u062a\u0633\u0628 \u0627\u0644\u0644\u0642\u0637\u0629\n\u0627\u0644\u064a\u062f\u0648\u064a\u0629 \u0636\u0645\u0646 \u062d\u062f\u0651 \u0627\u0644\u0644\u0642\u0637\u0627\u062a. \u0648\u064a\u064f\u0639\u0627\u062f `409` \u0639\u0646\u062f \u0628\u0644\u0648\u063a \u0627\u0644\u062d\u062f\u0651 (\u0644\u0627 \u062a\u064f\u062d\u062a\u0633\u0628 \u0625\u0644\u0627 \u0627\u0644\u0644\u0642\u0637\u0627\u062a\n\u0627\u0644\u064a\u062f\u0648\u064a\u0629)\u060c \u0623\u0648 \u0625\u0630\u0627 \u0644\u0645 \u062a\u062a\u0636\u0645\u0651\u0646 \u062e\u0637\u0629 \u0627\u0644\u0642\u0631\u0635 \u0644\u0642\u0637\u0627\u062a\u060c \u0623\u0648 \u0623\u062b\u0646\u0627\u0621 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645 \u0627\u0644\u0642\u0631\u0635 \u0623\u0648 \u0627\u0644\u062c\u0647\u0627\u0632\n\u0627\u0644\u0630\u064a \u064a\u062a\u0628\u0639\u0647\u061b \u0648\u064a\u0628\u064a\u0651\u0646 \u0627\u0644\u062d\u0642\u0644 `detail` \u0641\u064a \u0627\u0644\u062c\u0633\u0645 \u0623\u064a\u0651\u0647\u0627. \u0623\u0645\u0627 \u062d\u0630\u0641 \u0627\u0644\u0644\u0642\u0637\u0629 \u0648\u0627\u0633\u062a\u0639\u0627\u062f\u062a\u0647\u0627 \u0648\u062c\u062f\u0627\u0648\u0644\n\u0627\u0644\u0627\u062d\u062a\u0641\u0627\u0638 \u0641\u062a\u062a\u0645 \u0645\u0646 \u0627\u0644\u0644\u0648\u062d\u0629.\n" } }, "tags": [ "Storage" ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "nullable": true, "maxLength": 255, "description": "An optional label for the snapshot.", "x-i18n": { "tr": { "description": "Anl\u0131k g\u00f6r\u00fcnt\u00fc i\u00e7in iste\u011fe ba\u011fl\u0131 bir etiket." }, "ar": { "description": "\u062a\u0633\u0645\u064a\u0629 \u0627\u062e\u062a\u064a\u0627\u0631\u064a\u0629 \u0644\u0644\u0651\u0642\u0637\u0629." } }, "example": "before-upgrade" } } } } } }, "responses": { "201": { "description": "The snapshot, requested and being taken.", "x-i18n": { "tr": { "description": "\u0130stenmi\u015f ve al\u0131nmakta olan anl\u0131k g\u00f6r\u00fcnt\u00fc." }, "ar": { "description": "\u0627\u0644\u0644\u0642\u0637\u0629\u060c \u0648\u0642\u062f \u0637\u064f\u0644\u0628\u062a \u0648\u064a\u062c\u0631\u064a \u0623\u062e\u0630\u0647\u0627." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Snapshot" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/isos": { "get": { "operationId": "listIsos", "summary": "List ISOs", "description": "Database-backed by default. Pass `refresh=true` to reconcile against the provider\nfirst \u2014 that variant is rate-limited far more tightly and must not be used for\npolling.\n\nIncludes every ISO visible to the caller: their own, plus every ISO the provider\nmarks public.\n", "x-i18n": { "tr": { "summary": "ISO'lar\u0131 listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. \u00d6nce sa\u011flay\u0131c\u0131yla e\u015fitlemek i\u00e7in\n`refresh=true` g\u00f6nderin \u2014 bu bi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r ve d\u00fczenli yoklama\ni\u00e7in kullan\u0131lmamal\u0131d\u0131r.\n\n\u00c7a\u011f\u0131ran\u0131n g\u00f6rebildi\u011fi her ISO'yu i\u00e7erir: kendi ISO'lar\u0131 ve sa\u011flay\u0131c\u0131n\u0131n herkese a\u00e7\u0131k\ni\u015faretledi\u011fi b\u00fct\u00fcn ISO'lar.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0633\u062c\u0644\u0627\u062a ISO", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0645\u0631\u0651\u0631 `refresh=true` \u0644\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0623\u0648\u0644\u064b\u0627 \u2014\n\u0641\u0647\u0630\u0647 \u0627\u0644\u0635\u064a\u063a\u0629 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627 \u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a.\n\n\u064a\u0634\u0645\u0644 \u0643\u0644 \u0633\u062c\u0644 ISO \u0645\u0631\u0626\u064a \u0644\u0644\u0637\u0627\u0644\u0628: \u0633\u062c\u0644\u0627\u062a\u0647 \u0627\u0644\u062e\u0627\u0635\u0629\u060c \u0625\u0636\u0627\u0641\u0629\u064b \u0625\u0644\u0649 \u0643\u0644 \u0633\u062c\u0644 ISO \u064a\u0639\u0644\u0651\u0645\u0647 \u0627\u0644\u0645\u0632\u0648\u0651\u062f\n\u0628\u0623\u0646\u0647 \u0639\u0627\u0645.\n" } }, "tags": [ "Storage" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of ISOs.", "x-i18n": { "tr": { "description": "ISO'lardan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0633\u062c\u0644\u0627\u062a ISO." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Iso" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/isos/{iso}": { "parameters": [ { "name": "iso", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getIso", "summary": "Read one ISO", "description": "Visible when public, or when it belongs to the caller. A private ISO belonging to\nanother customer 404s, indistinguishable from one that does not exist.\n", "x-i18n": { "tr": { "summary": "Tek bir ISO'yu oku", "description": "Herkese a\u00e7\u0131ksa ya da \u00e7a\u011f\u0131rana aitse g\u00f6r\u00fcn\u00fcr. Ba\u015fka bir m\u00fc\u015fteriye ait \u00f6zel bir ISO\n404 d\u00f6ner; hi\u00e7 var olmayan bir kay\u0131ttan ay\u0131rt edilemez.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0633\u062c\u0644 ISO \u0648\u0627\u062d\u062f", "description": "\u064a\u0643\u0648\u0646 \u0645\u0631\u0626\u064a\u064b\u0627 \u0625\u0646 \u0643\u0627\u0646 \u0639\u0627\u0645\u064b\u0627 \u0623\u0648 \u0625\u0646 \u0643\u0627\u0646 \u0645\u0645\u0644\u0648\u0643\u064b\u0627 \u0644\u0644\u0637\u0627\u0644\u0628. \u0623\u0645\u0627 \u0633\u062c\u0644 ISO \u062e\u0627\u0635 \u064a\u0639\u0648\u062f \u0644\u0639\u0645\u064a\u0644\n\u0622\u062e\u0631 \u0641\u064a\u062c\u064a\u0628 \u0628\u0640 404\u060c \u062f\u0648\u0646 \u062a\u0645\u064a\u064a\u0632 \u0644\u0647 \u0639\u0646 \u0633\u062c\u0644 \u063a\u064a\u0631 \u0645\u0648\u062c\u0648\u062f \u0623\u0635\u0644\u064b\u0627.\n" } }, "tags": [ "Storage" ], "parameters": [ { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "The ISO.", "x-i18n": { "tr": { "description": "ISO." }, "ar": { "description": "\u0633\u062c\u0644 ISO." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Iso" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/templates": { "get": { "operationId": "listTemplates", "summary": "List templates", "description": "Reconciling the catalogue against the provider is a global administrative operation\nthat can remove sellable products, so it is deliberately not available here. This\nendpoint always serves what the panel already knows.\n", "x-i18n": { "tr": { "summary": "\u015eablonlar\u0131 listele", "description": "Katalo\u011fu sa\u011flay\u0131c\u0131yla e\u015fitlemek, sat\u0131labilir \u00fcr\u00fcnleri kald\u0131rabilen genel bir\ny\u00f6netim i\u015flemidir; bu y\u00fczden burada bilin\u00e7li olarak sunulmaz. Bu u\u00e7 nokta her\nzaman panelin h\u00e2lihaz\u0131rda bildi\u011fini d\u00f6nd\u00fcr\u00fcr.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u0642\u0648\u0627\u0644\u0628", "description": "\u0645\u0637\u0627\u0628\u0642\u0629 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0639\u0645\u0644\u064a\u0629 \u0625\u062f\u0627\u0631\u064a\u0629 \u0634\u0627\u0645\u0644\u0629 \u0642\u062f \u062a\u064f\u0632\u064a\u0644 \u0645\u0646\u062a\u062c\u0627\u062a \u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u0628\u064a\u0639\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627\n\u062a\u064f\u062a\u0627\u062d \u0647\u0646\u0627 \u0639\u0646 \u0642\u0635\u062f. \u0648\u062a\u0642\u062f\u0651\u0645 \u0647\u0630\u0647 \u0627\u0644\u0646\u0642\u0637\u0629 \u062f\u0627\u0626\u0645\u064b\u0627 \u0645\u0627 \u062a\u0639\u0631\u0641\u0647 \u0627\u0644\u0644\u0648\u062d\u0629 \u0628\u0627\u0644\u0641\u0639\u0644.\n" } }, "tags": [ "Catalogue" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of templates.", "x-i18n": { "tr": { "description": "\u015eablonlardan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0642\u0648\u0627\u0644\u0628." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Template" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/templates/{template}": { "parameters": [ { "name": "template", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getTemplate", "summary": "Read one template", "description": "Reconciling the catalogue against the provider is a global administrative operation\nthat can remove sellable products, so it is deliberately not available here. This\nendpoint always serves what the panel already knows.\n", "x-i18n": { "tr": { "summary": "Bir \u015fablonu oku", "description": "Katalo\u011fu sa\u011flay\u0131c\u0131yla e\u015fitlemek, sat\u0131labilir \u00fcr\u00fcnleri kald\u0131rabilen genel bir\ny\u00f6netim i\u015flemidir; bu y\u00fczden burada bilin\u00e7li olarak sunulmaz. Bu u\u00e7 nokta her\nzaman panelin h\u00e2lihaz\u0131rda bildi\u011fini d\u00f6nd\u00fcr\u00fcr.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0642\u0627\u0644\u0628 \u0648\u0627\u062d\u062f", "description": "\u0645\u0637\u0627\u0628\u0642\u0629 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0639\u0645\u0644\u064a\u0629 \u0625\u062f\u0627\u0631\u064a\u0629 \u0634\u0627\u0645\u0644\u0629 \u0642\u062f \u062a\u064f\u0632\u064a\u0644 \u0645\u0646\u062a\u062c\u0627\u062a \u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u0628\u064a\u0639\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627\n\u062a\u064f\u062a\u0627\u062d \u0647\u0646\u0627 \u0639\u0646 \u0642\u0635\u062f. \u0648\u062a\u0642\u062f\u0651\u0645 \u0647\u0630\u0647 \u0627\u0644\u0646\u0642\u0637\u0629 \u062f\u0627\u0626\u0645\u064b\u0627 \u0645\u0627 \u062a\u0639\u0631\u0641\u0647 \u0627\u0644\u0644\u0648\u062d\u0629 \u0628\u0627\u0644\u0641\u0639\u0644.\n" } }, "tags": [ "Catalogue" ], "responses": { "200": { "description": "The template.", "x-i18n": { "tr": { "description": "\u015eablon." }, "ar": { "description": "\u0627\u0644\u0642\u0627\u0644\u0628." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Template" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/compute-offerings": { "get": { "operationId": "listComputeOfferings", "summary": "List compute offerings", "description": "Reconciling the catalogue against the provider is a global administrative operation\nthat can remove sellable products, so it is deliberately not available here. This\nendpoint always serves what the panel already knows.\n", "x-i18n": { "tr": { "summary": "Hesaplama tekliflerini listele", "description": "Katalo\u011fu sa\u011flay\u0131c\u0131yla e\u015fitlemek, sat\u0131labilir \u00fcr\u00fcnleri kald\u0131rabilen genel bir y\u00f6netim\ni\u015flemidir; bu y\u00fczden burada bilin\u00e7li olarak sunulmaz. Bu u\u00e7 nokta her zaman panelin\nh\u00e2lihaz\u0131rda bildi\u011fini d\u00f6nd\u00fcr\u00fcr.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0639\u0631\u0648\u0636 \u0627\u0644\u062d\u0648\u0633\u0628\u0629", "description": "\u0645\u0637\u0627\u0628\u0642\u0629 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0639\u0645\u0644\u064a\u0629 \u0625\u062f\u0627\u0631\u064a\u0629 \u0634\u0627\u0645\u0644\u0629 \u0642\u062f \u062a\u064f\u0632\u064a\u0644 \u0645\u0646\u062a\u062c\u0627\u062a \u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u0628\u064a\u0639\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627\n\u062a\u064f\u062a\u0627\u062d \u0647\u0646\u0627 \u0639\u0646 \u0642\u0635\u062f. \u0648\u062a\u0642\u062f\u0651\u0645 \u0647\u0630\u0647 \u0627\u0644\u0646\u0642\u0637\u0629 \u062f\u0627\u0626\u0645\u064b\u0627 \u0645\u0627 \u062a\u0639\u0631\u0641\u0647 \u0627\u0644\u0644\u0648\u062d\u0629 \u0628\u0627\u0644\u0641\u0639\u0644.\n" } }, "tags": [ "Catalogue" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of compute offerings.", "x-i18n": { "tr": { "description": "Hesaplama tekliflerinden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0639\u0631\u0648\u0636 \u0627\u0644\u062d\u0648\u0633\u0628\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ComputeOffering" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/disk-offerings": { "get": { "operationId": "listDiskOfferings", "summary": "List disk offerings", "description": "Reconciling the catalogue against the provider is a global administrative operation\nthat can remove sellable products, so it is deliberately not available here. This\nendpoint always serves what the panel already knows.\n", "x-i18n": { "tr": { "summary": "Disk tekliflerini listele", "description": "Katalo\u011fu sa\u011flay\u0131c\u0131yla e\u015fitlemek, sat\u0131labilir \u00fcr\u00fcnleri kald\u0131rabilen genel bir\ny\u00f6netim i\u015flemidir; bu y\u00fczden burada bilin\u00e7li olarak sunulmaz. Bu u\u00e7 nokta her\nzaman panelin h\u00e2lihaz\u0131rda bildi\u011fini d\u00f6nd\u00fcr\u00fcr.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0639\u0631\u0648\u0636 \u0627\u0644\u0623\u0642\u0631\u0627\u0635", "description": "\u0645\u0637\u0627\u0628\u0642\u0629 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0639\u0645\u0644\u064a\u0629 \u0625\u062f\u0627\u0631\u064a\u0629 \u0634\u0627\u0645\u0644\u0629 \u0642\u062f \u062a\u064f\u0632\u064a\u0644 \u0645\u0646\u062a\u062c\u0627\u062a \u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u0628\u064a\u0639\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627\n\u062a\u064f\u062a\u0627\u062d \u0647\u0646\u0627 \u0639\u0646 \u0642\u0635\u062f. \u0648\u062a\u0642\u062f\u0651\u0645 \u0647\u0630\u0647 \u0627\u0644\u0646\u0642\u0637\u0629 \u062f\u0627\u0626\u0645\u064b\u0627 \u0645\u0627 \u062a\u0639\u0631\u0641\u0647 \u0627\u0644\u0644\u0648\u062d\u0629 \u0628\u0627\u0644\u0641\u0639\u0644.\n" } }, "tags": [ "Catalogue" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of disk offerings.", "x-i18n": { "tr": { "description": "Disk tekliflerinden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0639\u0631\u0648\u0636 \u0627\u0644\u0623\u0642\u0631\u0627\u0635." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DiskOffering" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/ingress-rules": { "get": { "operationId": "listIngressRules", "summary": "List ingress firewall rules", "description": "Database-backed by default. Pass `refresh=true` to reconcile against the provider\nfirst \u2014 that variant is rate-limited far more tightly and must not be used for\npolling. It is also the single most destructive read in this API: the reconciling\nmethod it calls deletes local firewall rules the provider listing omits, and its\ncreate-branch reconciles the caller's instances too, deleting any of those the\nlisting omits as well.\n", "x-i18n": { "tr": { "summary": "Giri\u015f g\u00fcvenlik duvar\u0131 kurallar\u0131n\u0131 listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. \u00d6nce sa\u011flay\u0131c\u0131yla e\u015fitlemek i\u00e7in\n`refresh=true` g\u00f6nderin \u2014 bu bi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r ve d\u00fczenli yoklama\ni\u00e7in kullan\u0131lmamal\u0131d\u0131r. Ayr\u0131ca bu API'deki en y\u0131k\u0131c\u0131 okumad\u0131r: \u00e7a\u011f\u0131rd\u0131\u011f\u0131 e\u015fitleme\nmetodu, sa\u011flay\u0131c\u0131n\u0131n listesinde yer almayan yerel g\u00fcvenlik duvar\u0131 kurallar\u0131n\u0131 siler;\nolu\u015fturma dal\u0131 ise \u00e7a\u011f\u0131ran\u0131n sanal makinalar\u0131n\u0131 da e\u015fitleyerek listede yer\nalmayanlar\u0131 ayn\u0131 \u015fekilde siler.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0642\u0648\u0627\u0639\u062f \u062c\u062f\u0627\u0631 \u0627\u0644\u062d\u0645\u0627\u064a\u0629 \u0644\u0644\u062f\u062e\u0648\u0644", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0645\u0631\u0651\u0631 `refresh=true` \u0644\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0623\u0648\u0644\u064b\u0627 \u2014\n\u0641\u0647\u0630\u0647 \u0627\u0644\u0635\u064a\u063a\u0629 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627 \u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a.\n\u0648\u0647\u064a \u0623\u064a\u0636\u064b\u0627 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0623\u0634\u062f \u062a\u062f\u0645\u064a\u0631\u064b\u0627 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629: \u0641\u0637\u0631\u064a\u0642\u0629 \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0627\u0644\u062a\u064a \u062a\u0633\u062a\u062f\u0639\u064a\u0647\u0627 \u062a\u062d\u0630\u0641\n\u0642\u0648\u0627\u0639\u062f \u062c\u062f\u0627\u0631 \u0627\u0644\u062d\u0645\u0627\u064a\u0629 \u0627\u0644\u0645\u062d\u0644\u064a\u0629 \u0627\u0644\u062a\u064a \u062a\u063a\u0641\u0644\u0647\u0627 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0645\u0632\u0648\u0651\u062f\u060c \u0643\u0645\u0627 \u064a\u0637\u0627\u0628\u0642 \u0641\u0631\u0639 \u0627\u0644\u0625\u0646\u0634\u0627\u0621 \u0641\u064a\u0647\u0627\n\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0623\u064a\u0636\u064b\u0627\u060c \u0641\u064a\u062d\u0630\u0641 \u0645\u0646\u0647\u0627 \u0643\u0644 \u0645\u0627 \u062a\u063a\u0641\u0644\u0647 \u0627\u0644\u0642\u0627\u0626\u0645\u0629.\n" } }, "tags": [ "Network" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of ingress rules.", "x-i18n": { "tr": { "description": "Giri\u015f kurallar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0642\u0648\u0627\u0639\u062f \u0627\u0644\u062f\u062e\u0648\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/IngressRule" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "post": { "operationId": "createIngressRule", "summary": "Create an ingress firewall rule", "description": "Forwards a public IP/port combination to a private port on one of the caller's own\ninstances. `public_ip_address` must name one of the caller's own stored public IP\naddresses, and `instance_id` one of the caller's own instances; either failing to\nresolve is `422`, not `404` \u2014 the addressed resource is this collection endpoint.\n", "x-i18n": { "tr": { "summary": "Bir giri\u015f g\u00fcvenlik duvar\u0131 kural\u0131 olu\u015ftur", "description": "Bir kamusal IP adresi ile port \u00e7iftini, \u00e7a\u011f\u0131ran\u0131n kendi sanal makinalar\u0131ndan\nbirindeki \u00f6zel bir porta y\u00f6nlendirir. `public_ip_address` \u00e7a\u011f\u0131ran\u0131n kendi kay\u0131tl\u0131\nkamusal IP adreslerinden birini, `instance_id` ise \u00e7a\u011f\u0131ran\u0131n kendi sanal\nmakinalar\u0131ndan birini g\u00f6stermelidir; ikisinden birinin \u00e7\u00f6z\u00fclememesi `404` de\u011fil\n`422` verir \u2014 adreslenen kaynak bu koleksiyon u\u00e7 noktas\u0131d\u0131r.\n" }, "ar": { "summary": "\u0625\u0646\u0634\u0627\u0621 \u0642\u0627\u0639\u062f\u0629 \u062c\u062f\u0627\u0631 \u062d\u0645\u0627\u064a\u0629 \u0644\u0644\u062f\u062e\u0648\u0644", "description": "\u064a\u062d\u0648\u0651\u0644 \u062a\u0631\u0643\u064a\u0628\u0629 \u0639\u0646\u0648\u0627\u0646 IP \u0639\u0627\u0645 \u0648\u0645\u0646\u0641\u0630 \u0639\u0627\u0645 \u0625\u0644\u0649 \u0645\u0646\u0641\u0630 \u062e\u0627\u0635 \u0639\u0644\u0649 \u0623\u062d\u062f \u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a\n\u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629. \u064a\u062c\u0628 \u0623\u0646 \u064a\u0634\u064a\u0631 `public_ip_address` \u0625\u0644\u0649 \u0623\u062d\u062f \u0639\u0646\u0627\u0648\u064a\u0646 IP \u0627\u0644\u0639\u0627\u0645\u0629 \u0627\u0644\u0645\u062d\u0641\u0648\u0638\u0629\n\u0644\u0644\u0645\u0633\u062a\u062f\u0639\u064a\u060c \u0648`instance_id` \u0625\u0644\u0649 \u0623\u062d\u062f \u0623\u062c\u0647\u0632\u062a\u0647 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629\u061b \u0648\u0625\u062e\u0641\u0627\u0642 \u0623\u064a\u064d\u0651 \u0645\u0646\u0647\u0645\u0627 \u0641\u064a\n\u0627\u0644\u062a\u062d\u0644\u064a\u0644 \u064a\u0639\u0637\u064a `422` \u0644\u0627 `404` \u2014 \u0641\u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0645\u062e\u0627\u0637\u064e\u0628 \u0647\u0648 \u0646\u0642\u0637\u0629 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0629 \u0647\u0630\u0647.\n" } }, "tags": [ "Network" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "public_ip_address", "protocol", "public_port_start", "public_port_end", "private_port_start", "private_port_end", "instance_id" ], "properties": { "public_ip_address": { "type": "string", "example": "203.0.113.10" }, "protocol": { "type": "string", "enum": [ "tcp", "udp", "icmp" ] }, "public_port_start": { "type": "integer", "minimum": 1, "maximum": 65535 }, "public_port_end": { "type": "integer", "minimum": 1, "maximum": 65535, "description": "Must be greater than or equal to `public_port_start`.", "x-i18n": { "tr": { "description": "`public_port_start` de\u011ferine e\u015fit ya da ondan b\u00fcy\u00fck olmal\u0131d\u0131r." }, "ar": { "description": "\u064a\u062c\u0628 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0623\u0643\u0628\u0631 \u0645\u0646 `public_port_start` \u0623\u0648 \u0645\u0633\u0627\u0648\u064a\u064b\u0627 \u0644\u0647." } } }, "private_port_start": { "type": "integer", "minimum": 1, "maximum": 65535 }, "private_port_end": { "type": "integer", "minimum": 1, "maximum": 65535, "description": "Must be greater than or equal to `private_port_start`.", "x-i18n": { "tr": { "description": "`private_port_start` de\u011ferine e\u015fit ya da ondan b\u00fcy\u00fck olmal\u0131d\u0131r." }, "ar": { "description": "\u064a\u062c\u0628 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0623\u0643\u0628\u0631 \u0645\u0646 `private_port_start` \u0623\u0648 \u0645\u0633\u0627\u0648\u064a\u064b\u0627 \u0644\u0647." } } }, "instance_id": { "type": "integer", "example": 17 } } } } } }, "responses": { "201": { "description": "The new ingress rule.", "x-i18n": { "tr": { "description": "Olu\u015fturulan giri\u015f kural\u0131." }, "ar": { "description": "\u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u062f\u062e\u0648\u0644 \u0627\u0644\u062c\u062f\u064a\u062f\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/IngressRule" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/ingress-rules/{ingressRule}": { "parameters": [ { "name": "ingressRule", "in": "path", "required": true, "schema": { "type": "integer" } } ], "patch": { "operationId": "updateIngressRule", "summary": "Retarget an ingress firewall rule", "description": "The only mutable attributes: which private ports the rule forwards to, and which\nof the caller's own instances it forwards to. `instance_id` must name an instance\nthe caller owns; a foreign or missing id fails validation (422), not 404 \u2014 the\naddressed resource is the rule, already resolved and owned before this request\nruns.\n", "x-i18n": { "tr": { "summary": "Bir giri\u015f g\u00fcvenlik duvar\u0131 kural\u0131n\u0131 yeniden y\u00f6nlendir", "description": "De\u011fi\u015ftirilebilen tek alanlar: kural\u0131n hangi \u00f6zel portlara ve \u00e7a\u011f\u0131ran\u0131n kendi\nsanal makinalar\u0131ndan hangisine y\u00f6nlendirdi\u011fidir. `instance_id`, \u00e7a\u011f\u0131ran\u0131n\nsahibi oldu\u011fu bir sanal makinay\u0131 g\u00f6stermelidir; ba\u015fkas\u0131na ait ya da var\nolmayan bir id 404 de\u011fil, do\u011frulama hatas\u0131 (422) verir \u2014 adreslenen kaynak\nkurald\u0131r ve bu istek \u00e7al\u0131\u015fmadan \u00f6nce \u00e7\u00f6z\u00fclm\u00fc\u015f, sahipli\u011fi do\u011frulanm\u0131\u015ft\u0131r.\n" }, "ar": { "summary": "\u0625\u0639\u0627\u062f\u0629 \u062a\u0648\u062c\u064a\u0647 \u0642\u0627\u0639\u062f\u0629 \u062c\u062f\u0627\u0631 \u062d\u0645\u0627\u064a\u0629 \u0644\u0644\u062f\u062e\u0648\u0644", "description": "\u0627\u0644\u0633\u0645\u0627\u062a \u0627\u0644\u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u062a\u0639\u062f\u064a\u0644 \u0641\u0642\u0637: \u0627\u0644\u0645\u0646\u0627\u0641\u0630 \u0627\u0644\u062e\u0627\u0635\u0629 \u0627\u0644\u062a\u064a \u062a\u064f\u062d\u0648\u0650\u0651\u0644 \u0625\u0644\u064a\u0647\u0627 \u0627\u0644\u0642\u0627\u0639\u062f\u0629\u060c \u0648\u0623\u064a\u0651\n\u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0645\u0646 \u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u062a\u064f\u062d\u0648\u0650\u0651\u0644 \u0625\u0644\u064a\u0647. \u064a\u062c\u0628 \u0623\u0646 \u064a\u0634\u064a\u0631 `instance_id` \u0625\u0644\u0649\n\u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u064a\u0645\u0644\u0643\u0647 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a\u061b \u0648\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u063a\u0631\u064a\u0628 \u0623\u0648 \u063a\u064a\u0631 \u0627\u0644\u0645\u0648\u062c\u0648\u062f \u064a\u0641\u0634\u0644 \u0641\u064a \u0627\u0644\u062a\u062d\u0642\u0642\n(422) \u0644\u0627 \u0628\u0640404 \u2014 \u0641\u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0645\u062e\u0627\u0637\u064e\u0628 \u0647\u0648 \u0627\u0644\u0642\u0627\u0639\u062f\u0629\u060c \u0648\u0642\u062f \u062d\u064f\u0644\u0651\u062a \u0648\u062a\u0623\u0643\u0651\u062f\u062a \u0645\u0644\u0643\u064a\u062a\u0647\u0627 \u0642\u0628\u0644\n\u062a\u0646\u0641\u064a\u0630 \u0647\u0630\u0627 \u0627\u0644\u0637\u0644\u0628.\n" } }, "tags": [ "Network" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "private_port_start", "private_port_end", "instance_id" ], "properties": { "private_port_start": { "type": "integer", "minimum": 1, "maximum": 65535 }, "private_port_end": { "type": "integer", "minimum": 1, "maximum": 65535, "description": "Must be greater than or equal to `private_port_start`.", "x-i18n": { "tr": { "description": "`private_port_start` de\u011ferine e\u015fit ya da ondan b\u00fcy\u00fck olmal\u0131d\u0131r." }, "ar": { "description": "\u064a\u062c\u0628 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0623\u0643\u0628\u0631 \u0645\u0646 `private_port_start` \u0623\u0648 \u0645\u0633\u0627\u0648\u064a\u064b\u0627 \u0644\u0647." } } }, "instance_id": { "type": "integer", "example": 17 } } } } } }, "responses": { "200": { "description": "The updated ingress rule.", "x-i18n": { "tr": { "description": "G\u00fcncellenen giri\u015f kural\u0131." }, "ar": { "description": "\u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u062f\u062e\u0648\u0644 \u0628\u0639\u062f \u0627\u0644\u062a\u062d\u062f\u064a\u062b." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/IngressRule" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "delete": { "operationId": "deleteIngressRule", "summary": "Delete an ingress firewall rule", "description": "The one documented exception to \"every mutation returns the current\nrepresentation\": there is nothing left to return after a delete, so this responds\n`204` with an empty body rather than `200` with the deleted resource.\n", "x-i18n": { "tr": { "summary": "Bir giri\u015f g\u00fcvenlik duvar\u0131 kural\u0131n\u0131 sil", "description": "\u201cHer de\u011fi\u015fiklik g\u00fcncel g\u00f6sterimi d\u00f6nd\u00fcr\u00fcr\u201d kural\u0131n\u0131n belgelenmi\u015f tek istisnas\u0131:\nsilmeden sonra d\u00f6nd\u00fcr\u00fclecek bir \u015fey kalmaz; bu y\u00fczden silinen kayna\u011f\u0131 `200` ile\nd\u00f6nd\u00fcrmek yerine bo\u015f g\u00f6vdeyle `204` yan\u0131t\u0131 verilir.\n" }, "ar": { "summary": "\u062d\u0630\u0641 \u0642\u0627\u0639\u062f\u0629 \u062c\u062f\u0627\u0631 \u062d\u0645\u0627\u064a\u0629 \u0644\u0644\u062f\u062e\u0648\u0644", "description": "\u0627\u0644\u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u0627\u0644\u0645\u0648\u062b\u064e\u0651\u0642 \u0627\u0644\u0648\u062d\u064a\u062f \u0644\u0642\u0627\u0639\u062f\u0629 \u00ab\u0643\u0644 \u062a\u0639\u062f\u064a\u0644 \u064a\u0639\u064a\u062f \u0627\u0644\u062a\u0645\u062b\u064a\u0644 \u0627\u0644\u062d\u0627\u0644\u064a\u00bb: \u0641\u0644\u0627 \u064a\u0628\u0642\u0649 \u0634\u064a\u0621 \u064a\u064f\u0639\u0627\u062f\n\u0628\u0639\u062f \u0627\u0644\u062d\u0630\u0641\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u064f\u062c\u064a\u0628 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u0627\u0644\u0631\u0645\u0632 `204` \u0628\u062c\u0633\u0645 \u0641\u0627\u0631\u063a \u0628\u062f\u0644 `200` \u0645\u0639 \u0627\u0644\u0645\u0648\u0631\u062f\n\u0627\u0644\u0645\u062d\u0630\u0648\u0641.\n" } }, "tags": [ "Network" ], "responses": { "204": { "description": "The rule was deleted.", "x-i18n": { "tr": { "description": "Kural silindi." }, "ar": { "description": "\u062a\u0645 \u062d\u0630\u0641 \u0627\u0644\u0642\u0627\u0639\u062f\u0629." } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/egress-rules": { "get": { "operationId": "listEgressRules", "summary": "List egress firewall rules", "description": "Database-backed by default. Pass `refresh=true` to reconcile against the provider\nfirst \u2014 that variant is rate-limited far more tightly and must not be used for\npolling.\n", "x-i18n": { "tr": { "summary": "\u00c7\u0131k\u0131\u015f g\u00fcvenlik duvar\u0131 kurallar\u0131n\u0131 listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. \u00d6nce sa\u011flay\u0131c\u0131yla e\u015fitlemek i\u00e7in\n`refresh=true` g\u00f6nderin \u2014 bu bi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r ve d\u00fczenli yoklama\ni\u00e7in kullan\u0131lmamal\u0131d\u0131r.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0642\u0648\u0627\u0639\u062f \u062c\u062f\u0627\u0631 \u0627\u0644\u062d\u0645\u0627\u064a\u0629 \u0644\u0644\u062e\u0631\u0648\u062c", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0645\u0631\u0651\u0631 `refresh=true` \u0644\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0623\u0648\u0644\u064b\u0627 \u2014\n\u0641\u0647\u0630\u0647 \u0627\u0644\u0635\u064a\u063a\u0629 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627 \u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a.\n" } }, "tags": [ "Network" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of egress rules.", "x-i18n": { "tr": { "description": "\u00c7\u0131k\u0131\u015f kurallar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0642\u0648\u0627\u0639\u062f \u0627\u0644\u062e\u0631\u0648\u062c." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/EgressRule" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "post": { "operationId": "createEgressRule", "summary": "Create an egress firewall rule", "description": "Permits traffic from `source_cidr` toward `destination_cidr`. Both must be\nwell-formed CIDR blocks \u2014 a malformed CIDR reaching the cloud from a firewall\nendpoint is a security defect, not a validation nicety.\n", "x-i18n": { "tr": { "summary": "Bir \u00e7\u0131k\u0131\u015f g\u00fcvenlik duvar\u0131 kural\u0131 olu\u015ftur", "description": "`source_cidr` adresinden `destination_cidr` adresine giden trafi\u011fe izin verir.\nHer ikisi de ge\u00e7erli birer CIDR blo\u011fu olmal\u0131d\u0131r \u2014 bir g\u00fcvenlik duvar\u0131 u\u00e7\nnoktas\u0131ndan buluta bozuk bir CIDR ula\u015fmas\u0131, do\u011frulama inceli\u011fi de\u011fil,\ng\u00fcvenlik a\u00e7\u0131\u011f\u0131d\u0131r.\n" }, "ar": { "summary": "\u0625\u0646\u0634\u0627\u0621 \u0642\u0627\u0639\u062f\u0629 \u062c\u062f\u0627\u0631 \u062d\u0645\u0627\u064a\u0629 \u0644\u0644\u062e\u0631\u0648\u062c", "description": "\u064a\u0633\u0645\u062d \u0628\u0645\u0631\u0648\u0631 \u062d\u0631\u0643\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0645\u0646 `source_cidr` \u0646\u062d\u0648 `destination_cidr`. \u0648\u064a\u062c\u0628 \u0623\u0646\n\u064a\u0643\u0648\u0646 \u0643\u0644\u0627\u0647\u0645\u0627 \u0643\u062a\u0644\u0629 CIDR \u0635\u062d\u064a\u062d\u0629 \u0627\u0644\u062a\u0643\u0648\u064a\u0646 \u2014 \u0641\u0648\u0635\u0648\u0644 CIDR \u0645\u0634\u0648\u064e\u0651\u0647 \u0625\u0644\u0649 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0645\u0646 \u0646\u0642\u0637\u0629\n\u062e\u0627\u0635\u0629 \u0628\u062c\u062f\u0627\u0631 \u0627\u0644\u062d\u0645\u0627\u064a\u0629 \u0639\u064a\u0628\u064c \u0623\u0645\u0646\u064a\u060c \u0644\u0627 \u0645\u062c\u0631\u062f \u062a\u062f\u0642\u064a\u0642 \u0634\u0643\u0644\u064a.\n" } }, "tags": [ "Network" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "source_cidr", "destination_cidr", "protocol", "port_start", "port_end" ], "properties": { "source_cidr": { "type": "string", "example": "10.0.0.0/24" }, "destination_cidr": { "type": "string", "example": "0.0.0.0/0" }, "protocol": { "type": "string", "enum": [ "tcp", "udp", "icmp" ] }, "port_start": { "type": "integer", "minimum": 1, "maximum": 65535 }, "port_end": { "type": "integer", "minimum": 1, "maximum": 65535, "description": "Must be greater than or equal to `port_start`.", "x-i18n": { "tr": { "description": "`port_start` de\u011ferine e\u015fit ya da ondan b\u00fcy\u00fck olmal\u0131d\u0131r." }, "ar": { "description": "\u064a\u062c\u0628 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0623\u0643\u0628\u0631 \u0645\u0646 `port_start` \u0623\u0648 \u0645\u0633\u0627\u0648\u064a\u064b\u0627 \u0644\u0647." } } } } } } } }, "responses": { "201": { "description": "The new egress rule.", "x-i18n": { "tr": { "description": "Olu\u015fturulan \u00e7\u0131k\u0131\u015f kural\u0131." }, "ar": { "description": "\u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u062e\u0631\u0648\u062c \u0627\u0644\u062c\u062f\u064a\u062f\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/EgressRule" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/egress-rules/{egressRule}": { "parameters": [ { "name": "egressRule", "in": "path", "required": true, "schema": { "type": "integer" } } ], "delete": { "operationId": "deleteEgressRule", "summary": "Delete an egress firewall rule", "description": "The one documented exception to \"every mutation returns the current\nrepresentation\": there is nothing left to return after a delete, so this responds\n`204` with an empty body rather than `200` with the deleted resource.\n", "x-i18n": { "tr": { "summary": "Bir \u00e7\u0131k\u0131\u015f g\u00fcvenlik duvar\u0131 kural\u0131n\u0131 sil", "description": "\u201cHer de\u011fi\u015fiklik g\u00fcncel g\u00f6sterimi d\u00f6nd\u00fcr\u00fcr\u201d kural\u0131n\u0131n belgelenmi\u015f tek istisnas\u0131:\nsilmeden sonra d\u00f6nd\u00fcr\u00fclecek bir \u015fey kalmaz; bu y\u00fczden silinen kayna\u011f\u0131 `200` ile\nd\u00f6nd\u00fcrmek yerine bo\u015f g\u00f6vdeyle `204` yan\u0131t\u0131 verilir.\n" }, "ar": { "summary": "\u062d\u0630\u0641 \u0642\u0627\u0639\u062f\u0629 \u062c\u062f\u0627\u0631 \u062d\u0645\u0627\u064a\u0629 \u0644\u0644\u062e\u0631\u0648\u062c", "description": "\u0627\u0644\u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u0627\u0644\u0645\u0648\u062b\u064e\u0651\u0642 \u0627\u0644\u0648\u062d\u064a\u062f \u0644\u0642\u0627\u0639\u062f\u0629 \u00ab\u0643\u0644 \u062a\u0639\u062f\u064a\u0644 \u064a\u0639\u064a\u062f \u0627\u0644\u062a\u0645\u062b\u064a\u0644 \u0627\u0644\u062d\u0627\u0644\u064a\u00bb: \u0641\u0644\u0627 \u064a\u0628\u0642\u0649 \u0634\u064a\u0621 \u064a\u064f\u0639\u0627\u062f\n\u0628\u0639\u062f \u0627\u0644\u062d\u0630\u0641\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u064f\u062c\u064a\u0628 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u0627\u0644\u0631\u0645\u0632 `204` \u0628\u062c\u0633\u0645 \u0641\u0627\u0631\u063a \u0628\u062f\u0644 `200` \u0645\u0639 \u0627\u0644\u0645\u0648\u0631\u062f\n\u0627\u0644\u0645\u062d\u0630\u0648\u0641.\n" } }, "tags": [ "Network" ], "responses": { "204": { "description": "The rule was deleted.", "x-i18n": { "tr": { "description": "Kural silindi." }, "ar": { "description": "\u062a\u0645 \u062d\u0630\u0641 \u0627\u0644\u0642\u0627\u0639\u062f\u0629." } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/public-ip-addresses": { "get": { "operationId": "listPublicIPAddresses", "summary": "List public IP addresses", "description": "Database-backed by default. Pass `refresh=true` to reconcile against the provider\nfirst \u2014 that variant is rate-limited far more tightly and must not be used for\npolling. It deletes local rows the provider listing does not contain.\n", "x-i18n": { "tr": { "summary": "Kamusal IP adreslerini listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. \u00d6nce sa\u011flay\u0131c\u0131yla e\u015fitlemek i\u00e7in\n`refresh=true` g\u00f6nderin \u2014 bu bi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r ve d\u00fczenli yoklama\ni\u00e7in kullan\u0131lmamal\u0131d\u0131r. Sa\u011flay\u0131c\u0131n\u0131n listesinde bulunmayan yerel kay\u0131tlar\u0131 siler.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0639\u0646\u0627\u0648\u064a\u0646 IP \u0627\u0644\u0639\u0627\u0645\u0629", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0645\u0631\u0651\u0631 `refresh=true` \u0644\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0623\u0648\u0644\u064b\u0627 \u2014\n\u0641\u0647\u0630\u0647 \u0627\u0644\u0635\u064a\u063a\u0629 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627 \u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a.\n\u0648\u0647\u064a \u062a\u062d\u0630\u0641 \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0645\u062d\u0644\u064a\u0629 \u0627\u0644\u062a\u064a \u0644\u0627 \u062a\u062a\u0636\u0645\u0646\u0647\u0627 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0645\u0632\u0648\u0651\u062f.\n" } }, "tags": [ "Network" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of public IP addresses.", "x-i18n": { "tr": { "description": "Kamusal IP adreslerinden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0639\u0646\u0627\u0648\u064a\u0646 IP \u0627\u0644\u0639\u0627\u0645\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PublicIPAddress" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/public-ip-addresses/{publicIPAddress}": { "parameters": [ { "name": "publicIPAddress", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getPublicIPAddress", "summary": "Read a public IP address", "description": "Database-backed by default. Pass `refresh=true` to reconcile the caller's whole\nset against the provider first, then pick this address out of it \u2014 there is no\nsingle-address provider lookup \u2014 before responding. That variant is rate-limited\nfar more tightly and must not be used for polling, and, like the collection\nendpoint, deletes local rows the provider listing does not contain.\n", "x-i18n": { "tr": { "summary": "Bir kamusal IP adresini oku", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. Yan\u0131t verilmeden \u00f6nce \u00e7a\u011f\u0131ran\u0131n adres\nk\u00fcmesinin tamam\u0131n\u0131 sa\u011flay\u0131c\u0131yla e\u015fitleyip bu adresi aralar\u0131ndan se\u00e7mek i\u00e7in\n`refresh=true` g\u00f6nderin \u2014 sa\u011flay\u0131c\u0131da tek bir adresi sorgulaman\u0131n yolu yoktur. Bu\nbi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r, d\u00fczenli yoklama i\u00e7in kullan\u0131lmamal\u0131d\u0131r ve\nkoleksiyon u\u00e7 noktas\u0131nda oldu\u011fu gibi, sa\u011flay\u0131c\u0131n\u0131n listesinde bulunmayan yerel\nkay\u0131tlar\u0131 siler.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0639\u0646\u0648\u0627\u0646 IP \u0639\u0627\u0645", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0645\u0631\u0651\u0631 `refresh=true` \u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u062c\u0645\u0648\u0639\u0629 \u0639\u0646\u0627\u0648\u064a\u0646 \u0627\u0644\u0637\u0627\u0644\u0628\n\u0643\u0627\u0645\u0644\u0629\u064b \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0623\u0648\u0644\u064b\u0627 \u062b\u0645 \u0627\u0646\u062a\u0642\u0627\u0621 \u0647\u0630\u0627 \u0627\u0644\u0639\u0646\u0648\u0627\u0646 \u0645\u0646\u0647\u0627 \u0642\u0628\u0644 \u0627\u0644\u0631\u062f \u2014 \u0625\u0630 \u0644\u0627 \u064a\u0648\u062c\u062f \u0644\u062f\u0649 \u0627\u0644\u0645\u0632\u0648\u0651\u062f\n\u0627\u0633\u062a\u0639\u0644\u0627\u0645 \u0639\u0646 \u0639\u0646\u0648\u0627\u0646 \u0645\u0641\u0631\u062f. \u0648\u0647\u0630\u0647 \u0627\u0644\u0635\u064a\u063a\u0629 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627 \u064a\u062c\u0648\u0632\n\u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a\u060c \u0648\u0647\u064a\u060c \u0645\u062b\u0644 \u0646\u0642\u0637\u0629 \u0646\u0647\u0627\u064a\u0629 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0629\u060c \u062a\u062d\u0630\u0641 \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0645\u062d\u0644\u064a\u0629 \u0627\u0644\u062a\u064a\n\u0644\u0627 \u062a\u062a\u0636\u0645\u0646\u0647\u0627 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0645\u0632\u0648\u0651\u062f.\n" } }, "tags": [ "Network" ], "parameters": [ { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "The public IP address.", "x-i18n": { "tr": { "description": "Kamusal IP adresi." }, "ar": { "description": "\u0639\u0646\u0648\u0627\u0646 IP \u0627\u0644\u0639\u0627\u0645." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PublicIPAddress" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "patch": { "operationId": "updatePublicIPAddressReverseDns", "summary": "Set the reverse DNS record for a public IP address", "description": "Writes a PTR record on the DNS service and the local row; it never touches the\ncloud, which is why this requires `dns:write` rather than `cloud:write`. See\nDNSUserService::updatePublicIPAddress().\n", "x-i18n": { "tr": { "summary": "Bir kamusal IP adresinin ters DNS kayd\u0131n\u0131 ayarla", "description": "DNS servisinde bir PTR kayd\u0131 ve yerel sat\u0131r\u0131 yazar; buluta hi\u00e7\ndokunmaz, bu y\u00fczden `cloud:write` de\u011fil `dns:write` izni gerekir. Bkz.\nDNSUserService::updatePublicIPAddress().\n" }, "ar": { "summary": "\u0636\u0628\u0637 \u0633\u062c\u0644 DNS \u0627\u0644\u0639\u0643\u0633\u064a \u0644\u0639\u0646\u0648\u0627\u0646 IP \u0639\u0627\u0645", "description": "\u064a\u0643\u062a\u0628 \u0633\u062c\u0644 PTR \u0639\u0628\u0631 \u062e\u062f\u0645\u0629 DNS \u0648\u064a\u0643\u062a\u0628 \u0627\u0644\u0633\u062c\u0644 \u0627\u0644\u0645\u062d\u0644\u064a\u061b \u0648\u0644\u0627 \u064a\u0645\u0633 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0625\u0637\u0644\u0627\u0642\u064b\u0627\u060c\n\u0648\u0644\u0630\u0644\u0643 \u064a\u062a\u0637\u0644\u0628 `dns:write` \u0644\u0627 `cloud:write`. \u0627\u0646\u0638\u0631\nDNSUserService::updatePublicIPAddress().\n" } }, "tags": [ "Network" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "reverse_record" ], "properties": { "reverse_record": { "type": "string", "description": "A valid DNS hostname.", "x-i18n": { "tr": { "description": "Ge\u00e7erli bir DNS ana makine ad\u0131." }, "ar": { "description": "\u0627\u0633\u0645 \u0645\u0636\u064a\u0641 DNS \u0635\u0627\u0644\u062d." } }, "example": "host.example.com" } } } } } }, "responses": { "200": { "description": "The updated public IP address.", "x-i18n": { "tr": { "description": "G\u00fcncellenen kamusal IP adresi." }, "ar": { "description": "\u0639\u0646\u0648\u0627\u0646 IP \u0627\u0644\u0639\u0627\u0645 \u0628\u0639\u062f \u0627\u0644\u062a\u062d\u062f\u064a\u062b." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/PublicIPAddress" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/vpn": { "get": { "operationId": "listVpns", "summary": "List the caller's VPNs", "description": "A collection, not a single object: a customer account may have zero VPNs\nconfigured, or in principle more than one. Database-backed by default; pass\n`refresh=true` to reconcile against the provider first \u2014 that variant is\nrate-limited far more tightly and must not be used for polling, and deletes\nlocal rows the provider listing does not contain.\n", "x-i18n": { "tr": { "summary": "\u00c7a\u011f\u0131ran\u0131n VPN'lerini listele", "description": "Tek bir nesne de\u011fil, bir koleksiyondur: bir m\u00fc\u015fteri hesab\u0131nda hi\u00e7 yap\u0131land\u0131r\u0131lm\u0131\u015f\nVPN olmayabilir ya da ilke olarak birden fazla olabilir. Varsay\u0131lan olarak\nveritaban\u0131ndan yan\u0131tlan\u0131r; \u00f6nce sa\u011flay\u0131c\u0131yla e\u015fitlemek i\u00e7in `refresh=true` g\u00f6nderin\n\u2014 bu bi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r, d\u00fczenli yoklama i\u00e7in kullan\u0131lmamal\u0131d\u0131r ve\nsa\u011flay\u0131c\u0131n\u0131n listesinde bulunmayan yerel sat\u0131rlar\u0131 siler.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0634\u0628\u0643\u0627\u062a VPN \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a", "description": "\u0645\u062c\u0645\u0648\u0639\u0629 \u0644\u0627 \u0643\u0627\u0626\u0646 \u0648\u0627\u062d\u062f: \u0641\u0642\u062f \u0644\u0627 \u064a\u0643\u0648\u0646 \u0644\u062d\u0633\u0627\u0628 \u0627\u0644\u0639\u0645\u064a\u0644 \u0623\u064a \u0634\u0628\u0643\u0629 VPN \u0645\u064f\u0647\u064a\u064e\u0651\u0623\u0629\u060c \u0648\u0642\u062f \u064a\u0643\u0648\u0646 \u0644\u0647 \u0645\u0646\n\u062d\u064a\u062b \u0627\u0644\u0645\u0628\u062f\u0623 \u0623\u0643\u062b\u0631 \u0645\u0646 \u0648\u0627\u062d\u062f\u0629. \u064a\u0639\u062a\u0645\u062f \u0639\u0644\u0649 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627\u061b \u0648\u0645\u0631\u0650\u0651\u0631 `refresh=true`\n\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0623\u0648\u0644\u064b\u0627 \u2014 \u0648\u0647\u0630\u0647 \u0627\u0644\u0635\u064a\u063a\u0629 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627\n\u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a\u060c \u0648\u0647\u064a \u062a\u062d\u0630\u0641 \u0627\u0644\u0635\u0641\u0648\u0641 \u0627\u0644\u0645\u062d\u0644\u064a\u0629 \u0627\u0644\u062a\u064a \u0644\u0627 \u062a\u0631\u062f \u0641\u064a \u0642\u0627\u0626\u0645\u0629\n\u0627\u0644\u0645\u0632\u0648\u0651\u062f.\n" } }, "tags": [ "Network" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of VPNs.", "x-i18n": { "tr": { "description": "VPN'lerden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0634\u0628\u0643\u0627\u062a VPN." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Vpn" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/vpn/users": { "get": { "operationId": "listVpnUsers", "summary": "List VPN users", "description": "Database-backed; never contacts the cloud. No `refresh` parameter \u2014 unlike\npublic IP addresses and VPNs, this endpoint has no reconciling sibling exposed\nover the API.\n", "x-i18n": { "tr": { "summary": "VPN kullan\u0131c\u0131lar\u0131n\u0131 listele", "description": "Veritaban\u0131ndan yan\u0131tlan\u0131r; buluta hi\u00e7 ba\u011flanmaz. `refresh` parametresi yoktur\n\u2014 kamusal IP adresleri ve VPN'lerin aksine, bu u\u00e7 noktan\u0131n API \u00fczerinden a\u00e7\u0131lm\u0131\u015f,\ne\u015fitleyici bir e\u015fi yoktur.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0645\u0633\u062a\u062e\u062f\u0645\u064a VPN", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a\u061b \u0648\u0644\u0627 \u064a\u062a\u0635\u0644 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0625\u0637\u0644\u0627\u0642\u064b\u0627. \u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh` \u2014\n\u0641\u0628\u062e\u0644\u0627\u0641 \u0639\u0646\u0627\u0648\u064a\u0646 IP \u0627\u0644\u0639\u0627\u0645\u0629 \u0648\u0634\u0628\u0643\u0627\u062a VPN\u060c \u0644\u064a\u0633 \u0644\u0647\u0630\u0647 \u0627\u0644\u0646\u0642\u0637\u0629 \u0646\u0638\u064a\u0631 \u0645\u064f\u0637\u0627\u0628\u0650\u0642 \u0645\u062a\u0627\u062d \u0639\u0628\u0631 \u0648\u0627\u062c\u0647\u0629\n\u0627\u0644\u0628\u0631\u0645\u062c\u0629.\n" } }, "tags": [ "Network" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of VPN users.", "x-i18n": { "tr": { "description": "VPN kullan\u0131c\u0131lar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0645\u0633\u062a\u062e\u062f\u0645\u064a VPN." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/VpnUser" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } }, "post": { "operationId": "createVpnUser", "summary": "Create a VPN user", "description": "Creates a VPN user in the cloud under the caller's account. `username` must be\nfree of the caller's own VPN users; a name already used by a different customer\nis not a conflict.\n\nBoth fields are validated against the cloud provider's own rule rather than a\nlooser one of ours: each must BEGIN with a letter or a digit, and may then use\nletters, digits and a small punctuation set \u2014 `@ . - _` for the username, and\n`@ + = . - _` for the password. A value outside that is `422` here. It used to be\naccepted and refused by the provider afterwards, which reached the caller as a\n`502` naming a system they have no access to.\n", "x-i18n": { "tr": { "summary": "Bir VPN kullan\u0131c\u0131s\u0131 olu\u015ftur", "description": "\u00c7a\u011f\u0131ran\u0131n hesab\u0131 alt\u0131nda bulutta bir VPN kullan\u0131c\u0131s\u0131 olu\u015fturur.\n`username`, \u00e7a\u011f\u0131ran\u0131n kendi VPN kullan\u0131c\u0131lar\u0131 aras\u0131nda kullan\u0131lmam\u0131\u015f\nolmal\u0131d\u0131r; ba\u015fka bir m\u00fc\u015fterinin kulland\u0131\u011f\u0131 bir ad \u00e7ak\u0131\u015fma say\u0131lmaz.\n\nHer iki alan da bizim daha gev\u015fek bir kural\u0131m\u0131za g\u00f6re de\u011fil, bulut\nsa\u011flay\u0131c\u0131s\u0131n\u0131n kendi kural\u0131na g\u00f6re do\u011frulan\u0131r: her biri bir harf ya da\nrakamla BA\u015eLAMALI, ard\u0131ndan harf, rakam ve k\u00fc\u00e7\u00fck bir noktalama k\u00fcmesi\nkullanabilir \u2014 kullan\u0131c\u0131 ad\u0131 i\u00e7in `@ . - _`, parola i\u00e7in `@ + = . - _`. Bunun\nd\u0131\u015f\u0131nda kalan bir de\u011fer burada `422` verir. Eskiden b\u00f6yle bir de\u011fer kabul\nedilir, sonras\u0131nda sa\u011flay\u0131c\u0131 taraf\u0131ndan reddedilirdi; bu da \u00e7a\u011f\u0131rana, hi\u00e7\neri\u015fimi olmayan bir sistemi ad\u0131yla anan bir `502` olarak d\u00f6nerdi.\n" }, "ar": { "summary": "\u0625\u0646\u0634\u0627\u0621 \u0645\u0633\u062a\u062e\u062f\u0645 VPN", "description": "\u064a\u064f\u0646\u0634\u0626 \u0645\u0633\u062a\u062e\u062f\u0645 VPN \u0641\u064a \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u062a\u062d\u062a \u062d\u0633\u0627\u0628 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a. \u0648\u064a\u062c\u0628 \u0623\u0646 \u064a\u0643\u0648\u0646 `username`\n\u063a\u064a\u0631 \u0645\u0633\u062a\u062e\u062f\u064e\u0645 \u0628\u064a\u0646 \u0645\u0633\u062a\u062e\u062f\u0645\u064a VPN \u0627\u0644\u062e\u0627\u0635\u064a\u0646 \u0628\u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a\u061b \u0623\u0645\u0627 \u0627\u0644\u0627\u0633\u0645 \u0627\u0644\u0630\u064a \u064a\u0633\u062a\u062e\u062f\u0645\u0647 \u0639\u0645\u064a\u0644\n\u0622\u062e\u0631 \u0641\u0644\u0627 \u064a\u064f\u0639\u062f\u0651 \u062a\u0639\u0627\u0631\u0636\u064b\u0627.\n\n\u064a\u064f\u062a\u062d\u0642\u064e\u0651\u0642 \u0645\u0646 \u0627\u0644\u062d\u0642\u0644\u064a\u0646 \u0648\u0641\u0642 \u0642\u0627\u0639\u062f\u0629 \u0645\u0632\u0648\u0651\u062f \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0646\u0641\u0633\u0647 \u0644\u0627 \u0648\u0641\u0642 \u0642\u0627\u0639\u062f\u0629 \u0623\u0648\u0633\u0639 \u0645\u0646 \u0639\u0646\u062f\u0646\u0627:\n\u0641\u0643\u0644\u064c\u0651 \u0645\u0646\u0647\u0645\u0627 \u064a\u062c\u0628 \u0623\u0646 \u064a\u0628\u062f\u0623 \u0628\u062d\u0631\u0641 \u0623\u0648 \u0631\u0642\u0645\u060c \u062b\u0645 \u064a\u062c\u0648\u0632 \u0623\u0646 \u064a\u0633\u062a\u062e\u062f\u0645 \u0627\u0644\u062d\u0631\u0648\u0641 \u0648\u0627\u0644\u0623\u0631\u0642\u0627\u0645\n\u0648\u0645\u062c\u0645\u0648\u0639\u0629 \u0635\u063a\u064a\u0631\u0629 \u0645\u0646 \u0639\u0644\u0627\u0645\u0627\u062a \u0627\u0644\u062a\u0631\u0642\u064a\u0645 \u2014 `@ . - _` \u0644\u0627\u0633\u0645 \u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645\u060c \u0648`@ + = . - _`\n\u0644\u0643\u0644\u0645\u0629 \u0627\u0644\u0645\u0631\u0648\u0631. \u0648\u0623\u064a \u0642\u064a\u0645\u0629 \u062e\u0627\u0631\u062c \u0630\u0644\u0643 \u062a\u064f\u062c\u0627\u0628 \u0647\u0646\u0627 \u0628\u0640 `422`. \u0648\u0643\u0627\u0646\u062a \u0627\u0644\u0642\u064a\u0645\u0629 \u062a\u064f\u0642\u0628\u0644\n\u0633\u0627\u0628\u0642\u064b\u0627 \u062b\u0645 \u064a\u0631\u0641\u0636\u0647\u0627 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0628\u0639\u062f \u0630\u0644\u0643\u060c \u0641\u064a\u0635\u0644 \u0630\u0644\u0643 \u0625\u0644\u0649 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0639\u0644\u0649 \u0647\u064a\u0626\u0629 `502` \u064a\u0630\u0643\u0631\n\u0646\u0638\u0627\u0645\u064b\u0627 \u0644\u0627 \u064a\u0645\u0644\u0643 \u0623\u064a \u0648\u0635\u0648\u0644 \u0625\u0644\u064a\u0647.\n" } }, "tags": [ "Network" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "username", "password" ], "properties": { "username": { "type": "string", "minLength": 3, "maxLength": 64, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9@._-]{2,63}$", "example": "jdoe" }, "password": { "type": "string", "minLength": 3, "maxLength": 32, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9@+=._-]{2,31}$" } } } } } }, "responses": { "201": { "description": "The new VPN user.", "x-i18n": { "tr": { "description": "Yeni VPN kullan\u0131c\u0131s\u0131." }, "ar": { "description": "\u0645\u0633\u062a\u062e\u062f\u0645 VPN \u0627\u0644\u062c\u062f\u064a\u062f." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/VpnUser" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/vpn/users/{vpnUser}": { "parameters": [ { "name": "vpnUser", "in": "path", "required": true, "schema": { "type": "integer" } } ], "delete": { "operationId": "deleteVpnUser", "summary": "Delete a VPN user", "description": "The one documented exception to \"every mutation returns the current\nrepresentation\": there is nothing left to return after a delete, so this\nresponds `204` with an empty body rather than `200` with the deleted resource.\n", "x-i18n": { "tr": { "summary": "Bir VPN kullan\u0131c\u0131s\u0131n\u0131 sil", "description": "\u201cHer de\u011fi\u015fiklik g\u00fcncel g\u00f6sterimi d\u00f6nd\u00fcr\u00fcr\u201d kural\u0131n\u0131n belgelenmi\u015f tek istisnas\u0131:\nsilmeden sonra d\u00f6nd\u00fcr\u00fclecek bir \u015fey kalmaz; bu y\u00fczden silinen kayna\u011f\u0131 `200` ile\nd\u00f6nd\u00fcrmek yerine bo\u015f g\u00f6vdeyle `204` yan\u0131t\u0131 verilir.\n" }, "ar": { "summary": "\u062d\u0630\u0641 \u0645\u0633\u062a\u062e\u062f\u0645 VPN", "description": "\u0627\u0644\u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u0627\u0644\u0645\u0648\u062b\u064e\u0651\u0642 \u0627\u0644\u0648\u062d\u064a\u062f \u0644\u0642\u0627\u0639\u062f\u0629 \u00ab\u0643\u0644 \u062a\u0639\u062f\u064a\u0644 \u064a\u0639\u064a\u062f \u0627\u0644\u062a\u0645\u062b\u064a\u0644 \u0627\u0644\u062d\u0627\u0644\u064a\u00bb: \u0641\u0644\u0627 \u064a\u0628\u0642\u0649 \u0634\u064a\u0621 \u064a\u064f\u0639\u0627\u062f\n\u0628\u0639\u062f \u0627\u0644\u062d\u0630\u0641\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u064f\u062c\u064a\u0628 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u0627\u0644\u0631\u0645\u0632 `204` \u0628\u062c\u0633\u0645 \u0641\u0627\u0631\u063a \u0628\u062f\u0644 `200` \u0645\u0639 \u0627\u0644\u0645\u0648\u0631\u062f\n\u0627\u0644\u0645\u062d\u0630\u0648\u0641.\n" } }, "tags": [ "Network" ], "responses": { "204": { "description": "The VPN user was deleted.", "x-i18n": { "tr": { "description": "VPN kullan\u0131c\u0131s\u0131 silindi." }, "ar": { "description": "\u062d\u064f\u0630\u0641 \u0645\u0633\u062a\u062e\u062f\u0645 VPN." } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/affinity-groups": { "get": { "operationId": "listAffinityGroups", "summary": "List affinity groups", "description": "Database-backed; never contacts the cloud. No `refresh` parameter: this\nendpoint's reconciling sibling is destructive in a way none of the others in\nthis API are \u2014 it deletes both local affinity groups the provider listing omits\nand instance membership rows alongside them \u2014 and is never exposed here.\n", "x-i18n": { "tr": { "summary": "Uyum gruplar\u0131n\u0131 listele", "description": "Veritaban\u0131ndan yan\u0131tlan\u0131r; buluta hi\u00e7 ba\u011flanmaz. `refresh` parametresi yoktur:\nbu u\u00e7 noktan\u0131n e\u015fitleyici e\u015fi, bu API'deki di\u011ferlerinin hi\u00e7birine benzemeyecek\n\u00f6l\u00e7\u00fcde y\u0131k\u0131c\u0131d\u0131r \u2014 sa\u011flay\u0131c\u0131n\u0131n listesinde bulunmayan yerel uyum gruplar\u0131n\u0131, yan\u0131\ns\u0131ra sanal makina \u00fcyelik kay\u0131tlar\u0131n\u0131 da siler \u2014 ve burada asla a\u00e7\u0131lmaz.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0627\u0644\u062a\u0642\u0627\u0631\u0628", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a\u061b \u0648\u0644\u0627 \u064a\u062a\u0635\u0644 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0625\u0637\u0644\u0627\u0642\u064b\u0627. \u0648\u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh`:\n\u0641\u0627\u0644\u0646\u0633\u062e\u0629 \u0627\u0644\u062a\u064a \u062a\u064f\u062c\u0631\u064a \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0644\u0647\u0630\u0647 \u0627\u0644\u0646\u0642\u0637\u0629 \u0645\u062f\u0645\u0650\u0651\u0631\u0629 \u0639\u0644\u0649 \u0646\u062d\u0648 \u0644\u0627 \u064a\u0645\u0627\u062b\u0644\u0647 \u0634\u064a\u0621 \u0622\u062e\u0631 \u0641\u064a \u0647\u0630\u0647\n\u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u2014 \u0625\u0630 \u062a\u062d\u0630\u0641 \u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0627\u0644\u062a\u0642\u0627\u0631\u0628 \u0627\u0644\u0645\u062d\u0644\u064a\u0629 \u0627\u0644\u062a\u064a \u062a\u063a\u0641\u0644\u0647\u0627 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0645\u0632\u0648\u0651\u062f\u060c \u0648\u062a\u062d\u0630\u0641\n\u0645\u0639\u0647\u0627 \u0635\u0641\u0648\u0641 \u0639\u0636\u0648\u064a\u0629 \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u2014 \u0648\u0644\u0630\u0644\u0643 \u0644\u0627 \u062a\u064f\u0643\u0634\u0641 \u0647\u0646\u0627 \u0623\u0628\u062f\u064b\u0627.\n" } }, "tags": [ "Network" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of affinity groups.", "x-i18n": { "tr": { "description": "Uyum gruplar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0627\u0644\u062a\u0642\u0627\u0631\u0628." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AffinityGroup" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } }, "post": { "operationId": "createAffinityGroup", "summary": "Create an affinity group", "description": "`name` must be unique across every customer's affinity groups \u2014 the provider\ndoes not namespace affinity group names per account. Each `instances.*` must\nname one of the caller's own instances; a foreign or missing id is `422`, not\n`404`.\n", "x-i18n": { "tr": { "summary": "Bir uyum grubu olu\u015ftur", "description": "`name`, b\u00fct\u00fcn m\u00fc\u015fterilerin uyum gruplar\u0131 aras\u0131nda benzersiz olmal\u0131d\u0131r \u2014 sa\u011flay\u0131c\u0131,\nuyum grubu adlar\u0131n\u0131 hesap baz\u0131nda ay\u0131rmaz. Her `instances.*` de\u011feri, \u00e7a\u011f\u0131ran\u0131n kendi\nsanal makinalar\u0131ndan birini g\u00f6stermelidir; ba\u015fkas\u0131na ait ya da olmayan bir id `404`\nde\u011fil `422` verir.\n" }, "ar": { "summary": "\u0625\u0646\u0634\u0627\u0621 \u0645\u062c\u0645\u0648\u0639\u0629 \u062a\u0642\u0627\u0631\u0628", "description": "\u064a\u062c\u0628 \u0623\u0646 \u064a\u0643\u0648\u0646 `name` \u0641\u0631\u064a\u062f\u064b\u0627 \u0628\u064a\u0646 \u0645\u062c\u0645\u0648\u0639\u0627\u062a \u062a\u0642\u0627\u0631\u0628 \u062c\u0645\u064a\u0639 \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u2014 \u0641\u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0644\u0627 \u064a\u0641\u0635\u0644\n\u0623\u0633\u0645\u0627\u0621 \u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0627\u0644\u062a\u0642\u0627\u0631\u0628 \u0628\u062d\u0633\u0628 \u0627\u0644\u062d\u0633\u0627\u0628. \u0648\u064a\u062c\u0628 \u0623\u0646 \u064a\u0634\u064a\u0631 \u0643\u0644 \u0639\u0646\u0635\u0631 \u0641\u064a `instances.*` \u0625\u0644\u0649 \u0623\u062d\u062f\n\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0646\u0641\u0633\u0647\u061b \u0648\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0639\u0627\u0626\u062f \u0644\u063a\u064a\u0631\u0647 \u0623\u0648 \u063a\u064a\u0631 \u0627\u0644\u0645\u0648\u062c\u0648\u062f \u064a\u0639\u0637\u064a `422` \u0644\u0627 `404`.\n" } }, "tags": [ "Network" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "affinity_type" ], "properties": { "name": { "type": "string", "maxLength": 1024, "example": "web-tier" }, "description": { "type": "string", "nullable": true, "maxLength": 2048 }, "affinity_type": { "type": "string", "enum": [ "Host Affinity", "Host Anti-Affinity" ] }, "instances": { "type": "array", "default": [], "items": { "type": "integer" }, "example": [ 17, 24 ] } } } } } }, "responses": { "201": { "description": "The new affinity group.", "x-i18n": { "tr": { "description": "Yeni uyum grubu." }, "ar": { "description": "\u0645\u062c\u0645\u0648\u0639\u0629 \u0627\u0644\u062a\u0642\u0627\u0631\u0628 \u0627\u0644\u062c\u062f\u064a\u062f\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/AffinityGroup" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/affinity-groups/{affinityGroup}": { "parameters": [ { "name": "affinityGroup", "in": "path", "required": true, "schema": { "type": "integer" } } ], "patch": { "operationId": "updateAffinityGroup", "summary": "Retarget an affinity group's membership", "description": "The only mutable attribute: which of the caller's own instances belong to the\ngroup. The provider does not support renaming or retyping an affinity group\nafter creation. Each `instances.*` must name one of the caller's own instances; a\nforeign or missing id is `422`, not `404` \u2014 the addressed resource is the group,\nalready resolved and owned before this request runs. An empty array clears the\ngroup's membership.\n", "x-i18n": { "tr": { "summary": "Bir uyum grubunun \u00fcyeli\u011fini yeniden belirle", "description": "De\u011fi\u015ftirilebilen tek alan: \u00e7a\u011f\u0131ran\u0131n kendi sanal makinalar\u0131ndan hangilerinin gruba\nait oldu\u011fu. Sa\u011flay\u0131c\u0131, olu\u015fturulduktan sonra bir uyum grubunun ad\u0131n\u0131n ya da t\u00fcr\u00fcn\u00fcn\nde\u011fi\u015ftirilmesini desteklemez. Her `instances.*` de\u011feri, \u00e7a\u011f\u0131ran\u0131n kendi sanal\nmakinalar\u0131ndan birini g\u00f6stermelidir; ba\u015fkas\u0131na ait ya da olmayan bir id `404` de\u011fil\n`422` verir \u2014 adreslenen kaynak, bu istek \u00e7al\u0131\u015fmadan \u00f6nce zaten \u00e7\u00f6z\u00fcmlenmi\u015f ve\nsahipli\u011fi do\u011frulanm\u0131\u015f olan grubun kendisidir. Bo\u015f bir dizi, grubun \u00fcyeli\u011fini\ntemizler.\n" }, "ar": { "summary": "\u0625\u0639\u0627\u062f\u0629 \u062a\u062d\u062f\u064a\u062f \u0639\u0636\u0648\u064a\u0629 \u0645\u062c\u0645\u0648\u0639\u0629 \u062a\u0642\u0627\u0631\u0628", "description": "\u0627\u0644\u0633\u0645\u0629 \u0627\u0644\u0648\u062d\u064a\u062f\u0629 \u0627\u0644\u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u062a\u0639\u062f\u064a\u0644: \u0623\u064a\u0651 \u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u062a\u0646\u062a\u0645\u064a \u0625\u0644\u0649 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0629.\n\u0648\u0644\u0627 \u064a\u062f\u0639\u0645 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0625\u0639\u0627\u062f\u0629 \u062a\u0633\u0645\u064a\u0629 \u0645\u062c\u0645\u0648\u0639\u0629 \u062a\u0642\u0627\u0631\u0628 \u0623\u0648 \u062a\u063a\u064a\u064a\u0631 \u0646\u0648\u0639\u0647\u0627 \u0628\u0639\u062f \u0625\u0646\u0634\u0627\u0626\u0647\u0627. \u0648\u064a\u062c\u0628 \u0623\u0646\n\u064a\u0634\u064a\u0631 \u0643\u0644 \u0639\u0646\u0635\u0631 \u0641\u064a `instances.*` \u0625\u0644\u0649 \u0623\u062d\u062f \u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0646\u0641\u0633\u0647\u061b \u0648\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0639\u0627\u0626\u062f \u0644\u063a\u064a\u0631\u0647 \u0623\u0648\n\u063a\u064a\u0631 \u0627\u0644\u0645\u0648\u062c\u0648\u062f \u064a\u0639\u0637\u064a `422` \u0644\u0627 `404` \u2014 \u0641\u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0645\u064f\u062e\u0627\u0637\u064e\u0628 \u0647\u0648 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0629\u060c \u0648\u0642\u062f \u062c\u0631\u0649 \u062a\u062d\u0644\u064a\u0644\u0647\u0627\n\u0648\u0627\u0644\u062a\u062d\u0642\u0642 \u0645\u0646 \u0645\u0644\u0643\u064a\u062a\u0647\u0627 \u0642\u0628\u0644 \u062a\u0646\u0641\u064a\u0630 \u0647\u0630\u0627 \u0627\u0644\u0637\u0644\u0628. \u0648\u0627\u0644\u0645\u0635\u0641\u0648\u0641\u0629 \u0627\u0644\u0641\u0627\u0631\u063a\u0629 \u062a\u0645\u0633\u062d \u0639\u0636\u0648\u064a\u0629 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0629.\n" } }, "tags": [ "Network" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "instances" ], "properties": { "instances": { "type": "array", "items": { "type": "integer" }, "example": [ 17 ] } } } } } }, "responses": { "200": { "description": "The updated affinity group.", "x-i18n": { "tr": { "description": "G\u00fcncellenmi\u015f uyum grubu." }, "ar": { "description": "\u0645\u062c\u0645\u0648\u0639\u0629 \u0627\u0644\u062a\u0642\u0627\u0631\u0628 \u0628\u0639\u062f \u062a\u062d\u062f\u064a\u062b\u0647\u0627." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/AffinityGroup" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "delete": { "operationId": "deleteAffinityGroup", "summary": "Delete an affinity group", "description": "The one documented exception to \"every mutation returns the current\nrepresentation\": there is nothing left to return after a delete, so this\nresponds `204` with an empty body rather than `200` with the deleted resource.\n", "x-i18n": { "tr": { "summary": "Bir uyum grubunu sil", "description": "\u201cHer de\u011fi\u015fiklik g\u00fcncel g\u00f6sterimi d\u00f6nd\u00fcr\u00fcr\u201d kural\u0131n\u0131n belgelenmi\u015f tek istisnas\u0131:\nsilmeden sonra d\u00f6nd\u00fcr\u00fclecek bir \u015fey kalmaz; bu y\u00fczden silinen kayna\u011f\u0131 `200` ile\nd\u00f6nd\u00fcrmek yerine bo\u015f g\u00f6vdeyle `204` yan\u0131t\u0131 verilir.\n" }, "ar": { "summary": "\u062d\u0630\u0641 \u0645\u062c\u0645\u0648\u0639\u0629 \u062a\u0642\u0627\u0631\u0628", "description": "\u0627\u0644\u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u0627\u0644\u0645\u0648\u062b\u064e\u0651\u0642 \u0627\u0644\u0648\u062d\u064a\u062f \u0644\u0642\u0627\u0639\u062f\u0629 \u00ab\u0643\u0644 \u062a\u0639\u062f\u064a\u0644 \u064a\u0639\u064a\u062f \u0627\u0644\u062a\u0645\u062b\u064a\u0644 \u0627\u0644\u062d\u0627\u0644\u064a\u00bb: \u0641\u0644\u0627 \u064a\u0628\u0642\u0649 \u0634\u064a\u0621\n\u064a\u064f\u0639\u0627\u062f \u0628\u0639\u062f \u0627\u0644\u062d\u0630\u0641\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u064f\u062c\u064a\u0628 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u0627\u0644\u0631\u0645\u0632 `204` \u0628\u062c\u0633\u0645 \u0641\u0627\u0631\u063a \u0628\u062f\u0644 `200` \u0645\u0639 \u0627\u0644\u0645\u0648\u0631\u062f\n\u0627\u0644\u0645\u062d\u0630\u0648\u0641.\n" } }, "tags": [ "Network" ], "responses": { "204": { "description": "The affinity group was deleted.", "x-i18n": { "tr": { "description": "Uyum grubu silindi." }, "ar": { "description": "\u062d\u064f\u0630\u0641\u062a \u0645\u062c\u0645\u0648\u0639\u0629 \u0627\u0644\u062a\u0642\u0627\u0631\u0628." } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/dns-zones": { "get": { "operationId": "listDNSZones", "summary": "List DNS zones", "description": "Database-backed by default. Pass `refresh=true` to reconcile against the DNS\nservice first \u2014 that variant is rate-limited far more tightly and must not be\nused for polling. Unlike the equivalent parameter on `/instances` or\n`/volumes`, a DNS refresh reconciles the caller's **entire** DNS account, not\njust this listing: there is no cheaper single-zone reconcile primitive in the\nunderlying service. It also deletes local zones (and cascades to their\nrecords) that the DNS service's own listing no longer contains.\n", "x-i18n": { "tr": { "summary": "DNS alanlar\u0131n\u0131 listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. \u00d6nce DNS servisiyle e\u015fitlemek i\u00e7in\n`refresh=true` g\u00f6nderin \u2014 bu bi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r ve d\u00fczenli yoklama\ni\u00e7in kullan\u0131lmamal\u0131d\u0131r. `/instances` veya `/volumes` \u00fczerindeki ayn\u0131 parametrenin\naksine, bir DNS tazelemesi yaln\u0131zca bu listeyi de\u011fil, \u00e7a\u011f\u0131ran\u0131n **t\u00fcm** DNS hesab\u0131n\u0131\ne\u015fitler: alttaki serviste tek bir DNS alan\u0131n\u0131 e\u015fitlemenin daha ucuz bir yolu yoktur.\nAyr\u0131ca DNS servisinin kendi listesinde art\u0131k bulunmayan yerel DNS alanlar\u0131n\u0131 (ve buna\nba\u011fl\u0131 olarak kay\u0131tlar\u0131n\u0131) siler.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0645\u0646\u0627\u0637\u0642 DNS", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0623\u0631\u0633\u0644 `refresh=true` \u0644\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u0639 \u062e\u062f\u0645\u0629 DNS \u0623\u0648\u0644\u064b\u0627 \u2014\n\u0647\u0630\u0627 \u0627\u0644\u0634\u0643\u0644 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627 \u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a.\n\u0648\u062e\u0644\u0627\u0641\u064b\u0627 \u0644\u0644\u0645\u0639\u0627\u0645\u0644 \u0646\u0641\u0633\u0647 \u0641\u064a `/instances` \u0623\u0648 `/volumes`\u060c \u062a\u0637\u0627\u0628\u0642 \u0645\u0637\u0627\u0628\u0642\u0629 DNS \u062d\u0633\u0627\u0628 DNS\n**\u0628\u0627\u0644\u0643\u0627\u0645\u0644** \u0644\u0644\u0645\u0633\u062a\u062f\u0639\u064a\u060c \u0644\u0627 \u0647\u0630\u0647 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0648\u062d\u062f\u0647\u0627: \u0625\u0630 \u0644\u0627 \u062a\u0648\u062c\u062f \u0641\u064a \u0627\u0644\u062e\u062f\u0645\u0629 \u0627\u0644\u0623\u0633\u0627\u0633\u064a\u0629 \u0648\u0633\u064a\u0644\u0629 \u0623\u0631\u062e\u0635\n\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u0646\u0637\u0642\u0629 \u0648\u0627\u062d\u062f\u0629. \u0643\u0645\u0627 \u062a\u062d\u0630\u0641 \u0627\u0644\u0645\u0646\u0627\u0637\u0642 \u0627\u0644\u0645\u062d\u0644\u064a\u0629 (\u0648\u0633\u062c\u0644\u0627\u062a\u0647\u0627 \u062a\u0628\u0639\u064b\u0627 \u0644\u0647\u0627) \u0627\u0644\u062a\u064a \u0644\u0645 \u062a\u0639\u062f \u0642\u0627\u0626\u0645\u0629\n\u062e\u062f\u0645\u0629 DNS \u062a\u062a\u0636\u0645\u0646\u0647\u0627.\n" } }, "tags": [ "DNS" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of DNS zones.", "x-i18n": { "tr": { "description": "DNS alanlar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0645\u0646\u0627\u0637\u0642 DNS." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DNSZone" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "post": { "operationId": "createDNSZone", "summary": "Create a DNS zone", "description": "Requires at least one of the caller's own subscriptions to be in the deployed\nstate, and refuses a 6th zone \u2014 both checked before the zone is created on the\nDNS service, so a rejected request never leaves an orphan zone upstream.\n", "x-i18n": { "tr": { "summary": "Bir DNS alan\u0131 olu\u015ftur", "description": "\u00c7a\u011f\u0131ran\u0131n kendi aboneliklerinden en az birinin da\u011f\u0131t\u0131lm\u0131\u015f durumda olmas\u0131n\u0131\ngerektirir ve 6'nc\u0131 DNS alan\u0131n\u0131 reddeder \u2014 her ikisi de DNS alan\u0131 DNS servisinde\nolu\u015fturulmadan \u00f6nce denetlenir; b\u00f6ylece reddedilen bir istek sa\u011flay\u0131c\u0131\ntaraf\u0131nda asla sahipsiz bir DNS alan\u0131 b\u0131rakmaz.\n" }, "ar": { "summary": "\u0625\u0646\u0634\u0627\u0621 \u0645\u0646\u0637\u0642\u0629 DNS", "description": "\u064a\u062a\u0637\u0644\u0628 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0648\u0627\u062d\u062f \u0639\u0644\u0649 \u0627\u0644\u0623\u0642\u0644 \u0645\u0646 \u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0641\u064a \u062d\u0627\u0644\u0629 \u0627\u0644\u0646\u0634\u0631\u060c \u0648\u064a\u0631\u0641\u0636\n\u0627\u0644\u0645\u0646\u0637\u0642\u0629 \u0627\u0644\u0633\u0627\u062f\u0633\u0629 \u2014 \u0648\u064a\u064f\u062a\u062d\u0642\u064e\u0651\u0642 \u0645\u0646 \u0627\u0644\u0623\u0645\u0631\u064a\u0646 \u0642\u0628\u0644 \u0625\u0646\u0634\u0627\u0621 \u0627\u0644\u0645\u0646\u0637\u0642\u0629 \u0641\u064a \u062e\u062f\u0645\u0629 DNS\u060c \u0641\u0644\u0627 \u064a\u062a\u0631\u0643\n\u0627\u0644\u0637\u0644\u0628 \u0627\u0644\u0645\u0631\u0641\u0648\u0636 \u0623\u0628\u062f\u064b\u0627 \u0645\u0646\u0637\u0642\u0629 \u064a\u062a\u064a\u0645\u0629 \u0644\u062f\u0649 \u0627\u0644\u0645\u0632\u0648\u0651\u062f.\n" } }, "tags": [ "DNS" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "description": "The zone's domain name, without a trailing dot.", "x-i18n": { "tr": { "description": "DNS alan\u0131n\u0131n etki alan\u0131 ad\u0131; sonunda nokta olmadan." }, "ar": { "description": "\u0627\u0633\u0645 \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u0645\u0646\u0637\u0642\u0629\u060c \u062f\u0648\u0646 \u0646\u0642\u0637\u0629 \u0641\u064a \u0622\u062e\u0631\u0647." } }, "example": "example.com" } } } } } }, "responses": { "201": { "description": "The new DNS zone.", "x-i18n": { "tr": { "description": "Olu\u015fturulan DNS alan\u0131." }, "ar": { "description": "\u0645\u0646\u0637\u0642\u0629 DNS \u0627\u0644\u062c\u062f\u064a\u062f\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/DNSZone" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/dns-zones/{zone}": { "parameters": [ { "name": "zone", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getDNSZone", "summary": "Read a DNS zone", "description": "Database-backed by default. Pass `refresh=true` to reconcile before responding \u2014\nlike the collection endpoint, this reconciles the caller's **entire** DNS\naccount (there is no single-zone reconcile primitive), then picks this zone out\nof the result. That variant is rate-limited far more tightly and must not be\nused for polling.\n", "x-i18n": { "tr": { "summary": "Bir DNS alan\u0131n\u0131 oku", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. Yan\u0131t vermeden \u00f6nce e\u015fitlemek i\u00e7in\n`refresh=true` g\u00f6nderin \u2014 koleksiyon u\u00e7 noktas\u0131nda oldu\u011fu gibi bu, \u00e7a\u011f\u0131ran\u0131n **t\u00fcm**\nDNS hesab\u0131n\u0131 e\u015fitler (tek bir DNS alan\u0131n\u0131 e\u015fitleyen bir i\u015flem yoktur) ve ard\u0131ndan bu\nDNS alan\u0131n\u0131 sonucun i\u00e7inden se\u00e7er. Bu bi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r ve\nd\u00fczenli yoklama i\u00e7in kullan\u0131lmamal\u0131d\u0131r.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0645\u0646\u0637\u0642\u0629 DNS", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0623\u0631\u0633\u0644 `refresh=true` \u0644\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0642\u0628\u0644 \u0627\u0644\u0627\u0633\u062a\u062c\u0627\u0628\u0629 \u2014 \u0648\u0643\u0645\u0627\n\u0641\u064a \u0646\u0642\u0637\u0629 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0629\u060c \u062a\u0637\u0627\u0628\u0642 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u062d\u0633\u0627\u0628 DNS **\u0628\u0627\u0644\u0643\u0627\u0645\u0644** \u0644\u0644\u0645\u0633\u062a\u062f\u0639\u064a (\u0625\u0630 \u0644\u0627 \u062a\u0648\u062c\u062f \u0639\u0645\u0644\u064a\u0629\n\u0645\u0637\u0627\u0628\u0642\u0629 \u0644\u0645\u0646\u0637\u0642\u0629 \u0648\u0627\u062d\u062f\u0629)\u060c \u062b\u0645 \u062a\u062e\u062a\u0627\u0631 \u0647\u0630\u0647 \u0627\u0644\u0645\u0646\u0637\u0642\u0629 \u0645\u0646 \u0627\u0644\u0646\u062a\u064a\u062c\u0629. \u0648\u0647\u0630\u0627 \u0627\u0644\u0634\u0643\u0644 \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644\n\u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627 \u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a.\n" } }, "tags": [ "DNS" ], "parameters": [ { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "The DNS zone.", "x-i18n": { "tr": { "description": "DNS alan\u0131." }, "ar": { "description": "\u0645\u0646\u0637\u0642\u0629 DNS." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/DNSZone" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "delete": { "operationId": "deleteDNSZone", "summary": "Delete a DNS zone", "description": "Deletes the zone on the DNS service and its local row, and all of its records'\nlocal rows along with it. The one documented exception to \"every mutation\nreturns the current representation\": there is nothing left to return, so this\nresponds `204` with an empty body rather than `200` with the deleted resource.\n", "x-i18n": { "tr": { "summary": "Bir DNS alan\u0131n\u0131 sil", "description": "DNS alan\u0131n\u0131 DNS servisinden ve yerel sat\u0131r\u0131yla birlikte, ayr\u0131ca t\u00fcm kay\u0131tlar\u0131n\u0131n\nyerel sat\u0131rlar\u0131yla birlikte siler. \u201cHer de\u011fi\u015fiklik g\u00fcncel g\u00f6sterimi d\u00f6nd\u00fcr\u00fcr\u201d\nkural\u0131n\u0131n belgelenmi\u015f tek istisnas\u0131: d\u00f6nd\u00fcr\u00fclecek bir \u015fey kalmaz; bu y\u00fczden silinen\nkayna\u011f\u0131 `200` ile d\u00f6nd\u00fcrmek yerine bo\u015f g\u00f6vdeyle `204` yan\u0131t\u0131 verilir.\n" }, "ar": { "summary": "\u062d\u0630\u0641 \u0645\u0646\u0637\u0642\u0629 DNS", "description": "\u064a\u062d\u0630\u0641 \u0627\u0644\u0645\u0646\u0637\u0642\u0629 \u0641\u064a \u062e\u062f\u0645\u0629 DNS \u0648\u0635\u0641\u064e\u0651\u0647\u0627 \u0627\u0644\u0645\u062d\u0644\u064a\u060c \u0648\u0645\u0639\u0647\u0627 \u0627\u0644\u0635\u0641\u0648\u0641 \u0627\u0644\u0645\u062d\u0644\u064a\u0629 \u0644\u062c\u0645\u064a\u0639 \u0633\u062c\u0644\u0627\u062a\u0647\u0627. \u0648\u0647\u0648\n\u0627\u0644\u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u0627\u0644\u0645\u0648\u062b\u064e\u0651\u0642 \u0627\u0644\u0648\u062d\u064a\u062f \u0644\u0642\u0627\u0639\u062f\u0629 \u00ab\u0643\u0644 \u062a\u0639\u062f\u064a\u0644 \u064a\u0639\u064a\u062f \u0627\u0644\u062a\u0645\u062b\u064a\u0644 \u0627\u0644\u062d\u0627\u0644\u064a\u00bb: \u0641\u0644\u0627 \u064a\u0628\u0642\u0649 \u0634\u064a\u0621 \u064a\u064f\u0639\u0627\u062f\u060c\n\u0648\u0644\u0630\u0644\u0643 \u062a\u064f\u062c\u064a\u0628 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u0627\u0644\u0631\u0645\u0632 `204` \u0628\u062c\u0633\u0645 \u0641\u0627\u0631\u063a \u0628\u062f\u0644 `200` \u0645\u0639 \u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0645\u062d\u0630\u0648\u0641.\n" } }, "tags": [ "DNS" ], "responses": { "204": { "description": "The zone (and its records) were deleted.", "x-i18n": { "tr": { "description": "DNS alan\u0131 (ve kay\u0131tlar\u0131) silindi." }, "ar": { "description": "\u062a\u0645 \u062d\u0630\u0641 \u0627\u0644\u0645\u0646\u0637\u0642\u0629 (\u0648\u0633\u062c\u0644\u0627\u062a\u0647\u0627)." } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/dns-zones/{zone}/records": { "parameters": [ { "name": "zone", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "listDNSRecords", "summary": "List a DNS zone's records", "description": "Database-backed by default: a plain read of the zone's own records, no provider\ncall involved (the zone itself must already belong to the caller \u2014 resolved and\n404'd before any record is ever looked up). Pass `refresh=true` to reconcile\nfirst \u2014 like the zone endpoints, this reconciles the caller's **entire** DNS\naccount, not just this zone, and is rate-limited far more tightly.\n", "x-i18n": { "tr": { "summary": "Bir DNS alan\u0131n\u0131n kay\u0131tlar\u0131n\u0131 listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r: DNS alan\u0131n\u0131n kendi kay\u0131tlar\u0131n\u0131n sade\nbir okumas\u0131, sa\u011flay\u0131c\u0131ya hi\u00e7bir \u00e7a\u011fr\u0131 yap\u0131lmaz (DNS alan\u0131n\u0131n kendisi zaten \u00e7a\u011f\u0131rana\nait olmal\u0131d\u0131r \u2014 herhangi bir kayda bak\u0131lmadan \u00f6nce \u00e7\u00f6z\u00fcl\u00fcr ve de\u011filse 404 d\u00f6ner).\n\u00d6nce e\u015fitlemek i\u00e7in `refresh=true` g\u00f6nderin \u2014 DNS alan\u0131 u\u00e7 noktalar\u0131nda oldu\u011fu gibi\nbu, yaln\u0131zca bu DNS alan\u0131n\u0131 de\u011fil, \u00e7a\u011f\u0131ran\u0131n **t\u00fcm** DNS hesab\u0131n\u0131 e\u015fitler ve istek\ns\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0633\u062c\u0644\u0627\u062a \u0645\u0646\u0637\u0642\u0629 DNS", "description": "\u064a\u0642\u0631\u0623 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627: \u0642\u0631\u0627\u0621\u0629 \u0628\u0633\u064a\u0637\u0629 \u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0645\u0646\u0637\u0642\u0629 \u0646\u0641\u0633\u0647\u0627\u060c \u062f\u0648\u0646 \u0623\u064a\n\u0627\u0633\u062a\u062f\u0639\u0627\u0621 \u0644\u0644\u0645\u0632\u0648\u0651\u062f (\u064a\u062c\u0628 \u0623\u0646 \u062a\u0643\u0648\u0646 \u0627\u0644\u0645\u0646\u0637\u0642\u0629 \u0646\u0641\u0633\u0647\u0627 \u0645\u0645\u0644\u0648\u0643\u0629 \u0644\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u2014 \u062a\u064f\u062d\u0644\u0651 \u0648\u064a\u064f\u0631\u062f\u0651 404\n\u0642\u0628\u0644 \u0627\u0644\u0628\u062d\u062b \u0639\u0646 \u0623\u064a \u0633\u062c\u0644). \u0623\u0631\u0633\u0644 `refresh=true` \u0644\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0623\u0648\u0644\u064b\u0627 \u2014 \u0648\u0643\u0645\u0627 \u0641\u064a \u0646\u0642\u0627\u0637\n\u0627\u0644\u0645\u0646\u0637\u0642\u0629\u060c \u062a\u0637\u0627\u0628\u0642 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u062d\u0633\u0627\u0628 DNS **\u0628\u0627\u0644\u0643\u0627\u0645\u0644** \u0644\u0644\u0645\u0633\u062a\u062f\u0639\u064a\u060c \u0644\u0627 \u0647\u0630\u0647 \u0627\u0644\u0645\u0646\u0637\u0642\u0629\n\u0648\u062d\u062f\u0647\u0627\u060c \u0648\u0647\u064a \u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631.\n" } }, "tags": [ "DNS" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of the zone's DNS records.", "x-i18n": { "tr": { "description": "DNS alan\u0131n\u0131n kay\u0131tlar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0633\u062c\u0644\u0627\u062a DNS \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u0645\u0646\u0637\u0642\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DNSRecord" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "post": { "operationId": "createDNSRecord", "summary": "Create a DNS record", "description": "Requires at least one of the caller's own subscriptions to be in the deployed\nstate, and refuses a 256th record on this zone \u2014 both checked before the record\nis created on the DNS service. Creating the record also reconciles the caller's\n**entire** DNS account as a side effect of reading the new record back \u2014 there\nis no cheaper way to obtain its local row, since the underlying provider call\ndoes not return one. A value the record's name and type already hold is refused\nwith `422` on `data` before anything is written: one value is one record.\n", "x-i18n": { "tr": { "summary": "Bir DNS kayd\u0131 olu\u015ftur", "description": "\u00c7a\u011f\u0131ran\u0131n kendi aboneliklerinden en az birinin da\u011f\u0131t\u0131lm\u0131\u015f durumda olmas\u0131n\u0131\ngerektirir ve bu DNS alan\u0131nda 256'nc\u0131 kayd\u0131 reddeder \u2014 her ikisi de kay\u0131t DNS\nservisinde olu\u015fturulmadan \u00f6nce denetlenir. Kayd\u0131n olu\u015fturulmas\u0131, yeni kayd\u0131n\ngeri okunmas\u0131n\u0131n bir yan etkisi olarak \u00e7a\u011f\u0131ran\u0131n **t\u00fcm** DNS hesab\u0131n\u0131 da\ne\u015fitler \u2014 yerel sat\u0131r\u0131n\u0131 elde etmenin daha ucuz bir yolu yoktur, \u00e7\u00fcnk\u00fc alttaki\nsa\u011flay\u0131c\u0131 \u00e7a\u011fr\u0131s\u0131 b\u00f6yle bir sat\u0131r d\u00f6nd\u00fcrmez. Kayd\u0131n ad\u0131nda ve t\u00fcr\u00fcnde zaten\nbulunan bir de\u011fer, hi\u00e7bir \u015fey yaz\u0131lmadan `data` alan\u0131nda `422` ile reddedilir:\nbir de\u011fer, bir kay\u0131tt\u0131r.\n" }, "ar": { "summary": "\u0625\u0646\u0634\u0627\u0621 \u0633\u062c\u0644 DNS", "description": "\u064a\u062a\u0637\u0644\u0628 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0648\u0627\u062d\u062f \u0639\u0644\u0649 \u0627\u0644\u0623\u0642\u0644 \u0645\u0646 \u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0641\u064a \u062d\u0627\u0644\u0629 \u0627\u0644\u0646\u0634\u0631\u060c \u0648\u064a\u0631\u0641\u0636 \u0627\u0644\u0633\u062c\u0644\n\u0627\u0644\u0640256 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0645\u0646\u0637\u0642\u0629 \u2014 \u0648\u064a\u064f\u062a\u062d\u0642\u064e\u0651\u0642 \u0645\u0646 \u0627\u0644\u0623\u0645\u0631\u064a\u0646 \u0642\u0628\u0644 \u0625\u0646\u0634\u0627\u0621 \u0627\u0644\u0633\u062c\u0644 \u0641\u064a \u062e\u062f\u0645\u0629 DNS. \u0643\u0645\u0627\n\u064a\u0624\u062f\u064a \u0625\u0646\u0634\u0627\u0621 \u0627\u0644\u0633\u062c\u0644 \u0625\u0644\u0649 \u0645\u0637\u0627\u0628\u0642\u0629 \u062d\u0633\u0627\u0628 DNS **\u0628\u0627\u0644\u0643\u0627\u0645\u0644** \u0644\u0644\u0645\u0633\u062a\u062f\u0639\u064a\u060c \u0643\u0623\u062b\u0631 \u062c\u0627\u0646\u0628\u064a \u0644\u0625\u0639\u0627\u062f\u0629\n\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0633\u062c\u0644 \u0627\u0644\u062c\u062f\u064a\u062f \u2014 \u0625\u0630 \u0644\u0627 \u062a\u0648\u062c\u062f \u0648\u0633\u064a\u0644\u0629 \u0623\u0631\u062e\u0635 \u0644\u0644\u062d\u0635\u0648\u0644 \u0639\u0644\u0649 \u0635\u0641\u0651\u0647 \u0627\u0644\u0645\u062d\u0644\u064a\u060c \u0644\u0623\u0646 \u0627\u0633\u062a\u062f\u0639\u0627\u0621\n\u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0627\u0644\u0623\u0633\u0627\u0633\u064a \u0644\u0627 \u064a\u0639\u064a\u062f\u0647. \u0648\u062a\u064f\u0631\u0641\u0636 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0645\u0648\u062c\u0648\u062f\u0629 \u0628\u0627\u0644\u0641\u0639\u0644 \u0644\u0644\u0627\u0633\u0645 \u0648\u0627\u0644\u0646\u0648\u0639 \u0646\u0641\u0633\u064a\u0647\u0645\u0627\n\u0628\u0627\u0644\u0631\u0645\u0632 `422` \u0639\u0644\u0649 \u0627\u0644\u062d\u0642\u0644 `data` \u0642\u0628\u0644 \u0643\u062a\u0627\u0628\u0629 \u0623\u064a \u0634\u064a\u0621: \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0648\u0627\u062d\u062f\u0629 \u0633\u062c\u0644 \u0648\u0627\u062d\u062f.\n" } }, "tags": [ "DNS" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "name", "type", "data" ], "properties": { "name": { "type": "string", "description": "A relative value (e.g. `www`) is auto-qualified against the zone's own\nname; an already fully-qualified value (trailing dot) is used as-is.\n", "x-i18n": { "tr": { "description": "G\u00f6reli bir de\u011fer (\u00f6rne\u011fin `www`) DNS alan\u0131n\u0131n kendi ad\u0131na g\u00f6re otomatik olarak\nnitelenir; zaten tam nitelenmi\u015f bir de\u011fer (sonunda nokta) oldu\u011fu gibi\nkullan\u0131l\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0646\u0633\u0628\u064a\u0629 (\u0645\u062b\u0644 `www`) \u062a\u064f\u0633\u062a\u0643\u0645\u0644 \u062a\u0644\u0642\u0627\u0626\u064a\u064b\u0627 \u0628\u0627\u0633\u0645 \u0627\u0644\u0645\u0646\u0637\u0642\u0629 \u0646\u0641\u0633\u0647\u0627\u061b \u0623\u0645\u0627 \u0627\u0644\u0642\u064a\u0645\u0629\n\u0627\u0644\u0645\u0624\u0647\u064e\u0651\u0644\u0629 \u0628\u0627\u0644\u0643\u0627\u0645\u0644 (\u0627\u0644\u0645\u0646\u062a\u0647\u064a\u0629 \u0628\u0646\u0642\u0637\u0629) \u0641\u062a\u064f\u0633\u062a\u062e\u062f\u0645 \u0643\u0645\u0627 \u0647\u064a.\n" } }, "example": "www" }, "type": { "type": "string", "enum": [ "A", "CNAME", "MX", "PTR", "SRV", "TXT" ] }, "data": { "type": "string", "maxLength": 4096, "example": "203.0.113.5" } } } } } }, "responses": { "201": { "description": "The new DNS record.", "x-i18n": { "tr": { "description": "Olu\u015fturulan DNS kayd\u0131." }, "ar": { "description": "\u0633\u062c\u0644 DNS \u0627\u0644\u062c\u062f\u064a\u062f." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/DNSRecord" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/dns-zones/{zone}/records/{record}": { "parameters": [ { "name": "zone", "in": "path", "required": true, "schema": { "type": "integer" } }, { "name": "record", "in": "path", "required": true, "schema": { "type": "integer" } } ], "patch": { "operationId": "updateDNSRecord", "summary": "Update a DNS record", "description": "The only mutable attributes: `type` and `data`. Updates the record on the DNS\nservice and the local row directly, preserving the record's `id` \u2014 the underlying\nservice method does not persist the change locally on its own, and reconciling\nthrough the account-wide sync instead would delete this record and mint a new\none under a different id. A new `type` and `data` that another record at this\nname already holds is refused with `422` on `data` before anything is written;\nsending the record's own current value is accepted and changes nothing.\n", "x-i18n": { "tr": { "summary": "Bir DNS kayd\u0131n\u0131 g\u00fcncelle", "description": "De\u011fi\u015ftirilebilen tek alanlar: `type` ve `data`. Kayd\u0131 DNS servisinde ve\nyerel sat\u0131rda do\u011frudan g\u00fcnceller, kayd\u0131n `id` de\u011ferini korur \u2014 alttaki servis\nmetodu de\u011fi\u015fikli\u011fi kendi ba\u015f\u0131na yerelde saklamaz; bunun yerine hesab\u0131n\ntamam\u0131n\u0131 kapsayan e\u015fitleme \u00fczerinden ilerlemek bu kayd\u0131 silip yerine farkl\u0131\nbir id ile yenisini olu\u015ftururdu. Bu addaki ba\u015fka bir kayd\u0131n zaten ta\u015f\u0131d\u0131\u011f\u0131 yeni\nbir `type` ve `data`, hi\u00e7bir \u015fey yaz\u0131lmadan `data` alan\u0131nda `422` ile\nreddedilir; kayd\u0131n kendi g\u00fcncel de\u011ferini g\u00f6ndermek kabul edilir ve hi\u00e7bir \u015feyi\nde\u011fi\u015ftirmez.\n" }, "ar": { "summary": "\u062a\u062d\u062f\u064a\u062b \u0633\u062c\u0644 DNS", "description": "\u0627\u0644\u0633\u0645\u062a\u0627\u0646 \u0627\u0644\u0642\u0627\u0628\u0644\u062a\u0627\u0646 \u0644\u0644\u062a\u0639\u062f\u064a\u0644 \u0641\u0642\u0637: `type` \u0648`data`. \u064a\u064f\u062d\u062f\u0650\u0651\u062b \u0627\u0644\u0633\u062c\u0644 \u0641\u064a \u062e\u062f\u0645\u0629 DNS \u0648\u0641\u064a\n\u0627\u0644\u0635\u0641 \u0627\u0644\u0645\u062d\u0644\u064a \u0645\u0628\u0627\u0634\u0631\u0629\u060c \u0645\u0639 \u0627\u0644\u062d\u0641\u0627\u0638 \u0639\u0644\u0649 `id` \u0627\u0644\u0633\u062c\u0644 \u2014 \u0641\u0627\u0644\u062e\u062f\u0645\u0629 \u0627\u0644\u0623\u0633\u0627\u0633\u064a\u0629 \u0644\u0627 \u062a\u062d\u0641\u0638\n\u0627\u0644\u062a\u063a\u064a\u064a\u0631 \u0645\u062d\u0644\u064a\u064b\u0627 \u0645\u0646 \u062a\u0644\u0642\u0627\u0621 \u0646\u0641\u0633\u0647\u0627\u060c \u0648\u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0639\u0628\u0631 \u0627\u0644\u0645\u0632\u0627\u0645\u0646\u0629 \u0627\u0644\u0634\u0627\u0645\u0644\u0629 \u0644\u0644\u062d\u0633\u0627\u0628 \u0628\u062f\u0644\u064b\u0627 \u0645\u0646\n\u0630\u0644\u0643 \u0643\u0627\u0646\u062a \u0633\u062a\u062d\u0630\u0641 \u0647\u0630\u0627 \u0627\u0644\u0633\u062c\u0644 \u0648\u062a\u064f\u0646\u0634\u0626 \u0622\u062e\u0631 \u0628\u0645\u0639\u0631\u0651\u0641 \u0645\u062e\u062a\u0644\u0641. \u0648\u064a\u064f\u0631\u0641\u0636 `type` \u0648`data` \u062c\u062f\u064a\u062f\u0627\u0646\n\u064a\u062d\u0645\u0644\u0647\u0645\u0627 \u0633\u062c\u0644 \u0622\u062e\u0631 \u0628\u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u0645 \u0628\u0627\u0644\u0641\u0639\u0644 \u0628\u0627\u0644\u0631\u0645\u0632 `422` \u0639\u0644\u0649 \u0627\u0644\u062d\u0642\u0644 `data` \u0642\u0628\u0644 \u0643\u062a\u0627\u0628\u0629 \u0623\u064a\n\u0634\u064a\u0621\u061b \u0623\u0645\u0627 \u0625\u0631\u0633\u0627\u0644 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u062d\u0627\u0644\u064a\u0629 \u0644\u0644\u0633\u062c\u0644 \u0646\u0641\u0633\u0647 \u0641\u0645\u0642\u0628\u0648\u0644 \u0648\u0644\u0627 \u064a\u063a\u064a\u0651\u0631 \u0634\u064a\u0626\u064b\u0627.\n" } }, "tags": [ "DNS" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "type", "data" ], "properties": { "type": { "type": "string", "enum": [ "A", "CNAME", "MX", "PTR", "SRV", "TXT" ] }, "data": { "type": "string", "maxLength": 4096, "example": "203.0.113.6" } } } } } }, "responses": { "200": { "description": "The updated DNS record.", "x-i18n": { "tr": { "description": "G\u00fcncellenen DNS kayd\u0131." }, "ar": { "description": "\u0633\u062c\u0644 DNS \u0628\u0639\u062f \u0627\u0644\u062a\u062d\u062f\u064a\u062b." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/DNSRecord" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } }, "delete": { "operationId": "deleteDNSRecord", "summary": "Delete a DNS record", "description": "Deletes the record on the DNS service and its local row. The one documented exception\nto \"every mutation returns the current representation\": there is nothing left\nto return, so this responds `204` with an empty body rather than `200` with the\ndeleted resource. When the DNS service no longer holds this record's value, the call\nanswers `409`, keeps the local row, and `refresh=true` on the zone's record list\nreconciles it.\n", "x-i18n": { "tr": { "summary": "Bir DNS kayd\u0131n\u0131 sil", "description": "Kayd\u0131 DNS servisinden ve yerel sat\u0131r\u0131yla birlikte siler. \u201cHer de\u011fi\u015fiklik g\u00fcncel\ng\u00f6sterimi d\u00f6nd\u00fcr\u00fcr\u201d kural\u0131n\u0131n belgelenmi\u015f tek istisnas\u0131: d\u00f6nd\u00fcr\u00fclecek bir \u015fey\nkalmaz; bu y\u00fczden silinen kayna\u011f\u0131 `200` ile d\u00f6nd\u00fcrmek yerine bo\u015f g\u00f6vdeyle `204`\nyan\u0131t\u0131 verilir. DNS servisi bu kayd\u0131n de\u011ferini art\u0131k tutmuyorsa \u00e7a\u011fr\u0131 `409` d\u00f6ner,\nyerel sat\u0131r\u0131 korur; b\u00f6lgenin kay\u0131t listesinde `refresh=true` ile e\u015fitlenir.\n" }, "ar": { "summary": "\u062d\u0630\u0641 \u0633\u062c\u0644 DNS", "description": "\u064a\u062d\u0630\u0641 \u0627\u0644\u0633\u062c\u0644 \u0641\u064a \u062e\u062f\u0645\u0629 DNS \u0648\u0635\u0641\u064e\u0651\u0647 \u0627\u0644\u0645\u062d\u0644\u064a. \u0648\u0647\u0648 \u0627\u0644\u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u0627\u0644\u0645\u0648\u062b\u064e\u0651\u0642 \u0627\u0644\u0648\u062d\u064a\u062f \u0644\u0642\u0627\u0639\u062f\u0629 \u00ab\u0643\u0644 \u062a\u0639\u062f\u064a\u0644\n\u064a\u0639\u064a\u062f \u0627\u0644\u062a\u0645\u062b\u064a\u0644 \u0627\u0644\u062d\u0627\u0644\u064a\u00bb: \u0641\u0644\u0627 \u064a\u0628\u0642\u0649 \u0634\u064a\u0621 \u064a\u064f\u0639\u0627\u062f\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u064f\u062c\u064a\u0628 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u0627\u0644\u0631\u0645\u0632 `204` \u0628\u062c\u0633\u0645\n\u0641\u0627\u0631\u063a \u0628\u062f\u0644 `200` \u0645\u0639 \u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0645\u062d\u0630\u0648\u0641. \u0648\u0625\u0630\u0627 \u0644\u0645 \u062a\u0639\u062f \u062e\u062f\u0645\u0629 DNS \u062a\u062d\u062a\u0641\u0638 \u0628\u0642\u064a\u0645\u0629 \u0647\u0630\u0627 \u0627\u0644\u0633\u062c\u0644\u060c \u062a\u064f\u062c\u064a\u0628\n\u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u0627\u0644\u0631\u0645\u0632 `409` \u0648\u062a\u064f\u0628\u0642\u064a \u0627\u0644\u0635\u0641 \u0627\u0644\u0645\u062d\u0644\u064a\u060c \u0648\u064a\u064f\u0632\u0627\u0645\u0646\u0647 `refresh=true` \u0641\u064a \u0642\u0627\u0626\u0645\u0629 \u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642.\n" } }, "tags": [ "DNS" ], "responses": { "204": { "description": "The record was deleted.", "x-i18n": { "tr": { "description": "Kay\u0131t silindi." }, "ar": { "description": "\u062a\u0645 \u062d\u0630\u0641 \u0627\u0644\u0633\u062c\u0644." } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/virtual-machine-products": { "get": { "operationId": "listVirtualMachineProducts", "summary": "List virtual machine products", "description": "The sellable VM catalogue. No `refresh` parameter: this is database-backed by\nconstruction \u2014 nothing here ever reconciles against the cloud, unlike the\nofferings it is built from. Only published products are returned, matching\n`VirtualMachineProductPolicy::view()`.\n", "x-i18n": { "tr": { "summary": "Sanal makina \u00fcr\u00fcnlerini listele", "description": "Sat\u0131labilir sanal makina katalo\u011fu. `refresh` parametresi yoktur: bu u\u00e7 nokta yap\u0131s\u0131\ngere\u011fi veritaban\u0131ndan yan\u0131tlan\u0131r \u2014 \u00fczerine kuruldu\u011fu tan\u0131mlar\u0131n aksine, buradaki\nhi\u00e7bir \u015fey bulutla e\u015fitlenmez. `VirtualMachineProductPolicy::view()` ile\nuyumlu olarak yaln\u0131zca yay\u0131mlanm\u0131\u015f \u00fcr\u00fcnler d\u00f6ner.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0645\u0646\u062a\u062c\u0627\u062a \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629", "description": "\u0643\u062a\u0627\u0644\u0648\u062c \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0627\u0644\u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u0628\u064a\u0639. \u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh`: \u0641\u0647\u0630\u0647 \u0627\u0644\u0646\u0642\u0637\u0629\n\u062a\u064f\u0628\u0646\u0649 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0628\u062d\u0643\u0645 \u062a\u0635\u0645\u064a\u0645\u0647\u0627 \u2014 \u0648\u0644\u0627 \u064a\u064f\u0637\u0627\u0628\u064e\u0642 \u0623\u064a \u0634\u064a\u0621 \u0647\u0646\u0627 \u0645\u0639 \u0627\u0644\u0633\u062d\u0627\u0628\u0629\u060c\n\u0628\u062e\u0644\u0627\u0641 \u0627\u0644\u062a\u0639\u0631\u064a\u0641\u0627\u062a \u0627\u0644\u062a\u064a \u0628\u064f\u0646\u064a\u062a \u0645\u0646\u0647\u0627. \u0648\u0644\u0627 \u062a\u064f\u0631\u062c\u064e\u0639 \u0625\u0644\u0627 \u0627\u0644\u0645\u0646\u062a\u062c\u0627\u062a \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u0629\u060c \u0645\u0637\u0627\u0628\u0642\u0629\u064b \u0644\u0640\n`VirtualMachineProductPolicy::view()`.\n" } }, "tags": [ "Billing" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of virtual machine products.", "x-i18n": { "tr": { "description": "Sanal makina \u00fcr\u00fcnlerinden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0645\u0646\u062a\u062c\u0627\u062a \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/VirtualMachineProduct" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/virtual-machine-products/{virtualMachineProduct}": { "parameters": [ { "name": "virtualMachineProduct", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getVirtualMachineProduct", "summary": "Read one virtual machine product", "description": "404s for an unpublished product, matching\n`VirtualMachineProductPolicy::view()` \u2014 reproduced as a query constraint, the\nsame way `GET /isos/{iso}` reproduces `IsoPolicy::view`'s visibility rule,\nrather than a policy check that would 403 instead.\n", "x-i18n": { "tr": { "summary": "Bir sanal makina \u00fcr\u00fcn\u00fcn\u00fc oku", "description": "Yay\u0131mlanmam\u0131\u015f bir \u00fcr\u00fcn i\u00e7in 404 d\u00f6nd\u00fcr\u00fcr; bu,\n`VirtualMachineProductPolicy::view()` ile ayn\u0131d\u0131r \u2014 t\u0131pk\u0131 `GET /isos/{iso}`\nu\u00e7 noktas\u0131n\u0131n `IsoPolicy::view` g\u00f6r\u00fcn\u00fcrl\u00fck kural\u0131n\u0131 yeniden \u00fcretmesi gibi,\nkural burada bir sorgu k\u0131s\u0131t\u0131 olarak yeniden \u00fcretilmi\u015ftir; politika denetimi\nolsayd\u0131 bunun yerine 403 d\u00f6nerdi.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0645\u0646\u062a\u062c \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0648\u0627\u062d\u062f", "description": "\u064a\u064f\u0631\u062c\u0650\u0639 404 \u0644\u0644\u0645\u0646\u062a\u062c \u063a\u064a\u0631 \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u060c \u0645\u0637\u0627\u0628\u0642\u0629\u064b \u0644\u0640\n`VirtualMachineProductPolicy::view()` \u2014 \u0648\u0642\u062f \u0623\u064f\u0639\u064a\u062f \u0625\u0646\u062a\u0627\u062c \u0627\u0644\u0642\u0627\u0639\u062f\u0629 \u0647\u0646\u0627 \u0643\u0642\u064a\u062f \u0639\u0644\u0649\n\u0627\u0644\u0627\u0633\u062a\u0639\u0644\u0627\u0645\u060c \u062a\u0645\u0627\u0645\u064b\u0627 \u0643\u0645\u0627 \u064a\u064f\u0639\u064a\u062f `GET /isos/{iso}` \u0625\u0646\u062a\u0627\u062c \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0638\u0647\u0648\u0631 \u0641\u064a\n`IsoPolicy::view`\u060c \u0644\u0627 \u0643\u0641\u062d\u0635 \u0633\u064a\u0627\u0633\u0629 \u0643\u0627\u0646 \u0633\u064a\u064f\u0631\u062c\u0650\u0639 403 \u0628\u062f\u0644\u064b\u0627 \u0645\u0646 \u0630\u0644\u0643.\n" } }, "tags": [ "Billing" ], "responses": { "200": { "description": "The virtual machine product.", "x-i18n": { "tr": { "description": "Sanal makina \u00fcr\u00fcn\u00fc." }, "ar": { "description": "\u0645\u0646\u062a\u062c \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/VirtualMachineProduct" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/volume-products": { "get": { "operationId": "listVolumeProducts", "summary": "List volume products", "description": "The sellable volume catalogue. No `refresh` parameter, for the same reason as\n`GET /virtual-machine-products`. Only published products are returned.\n", "x-i18n": { "tr": { "summary": "Disk \u00fcr\u00fcnlerini listele", "description": "Sat\u0131labilir disk katalo\u011fu. `GET /virtual-machine-products` ile ayn\u0131 nedenden\n\u00f6t\u00fcr\u00fc `refresh` parametresi yoktur. Yaln\u0131zca yay\u0131mlanm\u0131\u015f \u00fcr\u00fcnler d\u00f6ner.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0645\u0646\u062a\u062c\u0627\u062a \u0627\u0644\u0623\u0642\u0631\u0627\u0635", "description": "\u0643\u062a\u0627\u0644\u0648\u062c \u0627\u0644\u0623\u0642\u0631\u0627\u0635 \u0627\u0644\u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u0628\u064a\u0639. \u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh` \u0644\u0644\u0633\u0628\u0628 \u0646\u0641\u0633\u0647 \u0627\u0644\u0645\u0630\u0643\u0648\u0631 \u0641\u064a\n`GET /virtual-machine-products`. \u0648\u0644\u0627 \u062a\u064f\u0631\u062c\u064e\u0639 \u0625\u0644\u0627 \u0627\u0644\u0645\u0646\u062a\u062c\u0627\u062a \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u0629.\n" } }, "tags": [ "Billing" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of volume products.", "x-i18n": { "tr": { "description": "Disk \u00fcr\u00fcnlerinden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0645\u0646\u062a\u062c\u0627\u062a \u0627\u0644\u0623\u0642\u0631\u0627\u0635." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/VolumeProduct" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/volume-products/{volumeProduct}": { "parameters": [ { "name": "volumeProduct", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getVolumeProduct", "summary": "Read one volume product", "description": "404s for an unpublished product, matching `VolumeProductPolicy::view()` \u2014\nreproduced as a query constraint rather than a policy check.\n", "x-i18n": { "tr": { "summary": "Bir disk \u00fcr\u00fcn\u00fcn\u00fc oku", "description": "Yay\u0131mlanmam\u0131\u015f bir \u00fcr\u00fcn i\u00e7in 404 d\u00f6nd\u00fcr\u00fcr; bu, `VolumeProductPolicy::view()`\nile ayn\u0131d\u0131r \u2014 kural bir politika denetimi olarak de\u011fil, bir sorgu k\u0131s\u0131t\u0131\nolarak yeniden \u00fcretilmi\u015ftir.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0645\u0646\u062a\u062c \u0642\u0631\u0635 \u0648\u0627\u062d\u062f", "description": "\u064a\u064f\u0631\u062c\u0650\u0639 404 \u0644\u0644\u0645\u0646\u062a\u062c \u063a\u064a\u0631 \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u060c \u0645\u0637\u0627\u0628\u0642\u0629\u064b \u0644\u0640 `VolumeProductPolicy::view()` \u2014\n\u0648\u0642\u062f \u0623\u064f\u0639\u064a\u062f \u0625\u0646\u062a\u0627\u062c \u0627\u0644\u0642\u0627\u0639\u062f\u0629 \u0643\u0642\u064a\u062f \u0639\u0644\u0649 \u0627\u0644\u0627\u0633\u062a\u0639\u0644\u0627\u0645 \u0644\u0627 \u0643\u0641\u062d\u0635 \u0633\u064a\u0627\u0633\u0629.\n" } }, "tags": [ "Billing" ], "responses": { "200": { "description": "The volume product.", "x-i18n": { "tr": { "description": "Disk \u00fcr\u00fcn\u00fc." }, "ar": { "description": "\u0645\u0646\u062a\u062c \u0627\u0644\u0642\u0631\u0635." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/VolumeProduct" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/subscriptions": { "get": { "operationId": "listSubscriptions", "summary": "List subscriptions", "description": "Database-backed only \u2014 no `refresh` parameter. Unlike volumes or instances,\nthe reconciling sibling here (`BillingUserService::listSubscriptions()`) is\nnot \"ask the provider what exists\": it is an administrative repair pass that\npromotes any subscription below `deployed` to `deployed` (so merely listing\none would mark a Terraform provider's own deployment finished), terminates\nsubscriptions whose instance moved, deletes ROOT-volume subscriptions along\nwith their payments, and dials the cloud. It does not belong behind a\ncustomer's `GET` at any rate limit.\n", "x-i18n": { "tr": { "summary": "Abonelikleri listele", "description": "Yaln\u0131zca veritaban\u0131ndan yan\u0131tlan\u0131r \u2014 `refresh` parametresi yoktur. Disklerin ya da\nsanal makinalar\u0131n aksine buradaki e\u015fitleyici e\u015fi\n(`BillingUserService::listSubscriptions()`) \u201csa\u011flay\u0131c\u0131ya neyin var oldu\u011funu sormak\u201d\nde\u011fildir: `deployed` alt\u0131ndaki her aboneli\u011fi `deployed` durumuna y\u00fckselten (\u00f6yle ki\nyaln\u0131zca listelemek bile bir Terraform sa\u011flay\u0131c\u0131s\u0131n\u0131n kendi kurulumunu bitmi\u015f\nsayard\u0131), sanal makinas\u0131 ta\u015f\u0131nm\u0131\u015f abonelikleri sonland\u0131ran, ROOT disk aboneliklerini\n\u00f6demeleriyle birlikte silen ve bulutu arayan y\u00f6netsel bir onar\u0131m ge\u00e7i\u015fidir.\nHangi istek s\u0131n\u0131r\u0131yla olursa olsun, bir m\u00fc\u015fterinin `GET` iste\u011finin ard\u0131nda\ndurmamal\u0131d\u0131r.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0641\u0642\u0637 \u2014 \u0648\u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh`. \u0641\u062e\u0644\u0627\u0641\u064b\u0627 \u0644\u0644\u0623\u0642\u0631\u0627\u0635 \u0623\u0648\n\u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629\u060c \u0644\u064a\u0633\u062a \u0627\u0644\u0646\u0633\u062e\u0629 \u0627\u0644\u062a\u064a \u062a\u064f\u062c\u0631\u064a \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0647\u0646\u0627\n(`BillingUserService::listSubscriptions()`) \u00ab\u0633\u0624\u0627\u0644 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0639\u0645\u0651\u0627 \u0647\u0648 \u0645\u0648\u062c\u0648\u062f\u00bb: \u0628\u0644\n\u0647\u064a \u0639\u0645\u0644\u064a\u0629 \u0625\u0635\u0644\u0627\u062d \u0625\u062f\u0627\u0631\u064a\u0629 \u062a\u0631\u0641\u0639 \u0643\u0644 \u0627\u0634\u062a\u0631\u0627\u0643 \u062f\u0648\u0646 `deployed` \u0625\u0644\u0649 `deployed` (\u062d\u062a\u0649 \u0625\u0646\n\u0645\u062c\u0631\u062f \u0627\u0644\u0633\u0631\u062f \u0643\u0627\u0646 \u0633\u064a\u064e\u0639\u064f\u062f\u0651 \u062a\u062c\u0647\u064a\u0632 \u0645\u0632\u0648\u0651\u062f Terraform \u0645\u0646\u062a\u0647\u064a\u064b\u0627)\u060c \u0648\u062a\u064f\u0646\u0647\u064a \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u062a\u064a\n\u0627\u0646\u062a\u0642\u0644 \u062c\u0647\u0627\u0632\u0647\u0627 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u060c \u0648\u062a\u062d\u0630\u0641 \u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0623\u0642\u0631\u0627\u0635 ROOT \u0645\u0639 \u062f\u0641\u0639\u0627\u062a\u0647\u0627\u060c \u0648\u062a\u062a\u0635\u0644 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629. \u0648\u0647\u064a\n\u0644\u0627 \u062a\u0646\u062a\u0645\u064a \u062e\u0644\u0641 \u0637\u0644\u0628 `GET` \u0644\u0639\u0645\u064a\u0644 \u0645\u0647\u0645\u0627 \u0643\u0627\u0646 \u062d\u062f\u0651 \u0627\u0644\u0645\u0639\u062f\u0651\u0644.\n" } }, "tags": [ "Billing" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of subscriptions.", "x-i18n": { "tr": { "description": "Aboneliklerden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Subscription" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/subscriptions/{subscription}": { "parameters": [ { "name": "subscription", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getSubscription", "summary": "Read one subscription", "description": "Ownership is enforced as a query constraint, not a policy check: another\ncustomer's subscription 404s here, where the panel's own route (implicit\nbinding plus `SubscriptionPolicy`) would 403 it. No `refresh` parameter,\nfor the same reason as `GET /subscriptions`.\n", "x-i18n": { "tr": { "summary": "Tek bir aboneli\u011fi oku", "description": "Sahiplik, bir politika denetimi olarak de\u011fil, sorgunun kendisinde bir k\u0131s\u0131t olarak\nuygulan\u0131r: ba\u015fka bir m\u00fc\u015fterinin aboneli\u011fi burada 404 d\u00f6ner; panelin kendi rotas\u0131 ise\n(\u00f6rt\u00fck ba\u011flama ve `SubscriptionPolicy`) 403 d\u00f6nd\u00fcr\u00fcrd\u00fc. `GET /subscriptions` ile\nayn\u0131 nedenle `refresh` parametresi yoktur.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0627\u0634\u062a\u0631\u0627\u0643 \u0648\u0627\u062d\u062f", "description": "\u062a\u064f\u0641\u0631\u0636 \u0627\u0644\u0645\u0644\u0643\u064a\u0629 \u0628\u0648\u0635\u0641\u0647\u0627 \u0642\u064a\u062f\u064b\u0627 \u0639\u0644\u0649 \u0627\u0644\u0627\u0633\u062a\u0639\u0644\u0627\u0645 \u0644\u0627 \u0641\u062d\u0635\u064b\u0627 \u0644\u0644\u0633\u064a\u0627\u0633\u0629: \u0641\u0627\u0634\u062a\u0631\u0627\u0643 \u0639\u0645\u064a\u0644 \u0622\u062e\u0631\n\u064a\u062c\u064a\u0628 \u0647\u0646\u0627 \u0628\u0640 404\u060c \u0628\u064a\u0646\u0645\u0627 \u0643\u0627\u0646 \u0645\u0633\u0627\u0631 \u0627\u0644\u0644\u0648\u062d\u0629 \u0646\u0641\u0633\u0647 (\u0627\u0644\u0631\u0628\u0637 \u0627\u0644\u0636\u0645\u0646\u064a \u0645\u0639\n`SubscriptionPolicy`) \u0633\u064a\u062c\u064a\u0628 \u0628\u0640 403. \u0648\u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh`\u060c \u0644\u0644\u0633\u0628\u0628 \u0646\u0641\u0633\u0647\n\u0627\u0644\u0645\u0630\u0643\u0648\u0631 \u0641\u064a `GET /subscriptions`.\n" } }, "tags": [ "Billing" ], "responses": { "200": { "description": "The subscription.", "x-i18n": { "tr": { "description": "Abonelik." }, "ar": { "description": "\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Subscription" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/subscriptions/{subscription}/actions/cancel": { "parameters": [ { "name": "subscription", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "cancelSubscription", "summary": "Cancel a subscription", "description": "Terminates the subscription. Requires `order:write`, not `billing:read`:\ncancelling ends a paid asset, so it sits behind the same deliberate\ncommerce-write opt-in as an order would, even though nothing here charges a\ncard \u2014 `TokenAbility`'s docblock is explicit that the read/write grid is not\nmeant to be \"completed\" with a dedicated `billing:write`.\n\nIdempotent on an already-terminated subscription: repeating the call returns\n`200` with the current (already-terminated) representation rather than the\n`409` a second cancellation would otherwise produce, so a Terraform destroy\nthat retries after a timeout does not fail.\n\nRefuses to cancel anything not currently `deployed` \u2014 an instance still\nrunning, a volume still attached, or a missing instance/volume \u2014 with `409`,\nsince each of those is a conflicting state the caller must resolve first\n(stop the instance, detach the volume), not a malformed request.\n", "x-i18n": { "tr": { "summary": "Bir aboneli\u011fi iptal et", "description": "Aboneli\u011fi sonland\u0131r\u0131r. `billing:read` de\u011fil `order:write` izni gerekir: iptal,\n\u00f6denmi\u015f bir varl\u0131\u011f\u0131 sona erdirir; bu y\u00fczden burada hi\u00e7bir karta \u00e7ekim yap\u0131lmasa da,\nt\u0131pk\u0131 bir sipari\u015f gibi, ticari yazma izninin bilin\u00e7li olarak a\u00e7\u0131lmas\u0131n\u0131n ard\u0131ndad\u0131r\n\u2014 `TokenAbility` s\u0131n\u0131f\u0131n\u0131n a\u00e7\u0131klamas\u0131, okuma/yazma tablosunun ayr\u0131 bir\n`billing:write` ile \u201ctamamlanmas\u0131n\u0131n\u201d ama\u00e7lanmad\u0131\u011f\u0131n\u0131 a\u00e7\u0131k\u00e7a s\u00f6yler.\n\nZaten sonland\u0131r\u0131lm\u0131\u015f bir abonelikte tekrar\u0131 g\u00fcvenlidir (idempotent): \u00e7a\u011fr\u0131y\u0131\nyinelemek, ikinci bir iptalin yol a\u00e7aca\u011f\u0131 `409` yerine g\u00fcncel (zaten sonland\u0131r\u0131lm\u0131\u015f)\ng\u00f6sterimi `200` ile d\u00f6ner; b\u00f6ylece zaman a\u015f\u0131m\u0131ndan sonra yeniden denenen bir\nTerraform destroy i\u015flemi ba\u015far\u0131s\u0131z olmaz.\n\n\u015eu anda `deployed` durumunda olmayan hi\u00e7bir \u015feyi iptal etmez \u2014 h\u00e2l\u00e2 \u00e7al\u0131\u015fan bir\nsanal makina, h\u00e2l\u00e2 ba\u011fl\u0131 bir disk ya da eksik bir sanal makina/disk \u2014 ve `409` ile\nreddeder; \u00e7\u00fcnk\u00fc bunlar\u0131n her biri, \u00e7a\u011f\u0131ran\u0131n \u00f6nce \u00e7\u00f6zmesi gereken bir \u00e7ak\u0131\u015fma\ndurumudur (sanal makinay\u0131 durdurun, diski ay\u0131r\u0131n), hatal\u0131 bi\u00e7imlendirilmi\u015f bir istek\nde\u011fil.\n" }, "ar": { "summary": "\u0625\u0644\u063a\u0627\u0621 \u0627\u0634\u062a\u0631\u0627\u0643", "description": "\u064a\u064f\u0646\u0647\u064a \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643. \u0648\u064a\u062a\u0637\u0644\u0628 `order:write` \u0644\u0627 `billing:read`: \u0641\u0627\u0644\u0625\u0644\u063a\u0627\u0621 \u064a\u064f\u0646\u0647\u064a \u0623\u0635\u0644\u064b\u0627\n\u0645\u062f\u0641\u0648\u0639\u064b\u0627\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u0642\u0639 \u062e\u0644\u0641 \u0627\u0644\u0645\u0648\u0627\u0641\u0642\u0629 \u0627\u0644\u0645\u062a\u0639\u0645\u062f\u0629 \u0646\u0641\u0633\u0647\u0627 \u0639\u0644\u0649 \u0627\u0644\u0643\u062a\u0627\u0628\u0629 \u0627\u0644\u062a\u062c\u0627\u0631\u064a\u0629 \u0627\u0644\u062a\u064a \u064a\u0642\u0639\n\u062e\u0644\u0641\u0647\u0627 \u0627\u0644\u0637\u0644\u0628\u060c \u0648\u0625\u0646 \u0643\u0627\u0646 \u0644\u0627 \u0634\u064a\u0621 \u0647\u0646\u0627 \u064a\u0633\u062d\u0628 \u0645\u0646 \u0628\u0637\u0627\u0642\u0629 \u2014 \u0648\u062a\u0648\u062b\u064a\u0642 \u0627\u0644\u0635\u0646\u0641 `TokenAbility`\n\u0635\u0631\u064a\u062d \u0641\u064a \u0623\u0646 \u0634\u0628\u0643\u0629 \u0627\u0644\u0642\u0631\u0627\u0621\u0629/\u0627\u0644\u0643\u062a\u0627\u0628\u0629 \u0644\u064a\u0633 \u0627\u0644\u0645\u0642\u0635\u0648\u062f \u00ab\u0625\u0643\u0645\u0627\u0644\u0647\u0627\u00bb \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `billing:write`\n\u0645\u062e\u0635\u0635\u0629.\n\n\u0648\u0647\u0648 \u0645\u062a\u0643\u0627\u0641\u0626 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent) \u0639\u0644\u0649 \u0627\u0634\u062a\u0631\u0627\u0643 \u0645\u064f\u0646\u0647\u0649\u064b \u0633\u0644\u0641\u064b\u0627: \u0641\u062a\u0643\u0631\u0627\u0631 \u0627\u0644\u0627\u0633\u062a\u062f\u0639\u0627\u0621 \u064a\u0639\u064a\u062f `200`\n\u0645\u0639 \u0627\u0644\u062a\u0645\u062b\u064a\u0644 \u0627\u0644\u062d\u0627\u0644\u064a (\u0627\u0644\u0645\u064f\u0646\u0647\u0649 \u0633\u0644\u0641\u064b\u0627) \u0628\u062f\u0644\u064b\u0627 \u0645\u0646 `409` \u0627\u0644\u0630\u064a \u0643\u0627\u0646 \u0625\u0644\u063a\u0627\u0621 \u062b\u0627\u0646\u064d\n\u0633\u064a\u064f\u0646\u062a\u062c\u0647\u060c \u0641\u0644\u0627 \u064a\u0641\u0634\u0644 \u0623\u0645\u0631 Terraform destroy \u0627\u0644\u0630\u064a \u064a\u0639\u064a\u062f \u0627\u0644\u0645\u062d\u0627\u0648\u0644\u0629 \u0628\u0639\u062f \u0627\u0646\u062a\u0647\u0627\u0621 \u0627\u0644\u0645\u0647\u0644\u0629.\n\n\u0648\u064a\u0631\u0641\u0636 \u0625\u0644\u063a\u0627\u0621 \u0623\u064a \u0634\u064a\u0621 \u0644\u064a\u0633 \u0641\u064a \u062d\u0627\u0644\u0629 `deployed` \u062d\u0627\u0644\u064a\u064b\u0627 \u2014 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0645\u0627 \u064a\u0632\u0627\u0644 \u064a\u0639\u0645\u0644\u060c\n\u0623\u0648 \u0642\u0631\u0635 \u0645\u0627 \u064a\u0632\u0627\u0644 \u0645\u0648\u0635\u0648\u0644\u064b\u0627\u060c \u0623\u0648 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a/\u0642\u0631\u0635 \u0645\u0641\u0642\u0648\u062f \u2014 \u0641\u064a\u062c\u064a\u0628 \u0628\u0640 `409`\u060c \u0644\u0623\u0646 \u0643\u0644\u064b\u0651\u0627 \u0645\u0646 \u0647\u0630\u0647\n\u0627\u0644\u062d\u0627\u0644\u0627\u062a \u062d\u0627\u0644\u0629 \u062a\u0639\u0627\u0631\u0636 \u0639\u0644\u0649 \u0627\u0644\u0637\u0627\u0644\u0628 \u062d\u0644\u0651\u0647\u0627 \u0623\u0648\u0644\u064b\u0627 (\u0623\u0648\u0642\u0641 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u060c \u0627\u0641\u0635\u0644 \u0627\u0644\u0642\u0631\u0635)\u060c \u0644\u0627 \u0637\u0644\u0628\u064b\u0627\n\u0645\u064f\u0634\u0648\u064e\u0651\u0647 \u0627\u0644\u0628\u0646\u064a\u0629.\n" } }, "tags": [ "Billing" ], "responses": { "200": { "description": "The subscription, terminated (or already terminated).", "x-i18n": { "tr": { "description": "Sonland\u0131r\u0131lm\u0131\u015f (ya da zaten sonland\u0131r\u0131lm\u0131\u015f olan) abonelik." }, "ar": { "description": "\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0628\u0639\u062f \u0625\u0646\u0647\u0627\u0626\u0647 (\u0623\u0648 \u0627\u0644\u0645\u064f\u0646\u0647\u0649 \u0633\u0644\u0641\u064b\u0627)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Subscription" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/payments": { "get": { "operationId": "listPayments", "summary": "List payments", "description": "Database-backed by default. `amount`/`subtotal`/`taxes`/`discount`/\n`applied_balance`/`taxable_base`/`list_total`/`catalogue_discount` are `null` on\nany payment that has never been recalculated \u2014 recalculating is a write, so a plain `GET` never triggers\nit. Pass `refresh=true` to recalculate every payment on the returned page;\nthat variant is rate-limited far more tightly and must not be used for\npolling.\n", "x-i18n": { "tr": { "summary": "\u00d6demeleri listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. Hi\u00e7 yeniden hesaplanmam\u0131\u015f bir \u00f6demede\n`amount`/`subtotal`/`taxes`/`discount`/`applied_balance`/`taxable_base`/`list_total`/\n`catalogue_discount` alanlar\u0131 `null`'dur \u2014\nyeniden hesaplamak bir yazma i\u015flemidir, bu y\u00fczden d\u00fcz bir `GET` bunu hi\u00e7 tetiklemez.\nD\u00f6nen sayfadaki her \u00f6demeyi yeniden hesaplamak i\u00e7in `refresh=true` g\u00f6nderin; bu\nbi\u00e7imin istek s\u0131n\u0131r\u0131 \u00e7ok daha dard\u0131r ve d\u00fczenli yoklama i\u00e7in kullan\u0131lmamal\u0131d\u0131r.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u062f\u0641\u0639\u0627\u062a", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u0648\u062a\u0643\u0648\u0646 \u0627\u0644\u062d\u0642\u0648\u0644\n`amount`/`subtotal`/`taxes`/`discount`/`applied_balance`/`taxable_base`/`list_total`/\n`catalogue_discount` \u0628\u0642\u064a\u0645\u0629 `null` \u0641\u064a \u0623\u064a \u062f\u0641\u0639\u0629 \u0644\u0645\n\u064a\u064f\u0639\u064e\u062f \u0627\u062d\u062a\u0633\u0627\u0628\u0647\u0627 \u0642\u0637 \u2014 \u0641\u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u0627\u062d\u062a\u0633\u0627\u0628 \u0639\u0645\u0644\u064a\u0629 \u0643\u062a\u0627\u0628\u0629\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627 \u064a\u064f\u0637\u0644\u0642\u0647\u0627 \u0637\u0644\u0628 `GET` \u0639\u0627\u062f\u064a\n\u0623\u0628\u062f\u064b\u0627. \u0645\u0631\u0651\u0631 `refresh=true` \u0644\u0625\u0639\u0627\u062f\u0629 \u0627\u062d\u062a\u0633\u0627\u0628 \u0643\u0644 \u062f\u0641\u0639\u0629 \u0641\u064a \u0627\u0644\u0635\u0641\u062d\u0629 \u0627\u0644\u0645\u064f\u0639\u0627\u062f\u0629\u061b \u0648\u0647\u0630\u0647 \u0627\u0644\u0635\u064a\u063a\u0629\n\u0645\u062d\u062f\u0648\u062f\u0629 \u0627\u0644\u0645\u0639\u062f\u0651\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0648\u0644\u0627 \u064a\u062c\u0648\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a.\n" } }, "tags": [ "Billing" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of payments.", "x-i18n": { "tr": { "description": "\u00d6demelerden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u062f\u0641\u0639\u0627\u062a." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Payment" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/payments/{payment}": { "parameters": [ { "name": "payment", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getPayment", "summary": "Read one payment", "description": "Ownership is enforced as a query constraint: another customer's payment\n404s. Pass `refresh=true` to force a recalculation of `amount` and its\nsiblings before responding \u2014 see `GET /payments`'s description for why a\nplain read never does.\n", "x-i18n": { "tr": { "summary": "Tek bir \u00f6demeyi oku", "description": "Sahiplik, sorgunun kendisinde bir k\u0131s\u0131t olarak uygulan\u0131r: ba\u015fka bir\nm\u00fc\u015fterinin \u00f6demesi 404 d\u00f6ner. Yan\u0131t verilmeden \u00f6nce `amount` ve karde\u015f\nalanlar\u0131n\u0131n yeniden hesaplanmas\u0131n\u0131 zorlamak i\u00e7in `refresh=true` g\u00f6nderin \u2014\nd\u00fcz bir okuman\u0131n bunu neden hi\u00e7 yapmad\u0131\u011f\u0131 i\u00e7in `GET /payments` a\u00e7\u0131klamas\u0131na\nbak\u0131n.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u062f\u0641\u0639\u0629 \u0648\u0627\u062d\u062f\u0629", "description": "\u062a\u064f\u0641\u0631\u0636 \u0627\u0644\u0645\u0644\u0643\u064a\u0629 \u0628\u0648\u0635\u0641\u0647\u0627 \u0642\u064a\u062f\u064b\u0627 \u0639\u0644\u0649 \u0627\u0644\u0627\u0633\u062a\u0639\u0644\u0627\u0645: \u0641\u062f\u0641\u0639\u0629 \u0639\u0645\u064a\u0644 \u0622\u062e\u0631 \u062a\u062c\u064a\u0628 \u0628\u0640 404. \u0645\u0631\u0651\u0631\n`refresh=true` \u0644\u0641\u0631\u0636 \u0625\u0639\u0627\u062f\u0629 \u0627\u062d\u062a\u0633\u0627\u0628 `amount` \u0648\u0627\u0644\u062d\u0642\u0648\u0644 \u0627\u0644\u0634\u0642\u064a\u0642\u0629 \u0644\u0647 \u0642\u0628\u0644 \u0627\u0644\u0631\u062f \u2014\n\u0648\u0627\u0646\u0638\u0631 \u0648\u0635\u0641 `GET /payments` \u0644\u062a\u0639\u0631\u0641 \u0644\u0645\u0627\u0630\u0627 \u0644\u0627 \u062a\u0641\u0639\u0644 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0639\u0627\u062f\u064a\u0629 \u0630\u0644\u0643 \u0623\u0628\u062f\u064b\u0627.\n" } }, "tags": [ "Billing" ], "parameters": [ { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "The payment.", "x-i18n": { "tr": { "description": "\u00d6deme." }, "ar": { "description": "\u0627\u0644\u062f\u0641\u0639\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Payment" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/credit-cards": { "get": { "operationId": "listCreditCards", "summary": "List stored credit cards", "description": "Database-backed by default. Card enrolment stays in the panel, which is\nalready behind a session and 2FA \u2014 this API never accepts a PAN, so there\nis no `POST` here.\n\n`refresh=true` asks the payment gateway directly whether it still knows\neach card, one call per card, and **deletes** the local row for any card\nthe gateway no longer has \u2014 this is not a free \"check the status\" call, it\nis a destructive reconciliation the caller is opting into. Rate-limited far\nmore tightly than a plain read.\n", "x-i18n": { "tr": { "summary": "Sakl\u0131 kredi kartlar\u0131n\u0131 listele", "description": "Varsay\u0131lan olarak veritaban\u0131ndan yan\u0131tlan\u0131r. Kart kayd\u0131, zaten oturum ve 2FA\narkas\u0131nda olan panelde kal\u0131r \u2014 bu API hi\u00e7bir zaman PAN (kart numaras\u0131) kabul etmez,\nbu y\u00fczden burada `POST` yoktur.\n\n`refresh=true`, \u00f6deme sa\u011flay\u0131c\u0131s\u0131na her kart\u0131 h\u00e2l\u00e2 tan\u0131y\u0131p tan\u0131mad\u0131\u011f\u0131n\u0131 do\u011frudan\nsorar, kart ba\u015f\u0131na bir \u00e7a\u011fr\u0131 yapar ve sa\u011flay\u0131c\u0131n\u0131n art\u0131k tan\u0131mad\u0131\u011f\u0131 her kart\u0131n yerel\nsat\u0131r\u0131n\u0131 **siler** \u2014 bu, \u00fccretsiz bir \u201cdurumu kontrol et\u201d \u00e7a\u011fr\u0131s\u0131 de\u011fil, \u00e7a\u011f\u0131ran\u0131n\nbilerek se\u00e7ti\u011fi y\u0131k\u0131c\u0131 bir e\u015fitlemedir. Sade bir okumaya g\u00f6re istek s\u0131n\u0131r\u0131 \u00e7ok daha\ndard\u0131r.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0628\u0637\u0627\u0642\u0627\u062a \u0627\u0644\u0627\u0626\u062a\u0645\u0627\u0646 \u0627\u0644\u0645\u062d\u0641\u0648\u0638\u0629", "description": "\u064a\u064f\u062c\u0627\u0628 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627. \u064a\u0628\u0642\u0649 \u062a\u0633\u062c\u064a\u0644 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0648\u0647\u064a \u0645\u062d\u0645\u064a\u0629 \u0623\u0635\u0644\u064b\u0627\n\u0628\u062c\u0644\u0633\u0629 \u0648\u0628\u0627\u0644\u0645\u0635\u0627\u062f\u0642\u0629 \u0627\u0644\u062b\u0646\u0627\u0626\u064a\u0629 \u2014 \u0644\u0627 \u062a\u0642\u0628\u0644 \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0631\u0642\u0645 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 (PAN) \u0623\u0628\u062f\u064b\u0627\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627\n\u064a\u0648\u062c\u062f `POST` \u0647\u0646\u0627.\n\n\u064a\u0633\u0623\u0644 `refresh=true` \u0628\u0648\u0627\u0628\u0629 \u0627\u0644\u062f\u0641\u0639 \u0645\u0628\u0627\u0634\u0631\u0629 \u0639\u0645\u0651\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646\u062a \u0644\u0627 \u062a\u0632\u0627\u0644 \u062a\u0639\u0631\u0641 \u0643\u0644 \u0628\u0637\u0627\u0642\u0629\u060c \u0628\u0627\u0633\u062a\u062f\u0639\u0627\u0621\n\u0648\u0627\u062d\u062f \u0644\u0643\u0644 \u0628\u0637\u0627\u0642\u0629\u060c \u0648**\u064a\u062d\u0630\u0641** \u0627\u0644\u0635\u0641 \u0627\u0644\u0645\u062d\u0644\u064a \u0644\u0623\u064a \u0628\u0637\u0627\u0642\u0629 \u0644\u0645 \u062a\u0639\u062f \u0627\u0644\u0628\u0648\u0627\u0628\u0629 \u062a\u062d\u062a\u0641\u0638 \u0628\u0647\u0627 \u2014 \u0648\u0647\u0630\u0627 \u0644\u064a\u0633\n\u0627\u0633\u062a\u062f\u0639\u0627\u0621\u064b \u0645\u062c\u0627\u0646\u064a\u064b\u0627 \u00ab\u0644\u0644\u062a\u062d\u0642\u0642 \u0645\u0646 \u0627\u0644\u062d\u0627\u0644\u0629\u00bb\u060c \u0628\u0644 \u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u062f\u0645\u0650\u0651\u0631\u0629 \u064a\u062e\u062a\u0627\u0631\u0647\u0627 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0639\u0646 \u0642\u0635\u062f. \u0648\u0647\u0648\n\u0645\u062d\u062f\u0648\u062f \u0627\u0644\u0645\u0639\u062f\u0644 \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0643\u0628\u0631 \u0628\u0643\u062b\u064a\u0631 \u0645\u0646 \u0642\u0631\u0627\u0621\u0629 \u0639\u0627\u062f\u064a\u0629.\n" } }, "tags": [ "Billing" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "$ref": "#/components/parameters/Refresh" } ], "responses": { "200": { "description": "A page of stored credit cards.", "x-i18n": { "tr": { "description": "Sakl\u0131 kredi kartlar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0628\u0637\u0627\u0642\u0627\u062a \u0627\u0644\u0627\u0626\u062a\u0645\u0627\u0646 \u0627\u0644\u0645\u062d\u0641\u0648\u0638\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/CreditCard" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/refunds": { "get": { "operationId": "listRefunds", "summary": "List refunds", "description": "The caller's own refunds only. No `refresh` parameter: a refund is a record\nof something that already happened (or is pending), not a live provider\nresource to reconcile against.\n", "x-i18n": { "tr": { "summary": "\u0130adeleri listele", "description": "Yaln\u0131zca \u00e7a\u011f\u0131ran\u0131n kendi iadeleri. `refresh` parametresi yoktur: iade, olup bitmi\u015f\n(ya da beklemede olan) bir \u015feyin kayd\u0131d\u0131r; sa\u011flay\u0131c\u0131da e\u015fitlenecek canl\u0131 bir kaynak\nde\u011fildir.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f\u0627\u062a", "description": "\u0627\u0633\u062a\u0631\u062f\u0627\u062f\u0627\u062a \u0627\u0644\u0637\u0627\u0644\u0628 \u0648\u062d\u062f\u0647. \u0648\u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh`: \u0641\u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0633\u062c\u0644 \u0644\u0623\u0645\u0631 \u0648\u0642\u0639\n\u0641\u0639\u0644\u064b\u0627 (\u0623\u0648 \u0645\u0627 \u064a\u0632\u0627\u0644 \u0645\u0639\u0644\u0642\u064b\u0627)\u060c \u0644\u0627 \u0645\u0648\u0631\u062f \u062d\u064a \u0644\u062f\u0649 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u062a\u062c\u0631\u064a \u0645\u0637\u0627\u0628\u0642\u062a\u0647.\n" } }, "tags": [ "Billing" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of refunds.", "x-i18n": { "tr": { "description": "\u0130adelerden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f\u0627\u062a." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Refund" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/billing/account": { "get": { "operationId": "getBillingAccount", "summary": "Read the caller's balance and outstanding total", "description": "No `refresh` parameter: both `balance` and `due` are derived straight from\nstored rows, so there is nothing to reconcile against a provider.\n", "x-i18n": { "tr": { "summary": "\u00c7a\u011f\u0131ran\u0131n bakiyesini ve \u00f6denmemi\u015f toplam\u0131n\u0131 oku", "description": "`refresh` parametresi yoktur: hem `balance` hem `due`, do\u011frudan kay\u0131tl\u0131 sat\u0131rlardan\nt\u00fcretilir; dolay\u0131s\u0131yla bir sa\u011flay\u0131c\u0131yla e\u015fitlenecek bir \u015fey yoktur.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0631\u0635\u064a\u062f \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0648\u0625\u062c\u0645\u0627\u0644\u064a \u0627\u0644\u0645\u0633\u062a\u062d\u0642 \u0639\u0644\u064a\u0647", "description": "\u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh`: \u0641\u0643\u0644\u064c\u0651 \u0645\u0646 `balance` \u0648`due` \u0645\u0634\u062a\u0642\u0651 \u0645\u0628\u0627\u0634\u0631\u0629 \u0645\u0646 \u0635\u0641\u0648\u0641 \u0645\u062e\u0632\u0651\u0646\u0629\u060c\n\u0641\u0644\u064a\u0633 \u062b\u0645\u0629 \u0645\u0627 \u062a\u062c\u0631\u064a \u0645\u0637\u0627\u0628\u0642\u062a\u0647 \u0645\u0639 \u0645\u0632\u0648\u0651\u062f.\n" } }, "tags": [ "Billing" ], "responses": { "200": { "description": "The caller's account summary.", "x-i18n": { "tr": { "description": "\u00c7a\u011f\u0131ran\u0131n hesap \u00f6zeti." }, "ar": { "description": "\u0645\u0644\u062e\u0651\u0635 \u062d\u0633\u0627\u0628 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/BillingAccount" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/orders": { "post": { "operationId": "createOrder", "summary": "Place an order, discounted by the account balance", "description": "Buys virtual machines and volumes, applies whatever granted credit the account\nholds as a discount, and leaves the rest for a card. This is the only endpoint in\nthe API that spends money.\n\nThere is no card path HERE, and this is structural rather than a setting: a stored\ncard's first charge always requires an interactive 3-D Secure challenge in a\nbrowser (`global_settings.shop_threeds_only` defaults to true and\n`credit_cards.threeds_authorized` defaults to false), which nothing headless can\ncomplete. So the order is PLACED and the subscriptions are created, and the whole\nbill is left on the payment for a person to settle: `needs_card` says whether that\nis the case, `credit_applied` says what the account's credit will take off it,\n`payable` says what a card is then asked for, and `payment_url` is where a browser\nfinishes it. A card is never charged silently.\n\n**Placing an order moves no money.** Nothing is taken from the balance here \u2014 the\ncredit is applied when the payment is settled, like any other bill, so an order\nnobody ever pays holds none of the customer's credit. `credit_applied` and\n`payable` are therefore projections of what will happen at payment, while the\nnested `payment` object carries the row as it stands: its `amount` is the whole\nfigure and its `applied_balance` is `0.00` until it is paid.\n\nGranted credit is a discount on the NET, capped at a share of it, so an order with\na price on it normally leaves something payable however large the balance. An order\nis no longer refused for want of a balance.\n\nCredit is granted by our staff, never bought; there is no way to add it from\nthe API or the panel.\n\n**Asynchronous.** Paying does not provision. A queued listener reacts to the\norder and dials the cloud, driving each subscription `new` \u2192 `pending` \u2192\n`deployed` or `failed`. The response is `202` and carries a `Location` header\npointing at the first subscription; poll `GET /subscriptions/{id}` from there.\nA subscription that never leaves `pending` is a failed deployment that has not\nyet been recorded \u2014 check `failure_reason` on the subscription.\n\n**Idempotent.** `Idempotency-Key` is required. The key is claimed before the\norder runs, so a client that times out and retries while the first request is\nstill in flight gets `409` rather than a second charge; once the first request\nhas finished, the same key with the same body replays the original `202` and\ncreates nothing.\n\n**Preconditions**, each re-asserted here exactly as the panel's checkout\nenforces them, and each refused with `422` naming the one that is unmet:\nbilling information on file, the end-user licence agreement accepted, an\nidentity or passport number on file, the shop open, and the caller's `max_vms`\n/ `max_vols` quotas not exceeded. This endpoint is not a way around any limit\nthe panel applies.\n\nRequires `order:write`, which is off by default when a token is minted and is\nnever implied by another ability.\n", "x-i18n": { "tr": { "summary": "Hesap bakiyesiyle iskonto edilen bir sipari\u015f ver", "description": "Sanal makina ve disk sat\u0131n al\u0131r, hesapta bulunan hediye krediyi iskonto olarak\nuygular ve kalan\u0131 karta b\u0131rak\u0131r. API'de para harcayan tek u\u00e7 nokta budur.\n\nBURADA kart yolu yoktur ve bu bir ayar de\u011fil, yap\u0131sal bir durumdur: kay\u0131tl\u0131 bir\nkart\u0131n ilk \u00e7ekimi her zaman taray\u0131c\u0131da etkile\u015fimli bir 3-D Secure do\u011frulamas\u0131\ngerektirir (`global_settings.shop_threeds_only` varsay\u0131lan olarak true,\n`credit_cards.threeds_authorized` varsay\u0131lan olarak false'tur) ve bunu aray\u00fczs\u00fcz\nhi\u00e7bir istemci tamamlayamaz. Bu y\u00fczden sipari\u015f VER\u0130L\u0130R, abonelikler olu\u015fturulur ve\nfaturan\u0131n tamam\u0131, bir ki\u015finin tamamlamas\u0131 i\u00e7in \u00f6demenin \u00fczerinde b\u0131rak\u0131l\u0131r: b\u00f6yle bir\ndurumun olup olmad\u0131\u011f\u0131n\u0131 `needs_card`, hesaptaki kredinin d\u00fc\u015fece\u011fi tutar\u0131\n`credit_applied`, ard\u0131ndan karttan istenecek tutar\u0131 `payable`, i\u015flemin tamamlanaca\u011f\u0131\nadresi ise `payment_url` s\u00f6yler. Hi\u00e7bir kart sessizce \u00e7ekilmez.\n\n**Sipari\u015f vermek para hareketi yaratmaz.** Burada bakiyeden hi\u00e7bir tutar al\u0131nmaz \u2014\nkredi, di\u011fer b\u00fct\u00fcn faturalarda oldu\u011fu gibi \u00f6deme yap\u0131ld\u0131\u011f\u0131nda uygulan\u0131r; b\u00f6ylece hi\u00e7\n\u00f6denmeyen bir sipari\u015f m\u00fc\u015fterinin kredisinden hi\u00e7bir tutar tutmaz. Bu y\u00fczden\n`credit_applied` ile `payable`, \u00f6deme an\u0131nda ne olaca\u011f\u0131n\u0131n \u00f6ng\u00f6r\u00fcs\u00fcd\u00fcr; i\u00e7 i\u00e7e ge\u00e7mi\u015f\n`payment` nesnesi ise sat\u0131r\u0131n o anki h\u00e2lini ta\u015f\u0131r: `amount` alan\u0131 tutar\u0131n tamam\u0131d\u0131r ve\n`applied_balance` alan\u0131 \u00f6deme yap\u0131lana kadar `0.00`'d\u0131r.\n\nHediye kredi net tutar \u00fczerinden uygulanan ve bu tutar\u0131n belirli bir oran\u0131yla\ns\u0131n\u0131rlanan bir iskontodur; bu y\u00fczden fiyat\u0131 olan bir sipari\u015fte, bakiye ne kadar\nb\u00fcy\u00fck olursa olsun, genellikle \u00f6denecek bir tutar kal\u0131r. Bir sipari\u015f art\u0131k bakiye\nyetersizli\u011fi y\u00fcz\u00fcnden reddedilmez.\n\nKredi personelimiz taraf\u0131ndan tan\u0131mlan\u0131r, sat\u0131n al\u0131nmaz; API'den de panelden de\nbakiye eklemenin bir yolu yoktur.\n\n**E\u015fzamans\u0131z.** \u00d6deme, kurulum demek de\u011fildir. Kuyru\u011fa al\u0131nan bir dinleyici sipari\u015fe\ntepki verir ve bulutu arayarak her aboneli\u011fi `new` \u2192 `pending` \u2192 `deployed` ya\nda `failed` durumuna ta\u015f\u0131r. Yan\u0131t `202`'dir ve ilk aboneli\u011fi g\u00f6steren bir `Location`\nba\u015fl\u0131\u011f\u0131 ta\u015f\u0131r; oradan `GET /subscriptions/{id}` ile yoklay\u0131n. `pending` durumundan\nhi\u00e7 \u00e7\u0131kmayan bir abonelik, hen\u00fcz kaydedilmemi\u015f ba\u015far\u0131s\u0131z bir kurulumdur \u2014 aboneli\u011fin\n`failure_reason` alan\u0131na bak\u0131n.\n\n**\u0130dempotent.** `Idempotency-Key` zorunludur. Anahtar, sipari\u015f \u00e7al\u0131\u015fmadan \u00f6nce\nsahiplenilir; b\u00f6ylece zaman a\u015f\u0131m\u0131na u\u011fray\u0131p ilk istek h\u00e2l\u00e2 s\u00fcrerken yeniden deneyen\nbir istemci ikinci bir \u00e7ekim yerine `409` al\u0131r. \u0130lk istek tamamland\u0131ktan sonra ayn\u0131\nanahtar ayn\u0131 g\u00f6vdeyle \u00f6zg\u00fcn `202` yan\u0131t\u0131n\u0131 yineler ve hi\u00e7bir \u015fey olu\u015fturmaz.\n\n**\u00d6n ko\u015fullar**, panelin \u00f6deme ad\u0131m\u0131n\u0131n uygulad\u0131\u011f\u0131 bi\u00e7imde burada da bire bir\ndenetlenir ve kar\u015f\u0131lanmayan ko\u015fulu ad\u0131yla belirten bir `422` ile reddedilir: kay\u0131tl\u0131\nfatura bilgisi, kabul edilmi\u015f son kullan\u0131c\u0131 lisans s\u00f6zle\u015fmesi, kay\u0131tl\u0131 kimlik ya da\npasaport numaras\u0131, a\u00e7\u0131k bir ma\u011faza ve \u00e7a\u011f\u0131ran\u0131n a\u015f\u0131lmam\u0131\u015f `max_vms` / `max_vols`\nkotalar\u0131. Bu u\u00e7 nokta, panelin uygulad\u0131\u011f\u0131 hi\u00e7bir s\u0131n\u0131r\u0131 a\u015fman\u0131n yolu de\u011fildir.\n\n`order:write` izni gerekir; bu izin bir anahtar olu\u015fturulurken varsay\u0131lan olarak\nkapal\u0131d\u0131r ve ba\u015fka hi\u00e7bir izin onu \u00f6rt\u00fck olarak vermez.\n" }, "ar": { "summary": "\u0625\u0646\u0634\u0627\u0621 \u0637\u0644\u0628 \u064a\u064f\u062e\u0635\u0645 \u0645\u0646\u0647 \u0631\u0635\u064a\u062f \u0627\u0644\u062d\u0633\u0627\u0628", "description": "\u064a\u0634\u062a\u0631\u064a \u0623\u062c\u0647\u0632\u0629 \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0648\u0623\u0642\u0631\u0627\u0635\u064b\u0627\u060c \u0648\u064a\u0637\u0628\u0651\u0642 \u0645\u0627 \u064a\u062d\u0645\u0644\u0647 \u0627\u0644\u062d\u0633\u0627\u0628 \u0645\u0646 \u0631\u0635\u064a\u062f \u0645\u0645\u0646\u0648\u062d \u0628\u0648\u0635\u0641\u0647 \u062e\u0635\u0645\u064b\u0627\u060c\n\u0648\u064a\u062a\u0631\u0643 \u0627\u0644\u0628\u0627\u0642\u064a \u0644\u0644\u0628\u0637\u0627\u0642\u0629. \u0648\u0647\u0630\u0647 \u0647\u064a \u0646\u0642\u0637\u0629 \u0627\u0644\u0646\u0647\u0627\u064a\u0629 \u0627\u0644\u0648\u062d\u064a\u062f\u0629 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0627\u0644\u062a\u064a\n\u062a\u064f\u0646\u0641\u0642 \u0645\u0627\u0644\u064b\u0627.\n\n\u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0633\u0627\u0631 \u0644\u0644\u0628\u0637\u0627\u0642\u0629 \u0647\u0646\u0627\u060c \u0648\u0647\u0630\u0627 \u0623\u0645\u0631 \u0628\u0646\u064a\u0648\u064a \u0644\u0627 \u0625\u0639\u062f\u0627\u062f \u064a\u0645\u0643\u0646 \u062a\u063a\u064a\u064a\u0631\u0647: \u0641\u0623\u0648\u0644 \u0639\u0645\u0644\u064a\u0629 \u0633\u062d\u0628 \u0639\u0644\u0649\n\u0628\u0637\u0627\u0642\u0629 \u0645\u062d\u0641\u0648\u0638\u0629 \u062a\u062a\u0637\u0644\u0628 \u062f\u0627\u0626\u0645\u064b\u0627 \u062a\u062d\u062f\u064a 3-D Secure \u062a\u0641\u0627\u0639\u0644\u064a\u064b\u0627 \u062f\u0627\u062e\u0644 \u0627\u0644\u0645\u062a\u0635\u0641\u062d (\u0627\u0644\u0642\u064a\u0645\u0629\n\u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0644\u0640 `global_settings.shop_threeds_only` \u0647\u064a true \u0648\u0644\u0640\n`credit_cards.threeds_authorized` \u0647\u064a false)\u060c \u0648\u0647\u0648 \u0645\u0627 \u0644\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0623\u064a \u0639\u0645\u064a\u0644 \u0628\u0644\u0627\n\u0648\u0627\u062c\u0647\u0629 \u0625\u062a\u0645\u0627\u0645\u0647. \u0648\u0644\u0630\u0644\u0643 \u064a\u064f\u0646\u0634\u0623 \u0627\u0644\u0637\u0644\u0628 \u0648\u062a\u064f\u0646\u0634\u0623 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a\u060c \u0648\u062a\u064f\u062a\u0631\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0643\u0627\u0645\u0644\u0629\u064b \u0639\u0644\u0649\n\u0627\u0644\u062f\u0641\u0639\u0629 \u0644\u064a\u064f\u0633\u0648\u0651\u064a\u0647\u0627 \u0634\u062e\u0635\u064c: \u064a\u0642\u0648\u0644 `needs_card` \u0625\u0646 \u0643\u0627\u0646 \u0627\u0644\u0623\u0645\u0631 \u0643\u0630\u0644\u0643\u060c \u0648\u064a\u0642\u0648\u0644 `credit_applied`\n\u0645\u0627 \u0633\u064a\u062e\u0635\u0645\u0647 \u0631\u0635\u064a\u062f \u0627\u0644\u062d\u0633\u0627\u0628 \u0645\u0646\u0647\u0627\u060c \u0648\u064a\u0642\u0648\u0644 `payable` \u0645\u0627 \u064a\u064f\u0637\u0644\u0628 \u0645\u0646 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0628\u0639\u062f \u0630\u0644\u0643\u060c\n\u0648`payment_url` \u0647\u0648 \u0627\u0644\u0645\u0643\u0627\u0646 \u0627\u0644\u0630\u064a \u064a\u064f\u062a\u0645\u0651 \u0641\u064a\u0647 \u0645\u062a\u0635\u0641\u062d\u064c \u0627\u0644\u0639\u0645\u0644\u064a\u0629. \u0648\u0644\u0627 \u062a\u064f\u062d\u0645\u064e\u0651\u0644 \u0623\u064a \u0628\u0637\u0627\u0642\u0629 \u0641\u064a \u0635\u0645\u062a.\n\n**\u0648\u0625\u0646\u0634\u0627\u0621 \u0627\u0644\u0637\u0644\u0628 \u0644\u0627 \u064a\u062d\u0631\u0651\u0643 \u0645\u0627\u0644\u064b\u0627.** \u0644\u0627 \u064a\u064f\u0624\u062e\u0630 \u0647\u0646\u0627 \u0634\u064a\u0621 \u0645\u0646 \u0627\u0644\u0631\u0635\u064a\u062f \u2014 \u0625\u0630 \u064a\u064f\u0637\u0628\u064e\u0651\u0642 \u0627\u0644\u0631\u0635\u064a\u062f \u0639\u0646\u062f\n\u062a\u0633\u0648\u064a\u0629 \u0627\u0644\u062f\u0641\u0639\u0629\u060c \u0634\u0623\u0646\u0647 \u0634\u0623\u0646 \u0623\u064a \u0641\u0627\u062a\u0648\u0631\u0629 \u0623\u062e\u0631\u0649\u060c \u0641\u0644\u0627 \u064a\u062d\u062a\u062c\u0632 \u0627\u0644\u0637\u0644\u0628\u064f \u0627\u0644\u0630\u064a \u0644\u0627 \u064a\u062f\u0641\u0639\u0647 \u0623\u062d\u062f \u0634\u064a\u0626\u064b\u0627 \u0645\u0646\n\u0631\u0635\u064a\u062f \u0627\u0644\u0639\u0645\u064a\u0644. \u0648\u0644\u0630\u0644\u0643 \u0641\u0625\u0646 `credit_applied` \u0648`payable` \u062a\u0642\u062f\u064a\u0631\u064c \u0644\u0645\u0627 \u0633\u064a\u062d\u062f\u062b \u0639\u0646\u062f \u0627\u0644\u062f\u0641\u0639\u060c \u0628\u064a\u0646\u0645\u0627\n\u064a\u062d\u0645\u0644 \u0643\u0627\u0626\u0646 `payment` \u0627\u0644\u0645\u062a\u062f\u0627\u062e\u0644 \u062d\u0627\u0644\u064e \u0627\u0644\u0633\u062c\u0644 \u0627\u0644\u0622\u0646: \u062d\u0642\u0644 `amount` \u0641\u064a\u0647 \u0647\u0648 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0643\u0627\u0645\u0644\u060c\n\u0648\u062d\u0642\u0644 `applied_balance` \u0647\u0648 `0.00` \u062d\u062a\u0649 \u062a\u064f\u062f\u0641\u0639.\n\n\u0648\u0627\u0644\u0631\u0635\u064a\u062f \u0627\u0644\u0645\u0645\u0646\u0648\u062d \u062e\u0635\u0645 \u064a\u064f\u0637\u0631\u062d \u0645\u0646 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a \u0648\u0645\u062d\u062f\u0648\u062f \u0628\u062d\u0635\u0629 \u0645\u0646\u0647\u060c \u0641\u064a\u0628\u0642\u0649 \u0639\u0627\u062f\u0629\u064b \u0641\u064a \u0627\u0644\u0637\u0644\u0628\n\u0627\u0644\u0630\u064a \u0644\u0647 \u0633\u0639\u0631 \u0645\u0628\u0644\u063a \u0645\u0633\u062a\u062d\u0642 \u0645\u0647\u0645\u0627 \u0643\u064e\u0628\u064f\u0631 \u0627\u0644\u0631\u0635\u064a\u062f. \u0648\u0644\u0645 \u064a\u0639\u062f \u0627\u0644\u0637\u0644\u0628 \u064a\u064f\u0631\u0641\u0636 \u0644\u0639\u062f\u0645 \u0643\u0641\u0627\u064a\u0629 \u0627\u0644\u0631\u0635\u064a\u062f.\n\n\u064a\u0645\u0646\u062d \u0641\u0631\u064a\u0642\u0646\u0627 \u0627\u0644\u0631\u0635\u064a\u062f \u0648\u0644\u0627 \u064a\u064f\u0634\u062a\u0631\u0649\u061b \u0648\u0644\u0627 \u062a\u0648\u062c\u062f \u0648\u0633\u064a\u0644\u0629 \u0644\u0625\u0636\u0627\u0641\u062a\u0647 \u0645\u0646 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0648\u0644\u0627\n\u0645\u0646 \u0627\u0644\u0644\u0648\u062d\u0629.\n\n**\u063a\u064a\u0631 \u0645\u062a\u0632\u0627\u0645\u0646\u0629.** \u0627\u0644\u062f\u0641\u0639 \u0644\u0627 \u064a\u0639\u0646\u064a \u0627\u0644\u062a\u062c\u0647\u064a\u0632. \u0625\u0630 \u064a\u062a\u0641\u0627\u0639\u0644 \u0645\u0633\u062a\u0645\u0639 \u0641\u064a \u0627\u0644\u0637\u0627\u0628\u0648\u0631 \u0645\u0639 \u0627\u0644\u0637\u0644\u0628\n\u0648\u064a\u062a\u0635\u0644 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629\u060c \u0641\u064a\u0646\u0642\u0644 \u0643\u0644 \u0627\u0634\u062a\u0631\u0627\u0643 \u0639\u0628\u0631 `new` \u2192 `pending` \u2192 `deployed` \u0623\u0648\n`failed`. \u0648\u0627\u0644\u0627\u0633\u062a\u062c\u0627\u0628\u0629 \u0647\u064a `202` \u0648\u062a\u062d\u0645\u0644 \u062a\u0631\u0648\u064a\u0633\u0629 `Location` \u062a\u0634\u064a\u0631 \u0625\u0644\u0649 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0623\u0648\u0644\u061b\n\u0648\u0645\u0646 \u0647\u0646\u0627\u0643 \u0627\u0633\u062a\u0637\u0644\u0639 `GET /subscriptions/{id}`. \u0648\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u0644\u0627 \u064a\u063a\u0627\u062f\u0631 `pending`\n\u0623\u0628\u062f\u064b\u0627 \u0647\u0648 \u062a\u062c\u0647\u064a\u0632 \u0641\u0627\u0634\u0644 \u0644\u0645 \u064a\u064f\u0633\u062c\u064e\u0651\u0644 \u0628\u0639\u062f \u2014 \u0641\u0631\u0627\u062c\u0639 `failure_reason` \u0639\u0644\u0649 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643.\n\n**\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent).** \u062a\u0631\u0648\u064a\u0633\u0629 `Idempotency-Key` \u0645\u0637\u0644\u0648\u0628\u0629. \u0648\u064a\u064f\u062d\u062c\u0632 \u0627\u0644\u0645\u0641\u062a\u0627\u062d \u0642\u0628\u0644\n\u062a\u0646\u0641\u064a\u0630 \u0627\u0644\u0637\u0644\u0628\u060c \u0641\u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u062a\u0646\u062a\u0647\u064a \u0645\u0647\u0644\u062a\u0647 \u0648\u064a\u0639\u064a\u062f \u0627\u0644\u0645\u062d\u0627\u0648\u0644\u0629 \u0628\u064a\u0646\u0645\u0627 \u0627\u0644\u0637\u0644\u0628 \u0627\u0644\u0623\u0648\u0644 \u0645\u0627 \u064a\u0632\u0627\u0644\n\u062c\u0627\u0631\u064a\u064b\u0627 \u064a\u062a\u0644\u0642\u0649 `409` \u0644\u0627 \u0639\u0645\u0644\u064a\u0629 \u0633\u062d\u0628 \u062b\u0627\u0646\u064a\u0629\u061b \u0648\u0628\u0639\u062f \u0627\u0646\u062a\u0647\u0627\u0621 \u0627\u0644\u0637\u0644\u0628 \u0627\u0644\u0623\u0648\u0644\u060c \u064a\u0639\u064a\u062f \u0627\u0644\u0645\u0641\u062a\u0627\u062d\n\u0646\u0641\u0633\u0647 \u0645\u0639 \u0627\u0644\u062c\u0633\u0645 \u0646\u0641\u0633\u0647 \u0625\u0631\u0633\u0627\u0644 \u0627\u0633\u062a\u062c\u0627\u0628\u0629 `202` \u0627\u0644\u0623\u0635\u0644\u064a\u0629 \u062f\u0648\u0646 \u0625\u0646\u0634\u0627\u0621 \u0623\u064a \u0634\u064a\u0621.\n\n**\u0627\u0644\u0634\u0631\u0648\u0637 \u0627\u0644\u0645\u0633\u0628\u0642\u0629**\u060c \u0648\u064a\u064f\u062a\u062d\u0642\u0642 \u0645\u0646 \u0643\u0644\u064d\u0651 \u0645\u0646\u0647\u0627 \u0647\u0646\u0627 \u062a\u0645\u0627\u0645\u064b\u0627 \u0643\u0645\u0627 \u062a\u0641\u0631\u0636\u0647\u0627 \u0635\u0641\u062d\u0629 \u0627\u0644\u062f\u0641\u0639 \u0641\u064a\n\u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0648\u064a\u064f\u0631\u0641\u0636 \u0627\u0644\u0637\u0644\u0628 \u0628\u0640 `422` \u064a\u0633\u0645\u0651\u064a \u0627\u0644\u0634\u0631\u0637 \u063a\u064a\u0631 \u0627\u0644\u0645\u0633\u062a\u0648\u0641\u0649: \u0648\u062c\u0648\u062f \u0645\u0639\u0644\u0648\u0645\u0627\u062a \u0627\u0644\u0641\u0648\u062a\u0631\u0629\u060c\n\u0648\u0642\u0628\u0648\u0644 \u0627\u062a\u0641\u0627\u0642\u064a\u0629 \u062a\u0631\u062e\u064a\u0635 \u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645 \u0627\u0644\u0646\u0647\u0627\u0626\u064a\u060c \u0648\u062a\u0633\u062c\u064a\u0644 \u0631\u0642\u0645 \u0647\u0648\u064a\u0629 \u0623\u0648 \u062c\u0648\u0627\u0632 \u0633\u0641\u0631\u060c \u0648\u0643\u0648\u0646 \u0627\u0644\u0645\u062a\u062c\u0631\n\u0645\u0641\u062a\u0648\u062d\u064b\u0627\u060c \u0648\u0639\u062f\u0645 \u062a\u062c\u0627\u0648\u0632 \u062d\u0635\u062a\u064e\u064a `max_vms` / `max_vols` \u0627\u0644\u062e\u0627\u0635\u062a\u064a\u0646 \u0628\u0627\u0644\u0637\u0627\u0644\u0628. \u0648\u0644\u064a\u0633\u062a \u0646\u0642\u0637\u0629\n\u0627\u0644\u0646\u0647\u0627\u064a\u0629 \u0647\u0630\u0647 \u0648\u0633\u064a\u0644\u0629 \u0644\u062a\u062c\u0627\u0648\u0632 \u0623\u064a \u062d\u062f \u062a\u0641\u0631\u0636\u0647 \u0627\u0644\u0644\u0648\u062d\u0629.\n\n\u062a\u062a\u0637\u0644\u0628 \u0635\u0644\u0627\u062d\u064a\u0629 `order:write`\u060c \u0648\u0647\u064a \u0645\u064f\u0639\u0637\u064e\u0651\u0644\u0629 \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627 \u0639\u0646\u062f \u0625\u0635\u062f\u0627\u0631 \u0627\u0644\u0631\u0645\u0632 \u0627\u0644\u0645\u0645\u064a\u0632 \u0648\u0644\u0627\n\u062a\u062a\u0636\u0645\u0646\u0647\u0627 \u0623\u064a \u0635\u0644\u0627\u062d\u064a\u0629 \u0623\u062e\u0631\u0649 \u0636\u0645\u0646\u064b\u0627.\n" } }, "tags": [ "Billing" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "minItems": 1, "maxItems": 20, "description": "One entry per unit ordered. Repeat an entry to buy two of the same\nthing.\n", "x-i18n": { "tr": { "description": "Sipari\u015f edilen her birim i\u00e7in bir kay\u0131t. Ayn\u0131 \u015feyden iki adet\nalmak i\u00e7in kayd\u0131 yineleyin.\n" }, "ar": { "description": "\u0645\u064f\u062f\u062e\u0644 \u0648\u0627\u062d\u062f \u0644\u0643\u0644 \u0648\u062d\u062f\u0629 \u0645\u0637\u0644\u0648\u0628\u0629. \u0643\u0631\u0651\u0631 \u0627\u0644\u0645\u064f\u062f\u062e\u0644 \u0644\u0634\u0631\u0627\u0621 \u0646\u0633\u062e\u062a\u064a\u0646 \u0645\u0646 \u0627\u0644\u0634\u064a\u0621\n\u0646\u0641\u0633\u0647.\n" } }, "items": { "type": "object", "required": [ "type", "product_id", "payment_plan_id" ], "properties": { "type": { "type": "string", "enum": [ "virtual_machine", "volume" ], "description": "Domain names are deliberately not orderable: domain reselling\nis off by default and pricing is quoted live by the registrar.\n", "x-i18n": { "tr": { "description": "Alan adlar\u0131 bilerek sipari\u015f edilemez: alan ad\u0131 sat\u0131\u015f\u0131\nvarsay\u0131lan olarak kapal\u0131d\u0131r ve fiyat\u0131 kay\u0131t kurulu\u015fu anl\u0131k\nolarak bildirir.\n" }, "ar": { "description": "\u0623\u0633\u0645\u0627\u0621 \u0627\u0644\u0646\u0637\u0627\u0642\u0627\u062a \u063a\u064a\u0631 \u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u0637\u0644\u0628 \u0639\u0646 \u0642\u0635\u062f: \u0641\u0625\u0639\u0627\u062f\u0629 \u0628\u064a\u0639 \u0627\u0644\u0646\u0637\u0627\u0642\u0627\u062a\n\u0645\u064f\u0639\u0637\u064e\u0651\u0644\u0629 \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u064b\u0627\u060c \u0648\u0627\u0644\u0633\u0639\u0631 \u064a\u0642\u062a\u0628\u0633\u0647 \u0627\u0644\u0633\u062c\u0644 \u0644\u062d\u0638\u064a\u064b\u0627.\n" } } }, "product_id": { "type": "integer", "description": "A **published** product id, from\n`GET /virtual-machine-products` or `GET /volume-products`. An\nunpublished product is refused with `422`, the same way it is\nabsent from those listings.\n", "x-i18n": { "tr": { "description": "`GET /virtual-machine-products` ya da\n`GET /volume-products` u\u00e7 noktalar\u0131ndan al\u0131nan, **yay\u0131mlanm\u0131\u015f**\nbir \u00fcr\u00fcn kimli\u011fi. Yay\u0131mlanmam\u0131\u015f bir \u00fcr\u00fcn, o listelerde\ng\u00f6r\u00fcnmedi\u011fi gibi, `422` ile reddedilir.\n" }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0645\u0646\u062a\u062c **\u0645\u0646\u0634\u0648\u0631**\u060c \u064a\u064f\u0624\u062e\u0630 \u0645\u0646\n`GET /virtual-machine-products` \u0623\u0648 `GET /volume-products`.\n\u0648\u064a\u064f\u0631\u0641\u0636 \u0627\u0644\u0645\u0646\u062a\u062c \u063a\u064a\u0631 \u0627\u0644\u0645\u0646\u0634\u0648\u0631 \u0628\u0640 `422`\u060c \u062a\u0645\u0627\u0645\u064b\u0627 \u0643\u0645\u0627 \u064a\u063a\u064a\u0628 \u0639\u0646 \u062a\u0644\u0643\n\u0627\u0644\u0642\u0648\u0627\u0626\u0645.\n" } } }, "payment_plan_id": { "type": "integer", "description": "One of the `payment_plans` published on that product. A plan\nbelonging to another product is refused with `422`.\n", "x-i18n": { "tr": { "description": "O \u00fcr\u00fcn \u00fczerinde yay\u0131mlanm\u0131\u015f `payment_plans` kay\u0131tlar\u0131ndan\nbiri. Ba\u015fka bir \u00fcr\u00fcne ait bir plan `422` ile reddedilir.\n" }, "ar": { "description": "\u0625\u062d\u062f\u0649 `payment_plans` \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u0629 \u0639\u0644\u0649 \u0630\u0644\u0643 \u0627\u0644\u0645\u0646\u062a\u062c. \u0648\u062a\u064f\u0631\u0641\u0636 \u0623\u064a \u062e\u0637\u0629\n\u062a\u0639\u0648\u062f \u0644\u0645\u0646\u062a\u062c \u0622\u062e\u0631 \u0628\u0640 `422`.\n" } } } } } } } } } } }, "responses": { "202": { "description": "The order was paid and provisioning has been queued. `Location` points at the\nfirst subscription.\n", "x-i18n": { "tr": { "description": "Sipari\u015f \u00f6dendi ve kurulum kuyru\u011fa al\u0131nd\u0131. `Location` ilk aboneli\u011fi\ng\u00f6sterir.\n" }, "ar": { "description": "\u062f\u064f\u0641\u0639 \u0627\u0644\u0637\u0644\u0628 \u0648\u0623\u064f\u062f\u0631\u062c \u0627\u0644\u062a\u062c\u0647\u064a\u0632 \u0641\u064a \u0627\u0644\u0637\u0627\u0628\u0648\u0631. \u0648\u062a\u0634\u064a\u0631 `Location` \u0625\u0644\u0649 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\n\u0627\u0644\u0623\u0648\u0644.\n" } }, "headers": { "Location": { "description": "The first subscription created by this order.", "x-i18n": { "tr": { "description": "Bu sipari\u015fin olu\u015fturdu\u011fu ilk abonelik." }, "ar": { "description": "\u0623\u0648\u0644 \u0627\u0634\u062a\u0631\u0627\u0643 \u0623\u0646\u0634\u0623\u0647 \u0647\u0630\u0627 \u0627\u0644\u0637\u0644\u0628." } }, "schema": { "type": "string" } }, "Idempotent-Replay": { "description": "Present and `true` when this is a replay of an earlier response.", "x-i18n": { "tr": { "description": "Bu yan\u0131t daha \u00f6nceki bir yan\u0131t\u0131n yinelenmesiyse bulunur ve `true` olur." }, "ar": { "description": "\u062a\u0648\u062c\u062f \u0628\u0642\u064a\u0645\u0629 `true` \u0639\u0646\u062f\u0645\u0627 \u062a\u0643\u0648\u0646 \u0647\u0630\u0647 \u0627\u0644\u0627\u0633\u062a\u062c\u0627\u0628\u0629 \u062a\u0643\u0631\u0627\u0631\u064b\u0627 \u0644\u0627\u0633\u062a\u062c\u0627\u0628\u0629 \u0633\u0627\u0628\u0642\u0629." } }, "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Order" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "description": "The `Idempotency-Key` is in use by a request that is still running, or was\nalready used with a different body.\n", "x-i18n": { "tr": { "description": "`Idempotency-Key`, h\u00e2l\u00e2 s\u00fcren bir istek taraf\u0131ndan kullan\u0131l\u0131yor ya da\ndaha \u00f6nce farkl\u0131 bir g\u00f6vdeyle kullan\u0131lm\u0131\u015f.\n" }, "ar": { "description": "\u0645\u0641\u062a\u0627\u062d `Idempotency-Key` \u0645\u0633\u062a\u062e\u062f\u064e\u0645 \u0645\u0646 \u0637\u0644\u0628 \u0645\u0627 \u064a\u0632\u0627\u0644 \u062c\u0627\u0631\u064a\u064b\u0627\u060c \u0623\u0648 \u0633\u0628\u0642 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647 \u0645\u0639\n\u062c\u0633\u0645 \u0645\u062e\u062a\u0644\u0641.\n" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "The order was refused and nothing was created or charged. `errors` names the\nreason: `items.*` for an unavailable product or a mismatched payment plan, and\n`billing_info`, `eula`, `identity_number`, `shop`, `max_vms` or `max_vols` for\nan unmet precondition. A `balance` shortfall is NOT among them any more \u2014 a\nbalance too small no longer refuses an order, it simply discounts it by less\nand leaves more on `payable`.\n", "x-i18n": { "tr": { "description": "Sipari\u015f reddedildi; hi\u00e7bir \u015fey olu\u015fturulmad\u0131 ve hi\u00e7bir tutar tahsil\nedilmedi. Nedenini `errors` alan\u0131 ad\u0131yla belirtir: sat\u0131n al\u0131namayan bir\n\u00fcr\u00fcn ya da e\u015fle\u015fmeyen bir \u00f6deme plan\u0131 i\u00e7in `items.*`, kar\u015f\u0131lanmayan bir \u00f6n\nko\u015ful i\u00e7in `billing_info`, `eula`, `identity_number`, `shop`, `max_vms` ya\nda `max_vols`. Bakiye a\u00e7\u0131\u011f\u0131 (`balance`) art\u0131k bunlar\u0131n aras\u0131nda DE\u011e\u0130LD\u0130R \u2014\nyetersiz bakiye sipari\u015fi reddetmez, yaln\u0131zca daha az iskonto uygular ve\n`payable` alan\u0131nda daha \u00e7ok tutar b\u0131rak\u0131r.\n" }, "ar": { "description": "\u0631\u064f\u0641\u0636 \u0627\u0644\u0637\u0644\u0628 \u0648\u0644\u0645 \u064a\u064f\u0646\u0634\u0623 \u0634\u064a\u0621 \u0648\u0644\u0645 \u064a\u064f\u062d\u0635\u064e\u0651\u0644 \u0623\u064a \u0645\u0628\u0644\u063a. \u0648\u064a\u0633\u0645\u0651\u064a \u0627\u0644\u062d\u0642\u0644 `errors` \u0627\u0644\u0633\u0628\u0628:\n`items.*` \u0644\u0645\u0646\u062a\u062c \u063a\u064a\u0631 \u0645\u062a\u0627\u062d \u0623\u0648 \u062e\u0637\u0629 \u062f\u0641\u0639 \u063a\u064a\u0631 \u0645\u0637\u0627\u0628\u0642\u0629\u060c \u0648`billing_info` \u0623\u0648 `eula`\n\u0623\u0648 `identity_number` \u0623\u0648 `shop` \u0623\u0648 `max_vms` \u0623\u0648 `max_vols` \u0644\u0634\u0631\u0637 \u0645\u0633\u0628\u0642 \u063a\u064a\u0631\n\u0645\u0633\u062a\u0648\u0641\u0649. \u0648\u0644\u0645 \u064a\u0639\u062f \u0646\u0642\u0635 \u0627\u0644\u0631\u0635\u064a\u062f (`balance`) \u0645\u0646 \u0628\u064a\u0646\u0647\u0627 \u2014 \u0641\u0627\u0644\u0631\u0635\u064a\u062f \u063a\u064a\u0631 \u0627\u0644\u0643\u0627\u0641\u064a \u0644\u0627\n\u064a\u0631\u0641\u0636 \u0627\u0644\u0637\u0644\u0628\u060c \u0628\u0644 \u064a\u062e\u0635\u0645 \u0645\u0646\u0647 \u0623\u0642\u0644 \u0648\u064a\u062a\u0631\u0643 \u0645\u0628\u0644\u063a\u064b\u0627 \u0623\u0643\u0628\u0631 \u0641\u064a `payable`.\n" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/tickets": { "get": { "operationId": "listTickets", "summary": "List your support tickets", "description": "Every support ticket on the caller's account, the ones a colleague opened included \u2014\nthe list the panel's Support page shows. The list carries each thread's facts; read one\nticket for its messages.\n", "x-i18n": { "tr": { "summary": "Destek taleplerinizi listeleyin", "description": "\u00c7a\u011f\u0131ran\u0131n hesab\u0131ndaki her destek talebi, bir \u00e7al\u0131\u015fma arkada\u015f\u0131n\u0131n a\u00e7t\u0131klar\u0131 da dahil \u2014\npanelin Destek sayfas\u0131n\u0131n g\u00f6sterdi\u011fi liste. Liste her talebin temel bilgilerini ta\u015f\u0131r;\nmesajlar i\u00e7in tek bir talebi okuyun.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u062a\u0630\u0627\u0643\u0631 \u0627\u0644\u062f\u0639\u0645 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643", "description": "\u0643\u0644 \u062a\u0630\u0627\u0643\u0631 \u0627\u0644\u062f\u0639\u0645 \u0641\u064a \u062d\u0633\u0627\u0628 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a\u060c \u0628\u0645\u0627 \u0641\u064a\u0647\u0627 \u0645\u0627 \u0641\u062a\u062d\u0647 \u0632\u0645\u0644\u0627\u0624\u0647 \u2014 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u062a\u064a \u062a\u0639\u0631\u0636\u0647\u0627 \u0635\u0641\u062d\u0629\n\u0627\u0644\u062f\u0639\u0645 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629. \u062a\u062d\u0645\u0644 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u062d\u0642\u0627\u0626\u0642 \u0627\u0644\u0623\u0633\u0627\u0633\u064a\u0629 \u0644\u0643\u0644 \u062a\u0630\u0643\u0631\u0629\u061b \u0627\u0642\u0631\u0623 \u062a\u0630\u0643\u0631\u0629 \u0648\u0627\u062d\u062f\u0629 \u0644\u0631\u0624\u064a\u0629\n\u0631\u0633\u0627\u0626\u0644\u0647\u0627.\n" } }, "tags": [ "Tickets" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of tickets.", "x-i18n": { "tr": { "description": "Destek taleplerinden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u062a\u0630\u0627\u0643\u0631." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Ticket" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } }, "post": { "operationId": "createTicket", "summary": "Open a support ticket", "description": "Opens a ticket in the token owner's name and sends it to our support staff at once;\nthey are notified and read it. There is no undo. Files cannot be attached here \u2014 add\nthem from the ticket's page in the panel.\n", "x-i18n": { "tr": { "summary": "Bir destek talebi a\u00e7\u0131n", "description": "Anahtar\u0131n sahibi ad\u0131na bir talep a\u00e7ar ve hemen destek ekibimize g\u00f6nderir; ekibe\nbildirim gider ve ekip talebi okur. Geri al\u0131namaz. Buradan dosya eklenemez \u2014\ndosyalar\u0131 paneldeki talep sayfas\u0131ndan ekleyin.\n" }, "ar": { "summary": "\u0641\u062a\u062d \u062a\u0630\u0643\u0631\u0629 \u062f\u0639\u0645", "description": "\u064a\u0641\u062a\u062d \u062a\u0630\u0643\u0631\u0629 \u0628\u0627\u0633\u0645 \u0645\u0627\u0644\u0643 \u0627\u0644\u0631\u0645\u0632 \u0648\u064a\u0631\u0633\u0644\u0647\u0627 \u0625\u0644\u0649 \u0641\u0631\u064a\u0642 \u0627\u0644\u062f\u0639\u0645 \u0641\u0648\u0631\u064b\u0627\u061b \u0641\u064a\u064f\u0628\u0644\u064e\u0651\u063a \u0627\u0644\u0641\u0631\u064a\u0642 \u0648\u064a\u0642\u0631\u0624\u0647\u0627. \u0648\u0644\u0627\n\u064a\u0645\u0643\u0646 \u0627\u0644\u062a\u0631\u0627\u062c\u0639 \u0639\u0646 \u0630\u0644\u0643. \u0648\u0644\u0627 \u064a\u0645\u0643\u0646 \u0625\u0631\u0641\u0627\u0642 \u0645\u0644\u0641\u0627\u062a \u0647\u0646\u0627 \u2014 \u0623\u0636\u0641\u0647\u0627 \u0645\u0646 \u0635\u0641\u062d\u0629 \u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629.\n" } }, "tags": [ "Tickets" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "title", "body" ], "properties": { "title": { "type": "string", "minLength": 3, "maxLength": 255, "description": "A short subject line.", "x-i18n": { "tr": { "description": "K\u0131sa bir konu sat\u0131r\u0131." }, "ar": { "description": "\u0633\u0637\u0631 \u0645\u0648\u0636\u0648\u0639 \u0642\u0635\u064a\u0631." } }, "example": "Mail bounces since this morning" }, "body": { "type": "string", "maxLength": 2048, "description": "The message.", "x-i18n": { "tr": { "description": "Mesaj." }, "ar": { "description": "\u0627\u0644\u0631\u0633\u0627\u0644\u0629." } }, "example": "Every mail to our domain has bounced since 08:00." }, "category": { "type": "string", "nullable": true, "enum": [ "general", "cloud", "billing", "dns", "account", "partnership" ], "description": "What the ticket is about. `general` when left out.", "x-i18n": { "tr": { "description": "Talebin konusu. Verilmezse `general`." }, "ar": { "description": "\u0645\u0648\u0636\u0648\u0639 \u0627\u0644\u062a\u0630\u0643\u0631\u0629. `general` \u0625\u0646 \u0644\u0645 \u064a\u064f\u0630\u0643\u0631." } }, "example": "cloud" } } } } } }, "responses": { "201": { "description": "The new ticket.", "x-i18n": { "tr": { "description": "A\u00e7\u0131lan destek talebi." }, "ar": { "description": "\u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0627\u0644\u062c\u062f\u064a\u062f\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Ticket" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/tickets/{ticket}": { "parameters": [ { "name": "ticket", "in": "path", "required": true, "schema": { "type": "integer" } } ], "get": { "operationId": "getTicket", "summary": "Read one of your support tickets", "description": "The ticket with its opening message and every reply, oldest first. Another account's\nticket answers 404, exactly like one that does not exist.\n", "x-i18n": { "tr": { "summary": "Destek taleplerinizden birini okuyun", "description": "Talep; ilk mesaj\u0131 ve en eskiden yeniye her yan\u0131t\u0131yla birlikte. Ba\u015fka bir hesab\u0131n\ntalebi, hi\u00e7 var olmayan bir talep gibi 404 d\u00f6ner.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0625\u062d\u062f\u0649 \u062a\u0630\u0627\u0643\u0631 \u0627\u0644\u062f\u0639\u0645 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643", "description": "\u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0645\u0639 \u0631\u0633\u0627\u0644\u062a\u0647\u0627 \u0627\u0644\u0623\u0648\u0644\u0649 \u0648\u0643\u0644 \u0631\u062f \u0639\u0644\u064a\u0647\u0627\u060c \u0645\u0646 \u0627\u0644\u0623\u0642\u062f\u0645 \u0625\u0644\u0649 \u0627\u0644\u0623\u062d\u062f\u062b. \u0648\u062a\u062c\u064a\u0628 \u062a\u0630\u0643\u0631\u0629 \u062d\u0633\u0627\u0628 \u0622\u062e\u0631\n\u0628\u0640 404\u060c \u062a\u0645\u0627\u0645\u064b\u0627 \u0643\u062a\u0630\u0643\u0631\u0629 \u063a\u064a\u0631 \u0645\u0648\u062c\u0648\u062f\u0629.\n" } }, "tags": [ "Tickets" ], "responses": { "200": { "description": "The ticket.", "x-i18n": { "tr": { "description": "Destek talebi." }, "ar": { "description": "\u0627\u0644\u062a\u0630\u0643\u0631\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Ticket" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/tickets/{ticket}/comments": { "parameters": [ { "name": "ticket", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "createTicketComment", "summary": "Reply to one of your support tickets", "description": "Adds a reply in the token owner's name; our support staff are notified and read it.\nThere is no undo. A ticket that is `solved` or later takes no reply and answers 409 \u2014\nopen a new one instead. Files cannot be attached here.\n", "x-i18n": { "tr": { "summary": "Destek taleplerinizden birine yan\u0131t yaz\u0131n", "description": "Anahtar\u0131n sahibi ad\u0131na bir yan\u0131t ekler; destek ekibimize bildirim gider ve ekip yan\u0131t\u0131\nokur. Geri al\u0131namaz. `solved` veya sonras\u0131ndaki bir talep yan\u0131t almaz ve 409 d\u00f6ner \u2014\nbunun yerine yeni bir talep a\u00e7\u0131n. Buradan dosya eklenemez.\n" }, "ar": { "summary": "\u0627\u0644\u0631\u062f \u0639\u0644\u0649 \u0625\u062d\u062f\u0649 \u062a\u0630\u0627\u0643\u0631 \u0627\u0644\u062f\u0639\u0645 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643", "description": "\u064a\u0636\u064a\u0641 \u0631\u062f\u064b\u0651\u0627 \u0628\u0627\u0633\u0645 \u0645\u0627\u0644\u0643 \u0627\u0644\u0631\u0645\u0632\u061b \u0641\u064a\u064f\u0628\u0644\u064e\u0651\u063a \u0641\u0631\u064a\u0642 \u0627\u0644\u062f\u0639\u0645 \u0648\u064a\u0642\u0631\u0624\u0647. \u0648\u0644\u0627 \u064a\u0645\u0643\u0646 \u0627\u0644\u062a\u0631\u0627\u062c\u0639 \u0639\u0646 \u0630\u0644\u0643. \u0648\u0644\u0627\n\u062a\u0642\u0628\u0644 \u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0627\u0644\u062a\u064a \u0628\u0644\u063a\u062a `solved` \u0623\u0648 \u0645\u0627 \u0628\u0639\u062f\u0647\u0627 \u0623\u064a \u0631\u062f \u0648\u062a\u062c\u064a\u0628 \u0628\u0640 409 \u2014 \u0627\u0641\u062a\u062d \u062a\u0630\u0643\u0631\u0629 \u062c\u062f\u064a\u062f\u0629\n\u0628\u062f\u0644\u064b\u0627 \u0645\u0646 \u0630\u0644\u0643. \u0648\u0644\u0627 \u064a\u0645\u0643\u0646 \u0625\u0631\u0641\u0627\u0642 \u0645\u0644\u0641\u0627\u062a \u0647\u0646\u0627.\n" } }, "tags": [ "Tickets" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "comment" ], "properties": { "comment": { "type": "string", "maxLength": 1024, "description": "The reply.", "x-i18n": { "tr": { "description": "Yan\u0131t." }, "ar": { "description": "\u0627\u0644\u0631\u062f." } }, "example": "It works again, thank you." } } } } } }, "responses": { "201": { "description": "The new reply.", "x-i18n": { "tr": { "description": "Eklenen yan\u0131t." }, "ar": { "description": "\u0627\u0644\u0631\u062f \u0627\u0644\u062c\u062f\u064a\u062f." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/TicketComment" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "description": "The ticket is solved or closed and takes no more replies.", "x-i18n": { "tr": { "description": "Talep \u00e7\u00f6z\u00fclm\u00fc\u015f veya kapat\u0131lm\u0131\u015f; art\u0131k yan\u0131t almaz." }, "ar": { "description": "\u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0645\u062d\u0644\u0648\u0644\u0629 \u0623\u0648 \u0645\u063a\u0644\u0642\u0629 \u0648\u0644\u0627 \u062a\u0642\u0628\u0644 \u0631\u062f\u0648\u062f\u064b\u0627 \u0623\u062e\u0631\u0649." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/tickets/{ticket}/actions/close": { "parameters": [ { "name": "ticket", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "closeTicket", "summary": "Close one of your support tickets", "description": "Closes the ticket; our support staff are notified. Answers 409 for a ticket that is\nalready closed, and for the work-order ticket of a purchased service that can still be\nrefunded \u2014 closing that ticket ends the right to the refund, so it is closed from the\nticket's page in the panel only.\n", "x-i18n": { "tr": { "summary": "Destek taleplerinizden birini kapat\u0131n", "description": "Talebi kapat\u0131r; destek ekibimize bildirim gider. Zaten kapal\u0131 bir talepte ve h\u00e2l\u00e2\niade edilebilen, sat\u0131n al\u0131nm\u0131\u015f bir hizmetin i\u015f emri talebinde 409 d\u00f6ner \u2014 o talebi\nkapatmak iade hakk\u0131n\u0131 sona erdirir, bu y\u00fczden yaln\u0131zca paneldeki talep sayfas\u0131ndan\nkapat\u0131l\u0131r.\n" }, "ar": { "summary": "\u0625\u063a\u0644\u0627\u0642 \u0625\u062d\u062f\u0649 \u062a\u0630\u0627\u0643\u0631 \u0627\u0644\u062f\u0639\u0645 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643", "description": "\u064a\u063a\u0644\u0642 \u0627\u0644\u062a\u0630\u0643\u0631\u0629\u061b \u0648\u064a\u064f\u0628\u0644\u064e\u0651\u063a \u0641\u0631\u064a\u0642 \u0627\u0644\u062f\u0639\u0645. \u0648\u064a\u062c\u064a\u0628 \u0628\u0640 409 \u0644\u0644\u062a\u0630\u0643\u0631\u0629 \u0627\u0644\u0645\u063a\u0644\u0642\u0629 \u0623\u0635\u0644\u064b\u0627\u060c \u0648\u0644\u062a\u0630\u0643\u0631\u0629 \u0623\u0645\u0631 \u0627\u0644\u0639\u0645\u0644\n\u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u062e\u062f\u0645\u0629 \u0645\u0634\u062a\u0631\u0627\u0629 \u0645\u0627 \u0632\u0627\u0644 \u0628\u0627\u0644\u0625\u0645\u0643\u0627\u0646 \u0627\u0633\u062a\u0631\u062f\u0627\u062f \u062b\u0645\u0646\u0647\u0627 \u2014 \u0641\u0625\u063a\u0644\u0627\u0642 \u062a\u0644\u0643 \u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u064a\u064f\u0646\u0647\u064a \u062d\u0642\n\u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627 \u062a\u064f\u063a\u0644\u0642 \u0625\u0644\u0627 \u0645\u0646 \u0635\u0641\u062d\u0629 \u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629.\n" } }, "tags": [ "Tickets" ], "responses": { "200": { "description": "The closed ticket.", "x-i18n": { "tr": { "description": "Kapat\u0131lan destek talebi." }, "ar": { "description": "\u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0627\u0644\u0645\u063a\u0644\u0642\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Ticket" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "description": "The ticket is already closed, or it is the work order of a service that can still be refunded.", "x-i18n": { "tr": { "description": "Talep zaten kapal\u0131 ya da h\u00e2l\u00e2 iade edilebilen bir hizmetin i\u015f emri." }, "ar": { "description": "\u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0645\u063a\u0644\u0642\u0629 \u0623\u0635\u0644\u064b\u0627\u060c \u0623\u0648 \u0647\u064a \u0623\u0645\u0631 \u0639\u0645\u0644 \u0644\u062e\u062f\u0645\u0629 \u0645\u0627 \u0632\u0627\u0644 \u0628\u0627\u0644\u0625\u0645\u0643\u0627\u0646 \u0627\u0633\u062a\u0631\u062f\u0627\u062f \u062b\u0645\u0646\u0647\u0627." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/usage": { "get": { "operationId": "getUsage", "summary": "Read what your cloud consumed", "description": "What the panel's Usage page draws: machine hours, storage, IP address hours and network\ntraffic over a window, with one row per machine and per disk and one per day.\nQuantities only \u2014 the bill is on `/payments`.\n\nThe window is `days` (7, 30 or 90; 30 when missing or anything else) or `from` and `to`\ntogether. It ends yesterday at the latest, because today is not counted yet, and spans at\nmost 365 days. `instance_id` or `volume_id` narrows the figures to one of your machines or\ndisks; one that is not yours answers 404. Only what the cloud meters per machine or per\ndisk survives the narrowing \u2014 a machine keeps its hours and its disks' storage, a disk its\nstorage. IP address hours, network traffic, snapshots and templates are metered per\naddress, network or image, so they are not measured there: `unmetered` names each such\nkey, and its figure is not a measurement, never zero traffic.\n\nThis reads the cloud's own usage records, so it is charged against the tighter\nreconciling-read budget. A window, once read, is kept for an hour. `available: false`\nmeans the records could not be read just now.\n", "x-i18n": { "tr": { "summary": "Bulutunuzun ne t\u00fcketti\u011fini okuyun", "description": "Panelin Kullan\u0131m sayfas\u0131n\u0131n \u00e7izdikleri: bir zaman aral\u0131\u011f\u0131ndaki makine saatleri,\ndepolama, IP adresi saatleri ve a\u011f trafi\u011fi; her makine ve her disk i\u00e7in birer sat\u0131r ve\nher g\u00fcn i\u00e7in bir sat\u0131rla. Yaln\u0131zca miktarlar \u2014 fatura `/payments` alt\u0131ndad\u0131r.\n\nAral\u0131k `days` (7, 30 veya 90; verilmezse ya da ba\u015fka bir de\u011ferse 30) ya da birlikte\nverilen `from` ve `to` ile belirlenir. En ge\u00e7 d\u00fcn biter, \u00e7\u00fcnk\u00fc bug\u00fcn hen\u00fcz say\u0131lmaz, ve\nen \u00e7ok 365 g\u00fcn s\u00fcrer. `instance_id` veya `volume_id` de\u011ferleri makinelerinizden ya da\ndisklerinizden birine daralt\u0131r; size ait olmayan biri 404 d\u00f6ner. Daraltmadan yaln\u0131zca\nbulutun makine ya da disk ba\u015f\u0131na \u00f6l\u00e7t\u00fckleri ge\u00e7er \u2014 bir makine kendi saatlerini ve\ndisklerinin depolamas\u0131n\u0131, bir disk kendi depolamas\u0131n\u0131 korur. IP adresi saatleri, a\u011f\ntrafi\u011fi, anl\u0131k g\u00f6r\u00fcnt\u00fcler ve \u015fablonlar adres, a\u011f ya da g\u00f6r\u00fcnt\u00fc ba\u015f\u0131na \u00f6l\u00e7\u00fcld\u00fc\u011f\u00fc i\u00e7in\norada \u00f6l\u00e7\u00fclmez: `unmetered` bu anahtarlar\u0131n her birini ad\u0131yla sayar ve de\u011ferleri bir\n\u00f6l\u00e7\u00fcm de\u011fildir, hi\u00e7bir zaman s\u0131f\u0131r trafik anlam\u0131na gelmez.\n\nBulutun kendi kullan\u0131m kay\u0131tlar\u0131n\u0131 okudu\u011fu i\u00e7in daha dar olan e\u015fitleyen okuma\nb\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr. Bir kez okunan bir aral\u0131k bir saat saklan\u0131r. `available: false`,\nkay\u0131tlar\u0131n \u015fu an okunamad\u0131\u011f\u0131 anlam\u0131na gelir.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0645\u0627 \u0627\u0633\u062a\u0647\u0644\u0643\u062a\u0647 \u0633\u062d\u0627\u0628\u062a\u0643", "description": "\u0645\u0627 \u062a\u0631\u0633\u0645\u0647 \u0635\u0641\u062d\u0629 \u0627\u0644\u0627\u0633\u062a\u062e\u062f\u0627\u0645 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629: \u0633\u0627\u0639\u0627\u062a \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0648\u0627\u0644\u062a\u062e\u0632\u064a\u0646 \u0648\u0633\u0627\u0639\u0627\u062a \u0639\u0646\u0627\u0648\u064a\u0646 IP \u0648\u062d\u0631\u0643\u0629\n\u0627\u0644\u0634\u0628\u0643\u0629 \u062e\u0644\u0627\u0644 \u0641\u062a\u0631\u0629\u060c \u0645\u0639 \u0633\u0637\u0631 \u0644\u0643\u0644 \u062c\u0647\u0627\u0632 \u0648\u0644\u0643\u0644 \u0642\u0631\u0635 \u0648\u0633\u0637\u0631 \u0644\u0643\u0644 \u064a\u0648\u0645. \u0643\u0645\u064a\u0627\u062a \u0641\u0642\u0637 \u2014 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0641\u064a\n`/payments`.\n\n\u062a\u064f\u062d\u062f\u064e\u0651\u062f \u0627\u0644\u0641\u062a\u0631\u0629 \u0628\u0640 `days` (7 \u0623\u0648 30 \u0623\u0648 90\u061b \u064830 \u0625\u0646 \u063a\u0627\u0628\u062a \u0623\u0648 \u0643\u0627\u0646\u062a \u0623\u064a \u0642\u064a\u0645\u0629 \u0623\u062e\u0631\u0649) \u0623\u0648 \u0628\u0640 `from`\n\u0648`to` \u0645\u0639\u064b\u0627. \u0648\u062a\u0646\u062a\u0647\u064a \u0628\u0627\u0644\u0623\u0645\u0633 \u0639\u0644\u0649 \u0627\u0644\u0623\u0643\u062b\u0631\u060c \u0644\u0623\u0646 \u0627\u0644\u064a\u0648\u0645 \u0644\u0645 \u064a\u064f\u062d\u062a\u0633\u0628 \u0628\u0639\u062f\u060c \u0648\u0644\u0627 \u062a\u062a\u062c\u0627\u0648\u0632 365 \u064a\u0648\u0645\u064b\u0627.\n\u0648\u064a\u062d\u0635\u0631 `instance_id` \u0623\u0648 `volume_id` \u0627\u0644\u0623\u0631\u0642\u0627\u0645 \u0628\u0623\u062d\u062f \u0623\u062c\u0647\u0632\u062a\u0643 \u0623\u0648 \u0623\u0642\u0631\u0627\u0635\u0643\u061b \u0648\u0645\u0627 \u0644\u064a\u0633 \u0644\u0643 \u064a\u062c\u064a\u0628 \u0628\u0640\n404. \u0648\u0644\u0627 \u064a\u0628\u0642\u0649 \u0628\u0639\u062f \u0627\u0644\u062d\u0635\u0631 \u0625\u0644\u0627 \u0645\u0627 \u062a\u0642\u064a\u0633\u0647 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0644\u0643\u0644 \u062c\u0647\u0627\u0632 \u0623\u0648 \u0644\u0643\u0644 \u0642\u0631\u0635 \u2014 \u064a\u062d\u062a\u0641\u0638 \u0627\u0644\u062c\u0647\u0627\u0632 \u0628\u0633\u0627\u0639\u0627\u062a\u0647\n\u0648\u0628\u062a\u062e\u0632\u064a\u0646 \u0623\u0642\u0631\u0627\u0635\u0647\u060c \u0648\u0627\u0644\u0642\u0631\u0635 \u0628\u062a\u062e\u0632\u064a\u0646\u0647. \u0623\u0645\u0627 \u0633\u0627\u0639\u0627\u062a \u0639\u0646\u0627\u0648\u064a\u0646 IP \u0648\u062d\u0631\u0643\u0629 \u0627\u0644\u0634\u0628\u0643\u0629 \u0648\u0627\u0644\u0644\u0642\u0637\u0627\u062a \u0648\u0627\u0644\u0642\u0648\u0627\u0644\u0628 \u0641\u062a\u064f\u0642\u0627\u0633\n\u0644\u0643\u0644 \u0639\u0646\u0648\u0627\u0646 \u0623\u0648 \u0634\u0628\u0643\u0629 \u0623\u0648 \u0635\u0648\u0631\u0629\u060c \u0641\u0644\u0627 \u062a\u064f\u0642\u0627\u0633 \u0647\u0646\u0627\u0643: \u064a\u0630\u0643\u0631 `unmetered` \u0643\u0644 \u0645\u0641\u062a\u0627\u062d \u0645\u0646 \u0647\u0630\u0647 \u0628\u0627\u0633\u0645\u0647\u060c\n\u0648\u0631\u0642\u0645\u0647 \u0644\u064a\u0633 \u0642\u064a\u0627\u0633\u064b\u0627 \u0648\u0644\u0627 \u064a\u0639\u0646\u064a \u0623\u0628\u062f\u064b\u0627 \u062d\u0631\u0643\u0629 \u0635\u0641\u0631\u064a\u0629.\n\n\u064a\u0642\u0631\u0623 \u0647\u0630\u0627 \u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0627\u0633\u062a\u062e\u062f\u0627\u0645 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0646\u0641\u0633\u0647\u0627\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0627\u0644\u0642\u0631\u0627\u0621\u0629\n\u0627\u0644\u0645\u064f\u0632\u0627\u0645\u0650\u0646\u0629 \u0627\u0644\u0623\u0636\u064a\u0642. \u0648\u062a\u064f\u062d\u0641\u0638 \u0627\u0644\u0641\u062a\u0631\u0629 \u0628\u0639\u062f \u0642\u0631\u0627\u0621\u062a\u0647\u0627 \u0644\u0645\u062f\u0629 \u0633\u0627\u0639\u0629. \u0648\u062a\u0639\u0646\u064a `available: false` \u0623\u0646\n\u0627\u0644\u0633\u062c\u0644\u0627\u062a \u062a\u0639\u0630\u0651\u0631\u062a \u0642\u0631\u0627\u0621\u062a\u0647\u0627 \u0627\u0644\u0622\u0646.\n" } }, "tags": [ "Usage" ], "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "7, 30 or 90. Ignored when `from` and `to` are both given.", "x-i18n": { "tr": { "description": "7, 30 veya 90. `from` ile `to` birlikte verilirse yok say\u0131l\u0131r." }, "ar": { "description": "7 \u0623\u0648 30 \u0623\u0648 90. \u064a\u064f\u062a\u062c\u0627\u0647\u0644 \u0639\u0646\u062f \u0625\u0639\u0637\u0627\u0621 `from` \u0648`to` \u0645\u0639\u064b\u0627." } } }, { "name": "from", "in": "query", "required": false, "schema": { "type": "string", "format": "date" }, "description": "The first day, YYYY-MM-DD (GMT).", "x-i18n": { "tr": { "description": "\u0130lk g\u00fcn, YYYY-MM-DD (GMT)." }, "ar": { "description": "\u0627\u0644\u064a\u0648\u0645 \u0627\u0644\u0623\u0648\u0644\u060c \u0628\u0635\u064a\u063a\u0629 YYYY-MM-DD (\u0628\u062a\u0648\u0642\u064a\u062a \u063a\u0631\u064a\u0646\u062a\u0634)." } } }, { "name": "to", "in": "query", "required": false, "schema": { "type": "string", "format": "date" }, "description": "The last day, YYYY-MM-DD (GMT); yesterday at the latest.", "x-i18n": { "tr": { "description": "Son g\u00fcn, YYYY-MM-DD (GMT); en ge\u00e7 d\u00fcn." }, "ar": { "description": "\u0627\u0644\u064a\u0648\u0645 \u0627\u0644\u0623\u062e\u064a\u0631\u060c \u0628\u0635\u064a\u063a\u0629 YYYY-MM-DD (\u0628\u062a\u0648\u0642\u064a\u062a \u063a\u0631\u064a\u0646\u062a\u0634)\u061b \u0627\u0644\u0623\u0645\u0633 \u0639\u0644\u0649 \u0627\u0644\u0623\u0643\u062b\u0631." } } }, { "name": "instance_id", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "One of your machines, by id.", "x-i18n": { "tr": { "description": "Makinelerinizden biri, id ile." }, "ar": { "description": "\u0623\u062d\u062f \u0623\u062c\u0647\u0632\u062a\u0643\u060c \u0628\u0645\u0639\u0631\u0651\u0641\u0647." } } }, { "name": "volume_id", "in": "query", "required": false, "schema": { "type": "integer" }, "description": "One of your disks, by id. Ignored when `instance_id` is given.", "x-i18n": { "tr": { "description": "Disklerinizden biri, id ile. `instance_id` verilirse yok say\u0131l\u0131r." }, "ar": { "description": "\u0623\u062d\u062f \u0623\u0642\u0631\u0627\u0635\u0643\u060c \u0628\u0645\u0639\u0631\u0651\u0641\u0647. \u064a\u064f\u062a\u062c\u0627\u0647\u0644 \u0639\u0646\u062f \u0625\u0639\u0637\u0627\u0621 `instance_id`." } } } ], "responses": { "200": { "description": "The figures for the window.", "x-i18n": { "tr": { "description": "Aral\u0131\u011f\u0131n de\u011ferleri." }, "ar": { "description": "\u0623\u0631\u0642\u0627\u0645 \u0627\u0644\u0641\u062a\u0631\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Usage" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/customers": { "get": { "operationId": "listAdminCustomers", "summary": "List customers", "description": "Every account holding the `user` role, ordered by name.\n\nRequires an `admin:read` token whose owner also holds the `admin` (or\n`super-admin`) role. The ability alone is not enough: a token outlives the role\nits holder had when it was minted, so the role is checked on every request.\n\nThe query selects the published columns explicitly rather than reading whole\n`User` models \u2014 the same deliberate projection the panel's customer table uses,\nafter an unprojected version of it once shipped every customer's national\nidentity number into a page payload.\n\nDatabase-backed, with no `refresh` variant anywhere on this surface. The\nreconciling siblings of these reads (`listSubscriptions()`, `listZones()`,\n`getInstances()`) mutate; at admin scope they mutate the whole install. There is\nno rate limit at which that belongs behind a `GET`.\n\nThis listing writes no audit row: it publishes no more about any one customer\nthan a name and an email, and a per-request row per page of the roster would\nswamp the trail without recording an access to anybody's data in particular. The\nper-customer reads below are the ones that log.\n", "x-i18n": { "tr": { "summary": "M\u00fc\u015fterileri listele", "description": "`user` rol\u00fcn\u00fc ta\u015f\u0131yan her hesap, ada g\u00f6re s\u0131ral\u0131.\n\nSahibi ayr\u0131ca `admin` (ya da `super-admin`) rol\u00fcn\u00fc de ta\u015f\u0131yan bir `admin:read`\nanahtar\u0131 gerektirir. \u0130zin tek ba\u015f\u0131na yetmez: bir anahtar, sahibinin onu olu\u015fturdu\u011fu\nandaki rol\u00fcnden daha uzun ya\u015far; bu y\u00fczden rol her istekte yeniden denetlenir.\n\nSorgu, `User` modellerinin tamam\u0131n\u0131 okumak yerine yay\u0131mlanan s\u00fctunlar\u0131 a\u00e7\u0131k\u00e7a se\u00e7er\n\u2014 panelin m\u00fc\u015fteri tablosunun kulland\u0131\u011f\u0131 bilin\u00e7li izd\u00fc\u015f\u00fcm\u00fcn ayn\u0131s\u0131; \u00e7\u00fcnk\u00fc izd\u00fc\u015f\u00fcms\u00fcz\nbir s\u00fcr\u00fcm\u00fc bir zamanlar her m\u00fc\u015fterinin kimlik numaras\u0131n\u0131 sayfa y\u00fck\u00fcne g\u00f6ndermi\u015fti.\n\nVeritaban\u0131ndan yan\u0131tlan\u0131r; bu aray\u00fcz\u00fcn hi\u00e7bir yerinde `refresh` s\u00fcr\u00fcm\u00fc yoktur. Bu\nokumalar\u0131n e\u015fitleyici e\u015fleri (`listSubscriptions()`, `listZones()`,\n`getInstances()`) yazma yapar; y\u00f6netici kapsam\u0131nda kurulumun tamam\u0131n\u0131 de\u011fi\u015ftirir.\nB\u00f6yle bir i\u015fi bir `GET`'in arkas\u0131na koymay\u0131 kabul edilebilir k\u0131lacak bir istek\ns\u0131n\u0131r\u0131 yoktur.\n\nBu listeleme denetim kayd\u0131 yazmaz: tek bir m\u00fc\u015fteri hakk\u0131nda addan ve e-posta\nadresinden fazlas\u0131n\u0131 yay\u0131mlamaz; listenin her sayfas\u0131 i\u00e7in istek ba\u015f\u0131na bir sat\u0131r\nyazmak ise kimsenin verisine yap\u0131lm\u0131\u015f belirli bir eri\u015fimi kaydetmeden denetim izini\nbo\u011fard\u0131. Kayd\u0131, a\u015fa\u011f\u0131daki m\u00fc\u015fteri bazl\u0131 okumalar tutar.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u0639\u0645\u0644\u0627\u0621", "description": "\u0643\u0644 \u062d\u0633\u0627\u0628 \u064a\u062d\u0645\u0644 \u062f\u0648\u0631 `user`\u060c \u0645\u0631\u062a\u0651\u0628\u064b\u0627 \u062d\u0633\u0628 \u0627\u0644\u0627\u0633\u0645.\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0645\u0645\u064a\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u0623\u064a\u0636\u064b\u0627 \u062f\u0648\u0631 `admin` (\u0623\u0648 `super-admin`). \u0648\u0644\u0627 \u062a\u0643\u0641\u064a\n\u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 \u0648\u062d\u062f\u0647\u0627: \u0641\u0627\u0644\u0631\u0645\u0632 \u064a\u0628\u0642\u0649 \u0628\u0639\u062f \u0627\u0644\u062f\u0648\u0631 \u0627\u0644\u0630\u064a \u0643\u0627\u0646 \u0635\u0627\u062d\u0628\u0647 \u064a\u062d\u0645\u0644\u0647 \u0639\u0646\u062f \u0625\u0635\u062f\u0627\u0631\u0647\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u064f\u0641\u062d\u0635\n\u0627\u0644\u062f\u0648\u0631 \u0641\u064a \u0643\u0644 \u0637\u0644\u0628.\n\n\u0648\u064a\u062e\u062a\u0627\u0631 \u0627\u0644\u0627\u0633\u062a\u0639\u0644\u0627\u0645 \u0627\u0644\u0623\u0639\u0645\u062f\u0629 \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u0629 \u0635\u0631\u0627\u062d\u0629\u064b \u0628\u062f\u0644 \u0642\u0631\u0627\u0621\u0629 \u0646\u0645\u0627\u0630\u062c `User` \u0643\u0627\u0645\u0644\u0629 \u2014 \u0648\u0647\u0648\n\u0627\u0644\u0625\u0633\u0642\u0627\u0637 \u0627\u0644\u0645\u0642\u0635\u0648\u062f \u0646\u0641\u0633\u0647 \u0627\u0644\u0630\u064a \u064a\u0633\u062a\u0639\u0645\u0644\u0647 \u062c\u062f\u0648\u0644 \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0628\u0639\u062f\u0645\u0627 \u0623\u0631\u0633\u0644\u062a \u0646\u0633\u062e\u0629 \u0628\u0644\u0627\n\u0625\u0633\u0642\u0627\u0637 \u0645\u0646\u0647 \u0630\u0627\u062a \u0645\u0631\u0629 \u0631\u0642\u0645 \u0627\u0644\u0647\u0648\u064a\u0629 \u0627\u0644\u0648\u0637\u0646\u064a\u0629 \u0644\u0643\u0644 \u0639\u0645\u064a\u0644 \u0636\u0645\u0646 \u062d\u0645\u0648\u0644\u0629 \u0627\u0644\u0635\u0641\u062d\u0629.\n\n\u0648\u064a\u0639\u062a\u0645\u062f \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u0639\u0644\u0649 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a\u060c \u0648\u0644\u0627 \u062a\u0648\u062c\u062f \u0646\u0633\u062e\u0629 `refresh` \u0641\u064a \u0623\u064a \u0645\u0648\u0636\u0639 \u0645\u0646 \u0647\u0630\u0647\n\u0627\u0644\u0648\u0627\u062c\u0647\u0629. \u0641\u0627\u0644\u0646\u0633\u062e \u0627\u0644\u062a\u064a \u062a\u064f\u062c\u0631\u064a \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0644\u0647\u0630\u0647 \u0627\u0644\u0642\u0631\u0627\u0621\u0627\u062a\n(`listSubscriptions()` \u0648`listZones()` \u0648`getInstances()`) \u062a\u0639\u062f\u0651\u0644 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a\u061b \u0648\u0641\u064a \u0627\u0644\u0646\u0637\u0627\u0642\n\u0627\u0644\u0625\u062f\u0627\u0631\u064a \u062a\u0639\u062f\u0651\u0644 \u0627\u0644\u062a\u0646\u0635\u064a\u0628 \u0643\u0644\u0647. \u0648\u0644\u0627 \u064a\u0648\u062c\u062f \u062d\u062f\u0651 \u0645\u0639\u062f\u0644 \u064a\u062c\u0639\u0644 \u0648\u0636\u0639 \u0630\u0644\u0643 \u062e\u0644\u0641 \u0637\u0644\u0628 `GET` \u0645\u0642\u0628\u0648\u0644\u064b\u0627.\n\n\u0648\u0644\u0627 \u062a\u0643\u062a\u0628 \u0647\u0630\u0647 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0623\u064a \u0633\u062c\u0644 \u062a\u062f\u0642\u064a\u0642: \u0641\u0647\u064a \u0644\u0627 \u062a\u0646\u0634\u0631 \u0639\u0646 \u0623\u064a \u0639\u0645\u064a\u0644 \u0623\u0643\u062b\u0631 \u0645\u0646 \u0627\u0633\u0645 \u0648\u0628\u0631\u064a\u062f\n\u0625\u0644\u0643\u062a\u0631\u0648\u0646\u064a\u060c \u0648\u0643\u062a\u0627\u0628\u0629 \u0635\u0641 \u0644\u0643\u0644 \u0637\u0644\u0628 \u0639\u0646 \u0643\u0644 \u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0643\u0627\u0646\u062a \u0633\u062a\u064f\u063a\u0631\u0642 \u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642 \u062f\u0648\u0646 \u0623\u0646\n\u062a\u0633\u062c\u0651\u0644 \u0648\u0635\u0648\u0644\u064b\u0627 \u0625\u0644\u0649 \u0628\u064a\u0627\u0646\u0627\u062a \u0623\u062d\u062f \u0628\u0639\u064a\u0646\u0647. \u0623\u0645\u0627 \u0627\u0644\u0642\u0631\u0627\u0621\u0627\u062a \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643\u0644 \u0639\u0645\u064a\u0644 \u0623\u062f\u0646\u0627\u0647 \u0641\u0647\u064a \u0627\u0644\u062a\u064a\n\u062a\u064f\u0633\u062c\u064e\u0651\u0644.\n" } }, "tags": [ "Admin" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of customers.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterilerden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0639\u0645\u0644\u0627\u0621." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AdminCustomer" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/customers/{user}": { "get": { "operationId": "getAdminCustomer", "summary": "Get one customer", "description": "One customer, with database-derived counts of their instances, volumes, DNS\nzones, subscriptions, invoices and tickets.\n\nThe panel's equivalent page returns twenty-four props in a single request and\ndials CloudStack, PowerDNS **and** the payment gateway to build them. This is the\ndecomposition of that page: the counts here are plain `select count(*)`, and the\ndetail lives on the four per-domain collections beside this path.\n\nReading another person's record writes an `account.pii_read` row into the audit\ntrail, exactly as the equivalent panel page does \u2014 the KVKK access-log obligation\ndoes not stop at the panel's edge. Reading your **own** record writes nothing: the\nrow would be one per page load of your own dashboard, and your own actions are\nrecorded anyway.\n\nBecause every call writes an audit row, this path is charged against a tighter\nrate-limit budget than an ordinary read.\n\nAny account may be addressed here, not only one holding the `user` role \u2014 the\nequivalent panel page binds any user and an admin can legitimately need to look at\na colleague's record. The listing beside this path is customers only. An id that\ndoes not exist is a `404`.\n", "x-i18n": { "tr": { "summary": "Tek bir m\u00fc\u015fteriyi getir", "description": "Tek bir m\u00fc\u015fteri; sanal makinalar\u0131n\u0131n, disklerinin, DNS alanlar\u0131n\u0131n,\naboneliklerinin, faturalar\u0131n\u0131n ve destek taleplerinin veritaban\u0131ndan t\u00fcretilmi\u015f\nsay\u0131lar\u0131yla birlikte.\n\nPanelin buna kar\u015f\u0131l\u0131k gelen sayfas\u0131 tek bir istekte yirmi d\u00f6rt \u00f6zellik d\u00f6nd\u00fcr\u00fcr ve\nbunlar\u0131 olu\u015fturmak i\u00e7in CloudStack'e, PowerDNS'e **ve** \u00f6deme sa\u011flay\u0131c\u0131s\u0131na ba\u011flan\u0131r. Bu\nu\u00e7 nokta, o sayfan\u0131n par\u00e7alar\u0131na ayr\u0131lm\u0131\u015f h\u00e2lidir: buradaki say\u0131lar d\u00fcz\n`select count(*)` sorgular\u0131d\u0131r, ayr\u0131nt\u0131 ise bu yolun yan\u0131ndaki d\u00f6rt alan\nkoleksiyonunda durur.\n\nBa\u015fka bir ki\u015finin kayd\u0131n\u0131 okumak, t\u0131pk\u0131 paneldeki kar\u015f\u0131l\u0131\u011f\u0131 gibi denetim izine bir\n`account.pii_read` sat\u0131r\u0131 yazar \u2014 KVKK'n\u0131n eri\u015fim kayd\u0131 tutma y\u00fck\u00fcml\u00fcl\u00fc\u011f\u00fc panelin\ns\u0131n\u0131r\u0131nda bitmez. **Kendi** kayd\u0131n\u0131z\u0131 okumak hi\u00e7bir \u015fey yazmaz: aksi h\u00e2lde kendi\npanonuzun her a\u00e7\u0131l\u0131\u015f\u0131 i\u00e7in bir sat\u0131r olu\u015furdu ve kendi i\u015flemleriniz zaten\nkaydediliyor.\n\nHer \u00e7a\u011fr\u0131 bir denetim kayd\u0131 yazd\u0131\u011f\u0131 i\u00e7in bu yol, s\u0131radan bir okumaya g\u00f6re daha dar\nbir istek s\u0131n\u0131r\u0131 b\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr.\n\nBurada yaln\u0131zca `user` rol\u00fcn\u00fc ta\u015f\u0131yan de\u011fil, herhangi bir hesap adreslenebilir \u2014\npaneldeki kar\u015f\u0131l\u0131\u011f\u0131 da herhangi bir kullan\u0131c\u0131y\u0131 ba\u011flar ve bir y\u00f6neticinin bir\nmeslekta\u015f\u0131n\u0131n kayd\u0131na bakmas\u0131 me\u015fru bir ihtiya\u00e7 olabilir. Bu yolun yan\u0131ndaki\nlisteleme yaln\u0131zca m\u00fc\u015fterileri kapsar. Var olmayan bir id `404` verir.\n" }, "ar": { "summary": "\u062c\u0644\u0628 \u0639\u0645\u064a\u0644 \u0648\u0627\u062d\u062f", "description": "\u0639\u0645\u064a\u0644 \u0648\u0627\u062d\u062f\u060c \u0645\u0639 \u0623\u0639\u062f\u0627\u062f \u0645\u0634\u062a\u0642\u0651\u0629 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0644\u0623\u062c\u0647\u0632\u062a\u0647 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0648\u0623\u0642\u0631\u0627\u0635\u0647 \u0648\u0645\u0646\u0627\u0637\u0642 DNS\n\u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0647 \u0648\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a\u0647 \u0648\u0641\u0648\u0627\u062a\u064a\u0631\u0647 \u0648\u062a\u0630\u0627\u0643\u0631\u0647.\n\n\u0648\u062a\u0639\u064a\u062f \u0627\u0644\u0635\u0641\u062d\u0629 \u0627\u0644\u0645\u0642\u0627\u0628\u0644\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0623\u0631\u0628\u0639\u064b\u0627 \u0648\u0639\u0634\u0631\u064a\u0646 \u062e\u0627\u0635\u064a\u0629 \u0641\u064a \u0637\u0644\u0628 \u0648\u0627\u062d\u062f\u060c \u0648\u062a\u062a\u0635\u0644 \u0628\u0640\nCloudStack \u0648PowerDNS **\u0648**\u0628\u0648\u0627\u0628\u0629 \u0627\u0644\u062f\u0641\u0639 \u0644\u0628\u0646\u0627\u0626\u0647\u0627. \u0648\u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u0647\u0648 \u062a\u0641\u0643\u064a\u0643 \u062a\u0644\u0643 \u0627\u0644\u0635\u0641\u062d\u0629:\n\u0641\u0627\u0644\u0623\u0639\u062f\u0627\u062f \u0647\u0646\u0627 \u0645\u062c\u0631\u0651\u062f `select count(*)`\u060c \u0623\u0645\u0627 \u0627\u0644\u062a\u0641\u0627\u0635\u064a\u0644 \u0641\u062a\u0642\u064a\u0645 \u0641\u064a \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0627\u0644\u0623\u0631\u0628\u0639 \u0627\u0644\u062e\u0627\u0635\u0629\n\u0628\u0643\u0644 \u0646\u0637\u0627\u0642 \u0625\u0644\u0649 \u062c\u0627\u0646\u0628 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631.\n\n\u0648\u0642\u0631\u0627\u0621\u0629 \u0633\u062c\u0644 \u0634\u062e\u0635 \u0622\u062e\u0631 \u062a\u0643\u062a\u0628 \u0635\u0641\u064b\u0627 \u0628\u0627\u0644\u062d\u062f\u062b `account.pii_read` \u0641\u064a \u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642\u060c \u062a\u0645\u0627\u0645\u064b\u0627 \u0643\u0645\u0627\n\u062a\u0641\u0639\u0644 \u0627\u0644\u0635\u0641\u062d\u0629 \u0627\u0644\u0645\u0642\u0627\u0628\u0644\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u2014 \u0641\u0627\u0644\u062a\u0632\u0627\u0645 \u062a\u0633\u062c\u064a\u0644 \u0627\u0644\u0648\u0635\u0648\u0644 \u0641\u064a KVKK \u0644\u0627 \u064a\u062a\u0648\u0642\u0641 \u0639\u0646\u062f \u062d\u062f\u0648\u062f\n\u0627\u0644\u0644\u0648\u062d\u0629. \u0623\u0645\u0627 \u0642\u0631\u0627\u0621\u0629 \u0633\u062c\u0644\u0643 **\u0623\u0646\u062a** \u0641\u0644\u0627 \u062a\u0643\u062a\u0628 \u0634\u064a\u0626\u064b\u0627: \u0625\u0630 \u0643\u0627\u0646 \u0627\u0644\u0635\u0641 \u0633\u064a\u062a\u0643\u0631\u0651\u0631 \u0645\u0639 \u0643\u0644 \u062a\u062d\u0645\u064a\u0644\n\u0644\u0644\u0648\u062d\u0629 \u062a\u062d\u0643\u0651\u0645\u0643\u060c \u0648\u0623\u0641\u0639\u0627\u0644\u0643 \u0645\u0633\u062c\u064e\u0651\u0644\u0629 \u0623\u0635\u0644\u064b\u0627.\n\n\u0648\u0644\u0623\u0646 \u0643\u0644 \u0627\u0633\u062a\u062f\u0639\u0627\u0621 \u064a\u0643\u062a\u0628 \u0633\u062c\u0644 \u062a\u062f\u0642\u064a\u0642\u060c \u064a\u064f\u062d\u062a\u0633\u0628 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u0639\u0644\u0649 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u062d\u062f\u0651 \u0645\u0639\u062f\u0644 \u0623\u0636\u064a\u0642 \u0645\u0646\n\u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0639\u0627\u062f\u064a\u0629.\n\n\u0648\u064a\u0645\u0643\u0646 \u0645\u062e\u0627\u0637\u0628\u0629 \u0623\u064a \u062d\u0633\u0627\u0628 \u0647\u0646\u0627\u060c \u0644\u0627 \u0627\u0644\u062d\u0633\u0627\u0628\u0627\u062a \u0627\u0644\u062a\u064a \u062a\u062d\u0645\u0644 \u062f\u0648\u0631 `user` \u0648\u062d\u062f\u0647\u0627 \u2014 \u0641\u0627\u0644\u0635\u0641\u062d\u0629\n\u0627\u0644\u0645\u0642\u0627\u0628\u0644\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u062a\u0631\u0628\u0637 \u0623\u064a \u0645\u0633\u062a\u062e\u062f\u0645\u060c \u0648\u0642\u062f \u064a\u062d\u062a\u0627\u062c \u0627\u0644\u0645\u062f\u064a\u0631 \u0641\u0639\u0644\u064b\u0627 \u0625\u0644\u0649 \u0627\u0644\u0627\u0637\u0644\u0627\u0639 \u0639\u0644\u0649 \u0633\u062c\u0644 \u0632\u0645\u064a\u0644\n\u0644\u0647. \u0623\u0645\u0627 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0645\u062c\u0627\u0648\u0631\u0629 \u0644\u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u0641\u062a\u0642\u062a\u0635\u0631 \u0639\u0644\u0649 \u0627\u0644\u0639\u0645\u0644\u0627\u0621. \u0648\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u063a\u064a\u0631 \u0627\u0644\u0645\u0648\u062c\u0648\u062f \u064a\u0639\u0637\u064a\n`404`.\n" } }, "tags": [ "Admin" ], "parameters": [ { "$ref": "#/components/parameters/CustomerId" } ], "responses": { "200": { "description": "The customer.", "x-i18n": { "tr": { "description": "M\u00fc\u015fteri." }, "ar": { "description": "\u0627\u0644\u0639\u0645\u064a\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/AdminCustomerDetail" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/customers/{user}/instances": { "get": { "operationId": "listAdminCustomerInstances", "summary": "List one customer's virtual machines", "description": "The customer's instances as currently stored, in the same `Instance`\nrepresentation the customer's own `/instances` returns \u2014 so a field withheld from\nthe owner stays withheld from staff.\n\nServed by resolving the **customer-scoped** cloud service for the target\ncustomer and reading it. The admin-scoped variant of that service exists, and\noverriding only its data-source hooks turns every inherited reconcile-on-read\nmethod into a fleet-wide mutation \u2014 a read of one page can delete another\ncustomer's rows. Nothing on this surface resolves it, and a source-level test\nkeeps it that way.\n\nThere is therefore no `refresh` parameter here, unlike the customer-facing\n`/instances`. Reconciliation is a mutation; a third party reading somebody else's\nmachines is the last caller who should trigger one.\n\nWrites a `cloud.pii_read` audit row and is charged against the tighter privileged\nread budget.\n", "x-i18n": { "tr": { "summary": "Bir m\u00fc\u015fterinin sanal makinalar\u0131n\u0131 listele", "description": "M\u00fc\u015fterinin sanal makinalar\u0131, kay\u0131tl\u0131 h\u00e2lleriyle ve m\u00fc\u015fterinin kendi `/instances`\n\u00e7a\u011fr\u0131s\u0131n\u0131n d\u00f6nd\u00fcrd\u00fc\u011f\u00fc `Instance` g\u00f6sterimiyle ayn\u0131 bi\u00e7imde \u2014 yani sahibinden\ngizlenen bir alan personelden de gizli kal\u0131r.\n\n\u0130stek, hedef m\u00fc\u015fteri i\u00e7in **m\u00fc\u015fteri kapsaml\u0131** bulut servisi \u00e7\u00f6z\u00fcmlenip okunarak\nkar\u015f\u0131lan\u0131r. Bu servisin y\u00f6netici kapsaml\u0131 s\u00fcr\u00fcm\u00fc de vard\u0131r; yaln\u0131zca veri kayna\u011f\u0131\nkancalar\u0131n\u0131n ge\u00e7ersiz k\u0131l\u0131nmas\u0131, devral\u0131nan her \u201cokurken e\u015fitle\u201d y\u00f6ntemini\nkurulum genelinde bir yazma i\u015flemine d\u00f6n\u00fc\u015ft\u00fcr\u00fcr \u2014 tek bir sayfan\u0131n okunmas\u0131 ba\u015fka\nbir m\u00fc\u015fterinin kay\u0131tlar\u0131n\u0131 silebilir. Bu aray\u00fczde hi\u00e7bir yer onu \u00e7\u00f6z\u00fcmlemez ve bir\nkaynak d\u00fczeyi testi bunu b\u00f6yle tutar.\n\nBu y\u00fczden burada, m\u00fc\u015fteriye a\u00e7\u0131k `/instances` u\u00e7 noktas\u0131n\u0131n aksine `refresh`\nparametresi yoktur. E\u015fitleme bir yazma i\u015flemidir; ba\u015fkas\u0131n\u0131n makinelerini okuyan\n\u00fc\u00e7\u00fcnc\u00fc bir taraf, onu tetiklemesi en son akla gelecek \u00e7a\u011f\u0131rand\u0131r.\n\nBir `cloud.pii_read` denetim kayd\u0131 yazar ve daha dar olan ayr\u0131cal\u0131kl\u0131 okuma\nb\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0644\u0639\u0645\u064a\u0644 \u0648\u0627\u062d\u062f", "description": "\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0643\u0645\u0627 \u0647\u064a \u0645\u062e\u0632\u0651\u0646\u0629 \u062d\u0627\u0644\u064a\u064b\u0627\u060c \u0628\u0627\u0644\u062a\u0645\u062b\u064a\u0644 `Instance` \u0646\u0641\u0633\u0647 \u0627\u0644\u0630\u064a \u064a\u0639\u064a\u062f\u0647\n\u0627\u0644\u0645\u0633\u0627\u0631 `/instances` \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u0639\u0645\u064a\u0644 \u2014 \u0641\u0627\u0644\u062d\u0642\u0644 \u0627\u0644\u0645\u062d\u062c\u0648\u0628 \u0639\u0646 \u0627\u0644\u0645\u0627\u0644\u0643 \u064a\u0628\u0642\u0649 \u0645\u062d\u062c\u0648\u0628\u064b\u0627 \u0639\u0646\n\u0627\u0644\u0645\u0648\u0638\u0641\u064a\u0646.\n\n\u0648\u062a\u064f\u062e\u062f\u064e\u0645 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u062a\u062d\u0644\u064a\u0644 \u062e\u062f\u0645\u0629 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 **\u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a** \u0644\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0633\u062a\u0647\u062f\u0641\n\u0648\u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0645\u0646\u0647\u0627. \u0648\u0644\u0644\u062e\u062f\u0645\u0629 \u0646\u0633\u062e\u0629 \u0630\u0627\u062a \u0646\u0637\u0627\u0642 \u0625\u062f\u0627\u0631\u064a\u060c \u0648\u0627\u0644\u0627\u0643\u062a\u0641\u0627\u0621 \u0628\u062a\u062c\u0627\u0648\u0632 \u062e\u0637\u0651\u0627\u0641\u0627\u062a \u0645\u0635\u062f\u0631 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a\n\u0641\u064a\u0647\u0627 \u064a\u062d\u0648\u0651\u0644 \u0643\u0644 \u062a\u0627\u0628\u0639 \u0645\u0648\u0631\u0648\u062b \u064a\u064f\u062c\u0631\u064a \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0639\u0646\u062f \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0625\u0644\u0649 \u062a\u0639\u062f\u064a\u0644 \u064a\u0634\u0645\u0644 \u0627\u0644\u0623\u0633\u0637\u0648\u0644 \u0643\u0644\u0647 \u2014\n\u0641\u0642\u0631\u0627\u0621\u0629 \u0635\u0641\u062d\u0629 \u0648\u0627\u062d\u062f\u0629 \u0642\u062f \u062a\u062d\u0630\u0641 \u0635\u0641\u0648\u0641 \u0639\u0645\u064a\u0644 \u0622\u062e\u0631. \u0648\u0644\u0627 \u0634\u064a\u0621 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u064a\u062d\u0644\u0651 \u062a\u0644\u0643 \u0627\u0644\u0646\u0633\u062e\u0629\u060c\n\u0648\u064a\u062d\u0631\u0635 \u0627\u062e\u062a\u0628\u0627\u0631 \u0639\u0644\u0649 \u0645\u0633\u062a\u0648\u0649 \u0627\u0644\u0634\u064a\u0641\u0631\u0629 \u0639\u0644\u0649 \u0628\u0642\u0627\u0621 \u0627\u0644\u0623\u0645\u0631 \u0643\u0630\u0644\u0643.\n\n\u0648\u0644\u0630\u0644\u0643 \u0644\u0627 \u064a\u0648\u062c\u062f \u0647\u0646\u0627 \u0645\u0639\u0627\u0645\u0644 `refresh`\u060c \u062e\u0644\u0627\u0641\u064b\u0627 \u0644\u0645\u0633\u0627\u0631 `/instances` \u0627\u0644\u0645\u0648\u062c\u064e\u0651\u0647 \u0625\u0644\u0649 \u0627\u0644\u0639\u0645\u064a\u0644.\n\u0641\u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u062a\u0639\u062f\u064a\u0644\u061b \u0648\u0627\u0644\u0637\u0631\u0641 \u0627\u0644\u062b\u0627\u0644\u062b \u0627\u0644\u0630\u064a \u064a\u0642\u0631\u0623 \u0623\u062c\u0647\u0632\u0629 \u063a\u064a\u0631\u0647 \u0647\u0648 \u0622\u062e\u0631 \u0645\u0633\u062a\u062f\u0639\u064d \u064a\u0646\u0628\u063a\u064a \u0623\u0646\n\u064a\u064f\u0637\u0644\u0642\u0647\u0627.\n\n\u064a\u0643\u062a\u0628 \u0633\u062c\u0644 \u062a\u062f\u0642\u064a\u0642 `cloud.pii_read` \u0648\u064a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0645\u0645\u064a\u0651\u0632\u0629 \u0627\u0644\u0623\u0636\u064a\u0642.\n" } }, "tags": [ "Admin" ], "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of the customer's virtual machines.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin sanal makinalar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0644\u0644\u0639\u0645\u064a\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Instance" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/customers/{user}/dns-zones": { "get": { "operationId": "listAdminCustomerDNSZones", "summary": "List one customer's DNS zones", "description": "The customer's zones as currently stored, in the same `DNSZone` representation\nthe customer's own `/dns-zones` returns.\n\nServed by resolving the customer-scoped DNS service explicitly. No `refresh`\nparameter: the reconciling sibling deletes local zones \u2014 and cascades to their\nrecords \u2014 that PowerDNS's live listing no longer contains, *before* its own\nupdate flag is consulted, and at admin scope it does that to every zone in the\ninstall and reassigns unmatched ones to the acting staff member.\n\nWrites a `dns.pii_read` audit row and is charged against the tighter privileged\nread budget.\n", "x-i18n": { "tr": { "summary": "Bir m\u00fc\u015fterinin DNS alanlar\u0131n\u0131 listele", "description": "M\u00fc\u015fterinin DNS alanlar\u0131, kay\u0131tl\u0131 h\u00e2lleriyle ve m\u00fc\u015fterinin kendi `/dns-zones` \u00e7a\u011fr\u0131s\u0131n\u0131n\nd\u00f6nd\u00fcrd\u00fc\u011f\u00fc `DNSZone` g\u00f6sterimiyle ayn\u0131 bi\u00e7imde.\n\n\u0130stek, m\u00fc\u015fteri kapsaml\u0131 DNS servisi a\u00e7\u0131k\u00e7a \u00e7\u00f6z\u00fcmlenerek kar\u015f\u0131lan\u0131r. `refresh`\nparametresi yoktur: e\u015fitleyici e\u015fi, PowerDNS'in canl\u0131 listesinde art\u0131k\nbulunmayan yerel DNS alanlar\u0131n\u0131 \u2014 kay\u0131tlar\u0131na da yay\u0131larak \u2014 kendi g\u00fcncelleme bayra\u011f\u0131na\n*bak\u0131lmadan \u00f6nce* siler; y\u00f6netici kapsam\u0131nda ise bunu kurulumdaki her DNS alan\u0131na\nuygular ve e\u015fle\u015fmeyenleri i\u015flemi yapan personelin \u00fczerine ge\u00e7irir.\n\nBir `dns.pii_read` denetim kayd\u0131 yazar ve daha dar olan ayr\u0131cal\u0131kl\u0131 okuma\nb\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0645\u0646\u0627\u0637\u0642 DNS \u0644\u0639\u0645\u064a\u0644 \u0648\u0627\u062d\u062f", "description": "\u0645\u0646\u0627\u0637\u0642 \u0627\u0644\u0639\u0645\u064a\u0644 \u0643\u0645\u0627 \u0647\u064a \u0645\u062e\u0632\u0651\u0646\u0629 \u062d\u0627\u0644\u064a\u064b\u0627\u060c \u0628\u0627\u0644\u062a\u0645\u062b\u064a\u0644 `DNSZone` \u0646\u0641\u0633\u0647 \u0627\u0644\u0630\u064a \u064a\u0639\u064a\u062f\u0647 \u0627\u0644\u0645\u0633\u0627\u0631\n`/dns-zones` \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u0639\u0645\u064a\u0644.\n\n\u0648\u062a\u064f\u062e\u062f\u064e\u0645 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u062a\u062d\u0644\u064a\u0644 \u062e\u062f\u0645\u0629 DNS \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a \u0635\u0631\u0627\u062d\u0629\u064b. \u0648\u0644\u0627 \u064a\u0648\u062c\u062f \u0648\u0633\u064a\u0637\n`refresh`: \u0641\u0627\u0644\u0646\u0633\u062e\u0629 \u0627\u0644\u062a\u064a \u062a\u064f\u062c\u0631\u064a \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u062a\u062d\u0630\u0641 \u0627\u0644\u0645\u0646\u0627\u0637\u0642 \u0627\u0644\u0645\u062d\u0644\u064a\u0629 \u2014 \u0648\u062a\u062a\u0633\u0644\u0633\u0644 \u0625\u0644\u0649 \u0633\u062c\u0644\u0627\u062a\u0647\u0627 \u2014\n\u0627\u0644\u062a\u064a \u0644\u0645 \u062a\u0639\u062f \u0642\u0627\u0626\u0645\u0629 PowerDNS \u0627\u0644\u062d\u064a\u0651\u0629 \u062a\u062a\u0636\u0645\u0651\u0646\u0647\u0627\u060c \u0648\u0630\u0644\u0643 *\u0642\u0628\u0644* \u0627\u0644\u0631\u062c\u0648\u0639 \u0625\u0644\u0649 \u0631\u0627\u064a\u0629 \u0627\u0644\u062a\u062d\u062f\u064a\u062b\n\u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0647\u0627\u061b \u0648\u0641\u064a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0625\u062f\u0627\u0631\u064a \u062a\u0641\u0639\u0644 \u0630\u0644\u0643 \u0628\u0643\u0644 \u0645\u0646\u0637\u0642\u0629 \u0641\u064a \u0627\u0644\u062a\u0646\u0635\u064a\u0628 \u0648\u062a\u0646\u0642\u0644 \u063a\u064a\u0631 \u0627\u0644\u0645\u062a\u0637\u0627\u0628\u0642\u0629\n\u0645\u0646\u0647\u0627 \u0625\u0644\u0649 \u0627\u0644\u0645\u0648\u0638\u0641 \u0627\u0644\u0645\u0646\u0641\u0650\u0651\u0630.\n\n\u064a\u0643\u062a\u0628 \u0633\u062c\u0644 \u062a\u062f\u0642\u064a\u0642 `dns.pii_read` \u0648\u064a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0645\u0645\u064a\u0651\u0632\u0629 \u0627\u0644\u0623\u0636\u064a\u0642.\n" } }, "tags": [ "Admin" ], "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of the customer's DNS zones.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin DNS alanlar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0645\u0646\u0627\u0637\u0642 DNS \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u0639\u0645\u064a\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DNSZone" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/customers/{user}/subscriptions": { "get": { "operationId": "listAdminCustomerSubscriptions", "summary": "List one customer's subscriptions", "description": "The customer's subscriptions as currently stored, in the same `Subscription`\nrepresentation the customer's own `/subscriptions` returns. Money is always a\nminor-unit integer with its currency, never a float.\n\nServed by resolving the customer-scoped billing service explicitly. No `refresh`\nparameter, and this is the sharpest case for it: the reconciling sibling\nterminates subscriptions whose linked resource has moved, promotes every pending\nsubscription to deployed and erases its failure reason, deletes root-volume\nsubscriptions together with their payments, and fires orphan events that dial the\nprovider and create further subscriptions \u2014 all inside one transaction. At admin\nscope its input set is the whole table rather than one customer.\n\nWrites a `billing.pii_read` audit row and is charged against the tighter\nprivileged read budget.\n", "x-i18n": { "tr": { "summary": "Bir m\u00fc\u015fterinin aboneliklerini listele", "description": "M\u00fc\u015fterinin abonelikleri, kay\u0131tl\u0131 h\u00e2lleriyle ve m\u00fc\u015fterinin kendi `/subscriptions`\n\u00e7a\u011fr\u0131s\u0131n\u0131n d\u00f6nd\u00fcrd\u00fc\u011f\u00fc `Subscription` g\u00f6sterimiyle ayn\u0131 bi\u00e7imde. Para her zaman para\nbirimiyle birlikte, alt birim cinsinden bir tam say\u0131d\u0131r; asla ondal\u0131kl\u0131 bir say\u0131\nde\u011fildir.\n\n\u0130stek, m\u00fc\u015fteri kapsaml\u0131 faturaland\u0131rma servisi a\u00e7\u0131k\u00e7a \u00e7\u00f6z\u00fcmlenerek kar\u015f\u0131lan\u0131r.\n`refresh` parametresi yoktur ve bunun en keskin gerek\u00e7esi buradad\u0131r: e\u015fitleyici\ne\u015fi, ba\u011fl\u0131 kayna\u011f\u0131 yer de\u011fi\u015ftirmi\u015f abonelikleri sonland\u0131r\u0131r, bekleyen her aboneli\u011fi\nda\u011f\u0131t\u0131lm\u0131\u015f duruma y\u00fckseltip hata gerek\u00e7esini siler, k\u00f6k disk aboneliklerini\n\u00f6demeleriyle birlikte siler ve sa\u011flay\u0131c\u0131ya ba\u011flan\u0131p yeni abonelikler yaratan\nsahipsizlik olaylar\u0131 tetikler \u2014 hepsi tek bir veritaban\u0131 i\u015flemi i\u00e7inde. Y\u00f6netici\nkapsam\u0131nda ise girdi k\u00fcmesi tek bir m\u00fc\u015fteri de\u011fil, tablonun tamam\u0131d\u0131r.\n\nBir `billing.pii_read` denetim kayd\u0131 yazar ve daha dar olan ayr\u0131cal\u0131kl\u0131 okuma\nb\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0639\u0645\u064a\u0644 \u0648\u0627\u062d\u062f", "description": "\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u0639\u0645\u064a\u0644 \u0643\u0645\u0627 \u0647\u064a \u0645\u062e\u0632\u0651\u0646\u0629 \u062d\u0627\u0644\u064a\u064b\u0627\u060c \u0628\u0627\u0644\u062a\u0645\u062b\u064a\u0644 `Subscription` \u0646\u0641\u0633\u0647 \u0627\u0644\u0630\u064a \u064a\u0639\u064a\u062f\u0647\n\u0627\u0644\u0645\u0633\u0627\u0631 `/subscriptions` \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u0639\u0645\u064a\u0644. \u0648\u0627\u0644\u0645\u0628\u0627\u0644\u063a \u062f\u0627\u0626\u0645\u064b\u0627 \u0623\u0639\u062f\u0627\u062f \u0635\u062d\u064a\u062d\u0629 \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629\n\u0645\u0639 \u0639\u0645\u0644\u062a\u0647\u0627\u060c \u0644\u0627 \u0623\u0639\u062f\u0627\u062f\u064b\u0627 \u0639\u0634\u0631\u064a\u0629 \u0623\u0628\u062f\u064b\u0627.\n\n\u0648\u062a\u064f\u062e\u062f\u064e\u0645 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u062a\u062d\u0644\u064a\u0644 \u062e\u062f\u0645\u0629 \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a \u0635\u0631\u0627\u062d\u0629\u064b. \u0648\u0644\u0627 \u064a\u0648\u062c\u062f \u0648\u0633\u064a\u0637\n`refresh`\u060c \u0648\u0647\u0630\u0647 \u0623\u0648\u0636\u062d \u062d\u0627\u0644\u0629 \u062a\u0628\u0631\u0651\u0631 \u0630\u0644\u0643: \u0641\u0627\u0644\u0646\u0633\u062e\u0629 \u0627\u0644\u062a\u064a \u062a\u064f\u062c\u0631\u064a \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u062a\u064f\u0646\u0647\u064a \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a\n\u0627\u0644\u062a\u064a \u0627\u0646\u062a\u0642\u0644 \u0645\u0648\u0631\u062f\u0647\u0627 \u0627\u0644\u0645\u0631\u062a\u0628\u0637\u060c \u0648\u062a\u0631\u0641\u0639 \u0643\u0644 \u0627\u0634\u062a\u0631\u0627\u0643 \u0645\u0639\u0644\u0651\u0642 \u0625\u0644\u0649 \u062d\u0627\u0644\u0629 \u0627\u0644\u0646\u0634\u0631 \u0648\u062a\u0645\u062d\u0648 \u0633\u0628\u0628 \u0625\u062e\u0641\u0627\u0642\u0647\u060c\n\u0648\u062a\u062d\u0630\u0641 \u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u0642\u0631\u0635 \u0627\u0644\u062c\u0630\u0631\u064a \u0645\u0639 \u0645\u062f\u0641\u0648\u0639\u0627\u062a\u0647\u0627\u060c \u0648\u062a\u064f\u0637\u0644\u0642 \u0623\u062d\u062f\u0627\u062b \u0627\u0644\u064a\u062a\u0645 \u0627\u0644\u062a\u064a \u062a\u062a\u0635\u0644 \u0628\u0627\u0644\u0645\u0632\u0648\u0651\u062f\n\u0648\u062a\u0646\u0634\u0626 \u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0625\u0636\u0627\u0641\u064a\u0629 \u2014 \u0643\u0644 \u0630\u0644\u0643 \u062f\u0627\u062e\u0644 \u0645\u0639\u0627\u0645\u0644\u0629 \u0648\u0627\u062d\u062f\u0629. \u0648\u0641\u064a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0625\u062f\u0627\u0631\u064a \u062a\u0643\u0648\u0646 \u0645\u062c\u0645\u0648\u0639\u0629\n\u0645\u062f\u062e\u0644\u0627\u062a\u0647\u0627 \u0627\u0644\u062c\u062f\u0648\u0644 \u0643\u0644\u0647 \u0644\u0627 \u0639\u0645\u064a\u0644\u064b\u0627 \u0648\u0627\u062d\u062f\u064b\u0627.\n\n\u064a\u0643\u062a\u0628 \u0633\u062c\u0644 \u062a\u062f\u0642\u064a\u0642 `billing.pii_read` \u0648\u064a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0645\u0645\u064a\u0651\u0632\u0629 \u0627\u0644\u0623\u0636\u064a\u0642.\n" } }, "tags": [ "Admin" ], "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of the customer's subscriptions.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin aboneliklerinden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u0639\u0645\u064a\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Subscription" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/customers/{user}/instances/{instance}/actions/start": { "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "startAdminCustomerInstance", "summary": "Start a customer's virtual machine", "description": "Idempotent: starting an already-running machine returns 200 immediately without\ncontacting CloudStack, exactly as the owner's own `/instances/{instance}/actions/start`\ndoes.\n\nServed by resolving the customer-scoped cloud service for the target customer, never\nthe admin-scoped variant \u2014 see the \"customer-scoped service\" note on `GET /admin/customers/{user}/instances` for why that distinction is load-bearing here too.\n\n`audit.access:cloud` on this route is inert (it only records a successful GET); the\nadmin-acting-on-a-customer's-machine row is written explicitly by the controller,\nwhether or not CloudStack was actually dialled by the idempotency check above.\n", "x-i18n": { "tr": { "summary": "Bir m\u00fc\u015fterinin sanal makinas\u0131n\u0131 ba\u015flat", "description": "Idempotent: zaten \u00e7al\u0131\u015fan bir makineyi ba\u015flatmak, t\u0131pk\u0131 sahibinin kendi\n`/instances/{instance}/actions/start` \u00e7a\u011fr\u0131s\u0131nda oldu\u011fu gibi, CloudStack'e hi\u00e7\nba\u015fvurmadan an\u0131nda 200 d\u00f6nd\u00fcr\u00fcr.\n\n\u0130stek, hedef m\u00fc\u015fteri i\u00e7in m\u00fc\u015fteri kapsaml\u0131 bulut servisi \u00e7\u00f6z\u00fcmlenerek kar\u015f\u0131lan\u0131r;\ny\u00f6netici kapsaml\u0131 s\u00fcr\u00fcm asla kullan\u0131lmaz \u2014 bu ayr\u0131m\u0131n burada da neden belirleyici\noldu\u011funu g\u00f6rmek i\u00e7in `GET /admin/customers/{user}/instances` \u00fczerindeki \u201cm\u00fc\u015fteri\nkapsaml\u0131 servis\u201d notuna bak\u0131n.\n\nBu rotadaki `audit.access:cloud` etkisizdir (yaln\u0131zca ba\u015far\u0131l\u0131 bir GET'i kaydeder);\ny\u00f6neticinin bir m\u00fc\u015fterinin makinesi \u00fczerinde i\u015flem yapt\u0131\u011f\u0131n\u0131 g\u00f6steren kayd\u0131,\nyukar\u0131daki idempotenslik denetimi nedeniyle CloudStack'e ger\u00e7ekten ba\u011flan\u0131lm\u0131\u015f olsun\nya da olmas\u0131n, denetleyici a\u00e7\u0131k\u00e7a yazar.\n" }, "ar": { "summary": "\u062a\u0634\u063a\u064a\u0644 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0639\u0645\u064a\u0644", "description": "\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u062a\u0634\u063a\u064a\u0644 \u062c\u0647\u0627\u0632 \u064a\u0639\u0645\u0644 \u0623\u0635\u0644\u064b\u0627 \u064a\u0639\u064a\u062f 200 \u0641\u0648\u0631\u064b\u0627 \u062f\u0648\u0646 \u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0640\nCloudStack\u060c \u062a\u0645\u0627\u0645\u064b\u0627 \u0643\u0645\u0627 \u064a\u0641\u0639\u0644 \u0627\u0644\u0645\u0633\u0627\u0631 `/instances/{instance}/actions/start` \u0627\u0644\u062e\u0627\u0635\n\u0628\u0627\u0644\u0645\u0627\u0644\u0643 \u0646\u0641\u0633\u0647.\n\n\u0648\u062a\u064f\u062e\u062f\u064e\u0645 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u062a\u062d\u0644\u064a\u0644 \u062e\u062f\u0645\u0629 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a \u0644\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0633\u062a\u0647\u062f\u0641\u060c \u0644\u0627\n\u0627\u0644\u0646\u0633\u062e\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0625\u062f\u0627\u0631\u064a \u0623\u0628\u062f\u064b\u0627 \u2014 \u0631\u0627\u062c\u0639 \u0645\u0644\u0627\u062d\u0638\u0629 \u00ab\u0627\u0644\u062e\u062f\u0645\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a\u00bb \u0639\u0644\u0649\n`GET /admin/customers/{user}/instances` \u0644\u0645\u0639\u0631\u0641\u0629 \u0633\u0628\u0628 \u0623\u0647\u0645\u064a\u0629 \u0647\u0630\u0627 \u0627\u0644\u062a\u0645\u064a\u064a\u0632 \u0647\u0646\u0627 \u0623\u064a\u0636\u064b\u0627.\n\n\u0648\u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0627\u0644\u0648\u0633\u064a\u0637\u0629 `audit.access:cloud` \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u062e\u0627\u0645\u0644\u0629 (\u0641\u0647\u064a \u0644\u0627 \u062a\u0633\u062c\u0651\u0644 \u0625\u0644\u0627 \u0637\u0644\u0628 GET\n\u0646\u0627\u062c\u062d\u064b\u0627)\u061b \u0623\u0645\u0627 \u0633\u062c\u0644 \u062a\u0635\u0631\u064f\u0651\u0641 \u0627\u0644\u0645\u062f\u064a\u0631 \u0639\u0644\u0649 \u062c\u0647\u0627\u0632 \u0639\u0645\u064a\u0644 \u0641\u064a\u0643\u062a\u0628\u0647 \u0627\u0644\u0645\u062a\u062d\u0643\u0651\u0645 \u0635\u0631\u0627\u062d\u0629\u064b\u060c \u0633\u0648\u0627\u0621 \u062c\u0631\u0649\n\u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0640 CloudStack \u0641\u0639\u0644\u064b\u0627 \u0628\u0633\u0628\u0628 \u0641\u062d\u0635 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 \u0623\u0639\u0644\u0627\u0647 \u0623\u0645 \u0644\u0645 \u064a\u062c\u0631\u0650.\n" } }, "tags": [ "Admin" ], "responses": { "200": { "description": "The customer's virtual machine, started (or already running).", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin sanal makinas\u0131, ba\u015flat\u0131lm\u0131\u015f (ya da zaten \u00e7al\u0131\u015f\u0131yorken) h\u00e2liyle." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0644\u0639\u0645\u064a\u0644 \u0628\u0639\u062f \u062a\u0634\u063a\u064a\u0644\u0647 (\u0623\u0648 \u0648\u0647\u0648 \u064a\u0639\u0645\u0644 \u0623\u0635\u0644\u064b\u0627)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/admin/customers/{user}/instances/{instance}/actions/stop": { "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "stopAdminCustomerInstance", "summary": "Stop a customer's virtual machine", "description": "Idempotent: stopping an already-stopped machine returns 200 immediately without\ncontacting CloudStack, for the same reason as `start`.\n\nServed by resolving the customer-scoped cloud service for the target customer, never\nthe admin-scoped variant \u2014 see the \"customer-scoped service\" note on `GET /admin/customers/{user}/instances` for why that distinction is load-bearing here too.\n\n`audit.access:cloud` on this route is inert (it only records a successful GET); the\nadmin-acting-on-a-customer's-machine row is written explicitly by the controller,\nwhether or not CloudStack was actually dialled by the idempotency check above.\n", "x-i18n": { "tr": { "summary": "Bir m\u00fc\u015fterinin sanal makinas\u0131n\u0131 durdur", "description": "Idempotent: zaten durmu\u015f bir makineyi durdurmak, `start` ile ayn\u0131 gerek\u00e7eyle,\nCloudStack'e hi\u00e7 ba\u015fvurmadan an\u0131nda 200 d\u00f6nd\u00fcr\u00fcr.\n\n\u0130stek, hedef m\u00fc\u015fteri i\u00e7in m\u00fc\u015fteri kapsaml\u0131 bulut servisi \u00e7\u00f6z\u00fcmlenerek kar\u015f\u0131lan\u0131r;\ny\u00f6netici kapsaml\u0131 s\u00fcr\u00fcm asla kullan\u0131lmaz \u2014 bu ayr\u0131m\u0131n burada da neden belirleyici\noldu\u011funu g\u00f6rmek i\u00e7in `GET /admin/customers/{user}/instances` \u00fczerindeki \u201cm\u00fc\u015fteri\nkapsaml\u0131 servis\u201d notuna bak\u0131n.\n\nBu rotadaki `audit.access:cloud` etkisizdir (yaln\u0131zca ba\u015far\u0131l\u0131 bir GET'i kaydeder);\ny\u00f6neticinin bir m\u00fc\u015fterinin makinesi \u00fczerinde i\u015flem yapt\u0131\u011f\u0131n\u0131 g\u00f6steren kayd\u0131,\nyukar\u0131daki idempotenslik denetimi nedeniyle CloudStack'e ger\u00e7ekten ba\u011flan\u0131lm\u0131\u015f olsun\nya da olmas\u0131n, denetleyici a\u00e7\u0131k\u00e7a yazar.\n" }, "ar": { "summary": "\u0625\u064a\u0642\u0627\u0641 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0639\u0645\u064a\u0644", "description": "\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u0625\u064a\u0642\u0627\u0641 \u062c\u0647\u0627\u0632 \u0645\u062a\u0648\u0642\u0641 \u0623\u0635\u0644\u064b\u0627 \u064a\u0639\u064a\u062f 200 \u0641\u0648\u0631\u064b\u0627 \u062f\u0648\u0646 \u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0640\nCloudStack\u060c \u0644\u0644\u0633\u0628\u0628 \u0646\u0641\u0633\u0647 \u0627\u0644\u0645\u0630\u0643\u0648\u0631 \u0641\u064a `start`.\n\n\u0648\u062a\u064f\u062e\u062f\u064e\u0645 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u062a\u062d\u0644\u064a\u0644 \u062e\u062f\u0645\u0629 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a \u0644\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0633\u062a\u0647\u062f\u0641\u060c \u0644\u0627\n\u0627\u0644\u0646\u0633\u062e\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0625\u062f\u0627\u0631\u064a \u0623\u0628\u062f\u064b\u0627 \u2014 \u0631\u0627\u062c\u0639 \u0645\u0644\u0627\u062d\u0638\u0629 \u00ab\u0627\u0644\u062e\u062f\u0645\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a\u00bb \u0639\u0644\u0649\n`GET /admin/customers/{user}/instances` \u0644\u0645\u0639\u0631\u0641\u0629 \u0633\u0628\u0628 \u0623\u0647\u0645\u064a\u0629 \u0647\u0630\u0627 \u0627\u0644\u062a\u0645\u064a\u064a\u0632 \u0647\u0646\u0627 \u0623\u064a\u0636\u064b\u0627.\n\n\u0648\u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0627\u0644\u0648\u0633\u064a\u0637\u0629 `audit.access:cloud` \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u062e\u0627\u0645\u0644\u0629 (\u0641\u0647\u064a \u0644\u0627 \u062a\u0633\u062c\u0651\u0644 \u0625\u0644\u0627 \u0637\u0644\u0628 GET\n\u0646\u0627\u062c\u062d\u064b\u0627)\u061b \u0623\u0645\u0627 \u0633\u062c\u0644 \u062a\u0635\u0631\u064f\u0651\u0641 \u0627\u0644\u0645\u062f\u064a\u0631 \u0639\u0644\u0649 \u062c\u0647\u0627\u0632 \u0639\u0645\u064a\u0644 \u0641\u064a\u0643\u062a\u0628\u0647 \u0627\u0644\u0645\u062a\u062d\u0643\u0651\u0645 \u0635\u0631\u0627\u062d\u0629\u064b\u060c \u0633\u0648\u0627\u0621 \u062c\u0631\u0649\n\u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0640 CloudStack \u0641\u0639\u0644\u064b\u0627 \u0628\u0633\u0628\u0628 \u0641\u062d\u0635 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 \u0623\u0639\u0644\u0627\u0647 \u0623\u0645 \u0644\u0645 \u064a\u062c\u0631\u0650.\n" } }, "tags": [ "Admin" ], "responses": { "200": { "description": "The customer's virtual machine, stopped (or already stopped).", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin sanal makinas\u0131, durdurulmu\u015f (ya da zaten durmu\u015fken) h\u00e2liyle." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0644\u0639\u0645\u064a\u0644 \u0628\u0639\u062f \u0625\u064a\u0642\u0627\u0641\u0647 (\u0623\u0648 \u0648\u0647\u0648 \u0645\u062a\u0648\u0642\u0641 \u0623\u0635\u0644\u064b\u0627)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/admin/customers/{user}/instances/{instance}/actions/restart": { "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "restartAdminCustomerInstance", "summary": "Restart a customer's virtual machine", "description": "Not idempotent \u2014 unlike `start`/`stop` there is no target state to compare against,\nso this always reaches CloudStack regardless of the machine's current state.\n\nServed by resolving the customer-scoped cloud service for the target customer, never\nthe admin-scoped variant \u2014 see the \"customer-scoped service\" note on `GET /admin/customers/{user}/instances` for why that distinction is load-bearing here too.\n\n`audit.access:cloud` on this route is inert (it only records a successful GET); the\nadmin-acting-on-a-customer's-machine row is written explicitly by the controller.\n", "x-i18n": { "tr": { "summary": "Bir m\u00fc\u015fterinin sanal makinas\u0131n\u0131 yeniden ba\u015flat", "description": "Idempotent de\u011fil \u2014 `start`/`stop`'un aksine kar\u015f\u0131la\u015ft\u0131r\u0131lacak bir hedef durum\nyoktur; bu y\u00fczden makinenin o anki durumu ne olursa olsun her zaman CloudStack'e\ngidilir.\n\n\u0130stek, hedef m\u00fc\u015fteri i\u00e7in m\u00fc\u015fteri kapsaml\u0131 bulut servisi \u00e7\u00f6z\u00fcmlenerek kar\u015f\u0131lan\u0131r;\ny\u00f6netici kapsaml\u0131 s\u00fcr\u00fcm asla kullan\u0131lmaz \u2014 bu ayr\u0131m\u0131n burada da neden belirleyici\noldu\u011funu g\u00f6rmek i\u00e7in `GET /admin/customers/{user}/instances` \u00fczerindeki \u201cm\u00fc\u015fteri\nkapsaml\u0131 servis\u201d notuna bak\u0131n.\n\nBu rotadaki `audit.access:cloud` etkisizdir (yaln\u0131zca ba\u015far\u0131l\u0131 bir GET'i kaydeder);\ny\u00f6neticinin bir m\u00fc\u015fterinin makinesi \u00fczerinde i\u015flem yapt\u0131\u011f\u0131n\u0131 g\u00f6steren kayd\u0131\ndenetleyici a\u00e7\u0131k\u00e7a yazar.\n" }, "ar": { "summary": "\u0625\u0639\u0627\u062f\u0629 \u062a\u0634\u063a\u064a\u0644 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0639\u0645\u064a\u0644", "description": "\u063a\u064a\u0631 \u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent) \u2014 \u0641\u062e\u0644\u0627\u0641\u064b\u0627 \u0644\u0640 `start`/`stop` \u0644\u0627 \u062a\u0648\u062c\u062f \u062d\u0627\u0644\u0629 \u0647\u062f\u0641 \u062a\u064f\u0642\u0627\u0631\u064e\u0646\n\u0628\u0647\u0627\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u0635\u0644 \u062f\u0627\u0626\u0645\u064b\u0627 \u0625\u0644\u0649 CloudStack \u0645\u0647\u0645\u0627 \u0643\u0627\u0646\u062a \u062d\u0627\u0644\u0629 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0631\u0627\u0647\u0646\u0629.\n\n\u0648\u062a\u064f\u062e\u062f\u064e\u0645 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u062a\u062d\u0644\u064a\u0644 \u062e\u062f\u0645\u0629 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a \u0644\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0633\u062a\u0647\u062f\u0641\u060c \u0644\u0627\n\u0627\u0644\u0646\u0633\u062e\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0625\u062f\u0627\u0631\u064a \u0623\u0628\u062f\u064b\u0627 \u2014 \u0631\u0627\u062c\u0639 \u0645\u0644\u0627\u062d\u0638\u0629 \u00ab\u0627\u0644\u062e\u062f\u0645\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a\u00bb \u0639\u0644\u0649\n`GET /admin/customers/{user}/instances` \u0644\u0645\u0639\u0631\u0641\u0629 \u0633\u0628\u0628 \u0623\u0647\u0645\u064a\u0629 \u0647\u0630\u0627 \u0627\u0644\u062a\u0645\u064a\u064a\u0632 \u0647\u0646\u0627 \u0623\u064a\u0636\u064b\u0627.\n\n\u0648\u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0627\u0644\u0648\u0633\u064a\u0637\u0629 `audit.access:cloud` \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u062e\u0627\u0645\u0644\u0629 (\u0641\u0647\u064a \u0644\u0627 \u062a\u0633\u062c\u0651\u0644 \u0625\u0644\u0627 \u0637\u0644\u0628 GET\n\u0646\u0627\u062c\u062d\u064b\u0627)\u061b \u0623\u0645\u0627 \u0633\u062c\u0644 \u062a\u0635\u0631\u064f\u0651\u0641 \u0627\u0644\u0645\u062f\u064a\u0631 \u0639\u0644\u0649 \u062c\u0647\u0627\u0632 \u0639\u0645\u064a\u0644 \u0641\u064a\u0643\u062a\u0628\u0647 \u0627\u0644\u0645\u062a\u062d\u0643\u0651\u0645 \u0635\u0631\u0627\u062d\u0629\u064b.\n" } }, "tags": [ "Admin" ], "responses": { "200": { "description": "The customer's virtual machine, restarted.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin sanal makinas\u0131, yeniden ba\u015flat\u0131lm\u0131\u015f h\u00e2liyle." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0644\u0639\u0645\u064a\u0644 \u0628\u0639\u062f \u0625\u0639\u0627\u062f\u0629 \u062a\u0634\u063a\u064a\u0644\u0647." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/admin/customers/{user}/instances/{instance}/actions/attach-iso": { "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "attachIsoToAdminCustomerInstance", "summary": "Attach an ISO to a customer's virtual machine", "description": "Idempotent: attaching an ISO already mounted on this instance returns 200\nimmediately without contacting CloudStack.\n\n`iso_id` must name an ISO visible to the TARGET CUSTOMER \u2014 public, or owned by\ntheir account \u2014 never the acting admin's own account. Scoping on the admin's\naccount instead would offer the admin's private images and reject the customer's\nown.\n\nServed by resolving the customer-scoped cloud service for the target customer,\nnever the admin-scoped variant \u2014 see the \"customer-scoped service\" note on `GET /admin/customers/{user}/instances` for why that distinction is load-bearing here too.\n\n`audit.access:cloud` on this route is inert (it only records a successful GET); the\nadmin-acting-on-a-customer's-machine row is written explicitly by the controller.\n", "x-i18n": { "tr": { "summary": "Bir m\u00fc\u015fterinin sanal makinas\u0131na ISO ba\u011fla", "description": "Idempotent: bu sanal makinaya zaten ba\u011fl\u0131 olan bir ISO'yu ba\u011flamak, CloudStack'e hi\u00e7\nba\u015fvurmadan an\u0131nda 200 d\u00f6nd\u00fcr\u00fcr.\n\n`iso_id`, HEDEF M\u00dc\u015eTER\u0130N\u0130N g\u00f6rebildi\u011fi bir ISO'yu g\u00f6stermelidir \u2014 herkese a\u00e7\u0131k ya da\no m\u00fc\u015fterinin hesab\u0131na ait olan; i\u015flemi yapan y\u00f6neticinin kendi hesab\u0131na ait olan\nde\u011fil. Kapsam\u0131n y\u00f6neticinin hesab\u0131na g\u00f6re kurulmas\u0131, y\u00f6neticinin \u00f6zel imajlar\u0131n\u0131\nsunar ve m\u00fc\u015fterinin kendi imajlar\u0131n\u0131 reddederdi.\n\n\u0130stek, hedef m\u00fc\u015fteri i\u00e7in m\u00fc\u015fteri kapsaml\u0131 bulut servisi \u00e7\u00f6z\u00fcmlenerek kar\u015f\u0131lan\u0131r;\ny\u00f6netici kapsaml\u0131 s\u00fcr\u00fcm asla kullan\u0131lmaz \u2014 bu ayr\u0131m\u0131n burada da neden belirleyici\noldu\u011funu g\u00f6rmek i\u00e7in `GET /admin/customers/{user}/instances` \u00fczerindeki \u201cm\u00fc\u015fteri\nkapsaml\u0131 servis\u201d notuna bak\u0131n.\n\nBu rotadaki `audit.access:cloud` etkisizdir (yaln\u0131zca ba\u015far\u0131l\u0131 bir GET'i kaydeder);\ny\u00f6neticinin bir m\u00fc\u015fterinin makinesi \u00fczerinde i\u015flem yapt\u0131\u011f\u0131n\u0131 g\u00f6steren kayd\u0131\ndenetleyici a\u00e7\u0131k\u00e7a yazar.\n" }, "ar": { "summary": "\u0625\u0631\u0641\u0627\u0642 \u0635\u0648\u0631\u0629 ISO \u0628\u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0639\u0645\u064a\u0644", "description": "\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u0625\u0631\u0641\u0627\u0642 \u0635\u0648\u0631\u0629 ISO \u0645\u0631\u0643\u0651\u0628\u0629 \u0623\u0635\u0644\u064b\u0627 \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u064a\u0639\u064a\u062f 200\n\u0641\u0648\u0631\u064b\u0627 \u062f\u0648\u0646 \u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0640 CloudStack.\n\n\u0648\u064a\u062c\u0628 \u0623\u0646 \u064a\u0634\u064a\u0631 `iso_id` \u0625\u0644\u0649 \u0635\u0648\u0631\u0629 ISO \u0645\u0631\u0626\u064a\u0629 \u0644\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0633\u062a\u0647\u062f\u0641 \u2014 \u0639\u0627\u0645\u0629 \u0623\u0648 \u0645\u0645\u0644\u0648\u0643\u0629\n\u0644\u062d\u0633\u0627\u0628\u0647 \u2014 \u0644\u0627 \u0644\u062d\u0633\u0627\u0628 \u0627\u0644\u0645\u062f\u064a\u0631 \u0627\u0644\u0645\u0646\u0641\u0650\u0651\u0630 \u0623\u0628\u062f\u064b\u0627. \u0641\u062a\u062d\u062f\u064a\u062f \u0627\u0644\u0646\u0637\u0627\u0642 \u0628\u062d\u0633\u0627\u0628 \u0627\u0644\u0645\u062f\u064a\u0631 \u0643\u0627\u0646 \u0633\u064a\u0639\u0631\u0636 \u0635\u0648\u0631\n\u0627\u0644\u0645\u062f\u064a\u0631 \u0627\u0644\u062e\u0627\u0635\u0629 \u0648\u064a\u0631\u0641\u0636 \u0635\u0648\u0631 \u0627\u0644\u0639\u0645\u064a\u0644 \u0646\u0641\u0633\u0647.\n\n\u0648\u062a\u064f\u062e\u062f\u064e\u0645 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u062a\u062d\u0644\u064a\u0644 \u062e\u062f\u0645\u0629 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a \u0644\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0633\u062a\u0647\u062f\u0641\u060c \u0644\u0627\n\u0627\u0644\u0646\u0633\u062e\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0625\u062f\u0627\u0631\u064a \u0623\u0628\u062f\u064b\u0627 \u2014 \u0631\u0627\u062c\u0639 \u0645\u0644\u0627\u062d\u0638\u0629 \u00ab\u0627\u0644\u062e\u062f\u0645\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a\u00bb \u0639\u0644\u0649\n`GET /admin/customers/{user}/instances` \u0644\u0645\u0639\u0631\u0641\u0629 \u0633\u0628\u0628 \u0623\u0647\u0645\u064a\u0629 \u0647\u0630\u0627 \u0627\u0644\u062a\u0645\u064a\u064a\u0632 \u0647\u0646\u0627 \u0623\u064a\u0636\u064b\u0627.\n\n\u0648\u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0627\u0644\u0648\u0633\u064a\u0637\u0629 `audit.access:cloud` \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u062e\u0627\u0645\u0644\u0629 (\u0641\u0647\u064a \u0644\u0627 \u062a\u0633\u062c\u0651\u0644 \u0625\u0644\u0627 \u0637\u0644\u0628 GET\n\u0646\u0627\u062c\u062d\u064b\u0627)\u061b \u0623\u0645\u0627 \u0633\u062c\u0644 \u062a\u0635\u0631\u064f\u0651\u0641 \u0627\u0644\u0645\u062f\u064a\u0631 \u0639\u0644\u0649 \u062c\u0647\u0627\u0632 \u0639\u0645\u064a\u0644 \u0641\u064a\u0643\u062a\u0628\u0647 \u0627\u0644\u0645\u062a\u062d\u0643\u0651\u0645 \u0635\u0631\u0627\u062d\u0629\u064b.\n" } }, "tags": [ "Admin" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "iso_id" ], "properties": { "iso_id": { "type": "integer", "description": "Must name an ISO visible to the CUSTOMER (public, or owned by their\naccount). A foreign private or missing id fails validation (422)\nrather than 404 \u2014 the addressed resource is the instance, not the ISO.\n", "x-i18n": { "tr": { "description": "M\u00dc\u015eTER\u0130N\u0130N g\u00f6rebildi\u011fi bir ISO'yu g\u00f6stermelidir (herkese a\u00e7\u0131k ya da\nm\u00fc\u015fterinin hesab\u0131na ait). Ba\u015fkas\u0131na ait \u00f6zel bir id ya da olmayan bir id,\n404 de\u011fil do\u011frulama hatas\u0131 (422) verir \u2014 adreslenen kaynak ISO de\u011fil,\nsanal makinad\u0131r.\n" }, "ar": { "description": "\u064a\u062c\u0628 \u0623\u0646 \u064a\u0634\u064a\u0631 \u0625\u0644\u0649 \u0635\u0648\u0631\u0629 ISO \u0645\u0631\u0626\u064a\u0629 \u0644\u0644\u0639\u0645\u064a\u0644 (\u0639\u0627\u0645\u0629 \u0623\u0648 \u0645\u0645\u0644\u0648\u0643\u0629 \u0644\u062d\u0633\u0627\u0628\u0647). \u0623\u0645\u0627\n\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u062e\u0627\u0635 \u0627\u0644\u0639\u0627\u0626\u062f \u0644\u063a\u064a\u0631\u0647 \u0623\u0648 \u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u063a\u064a\u0631 \u0627\u0644\u0645\u0648\u062c\u0648\u062f \u0641\u064a\u0641\u0634\u0644 \u0641\u064a \u0627\u0644\u062a\u062d\u0642\u0642 (422)\n\u0644\u0627 \u0628\u0627\u0644\u0631\u0645\u0632 404 \u2014 \u0641\u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0645\u064f\u062e\u0627\u0637\u064e\u0628 \u0647\u0648 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0627 \u0635\u0648\u0631\u0629 ISO.\n" } }, "example": 5 } } } } } }, "responses": { "200": { "description": "The customer's virtual machine, with the ISO attached (or already attached).", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin sanal makinas\u0131, ISO ba\u011flanm\u0131\u015f (ya da zaten ba\u011fl\u0131yken) h\u00e2liyle." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0644\u0639\u0645\u064a\u0644 \u0628\u0639\u062f \u0625\u0631\u0641\u0627\u0642 \u0635\u0648\u0631\u0629 ISO (\u0623\u0648 \u0648\u0647\u064a \u0645\u0631\u0641\u0642\u0629 \u0623\u0635\u0644\u064b\u0627)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/admin/customers/{user}/instances/{instance}/actions/detach-iso": { "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "name": "instance", "in": "path", "required": true, "schema": { "type": "integer" } } ], "post": { "operationId": "detachIsoFromAdminCustomerInstance", "summary": "Detach whatever ISO is mounted on a customer's virtual machine", "description": "Idempotent: detaching an instance with no ISO attached returns 200 immediately\nwithout contacting CloudStack.\n\nServed by resolving the customer-scoped cloud service for the target customer,\nnever the admin-scoped variant \u2014 see the \"customer-scoped service\" note on `GET /admin/customers/{user}/instances` for why that distinction is load-bearing here too.\n\n`audit.access:cloud` on this route is inert (it only records a successful GET); the\nadmin-acting-on-a-customer's-machine row is written explicitly by the controller.\n", "x-i18n": { "tr": { "summary": "Bir m\u00fc\u015fterinin sanal makinas\u0131nda tak\u0131l\u0131 olan ISO'yu \u00e7\u0131kar", "description": "Idempotent: ba\u011fl\u0131 ISO'su olmayan bir sanal makinadan ISO \u00e7\u0131karmak, CloudStack'e hi\u00e7\nba\u015fvurmadan an\u0131nda 200 d\u00f6nd\u00fcr\u00fcr.\n\n\u0130stek, hedef m\u00fc\u015fteri i\u00e7in m\u00fc\u015fteri kapsaml\u0131 bulut servisi \u00e7\u00f6z\u00fcmlenerek kar\u015f\u0131lan\u0131r;\ny\u00f6netici kapsaml\u0131 s\u00fcr\u00fcm asla kullan\u0131lmaz \u2014 bu ayr\u0131m\u0131n burada da neden belirleyici\noldu\u011funu g\u00f6rmek i\u00e7in `GET /admin/customers/{user}/instances` \u00fczerindeki \u201cm\u00fc\u015fteri\nkapsaml\u0131 servis\u201d notuna bak\u0131n.\n\nBu rotadaki `audit.access:cloud` etkisizdir (yaln\u0131zca ba\u015far\u0131l\u0131 bir GET'i kaydeder);\ny\u00f6neticinin bir m\u00fc\u015fterinin makinesi \u00fczerinde i\u015flem yapt\u0131\u011f\u0131n\u0131 g\u00f6steren kayd\u0131\ndenetleyici a\u00e7\u0131k\u00e7a yazar.\n" }, "ar": { "summary": "\u0641\u0635\u0644 \u0635\u0648\u0631\u0629 ISO \u0627\u0644\u0645\u0631\u0643\u0651\u0628\u0629 \u0639\u0644\u0649 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0639\u0645\u064a\u0644\u060c \u0623\u064a\u064b\u0627 \u0643\u0627\u0646\u062a", "description": "\u0645\u062a\u0643\u0627\u0641\u0626\u0629 \u0627\u0644\u062a\u0643\u0631\u0627\u0631 (idempotent): \u0641\u0635\u0644 \u0635\u0648\u0631\u0629 ISO \u0639\u0646 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0627 \u0635\u0648\u0631\u0629 \u0645\u0631\u0641\u0642\u0629 \u0628\u0647 \u064a\u0639\u064a\u062f 200 \u0641\u0648\u0631\u064b\u0627\n\u062f\u0648\u0646 \u0627\u0644\u0627\u062a\u0635\u0627\u0644 \u0628\u0640 CloudStack.\n\n\u0648\u062a\u064f\u062e\u062f\u064e\u0645 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u0628\u062a\u062d\u0644\u064a\u0644 \u062e\u062f\u0645\u0629 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a \u0644\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0633\u062a\u0647\u062f\u0641\u060c \u0644\u0627\n\u0627\u0644\u0646\u0633\u062e\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0625\u062f\u0627\u0631\u064a \u0623\u0628\u062f\u064b\u0627 \u2014 \u0631\u0627\u062c\u0639 \u0645\u0644\u0627\u062d\u0638\u0629 \u00ab\u0627\u0644\u062e\u062f\u0645\u0629 \u0630\u0627\u062a \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u064a\u00bb \u0639\u0644\u0649\n`GET /admin/customers/{user}/instances` \u0644\u0645\u0639\u0631\u0641\u0629 \u0633\u0628\u0628 \u0623\u0647\u0645\u064a\u0629 \u0647\u0630\u0627 \u0627\u0644\u062a\u0645\u064a\u064a\u0632 \u0647\u0646\u0627 \u0623\u064a\u0636\u064b\u0627.\n\n\u0648\u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0627\u0644\u0648\u0633\u064a\u0637\u0629 `audit.access:cloud` \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u062e\u0627\u0645\u0644\u0629 (\u0641\u0647\u064a \u0644\u0627 \u062a\u0633\u062c\u0651\u0644 \u0625\u0644\u0627 \u0637\u0644\u0628 GET\n\u0646\u0627\u062c\u062d\u064b\u0627)\u061b \u0623\u0645\u0627 \u0633\u062c\u0644 \u062a\u0635\u0631\u064f\u0651\u0641 \u0627\u0644\u0645\u062f\u064a\u0631 \u0639\u0644\u0649 \u062c\u0647\u0627\u0632 \u0639\u0645\u064a\u0644 \u0641\u064a\u0643\u062a\u0628\u0647 \u0627\u0644\u0645\u062a\u062d\u0643\u0651\u0645 \u0635\u0631\u0627\u062d\u0629\u064b.\n" } }, "tags": [ "Admin" ], "responses": { "200": { "description": "The customer's virtual machine, with its ISO detached (or already detached).", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin sanal makinas\u0131, ISO'su \u00e7\u0131kar\u0131lm\u0131\u015f (ya da zaten \u00e7\u0131kar\u0131lm\u0131\u015fken) h\u00e2liyle." }, "ar": { "description": "\u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0644\u0644\u0639\u0645\u064a\u0644 \u0628\u0639\u062f \u0641\u0635\u0644 \u0635\u0648\u0631\u0629 ISO \u0639\u0646\u0647 (\u0623\u0648 \u0648\u0647\u064a \u0645\u0641\u0635\u0648\u0644\u0629 \u0623\u0635\u0644\u064b\u0627)." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/Instance" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" }, "502": { "$ref": "#/components/responses/UpstreamFailure" } } } }, "/admin/ai/prompts": { "get": { "operationId": "showAiPrompts", "summary": "Read both assistants' system prompts", "description": "The two assistants C2 runs \u2014 the panel assistant a signed-in customer talks to, and\nthe chat bubble on the public marketing site \u2014 and, for each, the fixed built-in\nprompt plus the operator's own guidance appended to it.\n\nRequires an `admin:read` token whose owner holds the `admin` or `super-admin` role.\n\n**`core` is read-only, on every surface.** It lives in the application's source, not\nin the database, and there is no endpoint, form or tool that edits it. It carries the\nrules that make the assistants safe to run: read every fact from a tool, never guess\nan instance state, a price or a balance, pause for the customer's explicit approval\nbefore a machine is started or stopped, and never do arithmetic on money. The panel\nassistant can spend a customer's money, so those rules are the reason it can be\nallowed to.\n\n**`guidance` is the part an operator writes**, and it is APPENDED below `core`, never\nsubstituted for it. It is framed in the prompt as operator policy that is additional\nto the rules above it and cannot relax, contradict or override them. `null` means\nnothing is set, and an installation with `null` on both surfaces sends exactly the\nprompt that shipped, byte for byte.\n\nIt is returned beside `core` deliberately: a caller iterating on the appended text is\niterating against the contract above it, and should not have to fetch a second\ndocument \u2014 or guess \u2014 to see what it is appending to.\n\n`max_guidance` is the character limit each surface's `guidance` is held to, enforced\nidentically by this API, the admin settings form and the MCP tool. The text is sent to\nthe model on every turn of every conversation, so it is a bill as well as a policy.\n", "x-i18n": { "tr": { "summary": "Her iki asistan\u0131n sistem istemlerini oku", "description": "C2'nin \u00e7al\u0131\u015ft\u0131rd\u0131\u011f\u0131 iki asistan \u2014 oturum a\u00e7m\u0131\u015f bir m\u00fc\u015fterinin konu\u015ftu\u011fu panel\nasistan\u0131 ve herkese a\u00e7\u0131k tan\u0131t\u0131m sitesindeki sohbet balonu \u2014 ve her biri i\u00e7in,\nde\u011fi\u015ftirilemeyen yerle\u015fik istem ile onun alt\u0131na eklenen operat\u00f6r y\u00f6nergesi.\n\nSahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:read` anahtar\u0131 gerektirir.\n\n**`core` her aray\u00fczde salt okunurdur.** Veritaban\u0131nda de\u011fil, uygulaman\u0131n kayna\u011f\u0131nda\ndurur; onu de\u011fi\u015ftiren bir u\u00e7 nokta, form ya da ara\u00e7 yoktur. Asistanlar\u0131n g\u00fcvenle\n\u00e7al\u0131\u015fmas\u0131n\u0131 sa\u011flayan kurallar\u0131 ta\u015f\u0131r: her bilgiyi bir ara\u00e7tan oku; bir sanal\nmakinan\u0131n durumunu, bir fiyat\u0131 ya da bir bakiyeyi asla tahmin etme; bir makine\nba\u015flat\u0131lmadan veya durdurulmadan \u00f6nce m\u00fc\u015fterinin a\u00e7\u0131k onay\u0131 i\u00e7in bekle; para\n\u00fczerinde asla aritmetik yapma. Panel asistan\u0131 m\u00fc\u015fterinin paras\u0131n\u0131 harcayabilir;\nbu kurallar, ona bu iznin verilebilmesinin sebebidir.\n\n**`guidance` operat\u00f6r\u00fcn yazd\u0131\u011f\u0131 b\u00f6l\u00fcmd\u00fcr** ve `core`'un alt\u0131na EKLEN\u0130R, hi\u00e7bir\nzaman onun yerine ge\u00e7mez. \u0130stemin i\u00e7inde, \u00fcst\u00fcndeki kurallara ek olan ve onlar\u0131\ngev\u015fetemeyen, onlarla \u00e7eli\u015femeyen, onlar\u0131 ge\u00e7ersiz k\u0131lamayan bir operat\u00f6r\npolitikas\u0131 olarak sunulur. `null` hi\u00e7bir \u015feyin ayarlanmad\u0131\u011f\u0131 anlam\u0131na gelir; her\niki aray\u00fczde de `null` olan bir kurulum, \u00fcr\u00fcnle birlikte gelen istemi bayt bayt\naynen g\u00f6nderir.\n\n`core` ile yan yana d\u00f6nd\u00fcr\u00fclmesi bilin\u00e7lidir: eklenen metin \u00fczerinde \u00e7al\u0131\u015fan bir\n\u00e7a\u011f\u0131ran, asl\u0131nda onun \u00fcst\u00fcndeki s\u00f6zle\u015fmeye kar\u015f\u0131 \u00e7al\u0131\u015fmaktad\u0131r ve neyin alt\u0131na\nekleme yapt\u0131\u011f\u0131n\u0131 g\u00f6rmek i\u00e7in ikinci bir belge \u00e7ekmek \u2014 ya da tahmin etmek \u2014\nzorunda kalmamal\u0131d\u0131r.\n\n`max_guidance`, her aray\u00fcz\u00fcn `guidance` alan\u0131 i\u00e7in ge\u00e7erli olan karakter s\u0131n\u0131r\u0131d\u0131r;\nbu API, y\u00f6netim ayarlar\u0131 formu ve MCP arac\u0131 taraf\u0131ndan birebir ayn\u0131 bi\u00e7imde\nuygulan\u0131r. Metin her konu\u015fman\u0131n her turunda modele g\u00f6nderilir; dolay\u0131s\u0131yla bir\npolitika oldu\u011fu kadar bir masraf kalemidir.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u0645\u0648\u062c\u0651\u0647\u0627\u062a \u0627\u0644\u0646\u0638\u0627\u0645 \u0644\u0643\u0650\u0644\u0627 \u0627\u0644\u0645\u0633\u0627\u0639\u062f\u064e\u064a\u0646", "description": "\u0627\u0644\u0645\u0633\u0627\u0639\u062f\u0627\u0646 \u0627\u0644\u0644\u0630\u0627\u0646 \u064a\u0634\u063a\u0651\u0644\u0647\u0645\u0627 C2 \u2014 \u0645\u0633\u0627\u0639\u062f \u0627\u0644\u0644\u0648\u062d\u0629 \u0627\u0644\u0630\u064a \u064a\u062d\u0627\u062f\u062b\u0647 \u0639\u0645\u064a\u0644 \u0645\u0633\u062c\u064e\u0651\u0644 \u0627\u0644\u062f\u062e\u0648\u0644\u060c\n\u0648\u0641\u0642\u0627\u0639\u0629 \u0627\u0644\u062f\u0631\u062f\u0634\u0629 \u0639\u0644\u0649 \u0627\u0644\u0645\u0648\u0642\u0639 \u0627\u0644\u062a\u0633\u0648\u064a\u0642\u064a \u0627\u0644\u0639\u0627\u0645 \u2014 \u0648\u0644\u0643\u0644\u064d\u0651 \u0645\u0646\u0647\u0645\u0627 \u0627\u0644\u0645\u0648\u062c\u0651\u0647 \u0627\u0644\u0645\u062f\u0645\u062c \u0627\u0644\u062b\u0627\u0628\u062a\n\u0645\u0636\u0627\u0641\u064b\u0627 \u0625\u0644\u064a\u0647 \u0625\u0631\u0634\u0627\u062f\u0627\u062a \u0627\u0644\u0645\u0634\u063a\u0651\u0644 \u0646\u0641\u0633\u0647.\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0645\u0645\u064a\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`.\n\n**`core` \u0644\u0644\u0642\u0631\u0627\u0621\u0629 \u0641\u0642\u0637\u060c \u0641\u064a \u0643\u0644 \u0648\u0627\u062c\u0647\u0629.** \u0641\u0647\u0648 \u0645\u0648\u062c\u0648\u062f \u0641\u064a \u0634\u064a\u0641\u0631\u0629 \u0627\u0644\u062a\u0637\u0628\u064a\u0642 \u0644\u0627 \u0641\u064a \u0642\u0627\u0639\u062f\u0629\n\u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a\u060c \u0648\u0644\u0627 \u062a\u0648\u062c\u062f \u0646\u0642\u0637\u0629 \u0646\u0647\u0627\u064a\u0629 \u0623\u0648 \u0646\u0645\u0648\u0630\u062c \u0623\u0648 \u0623\u062f\u0627\u0629 \u062a\u0639\u062f\u0651\u0644\u0647. \u0648\u0647\u0648 \u064a\u062d\u0645\u0644 \u0627\u0644\u0642\u0648\u0627\u0639\u062f \u0627\u0644\u062a\u064a\n\u062a\u062c\u0639\u0644 \u062a\u0634\u063a\u064a\u0644 \u0627\u0644\u0645\u0633\u0627\u0639\u062f\u064e\u064a\u0646 \u0622\u0645\u0646\u064b\u0627: \u0627\u0642\u0631\u0623 \u0643\u0644 \u0645\u0639\u0644\u0648\u0645\u0629 \u0645\u0646 \u0623\u062f\u0627\u0629\u060c \u0648\u0644\u0627 \u062a\u062e\u0645\u0651\u0646 \u062d\u0627\u0644\u0629 \u062c\u0647\u0627\u0632 \u0627\u0641\u062a\u0631\u0627\u0636\u064a\n\u0623\u0648 \u0633\u0639\u0631\u064b\u0627 \u0623\u0648 \u0631\u0635\u064a\u062f\u064b\u0627\u060c \u0648\u062a\u0648\u0642\u0651\u0641 \u0644\u0627\u0646\u062a\u0638\u0627\u0631 \u0645\u0648\u0627\u0641\u0642\u0629 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0635\u0631\u064a\u062d\u0629 \u0642\u0628\u0644 \u062a\u0634\u063a\u064a\u0644 \u062c\u0647\u0627\u0632 \u0623\u0648\n\u0625\u064a\u0642\u0627\u0641\u0647\u060c \u0648\u0644\u0627 \u062a\u064f\u062c\u0631\u0650 \u0623\u064a \u0639\u0645\u0644\u064a\u0629 \u062d\u0633\u0627\u0628\u064a\u0629 \u0639\u0644\u0649 \u0627\u0644\u0645\u0627\u0644. \u064a\u0633\u062a\u0637\u064a\u0639 \u0645\u0633\u0627\u0639\u062f \u0627\u0644\u0644\u0648\u062d\u0629 \u0625\u0646\u0641\u0627\u0642 \u0645\u0627\u0644\n\u0627\u0644\u0639\u0645\u064a\u0644\u060c \u0648\u0644\u0630\u0644\u0643 \u0641\u0625\u0646 \u062a\u0644\u0643 \u0627\u0644\u0642\u0648\u0627\u0639\u062f \u0647\u064a \u0633\u0628\u0628 \u0627\u0644\u0633\u0645\u0627\u062d \u0644\u0647 \u0628\u0630\u0644\u0643.\n\n**`guidance` \u0647\u0648 \u0627\u0644\u062c\u0632\u0621 \u0627\u0644\u0630\u064a \u064a\u0643\u062a\u0628\u0647 \u0627\u0644\u0645\u0634\u063a\u0651\u0644**\u060c \u0648\u064a\u064f\u0636\u0627\u0641 \u0623\u0633\u0641\u0644 `core` \u0648\u0644\u0627 \u064a\u062d\u0644\u0651 \u0645\u062d\u0644\u0651\u0647\n\u0623\u0628\u062f\u064b\u0627. \u0648\u064a\u064f\u0642\u062f\u064e\u0651\u0645 \u062f\u0627\u062e\u0644 \u0627\u0644\u0645\u0648\u062c\u0651\u0647 \u0628\u0648\u0635\u0641\u0647 \u0633\u064a\u0627\u0633\u0629 \u0645\u0634\u063a\u0651\u0644 \u0625\u0636\u0627\u0641\u064a\u0629 \u0644\u0644\u0642\u0648\u0627\u0639\u062f \u0627\u0644\u062a\u064a \u0641\u0648\u0642\u0647\u060c \u0644\u0627\n\u064a\u0645\u0643\u0646\u0647\u0627 \u062a\u062e\u0641\u064a\u0641\u0647\u0627 \u0623\u0648 \u0645\u0646\u0627\u0642\u0636\u062a\u0647\u0627 \u0623\u0648 \u062a\u062c\u0627\u0648\u0632\u0647\u0627. \u0648\u062a\u0639\u0646\u064a \u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0623\u0646\u0647 \u0644\u0645 \u064a\u064f\u0636\u0628\u0637 \u0634\u064a\u0621\u061b\n\u0648\u0627\u0644\u062a\u0646\u0635\u064a\u0628 \u0627\u0644\u0630\u064a \u062a\u0643\u0648\u0646 \u0641\u064a\u0647 \u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0641\u064a \u0643\u0644\u062a\u0627 \u0627\u0644\u0648\u0627\u062c\u0647\u062a\u064a\u0646 \u064a\u0631\u0633\u0644 \u0627\u0644\u0645\u0648\u062c\u0651\u0647 \u0627\u0644\u0645\u0631\u0641\u0642 \u0645\u0639\n\u0627\u0644\u0645\u0646\u062a\u062c \u062d\u0631\u0641\u064a\u064b\u0627\u060c \u0628\u0627\u064a\u062a\u064b\u0627 \u0628\u0628\u0627\u064a\u062a.\n\n\u0648\u0625\u0639\u0627\u062f\u062a\u0647 \u0625\u0644\u0649 \u062c\u0627\u0646\u0628 `core` \u0623\u0645\u0631 \u0645\u0642\u0635\u0648\u062f: \u0641\u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0627\u0644\u0630\u064a \u064a\u0637\u0648\u0651\u0631 \u0627\u0644\u0646\u0635 \u0627\u0644\u0645\u064f\u0636\u0627\u0641 \u0625\u0646\u0645\u0627 \u064a\u0639\u0645\u0644\n\u0641\u064a \u0645\u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0639\u0642\u062f \u0627\u0644\u0630\u064a \u0641\u0648\u0642\u0647\u060c \u0648\u0644\u0627 \u064a\u0646\u0628\u063a\u064a \u0623\u0646 \u064a\u0636\u0637\u0631 \u0625\u0644\u0649 \u062c\u0644\u0628 \u0645\u0633\u062a\u0646\u062f \u062b\u0627\u0646\u064d \u2014 \u0623\u0648 \u0625\u0644\u0649\n\u0627\u0644\u062a\u062e\u0645\u064a\u0646 \u2014 \u0644\u064a\u0631\u0649 \u0645\u0627 \u0627\u0644\u0630\u064a \u064a\u0636\u064a\u0641 \u0625\u0644\u064a\u0647.\n\n\u0648`max_guidance` \u0647\u0648 \u0627\u0644\u062d\u062f \u0627\u0644\u0623\u0642\u0635\u0649 \u0644\u0639\u062f\u062f \u0627\u0644\u0645\u062d\u0627\u0631\u0641 \u0627\u0644\u0645\u0633\u0645\u0648\u062d \u0628\u0647 \u0644\u062d\u0642\u0644 `guidance` \u0641\u064a \u0643\u0644\n\u0648\u0627\u062c\u0647\u0629\u060c \u0648\u064a\u064f\u0637\u0628\u064e\u0651\u0642 \u0628\u0627\u0644\u0637\u0631\u064a\u0642\u0629 \u0646\u0641\u0633\u0647\u0627 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0648\u0641\u064a \u0646\u0645\u0648\u0630\u062c \u0625\u0639\u062f\u0627\u062f\u0627\u062a \u0627\u0644\u0625\u062f\u0627\u0631\u0629\n\u0648\u0641\u064a \u0623\u062f\u0627\u0629 MCP. \u0648\u064a\u064f\u0631\u0633\u064e\u0644 \u0627\u0644\u0646\u0635 \u0625\u0644\u0649 \u0627\u0644\u0646\u0645\u0648\u0630\u062c \u0641\u064a \u0643\u0644 \u062f\u0648\u0631 \u0645\u0646 \u0643\u0644 \u0645\u062d\u0627\u062f\u062b\u0629\u060c \u0641\u0647\u0648 \u062a\u0643\u0644\u0641\u0629 \u0645\u0627\u0644\u064a\u0629\n\u0628\u0642\u062f\u0631 \u0645\u0627 \u0647\u0648 \u0633\u064a\u0627\u0633\u0629.\n" } }, "tags": [ "Admin" ], "responses": { "200": { "description": "Both assistants' prompts.", "x-i18n": { "tr": { "description": "Her iki asistan\u0131n istemleri." }, "ar": { "description": "\u0645\u0648\u062c\u0651\u0647\u0627\u062a \u0643\u0650\u0644\u0627 \u0627\u0644\u0645\u0633\u0627\u0639\u062f\u064e\u064a\u0646." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/AiPrompts" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } }, "post": { "operationId": "updateAiPrompt", "summary": "Set or clear one assistant's operator guidance", "description": "Replaces the operator guidance appended to one assistant's system prompt, or clears\nit. Requires an `admin:write` token whose owner holds the `admin` or `super-admin`\nrole.\n\n`surface` names which assistant: `assistant` for the signed-in panel assistant,\n`public` for the anonymous marketing chat bubble. They are separate fields because\nthey are separate audiences, and neither can read the other's text.\n\n`guidance` must be present. `null` or an empty string CLEARS it and restores the\nbuilt-in prompt exactly; anything longer than `max_guidance` characters is refused\nwith `422` rather than truncated.\n\nThe built-in prompt itself cannot be written here or anywhere else \u2014 see the `GET`\non this path.\n\nEvery change to the settings row is recorded in the audit trail, whether it was made\nhere, in the admin settings form or through the MCP tool, with the acting token\nowner as the actor. Answers with the same document the `GET` returns, so a caller\ntuning the text sees the result of its own write without a second request.\n", "x-i18n": { "tr": { "summary": "Bir asistan\u0131n operat\u00f6r y\u00f6nergesini ayarla ya da temizle", "description": "Bir asistan\u0131n sistem istemine eklenen operat\u00f6r y\u00f6nergesini de\u011fi\u015ftirir ya da\ntemizler. Sahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:write`\nanahtar\u0131 gerektirir.\n\n`surface` hangi asistan\u0131n kastedildi\u011fini belirtir: oturum a\u00e7\u0131lm\u0131\u015f panel asistan\u0131\ni\u00e7in `assistant`, anonim tan\u0131t\u0131m sohbet balonu i\u00e7in `public`. Ayr\u0131 alanlard\u0131r,\n\u00e7\u00fcnk\u00fc ayr\u0131 kitlelere seslenirler ve hi\u00e7biri di\u011ferinin metnini okuyamaz.\n\n`guidance` alan\u0131 g\u00f6nderilmek zorundad\u0131r. `null` veya bo\u015f dize onu TEM\u0130ZLER ve\nyerle\u015fik istemi oldu\u011fu gibi geri getirir; `max_guidance` karakterden uzun bir\nmetin k\u0131rp\u0131lmaz, `422` ile reddedilir.\n\nYerle\u015fik istemin kendisi ne burada ne de ba\u015fka bir yerde yaz\u0131labilir \u2014 bu yoldaki\n`GET` i\u015flemine bak\u0131n.\n\nAyar sat\u0131r\u0131ndaki her de\u011fi\u015fiklik \u2014 ister burada, ister y\u00f6netim ayarlar\u0131 formunda,\nister MCP arac\u0131 \u00fczerinden yap\u0131lm\u0131\u015f olsun \u2014 i\u015flemi yapan anahtar\u0131n sahibi akt\u00f6r olarak\ndenetim izine kaydedilir. Yan\u0131t olarak `GET`'in d\u00f6nd\u00fcrd\u00fc\u011f\u00fc belgenin ayn\u0131s\u0131 verilir;\nb\u00f6ylece metni ince ayarlayan bir \u00e7a\u011f\u0131ran, kendi yazd\u0131\u011f\u0131n\u0131n sonucunu ikinci bir\nistek atmadan g\u00f6r\u00fcr.\n" }, "ar": { "summary": "\u0636\u0628\u0637 \u0625\u0631\u0634\u0627\u062f\u0627\u062a \u0627\u0644\u0645\u0634\u063a\u0651\u0644 \u0644\u0623\u062d\u062f \u0627\u0644\u0645\u0633\u0627\u0639\u062f\u064e\u064a\u0646 \u0623\u0648 \u0645\u0633\u062d\u0647\u0627", "description": "\u064a\u0633\u062a\u0628\u062f\u0644 \u0625\u0631\u0634\u0627\u062f\u0627\u062a \u0627\u0644\u0645\u0634\u063a\u0651\u0644 \u0627\u0644\u0645\u0636\u0627\u0641\u0629 \u0625\u0644\u0649 \u0645\u0648\u062c\u0651\u0647 \u0646\u0638\u0627\u0645 \u0623\u062d\u062f \u0627\u0644\u0645\u0633\u0627\u0639\u062f\u064e\u064a\u0646\u060c \u0623\u0648 \u064a\u0645\u0633\u062d\u0647\u0627. \u0648\u064a\u062a\u0637\u0644\u0651\u0628\n\u0631\u0645\u0632\u064b\u0627 \u0645\u0645\u064a\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:write` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`.\n\n\u064a\u062d\u062f\u0651\u062f `surface` \u0623\u064a\u0651 \u0645\u0633\u0627\u0639\u062f \u064a\u064f\u0642\u0635\u062f: `assistant` \u0644\u0645\u0633\u0627\u0639\u062f \u0627\u0644\u0644\u0648\u062d\u0629 \u0628\u0639\u062f \u062a\u0633\u062c\u064a\u0644 \u0627\u0644\u062f\u062e\u0648\u0644\u060c\n\u0648`public` \u0644\u0641\u0642\u0627\u0639\u0629 \u0627\u0644\u062f\u0631\u062f\u0634\u0629 \u0627\u0644\u062a\u0633\u0648\u064a\u0642\u064a\u0629 \u0627\u0644\u0645\u062c\u0647\u0648\u0644\u0629. \u0648\u0647\u0645\u0627 \u062d\u0642\u0644\u0627\u0646 \u0645\u0646\u0641\u0635\u0644\u0627\u0646 \u0644\u0623\u0646 \u062c\u0645\u0647\u0648\u0631\u0647\u0645\u0627\n\u0645\u0646\u0641\u0635\u0644\u060c \u0648\u0644\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0623\u062d\u062f\u0647\u0645\u0627 \u0642\u0631\u0627\u0621\u0629 \u0646\u0635 \u0627\u0644\u0622\u062e\u0631.\n\n\u064a\u062c\u0628 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0627\u0644\u062d\u0642\u0644 `guidance` \u0645\u0648\u062c\u0648\u062f\u064b\u0627. \u0648\u062a\u0624\u062f\u0651\u064a \u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0623\u0648 \u0627\u0644\u0633\u0644\u0633\u0644\u0629 \u0627\u0644\u0641\u0627\u0631\u063a\u0629 \u0625\u0644\u0649\n\u0645\u0633\u062d\u0647 \u0648\u0627\u0633\u062a\u0639\u0627\u062f\u0629 \u0627\u0644\u0645\u0648\u062c\u0651\u0647 \u0627\u0644\u0645\u062f\u0645\u062c \u0643\u0645\u0627 \u0647\u0648 \u062a\u0645\u0627\u0645\u064b\u0627\u061b \u0623\u0645\u0627 \u0627\u0644\u0646\u0635 \u0627\u0644\u0630\u064a \u064a\u062a\u062c\u0627\u0648\u0632 `max_guidance`\n\u0645\u062d\u0631\u0641\u064b\u0627 \u0641\u064a\u064f\u0631\u0641\u0636 \u0628\u0627\u0644\u0631\u0645\u0632 `422` \u0628\u062f\u0644 \u0623\u0646 \u064a\u064f\u0642\u062a\u0637\u0639.\n\n\u0648\u0644\u0627 \u064a\u0645\u0643\u0646 \u0643\u062a\u0627\u0628\u0629 \u0627\u0644\u0645\u0648\u062c\u0651\u0647 \u0627\u0644\u0645\u062f\u0645\u062c \u0646\u0641\u0633\u0647 \u0647\u0646\u0627 \u0648\u0644\u0627 \u0641\u064a \u0623\u064a \u0645\u0643\u0627\u0646 \u0622\u062e\u0631 \u2014 \u0631\u0627\u062c\u0639 \u0639\u0645\u0644\u064a\u0629 `GET` \u0639\u0644\u0649\n\u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631.\n\n\u0648\u064a\u064f\u0633\u062c\u064e\u0651\u0644 \u0643\u0644 \u062a\u063a\u064a\u064a\u0631 \u0639\u0644\u0649 \u0635\u0641 \u0627\u0644\u0625\u0639\u062f\u0627\u062f\u0627\u062a \u0641\u064a \u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642\u060c \u0633\u0648\u0627\u0621 \u062c\u0631\u0649 \u0647\u0646\u0627 \u0623\u0648 \u0641\u064a \u0646\u0645\u0648\u0630\u062c\n\u0625\u0639\u062f\u0627\u062f\u0627\u062a \u0627\u0644\u0625\u062f\u0627\u0631\u0629 \u0623\u0648 \u0639\u0628\u0631 \u0623\u062f\u0627\u0629 MCP\u060c \u0648\u064a\u0643\u0648\u0646 \u0635\u0627\u062d\u0628 \u0627\u0644\u0631\u0645\u0632 \u0627\u0644\u0645\u0645\u064a\u0632 \u0627\u0644\u0645\u0646\u0641\u0650\u0651\u0630 \u0647\u0648 \u0627\u0644\u0641\u0627\u0639\u0644. \u0648\u064a\u064f\u062c\u0627\u0628\n\u0628\u0627\u0644\u0645\u0633\u062a\u0646\u062f \u0646\u0641\u0633\u0647 \u0627\u0644\u0630\u064a \u062a\u0639\u064a\u062f\u0647 \u0639\u0645\u0644\u064a\u0629 `GET`\u060c \u0641\u064a\u0631\u0649 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0627\u0644\u0630\u064a \u064a\u0636\u0628\u0637 \u0627\u0644\u0646\u0635 \u0646\u062a\u064a\u062c\u0629 \u0643\u062a\u0627\u0628\u062a\u0647\n\u062f\u0648\u0646 \u0637\u0644\u0628 \u062b\u0627\u0646\u064d.\n" } }, "tags": [ "Admin" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "surface", "guidance" ], "properties": { "surface": { "type": "string", "enum": [ "assistant", "public" ], "description": "Which assistant to update.", "x-i18n": { "tr": { "description": "Hangi asistan\u0131n g\u00fcncellenece\u011fi." }, "ar": { "description": "\u0623\u064a \u0645\u0633\u0627\u0639\u062f \u0633\u064a\u062c\u0631\u064a \u062a\u062d\u062f\u064a\u062b\u0647." } } }, "guidance": { "type": "string", "nullable": true, "description": "The operator guidance to store, or null/empty to clear it.", "x-i18n": { "tr": { "description": "Saklanacak operat\u00f6r y\u00f6nergesi; temizlemek i\u00e7in null ya da bo\u015f b\u0131rak\u0131n." }, "ar": { "description": "\u0625\u0631\u0634\u0627\u062f\u0627\u062a \u0627\u0644\u0645\u0634\u063a\u0651\u0644 \u0627\u0644\u0645\u0631\u0627\u062f \u062a\u062e\u0632\u064a\u0646\u0647\u0627\u060c \u0623\u0648 null/\u0641\u0627\u0631\u063a \u0644\u0645\u0633\u062d\u0647\u0627." } } } } } } } }, "responses": { "200": { "description": "Both assistants' prompts, after the write.", "x-i18n": { "tr": { "description": "Yazma i\u015fleminden sonra her iki asistan\u0131n istemleri." }, "ar": { "description": "\u0645\u0648\u062c\u0651\u0647\u0627\u062a \u0643\u0650\u0644\u0627 \u0627\u0644\u0645\u0633\u0627\u0639\u062f\u064e\u064a\u0646 \u0628\u0639\u062f \u0639\u0645\u0644\u064a\u0629 \u0627\u0644\u0643\u062a\u0627\u0628\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/AiPrompts" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/audit-logs": { "get": { "operationId": "listAuditLogs", "summary": "List audit-trail rows", "description": "A page of the whole audit trail, newest first (`occurred_at` descending, `id`\nbreaking ties so a client can page it without seeing a row twice).\n\nRequires an `admin:read` token whose owner holds the `admin` (or `super-admin`)\nrole **and** the `audit.view` permission. The ability alone is not enough: a token\noutlives the role its holder had when it was minted, so the role is checked on\nevery request.\n\nThe trail is append-only and nothing reconciles it, so there is no `refresh`\nparameter and no polling semantics \u2014 a row never changes after it is written.\n\n`changes`, `context`, `hash` and `previous_hash` are not published; see the\n`AuditLog` schema for why. The hash chain is sealed and verified out of band by the\n`c2:verify-audit-chain` command, not through this API.\n\nAny query parameter not listed below is a `422`, rather than being ignored: a\nclient that mistypes a filter would otherwise receive the whole unfiltered trail\nand believe it had asked a narrower question.\n", "x-i18n": { "tr": { "summary": "Denetim izi kay\u0131tlar\u0131n\u0131 listele", "description": "Denetim izinin tamam\u0131ndan bir sayfa, en yenisi ba\u015fta (`occurred_at` azalan, e\u015fitli\u011fi\n`id` bozar; b\u00f6ylece bir istemci ayn\u0131 kayd\u0131 iki kez g\u00f6rmeden sayfalar aras\u0131nda\nilerleyebilir).\n\nSahibi `admin` (ya da `super-admin`) rol\u00fcn\u00fc **ve** `audit.view` yetkisini ta\u015f\u0131yan\nbir `admin:read` anahtar\u0131 gerektirir. \u0130zin tek ba\u015f\u0131na yetmez: bir anahtar, sahibinin\nonu olu\u015fturdu\u011fu andaki rol\u00fcnden daha uzun ya\u015far; bu y\u00fczden rol her istekte yeniden\ndenetlenir.\n\nDenetim izine yaln\u0131zca ekleme yap\u0131l\u0131r ve hi\u00e7bir \u015fey onu e\u015fitlemez; bu y\u00fczden ne\n`refresh` parametresi ne de yoklama davran\u0131\u015f\u0131 vard\u0131r \u2014 bir kay\u0131t yaz\u0131ld\u0131ktan sonra\nasla de\u011fi\u015fmez.\n\n`changes`, `context`, `hash` ve `previous_hash` yay\u0131mlanmaz; nedeni i\u00e7in `AuditLog`\n\u015femas\u0131na bak\u0131n. \u00d6zet zinciri m\u00fch\u00fcrl\u00fcd\u00fcr ve bu API \u00fczerinden de\u011fil,\n`c2:verify-audit-chain` komutuyla ayr\u0131 bir kanaldan do\u011frulan\u0131r.\n\nA\u015fa\u011f\u0131da listelenmeyen her sorgu parametresi yok say\u0131lmaz, `422` ile kar\u015f\u0131lan\u0131r: aksi\nh\u00e2lde bir filtreyi yanl\u0131\u015f yazan istemci, denetim izinin tamam\u0131n\u0131 filtresiz al\u0131r ve\ndaha dar bir soru sordu\u011funu san\u0131r.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0633\u062c\u0644\u0627\u062a \u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642", "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642 \u0643\u0627\u0645\u0644\u064b\u0627\u060c \u0627\u0644\u0623\u062d\u062f\u062b \u0623\u0648\u0644\u064b\u0627 (`occurred_at` \u062a\u0646\u0627\u0632\u0644\u064a\u064b\u0627\u060c \u0648`id` \u064a\u0641\u0635\u0644\n\u0627\u0644\u062a\u0633\u0627\u0648\u064a \u062d\u062a\u0649 \u064a\u0633\u062a\u0637\u064a\u0639 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u062a\u0646\u0642\u0651\u0644 \u0628\u064a\u0646 \u0627\u0644\u0635\u0641\u062d\u0627\u062a \u062f\u0648\u0646 \u0623\u0646 \u064a\u0631\u0649 \u0627\u0644\u0633\u062c\u0644 \u0646\u0641\u0633\u0647 \u0645\u0631\u062a\u064a\u0646).\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0645\u0645\u064a\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` (\u0623\u0648 `super-admin`) **\u0648** \u0635\u0644\u0627\u062d\u064a\u0629\n`audit.view`. \u0648\u0644\u0627 \u062a\u0643\u0641\u064a \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 \u0648\u062d\u062f\u0647\u0627: \u0641\u0627\u0644\u0631\u0645\u0632 \u064a\u0628\u0642\u0649 \u0628\u0639\u062f \u0627\u0644\u062f\u0648\u0631 \u0627\u0644\u0630\u064a \u0643\u0627\u0646 \u0635\u0627\u062d\u0628\u0647\n\u064a\u062d\u0645\u0644\u0647 \u0639\u0646\u062f \u0625\u0635\u062f\u0627\u0631\u0647\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u064f\u0641\u062d\u0635 \u0627\u0644\u062f\u0648\u0631 \u0641\u064a \u0643\u0644 \u0637\u0644\u0628.\n\n\u0648\u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642 \u064a\u064f\u0636\u0627\u0641 \u0625\u0644\u064a\u0647 \u0641\u0642\u0637 \u0648\u0644\u0627 \u062a\u062c\u0631\u064a \u0644\u0647 \u0623\u064a \u0645\u0637\u0627\u0628\u0642\u0629\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh`\n\u0648\u0644\u0627 \u062f\u0644\u0627\u0644\u0627\u062a \u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u062f\u0648\u0631\u064a \u2014 \u0641\u0627\u0644\u0633\u062c\u0644 \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0623\u0628\u062f\u064b\u0627 \u0628\u0639\u062f \u0643\u062a\u0627\u0628\u062a\u0647.\n\n\u0648\u0644\u0627 \u062a\u064f\u0646\u0634\u0631 \u0627\u0644\u062d\u0642\u0648\u0644 `changes` \u0648`context` \u0648`hash` \u0648`previous_hash`\u061b \u0631\u0627\u062c\u0639 \u0645\u062e\u0637\u0637\n`AuditLog` \u0644\u0645\u0639\u0631\u0641\u0629 \u0627\u0644\u0633\u0628\u0628. \u0648\u0633\u0644\u0633\u0644\u0629 \u0627\u0644\u0628\u0635\u0645\u0627\u062a \u0645\u062e\u062a\u0648\u0645\u0629 \u0648\u064a\u062c\u0631\u064a \u0627\u0644\u062a\u062d\u0642\u0642 \u0645\u0646\u0647\u0627 \u062e\u0627\u0631\u062c \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629\n\u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0628\u0627\u0644\u0623\u0645\u0631 `c2:verify-audit-chain`.\n\n\u0648\u0623\u064a \u0645\u0639\u0627\u0645\u0644 \u0627\u0633\u062a\u0639\u0644\u0627\u0645 \u063a\u064a\u0631 \u0645\u0630\u0643\u0648\u0631 \u0623\u062f\u0646\u0627\u0647 \u064a\u0624\u062f\u064a \u0625\u0644\u0649 `422` \u0628\u062f\u0644 \u0623\u0646 \u064a\u064f\u062a\u062c\u0627\u0647\u0644: \u0641\u0644\u0648\u0644\u0627 \u0630\u0644\u0643 \u0644\u062a\u0644\u0642\u0651\u0649\n\u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u064a\u062e\u0637\u0626 \u0641\u064a \u0643\u062a\u0627\u0628\u0629 \u0627\u0633\u0645 \u0645\u0631\u0634\u0650\u0651\u062d \u0633\u062c\u0644\u064e\u0651 \u0627\u0644\u062a\u062f\u0642\u064a\u0642 \u0643\u0627\u0645\u0644\u064b\u0627 \u0628\u0644\u0627 \u062a\u0631\u0634\u064a\u062d\u060c \u0648\u0647\u0648 \u064a\u0638\u0646 \u0623\u0646\u0647\n\u0637\u0631\u062d \u0633\u0624\u0627\u0644\u064b\u0627 \u0623\u0636\u064a\u0642.\n" } }, "tags": [ "Admin" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" }, { "name": "actor_id", "in": "query", "required": false, "description": "Only rows written by this user.", "x-i18n": { "tr": { "description": "Yaln\u0131zca bu kullan\u0131c\u0131n\u0131n yazd\u0131\u011f\u0131 kay\u0131tlar." }, "ar": { "description": "\u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u062a\u064a \u0643\u062a\u0628\u0647\u0627 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645 \u0641\u0642\u0637." } }, "schema": { "type": "integer", "minimum": 1 } }, { "name": "subject_id", "in": "query", "required": false, "description": "Only rows whose data subject is this user.", "x-i18n": { "tr": { "description": "Yaln\u0131zca veri sahibi bu kullan\u0131c\u0131 olan kay\u0131tlar." }, "ar": { "description": "\u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u062a\u064a \u064a\u0643\u0648\u0646 \u0635\u0627\u062d\u0628 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0641\u064a\u0647\u0627 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645 \u0641\u0642\u0637." } }, "schema": { "type": "integer", "minimum": 1 } }, { "name": "event", "in": "query", "required": false, "description": "Substring match against the dotted event name.", "x-i18n": { "tr": { "description": "Noktal\u0131 olay ad\u0131 i\u00e7inde alt dize e\u015fle\u015fmesi." }, "ar": { "description": "\u0645\u0637\u0627\u0628\u0642\u0629 \u0646\u0635 \u062c\u0632\u0626\u064a \u0645\u0639 \u0627\u0633\u0645 \u0627\u0644\u062d\u062f\u062b \u0627\u0644\u0645\u0646\u0642\u0648\u0637." } }, "schema": { "type": "string", "maxLength": 96 } }, { "name": "domain", "in": "query", "required": false, "description": "Kept in lock-step with `App\\Enums\\AuditDomain`, which is what\n`IndexAuditLogRequest` derives its own validation rule from \u2014 see the\n`AuditLog` schema's `domain` field.\n", "x-i18n": { "tr": { "description": "`App\\Enums\\AuditDomain` ile birebir ayn\u0131 tutulur; `IndexAuditLogRequest` de\nkendi do\u011frulama kural\u0131n\u0131 buradan t\u00fcretir \u2014 `AuditLog` \u015femas\u0131ndaki `domain`\nalan\u0131na bak\u0131n.\n" }, "ar": { "description": "\u064a\u064f\u0628\u0642\u0649 \u0645\u062a\u0637\u0627\u0628\u0642\u064b\u0627 \u062a\u0645\u0627\u0645\u064b\u0627 \u0645\u0639 `App\\Enums\\AuditDomain`\u060c \u0648\u0647\u0648 \u0645\u0627 \u064a\u0634\u062a\u0642\u0651 \u0645\u0646\u0647\n`IndexAuditLogRequest` \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u062a\u062d\u0642\u0642 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0647 \u2014 \u0631\u0627\u062c\u0639 \u062d\u0642\u0644 `domain` \u0641\u064a \u0645\u062e\u0637\u0637\n`AuditLog`.\n" } }, "schema": { "type": "string", "enum": [ "cloud", "billing", "dns", "tickets", "account", "auth", "shop", "privacy", "partner", "system" ] } }, { "name": "from", "in": "query", "required": false, "description": "Inclusive lower bound on `occurred_at`.", "x-i18n": { "tr": { "description": "`occurred_at` i\u00e7in alt s\u0131n\u0131r (d\u00e2hil)." }, "ar": { "description": "\u0627\u0644\u062d\u062f \u0627\u0644\u0623\u062f\u0646\u0649 \u0644\u0640 `occurred_at`\u060c \u0634\u0627\u0645\u0644\u064b\u0627 \u0625\u064a\u0627\u0647." } }, "schema": { "type": "string", "format": "date-time" } }, { "name": "to", "in": "query", "required": false, "description": "Inclusive upper bound on `occurred_at`.", "x-i18n": { "tr": { "description": "`occurred_at` i\u00e7in \u00fcst s\u0131n\u0131r (d\u00e2hil)." }, "ar": { "description": "\u0627\u0644\u062d\u062f \u0627\u0644\u0623\u0639\u0644\u0649 \u0644\u0640 `occurred_at`\u060c \u0634\u0627\u0645\u0644\u064b\u0627 \u0625\u064a\u0627\u0647." } }, "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "A page of audit rows.", "x-i18n": { "tr": { "description": "Denetim kay\u0131tlar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0633\u062c\u0644\u0627\u062a \u0627\u0644\u062a\u062f\u0642\u064a\u0642." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AuditLog" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/audit-logs/{auditLog}": { "get": { "operationId": "getAuditLog", "summary": "Get one audit-trail row", "description": "One row of the append-only trail.\n\nThis is the only endpoint on the staff surface that answers `403` rather than\n`404` for a row the caller may not read. Elsewhere a resource outside the caller's\nscope is indistinguishable from one that does not exist, because scoping there is\nper-customer; the trail is a single global collection, so \"this row exists but is\nnot yours to read\" is the honest answer.\n\nUnlike the collection, this path carries no `audit.view` requirement in its\nmiddleware \u2014 authorization is the `AuditLogPolicy`, which admits an admin holding\n`audit.view`, the row's own data subject reading their own trail, and a support\nagent holding at least `view` on the row's domain for that row's subject. Rows in\nthe `auth`, `shop`, `privacy` and `system` domains have no support equivalent and\nare never visible to a support agent.\n\n`changes`, `context`, `hash` and `previous_hash` are not published; see the\n`AuditLog` schema.\n", "x-i18n": { "tr": { "summary": "Denetim izindeki tek bir kayd\u0131 getir", "description": "Yaln\u0131zca ekleme yap\u0131lan denetim izinin tek bir kayd\u0131.\n\n\u00c7a\u011f\u0131ran\u0131n okumaya yetkili olmad\u0131\u011f\u0131 bir kay\u0131t i\u00e7in `404` yerine `403` yan\u0131t\u0131 veren,\npersonel aray\u00fcz\u00fcndeki tek u\u00e7 nokta budur. Ba\u015fka yerlerde kapsam m\u00fc\u015fteri bazl\u0131\noldu\u011fundan, \u00e7a\u011f\u0131ran\u0131n kapsam\u0131 d\u0131\u015f\u0131ndaki bir kaynak ile var olmayan bir kaynak\nbirbirinden ay\u0131rt edilemez; denetim izi ise tek ve genel bir koleksiyondur,\ndolay\u0131s\u0131yla \u201cbu kay\u0131t var ama okumas\u0131 size ait de\u011fil\u201d d\u00fcr\u00fcst yan\u0131tt\u0131r.\n\nKoleksiyonun aksine bu yol, ara katman\u0131nda `audit.view` \u015fart\u0131 ta\u015f\u0131maz \u2014\nyetkilendirmeyi `AuditLogPolicy` yapar: `audit.view` yetkisine sahip bir y\u00f6neticiyi,\nkendi izini okuyan veri sahibini ve kayd\u0131n veri sahibi bak\u0131m\u0131ndan, kayd\u0131n\nalan\u0131nda en az `view` d\u00fczeyi ta\u015f\u0131yan bir destek temsilcisini kabul eder. `auth`,\n`shop`, `privacy` ve `system` alanlar\u0131ndaki kay\u0131tlar\u0131n destek taraf\u0131nda bir\nkar\u015f\u0131l\u0131\u011f\u0131 yoktur ve bir destek temsilcisine asla g\u00f6r\u00fcnmezler.\n\n`changes`, `context`, `hash` ve `previous_hash` yay\u0131mlanmaz; `AuditLog` \u015femas\u0131na\nbak\u0131n.\n" }, "ar": { "summary": "\u062c\u0644\u0628 \u0633\u062c\u0644 \u0648\u0627\u062d\u062f \u0645\u0646 \u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642", "description": "\u0633\u062c\u0644 \u0648\u0627\u062d\u062f \u0645\u0646 \u0627\u0644\u0633\u062c\u0644 \u0627\u0644\u0630\u064a \u064a\u064f\u0636\u0627\u0641 \u0625\u0644\u064a\u0647 \u0641\u0642\u0637.\n\n\u0647\u0630\u0647 \u0647\u064a \u0646\u0642\u0637\u0629 \u0627\u0644\u0646\u0647\u0627\u064a\u0629 \u0627\u0644\u0648\u062d\u064a\u062f\u0629 \u0641\u064a \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0645\u0648\u0638\u0641\u064a\u0646 \u0627\u0644\u062a\u064a \u062a\u062c\u064a\u0628 \u0628\u0627\u0644\u0631\u0645\u0632 `403` \u0628\u062f\u0644 `404`\n\u0639\u0646 \u0633\u062c\u0644 \u0644\u0627 \u064a\u062d\u0642 \u0644\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0642\u0631\u0627\u0621\u062a\u0647. \u0641\u0641\u064a \u0627\u0644\u0645\u0648\u0627\u0636\u0639 \u0627\u0644\u0623\u062e\u0631\u0649 \u0644\u0627 \u064a\u0645\u0643\u0646 \u062a\u0645\u064a\u064a\u0632 \u0645\u0648\u0631\u062f \u062e\u0627\u0631\u062c \u0646\u0637\u0627\u0642\n\u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0639\u0646 \u0645\u0648\u0631\u062f \u063a\u064a\u0631 \u0645\u0648\u062c\u0648\u062f\u060c \u0644\u0623\u0646 \u0627\u0644\u0646\u0637\u0627\u0642 \u0647\u0646\u0627\u0643 \u0645\u062d\u062f\u064e\u0651\u062f \u0644\u0643\u0644 \u0639\u0645\u064a\u0644\u061b \u0623\u0645\u0627 \u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642\n\u0641\u0645\u062c\u0645\u0648\u0639\u0629 \u0639\u0627\u0645\u0629 \u0648\u0627\u062d\u062f\u0629\u060c \u0648\u0644\u0630\u0644\u0643 \u0641\u0625\u0646 \u0627\u0644\u0642\u0648\u0644 \u00ab\u0647\u0630\u0627 \u0627\u0644\u0633\u062c\u0644 \u0645\u0648\u062c\u0648\u062f \u0644\u0643\u0646 \u0642\u0631\u0627\u0621\u062a\u0647 \u0644\u064a\u0633\u062a \u0645\u0646 \u062d\u0642\u0643\u00bb \u0647\u0648\n\u0627\u0644\u062c\u0648\u0627\u0628 \u0627\u0644\u0635\u0627\u062f\u0642.\n\n\u0648\u062e\u0644\u0627\u0641\u064b\u0627 \u0644\u0644\u0645\u062c\u0645\u0648\u0639\u0629\u060c \u0644\u0627 \u064a\u062d\u0645\u0644 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u0634\u0631\u0637 `audit.view` \u0641\u064a \u0648\u0633\u064a\u0637\u062a\u0647 \u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u2014 \u0625\u0630\n\u064a\u062a\u0648\u0644\u0651\u0649 \u0627\u0644\u062a\u062e\u0648\u064a\u0644 `AuditLogPolicy`\u060c \u0641\u064a\u0633\u0645\u062d \u0644\u0645\u062f\u064a\u0631 \u064a\u062d\u0645\u0644 `audit.view`\u060c \u0648\u0644\u0635\u0627\u062d\u0628 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a\n\u0646\u0641\u0633\u0647 \u0648\u0647\u0648 \u064a\u0642\u0631\u0623 \u0633\u062c\u0644\u0651\u0647\u060c \u0648\u0644\u0645\u0648\u0638\u0641 \u062f\u0639\u0645 \u064a\u062d\u0645\u0644 \u0645\u0633\u062a\u0648\u0649 `view` \u0639\u0644\u0649 \u0627\u0644\u0623\u0642\u0644 \u0641\u064a \u0646\u0637\u0627\u0642 \u0627\u0644\u0633\u062c\u0644 \u062a\u062c\u0627\u0647\n\u0635\u0627\u062d\u0628 \u0630\u0644\u0643 \u0627\u0644\u0633\u062c\u0644. \u0623\u0645\u0627 \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0641\u064a \u0627\u0644\u0646\u0637\u0627\u0642\u0627\u062a `auth` \u0648`shop` \u0648`privacy` \u0648`system` \u0641\u0644\u0627\n\u0645\u0642\u0627\u0628\u0644 \u0644\u0647\u0627 \u0641\u064a \u0627\u0644\u062f\u0639\u0645 \u0648\u0644\u0627 \u062a\u0638\u0647\u0631 \u0644\u0645\u0648\u0638\u0641 \u0627\u0644\u062f\u0639\u0645 \u0623\u0628\u062f\u064b\u0627.\n\n\u0648\u0644\u0627 \u062a\u064f\u0646\u0634\u0631 \u0627\u0644\u062d\u0642\u0648\u0644 `changes` \u0648`context` \u0648`hash` \u0648`previous_hash`\u061b \u0631\u0627\u062c\u0639 \u0645\u062e\u0637\u0637\n`AuditLog`.\n" } }, "tags": [ "Admin" ], "parameters": [ { "name": "auditLog", "in": "path", "required": true, "description": "The audit row id.", "x-i18n": { "tr": { "description": "Denetim kayd\u0131n\u0131n id de\u011feri." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642." } }, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "The audit row.", "x-i18n": { "tr": { "description": "Denetim kayd\u0131." }, "ar": { "description": "\u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/AuditLog" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/support-assignments": { "get": { "operationId": "listSupportAssignments", "summary": "List the support-assignment matrix", "description": "Every row of the support-assignment table, most recently updated first: which\nagent may act on which customer, and at what level in each of the five domains.\n\nRequires an `admin:read` token whose owner holds the `admin` (or `super-admin`)\nrole and the `support.manage` permission. The panel's equivalent route is gated\n`role_or_permission:super-admin|support.manage`; a `super-admin` who does not\nliterally hold the permission is admitted here too, through the application's\ngod-mode gate, which makes the two equivalent. That equivalence is proven by test\nrather than assumed.\n\nRead-only. This table is the control plane for every gate on the `Support`\nsurface: a token that could write it could grant any agent `manage` over any\ncustomer, and no policy stands behind such a route. Exposing the write side needs\nits own threat model, not a verb.\n\nBoth sides are projected to `{id, name, email}` and are `null` when the account\nhas been deleted. Publishing the matrix read-only lets an operator diff intended\naccess against actual access without touching either.\n", "x-i18n": { "tr": { "summary": "Destek atama matrisini listele", "description": "Destek atama tablosunun her sat\u0131r\u0131, en son g\u00fcncellenen ba\u015fta: hangi temsilcinin\nhangi m\u00fc\u015fteri \u00fczerinde i\u015flem yapabilece\u011fi ve be\u015f alan\u0131n her birinde hangi d\u00fczeyde.\n\nSahibi `admin` (ya da `super-admin`) rol\u00fcn\u00fc ve `support.manage` yetkisini ta\u015f\u0131yan bir\n`admin:read` anahtar\u0131 gerektirir. Paneldeki kar\u015f\u0131l\u0131\u011f\u0131 olan rota\n`role_or_permission:super-admin|support.manage` ile korunur; yetkiyi harfiyen ta\u015f\u0131mayan\nbir `super-admin` da uygulaman\u0131n her kap\u0131y\u0131 a\u00e7an yetki ge\u00e7idi sayesinde buraya kabul\nedilir ve bu, ikisini e\u015fde\u011fer k\u0131lar. Bu e\u015fde\u011ferlik varsay\u0131lmaz, testle kan\u0131tlan\u0131r.\n\nSalt okunurdur. Bu tablo, `Support` aray\u00fcz\u00fcndeki her yetki ge\u00e7idinin denetim\nd\u00fczlemidir: onu yazabilen bir anahtar, herhangi bir temsilciye herhangi bir m\u00fc\u015fteri\n\u00fczerinde `manage` verebilirdi ve b\u00f6yle bir rotan\u0131n arkas\u0131nda duran bir politika\nyoktur. Yazma taraf\u0131n\u0131 a\u00e7mak, yeni bir HTTP fiili de\u011fil, kendine ait bir tehdit\nmodeli ister.\n\nHer iki taraf da `{id, name, email}` alanlar\u0131na indirgenir ve hesap silinmi\u015fse\n`null` olur. Matrisin salt okunur yay\u0131mlanmas\u0131, bir operat\u00f6r\u00fcn ama\u00e7lanan eri\u015fim ile\nger\u00e7ekle\u015fen eri\u015fimi hi\u00e7birine dokunmadan kar\u015f\u0131la\u015ft\u0131rmas\u0131na imk\u00e2n verir.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0645\u0635\u0641\u0648\u0641\u0629 \u062a\u0639\u064a\u064a\u0646\u0627\u062a \u0627\u0644\u062f\u0639\u0645", "description": "\u0643\u0644 \u0635\u0641 \u0645\u0646 \u062c\u062f\u0648\u0644 \u062a\u0639\u064a\u064a\u0646\u0627\u062a \u0627\u0644\u062f\u0639\u0645\u060c \u0627\u0644\u0623\u062d\u062f\u062b \u062a\u062d\u062f\u064a\u062b\u064b\u0627 \u0623\u0648\u0644\u064b\u0627: \u0623\u064a \u0645\u0648\u0638\u0641 \u064a\u062c\u0648\u0632 \u0644\u0647 \u0627\u0644\u062a\u0635\u0631\u0651\u0641 \u062a\u062c\u0627\u0647\n\u0623\u064a \u0639\u0645\u064a\u0644\u060c \u0648\u0628\u0623\u064a \u0645\u0633\u062a\u0648\u0649 \u0641\u064a \u0643\u0644 \u0646\u0637\u0627\u0642 \u0645\u0646 \u0627\u0644\u0646\u0637\u0627\u0642\u0627\u062a \u0627\u0644\u062e\u0645\u0633\u0629.\n\n\u0648\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0645\u0645\u064a\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` (\u0623\u0648 `super-admin`) \u0648\u0635\u0644\u0627\u062d\u064a\u0629\n`support.manage`. \u0648\u0627\u0644\u0645\u0633\u0627\u0631 \u0627\u0644\u0645\u0642\u0627\u0628\u0644 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0645\u062d\u0645\u064a\u0651 \u0628\u0640\n`role_or_permission:super-admin|support.manage`\u061b \u0648\u064a\u064f\u0642\u0628\u0644 \u0647\u0646\u0627 \u0623\u064a\u0636\u064b\u0627 `super-admin` \u0644\u0627\n\u064a\u062d\u0645\u0644 \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 \u062d\u0631\u0641\u064a\u064b\u0627\u060c \u0639\u0628\u0631 \u0628\u0648\u0627\u0628\u0629 \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 \u0627\u0644\u0645\u0637\u0644\u0642\u0629 \u0641\u064a \u0627\u0644\u062a\u0637\u0628\u064a\u0642\u060c \u0648\u0647\u0648 \u0645\u0627 \u064a\u062c\u0639\u0644 \u0627\u0644\u0627\u062b\u0646\u064a\u0646\n\u0645\u062a\u0643\u0627\u0641\u0626\u064a\u0646. \u0648\u0647\u0630\u0627 \u0627\u0644\u062a\u0643\u0627\u0641\u0624 \u0645\u064f\u062b\u0628\u064e\u062a \u0628\u0627\u062e\u062a\u0628\u0627\u0631 \u0644\u0627 \u0645\u0641\u062a\u0631\u064e\u0636.\n\n\u0648\u0647\u0630\u0647 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0644\u0644\u0642\u0631\u0627\u0621\u0629 \u0641\u0642\u0637. \u0641\u0647\u0630\u0627 \u0627\u0644\u062c\u062f\u0648\u0644 \u0647\u0648 \u0645\u0633\u062a\u0648\u0649 \u0627\u0644\u062a\u062d\u0643\u0651\u0645 \u0644\u0643\u0644 \u0628\u0648\u0627\u0628\u0629 \u0639\u0644\u0649 \u0648\u0627\u062c\u0647\u0629\n`Support`: \u0648\u0627\u0644\u0631\u0645\u0632 \u0627\u0644\u0642\u0627\u062f\u0631 \u0639\u0644\u0649 \u0627\u0644\u0643\u062a\u0627\u0628\u0629 \u0641\u064a\u0647 \u0643\u0627\u0646 \u0628\u0625\u0645\u0643\u0627\u0646\u0647 \u0645\u0646\u062d \u0623\u064a \u0645\u0648\u0638\u0641 \u0645\u0633\u062a\u0648\u0649 `manage` \u0639\u0644\u0649\n\u0623\u064a \u0639\u0645\u064a\u0644\u060c \u0648\u0644\u0627 \u0633\u064a\u0627\u0633\u0629 \u062a\u0642\u0641 \u062e\u0644\u0641 \u0645\u0633\u0627\u0631 \u0643\u0647\u0630\u0627. \u0648\u0643\u0634\u0641 \u062c\u0627\u0646\u0628 \u0627\u0644\u0643\u062a\u0627\u0628\u0629 \u064a\u062d\u062a\u0627\u062c \u0646\u0645\u0648\u0630\u062c \u062a\u0647\u062f\u064a\u062f \u062e\u0627\u0635\u064b\u0627 \u0628\u0647\u060c\n\u0644\u0627 \u0645\u062c\u0631\u0651\u062f \u0625\u0636\u0627\u0641\u0629 \u0641\u0639\u0644 HTTP.\n\n\u0648\u064a\u064f\u062e\u062a\u0635\u0631 \u0627\u0644\u0637\u0631\u0641\u0627\u0646 \u0625\u0644\u0649 `{id, name, email}`\u060c \u0648\u064a\u0643\u0648\u0646\u0627\u0646 `null` \u0625\u0630\u0627 \u0643\u0627\u0646 \u0627\u0644\u062d\u0633\u0627\u0628 \u0642\u062f \u062d\u064f\u0630\u0641.\n\u0648\u0646\u0634\u0631 \u0627\u0644\u0645\u0635\u0641\u0648\u0641\u0629 \u0644\u0644\u0642\u0631\u0627\u0621\u0629 \u0641\u0642\u0637 \u064a\u062a\u064a\u062d \u0644\u0644\u0645\u0634\u063a\u0651\u0644 \u0623\u0646 \u064a\u0642\u0627\u0631\u0646 \u0627\u0644\u0648\u0635\u0648\u0644 \u0627\u0644\u0645\u0642\u0635\u0648\u062f \u0628\u0627\u0644\u0648\u0635\u0648\u0644 \u0627\u0644\u0641\u0639\u0644\u064a \u062f\u0648\u0646\n\u0627\u0644\u0645\u0633\u0627\u0633 \u0628\u0623\u064a\u0651\u0647\u0645\u0627.\n" } }, "tags": [ "Admin" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of assignment rows.", "x-i18n": { "tr": { "description": "Atama kay\u0131tlar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0635\u0641\u0648\u0641 \u0627\u0644\u062a\u0639\u064a\u064a\u0646\u0627\u062a." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/SupportAssignment" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/staged-actions": { "get": { "operationId": "listStagedActions", "summary": "List the approval queue", "description": "Every action a token has asked for and a person decides \u2014 a news item to publish, and\nlater kinds \u2014 newest first, with what it will do (`preview`), who asked, and what became\nof it. Poll this, or the single entry, to learn whether a request was approved, rejected,\nlapsed or failed.\n\nRequires an `admin:read` token whose owner holds the `admin` or `super-admin` role.\n\n**Read-only, and deliberately so.** No endpoint on this API approves or rejects an\nentry: that is a click by a signed-in administrator on the panel's approvals page\n(`approval_url`). A token can only ask. The frozen payload is not published; `preview`\nis the sentence the approver reads.\n", "x-i18n": { "tr": { "summary": "Onay kuyru\u011funu listele", "description": "Bir anahtar\u0131n istedi\u011fi ve bir ki\u015finin karar verdi\u011fi her eylem \u2014 yay\u0131mlanacak bir\nduyuru ve ileride eklenecek t\u00fcrler \u2014 en yenisi ba\u015fta; ne yapaca\u011f\u0131 (`preview`), kimin\nistedi\u011fi ve sonunun ne oldu\u011fuyla birlikte. Bir iste\u011fin onaylan\u0131p onaylanmad\u0131\u011f\u0131n\u0131,\nreddedildi\u011fini, s\u00fcresinin doldu\u011funu ya da ba\u015far\u0131s\u0131z oldu\u011funu \u00f6\u011frenmek i\u00e7in bu listeyi\nveya tek kayd\u0131 yoklay\u0131n.\n\nSahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:read` anahtar\u0131 gerektirir.\n\n**Salt okunurdur ve bu bilin\u00e7li bir tercihtir.** Bu API'deki hi\u00e7bir u\u00e7 nokta bir kayd\u0131\nonaylamaz ya da reddetmez: bu, oturum a\u00e7m\u0131\u015f bir y\u00f6neticinin paneldeki onaylar\nsayfas\u0131nda (`approval_url`) yapt\u0131\u011f\u0131 bir t\u0131klamad\u0131r. Bir anahtar yaln\u0131zca isteyebilir.\nDondurulmu\u015f y\u00fck yay\u0131mlanmaz; `preview`, onaylayan\u0131n okudu\u011fu c\u00fcmledir.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0642\u0627\u0626\u0645\u0629 \u0627\u0646\u062a\u0638\u0627\u0631 \u0627\u0644\u0645\u0648\u0627\u0641\u0642\u0627\u062a", "description": "\u0643\u0644 \u0625\u062c\u0631\u0627\u0621 \u0637\u0644\u0628\u0647 \u0631\u0645\u0632 \u0648\u064a\u0642\u0631\u0651\u0631\u0647 \u0634\u062e\u0635 \u2014 \u062e\u0628\u0631 \u064a\u064f\u0631\u0627\u062f \u0646\u0634\u0631\u0647\u060c \u0648\u0623\u0646\u0648\u0627\u0639 \u0623\u062e\u0631\u0649 \u062a\u064f\u0636\u0627\u0641 \u0644\u0627\u062d\u0642\u064b\u0627 \u2014 \u0627\u0644\u0623\u062d\u062f\u062b\n\u0623\u0648\u0644\u064b\u0627\u060c \u0645\u0639 \u0645\u0627 \u0633\u064a\u0641\u0639\u0644\u0647 (`preview`) \u0648\u0645\u0646 \u0637\u0644\u0628\u0647 \u0648\u0645\u0627 \u0622\u0644 \u0625\u0644\u064a\u0647. \u0627\u0633\u062a\u0637\u0644\u0639 \u0647\u0630\u0647 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0623\u0648 \u0627\u0644\u0633\u062c\u0644\n\u0627\u0644\u0645\u0641\u0631\u062f \u0644\u062a\u0639\u0631\u0641 \u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646 \u0627\u0644\u0637\u0644\u0628 \u0642\u062f \u0648\u064f\u0648\u0641\u0642 \u0639\u0644\u064a\u0647 \u0623\u0648 \u0631\u064f\u0641\u0636 \u0623\u0648 \u0627\u0646\u062a\u0647\u062a \u0645\u0647\u0644\u062a\u0647 \u0623\u0648 \u0641\u0634\u0644.\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`.\n\n**\u0644\u0644\u0642\u0631\u0627\u0621\u0629 \u0641\u0642\u0637\u060c \u0648\u0630\u0644\u0643 \u0639\u0646 \u0642\u0635\u062f.** \u0644\u0627 \u062a\u0648\u062c\u062f \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0646\u0642\u0637\u0629 \u0646\u0647\u0627\u064a\u0629 \u062a\u0648\u0627\u0641\u0642 \u0639\u0644\u0649 \u0633\u062c\u0644 \u0623\u0648\n\u062a\u0631\u0641\u0636\u0647: \u0641\u0630\u0644\u0643 \u0646\u0642\u0631\u0629 \u064a\u0624\u062f\u064a\u0647\u0627 \u0645\u062f\u064a\u0631 \u0645\u0633\u062c\u064e\u0651\u0644 \u0627\u0644\u062f\u062e\u0648\u0644 \u0641\u064a \u0635\u0641\u062d\u0629 \u0627\u0644\u0645\u0648\u0627\u0641\u0642\u0627\u062a \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629\n(`approval_url`). \u0627\u0644\u0631\u0645\u0632 \u0644\u0627 \u064a\u0645\u0644\u0643 \u0625\u0644\u0627 \u0623\u0646 \u064a\u0637\u0644\u0628. \u0648\u0644\u0627 \u062a\u064f\u0646\u0634\u0631 \u0627\u0644\u062d\u0645\u0648\u0644\u0629 \u0627\u0644\u0645\u062c\u0645\u0651\u062f\u0629\u061b \u0648`preview`\n\u0647\u064a \u0627\u0644\u062c\u0645\u0644\u0629 \u0627\u0644\u062a\u064a \u064a\u0642\u0631\u0624\u0647\u0627 \u0645\u0646 \u064a\u0648\u0627\u0641\u0642.\n" } }, "tags": [ "Admin" ], "parameters": [ { "name": "status", "in": "query", "required": false, "description": "Only entries in this state.", "x-i18n": { "tr": { "description": "Yaln\u0131zca bu durumdaki kay\u0131tlar." }, "ar": { "description": "\u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u062a\u064a \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u062d\u0627\u0644\u0629 \u0641\u0642\u0637." } }, "schema": { "type": "string", "enum": [ "pending", "approved", "rejected", "expired", "failed" ] } }, { "name": "action", "in": "query", "required": false, "description": "Only entries of this kind, for example `publish_news`. An unknown kind is refused with `422`.", "x-i18n": { "tr": { "description": "Yaln\u0131zca bu t\u00fcrdeki kay\u0131tlar; \u00f6rne\u011fin `publish_news`. Bilinmeyen bir t\u00fcr `422` ile reddedilir." }, "ar": { "description": "\u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0645\u0646 \u0647\u0630\u0627 \u0627\u0644\u0646\u0648\u0639 \u0641\u0642\u0637\u060c \u0645\u062b\u0644 `publish_news`. \u0648\u064a\u064f\u0631\u0641\u0636 \u0627\u0644\u0646\u0648\u0639 \u063a\u064a\u0631 \u0627\u0644\u0645\u0639\u0631\u0648\u0641 \u0628\u0627\u0644\u0631\u0645\u0632 `422`." } }, "schema": { "type": "string" } }, { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of queue entries.", "x-i18n": { "tr": { "description": "Kuyruk kay\u0131tlar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0633\u062c\u0644\u0627\u062a \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StagedAction" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/staged-actions/{stagedAction}": { "get": { "operationId": "getStagedAction", "summary": "Get one approval-queue entry", "description": "One entry of the approval queue, by the `staged_action_id` the request that created it\nreturned. `status` moves from `pending` to exactly one of `approved`, `rejected`,\n`expired` or `failed`, and never back.\n\nRequires an `admin:read` token whose owner holds the `admin` or `super-admin` role.\nRead-only: see the listing for why.\n", "x-i18n": { "tr": { "summary": "Onay kuyru\u011fundaki tek bir kayd\u0131 getir", "description": "Onay kuyru\u011fundaki tek bir kay\u0131t; onu olu\u015fturan iste\u011fin d\u00f6nd\u00fcrd\u00fc\u011f\u00fc `staged_action_id`\nile. `status`, `pending` durumundan `approved`, `rejected`, `expired` ya da `failed`\ndurumlar\u0131ndan tam olarak birine ge\u00e7er ve hi\u00e7bir zaman geri d\u00f6nmez.\n\nSahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:read` anahtar\u0131 gerektirir.\nSalt okunurdur: nedeni i\u00e7in listeye bak\u0131n.\n" }, "ar": { "summary": "\u062c\u0644\u0628 \u0633\u062c\u0644 \u0648\u0627\u062d\u062f \u0645\u0646 \u0642\u0627\u0626\u0645\u0629 \u0627\u0646\u062a\u0638\u0627\u0631 \u0627\u0644\u0645\u0648\u0627\u0641\u0642\u0627\u062a", "description": "\u0633\u062c\u0644 \u0648\u0627\u062d\u062f \u0645\u0646 \u0642\u0627\u0626\u0645\u0629 \u0627\u0646\u062a\u0638\u0627\u0631 \u0627\u0644\u0645\u0648\u0627\u0641\u0642\u0627\u062a\u060c \u0628\u062d\u0633\u0628 \u0642\u064a\u0645\u0629 `staged_action_id` \u0627\u0644\u062a\u064a \u0623\u0639\u0627\u062f\u0647\u0627 \u0627\u0644\u0637\u0644\u0628\n\u0627\u0644\u0630\u064a \u0623\u0646\u0634\u0623\u0647. \u062a\u0646\u062a\u0642\u0644 `status` \u0645\u0646 `pending` \u0625\u0644\u0649 \u0648\u0627\u062d\u062f\u0629 \u0641\u0642\u0637 \u0645\u0646 `approved` \u0623\u0648 `rejected` \u0623\u0648\n`expired` \u0623\u0648 `failed`\u060c \u0648\u0644\u0627 \u062a\u0639\u0648\u062f \u0623\u0628\u062f\u064b\u0627.\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`. \u0644\u0644\u0642\u0631\u0627\u0621\u0629\n\u0641\u0642\u0637: \u0631\u0627\u062c\u0639 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0644\u0645\u0639\u0631\u0641\u0629 \u0627\u0644\u0633\u0628\u0628.\n" } }, "tags": [ "Admin" ], "parameters": [ { "name": "stagedAction", "in": "path", "required": true, "description": "The queue entry id.", "x-i18n": { "tr": { "description": "Kuyruk kayd\u0131n\u0131n id de\u011feri." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0633\u062c\u0644 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631." } }, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "The queue entry.", "x-i18n": { "tr": { "description": "Kuyruk kayd\u0131." }, "ar": { "description": "\u0633\u062c\u0644 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/StagedAction" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/news": { "get": { "operationId": "listNews", "summary": "List news items", "description": "The panel's news items, newest first \u2014 drafts and published alike, filtered by\n`published` when it is given.\n\nRequires an `admin:read` token whose owner holds the `admin` or `super-admin` role.\nEditorial content: no person's data is read, so no access-log row is written.\n", "x-i18n": { "tr": { "summary": "Duyurular\u0131 listele", "description": "Paneldeki duyurular, en yenisi ba\u015fta; taslaklar da yay\u0131mlananlar da. `published`\nverildi\u011finde ona g\u00f6re s\u00fcz\u00fcl\u00fcr.\n\nSahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:read` anahtar\u0131 gerektirir.\nYay\u0131n i\u00e7eri\u011fidir: hi\u00e7bir ki\u015finin verisi okunmad\u0131\u011f\u0131 i\u00e7in eri\u015fim g\u00fcnl\u00fc\u011f\u00fcne sat\u0131r yaz\u0131lmaz.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u0623\u062e\u0628\u0627\u0631", "description": "\u0623\u062e\u0628\u0627\u0631 \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0627\u0644\u0623\u062d\u062f\u062b \u0623\u0648\u0644\u064b\u0627 \u2014 \u0627\u0644\u0645\u0633\u0648\u062f\u0627\u062a \u0648\u0627\u0644\u0645\u0646\u0634\u0648\u0631\u0629 \u0645\u0639\u064b\u0627\u060c \u0648\u062a\u064f\u0635\u0641\u0651\u0649 \u0628\u062d\u0633\u0628 `published` \u0639\u0646\u062f\n\u062a\u0645\u0631\u064a\u0631\u0647.\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`. \u0647\u0630\u0627 \u0645\u062d\u062a\u0648\u0649\n\u062a\u062d\u0631\u064a\u0631\u064a: \u0644\u0627 \u062a\u064f\u0642\u0631\u0623 \u0628\u064a\u0627\u0646\u0627\u062a \u0623\u064a \u0634\u062e\u0635\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627 \u064a\u064f\u0643\u062a\u0628 \u0633\u0637\u0631 \u0641\u064a \u0633\u062c\u0644 \u0627\u0644\u0648\u0635\u0648\u0644.\n" } }, "tags": [ "Admin" ], "parameters": [ { "name": "published", "in": "query", "required": false, "description": "`true` for published items only, `false` for drafts only.", "x-i18n": { "tr": { "description": "Yaln\u0131zca yay\u0131mlanm\u0131\u015flar i\u00e7in `true`, yaln\u0131zca taslaklar i\u00e7in `false`." }, "ar": { "description": "`true` \u0644\u0644\u0623\u062e\u0628\u0627\u0631 \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u0629 \u0641\u0642\u0637\u060c \u0648`false` \u0644\u0644\u0645\u0633\u0648\u062f\u0627\u062a \u0641\u0642\u0637." } }, "schema": { "type": "boolean" } }, { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of news items.", "x-i18n": { "tr": { "description": "Duyurulardan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0623\u062e\u0628\u0627\u0631." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/News" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" } } }, "post": { "operationId": "createNewsDraft", "summary": "Create a news draft", "description": "Creates a DRAFT with the rules the draft tools apply: `title` up to 255 characters,\n`body` up to 2048, `language` one of `tr-TR`, `en-US`, `ar-SA`, and an optional\n`audience`. It is never published, scheduled or sent here: `is_published`,\n`publish_date` and `scheduled_for` in the body are refused with `422` (a schedule\npublishes on its own when it falls due), and publishing is a separate request that an\nadministrator must approve (`POST /admin/news/{news}/publish`).\n\nRequires an `admin:write` token whose owner holds the `admin` or `super-admin` role.\n", "x-i18n": { "tr": { "summary": "Duyuru tasla\u011f\u0131 olu\u015ftur", "description": "Taslak ara\u00e7lar\u0131n\u0131n uygulad\u0131\u011f\u0131 kurallarla bir TASLAK olu\u015fturur: en \u00e7ok 255 karakterlik\n`title`, en \u00e7ok 2048 karakterlik `body`, `tr-TR`, `en-US` veya `ar-SA` de\u011ferlerinden biri\nolan `language` ve iste\u011fe ba\u011fl\u0131 `audience`. Burada hi\u00e7bir zaman yay\u0131mlanmaz,\nzamanlanmaz ya da g\u00f6nderilmez: g\u00f6vdedeki `is_published`, `publish_date` ve\n`scheduled_for` `422` ile reddedilir (zamanlanan bir duyuru, vakti gelince kendili\u011finden\nyay\u0131mlan\u0131r); yay\u0131mlama, bir y\u00f6neticinin onaylamas\u0131 gereken ayr\u0131 bir istektir\n(`POST /admin/news/{news}/publish`).\n\nSahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:write` anahtar\u0131 gerektirir.\n" }, "ar": { "summary": "\u0625\u0646\u0634\u0627\u0621 \u0645\u0633\u0648\u062f\u0629 \u062e\u0628\u0631", "description": "\u064a\u0646\u0634\u0626 \u0645\u0633\u0648\u062f\u0629 \u0628\u0627\u0644\u0642\u0648\u0627\u0639\u062f \u0627\u0644\u062a\u064a \u062a\u0637\u0628\u0651\u0642\u0647\u0627 \u0623\u062f\u0648\u0627\u062a \u0627\u0644\u0645\u0633\u0648\u062f\u0627\u062a: `title` \u062d\u062a\u0649 255 \u0645\u062d\u0631\u0641\u064b\u0627\u060c \u0648`body` \u062d\u062a\u0649\n2048\u060c \u0648`language` \u0625\u062d\u062f\u0649 \u0627\u0644\u0642\u064a\u0645 `tr-TR` \u0623\u0648 `en-US` \u0623\u0648 `ar-SA`\u060c \u0648`audience` \u0627\u062e\u062a\u064a\u0627\u0631\u064a. \u0648\u0644\u0627\n\u064a\u064f\u0646\u0634\u0631 \u0647\u0646\u0627 \u0648\u0644\u0627 \u064a\u064f\u062c\u062f\u0648\u0644 \u0648\u0644\u0627 \u064a\u064f\u0631\u0633\u0644 \u0623\u0628\u062f\u064b\u0627: \u064a\u064f\u0631\u0641\u0636 \u0648\u062c\u0648\u062f `is_published` \u0623\u0648 `publish_date` \u0623\u0648\n`scheduled_for` \u0641\u064a \u0627\u0644\u062c\u0633\u0645 \u0628\u0627\u0644\u0631\u0645\u0632 `422` (\u0641\u0627\u0644\u062e\u0628\u0631 \u0627\u0644\u0645\u062c\u062f\u0648\u0644 \u064a\u064f\u0646\u0634\u0631 \u0645\u0646 \u062a\u0644\u0642\u0627\u0621 \u0646\u0641\u0633\u0647 \u0639\u0646\u062f \u062d\u0644\u0648\u0644\n\u0645\u0648\u0639\u062f\u0647)\u060c \u0648\u0627\u0644\u0646\u0634\u0631 \u0637\u0644\u0628 \u0645\u0646\u0641\u0635\u0644 \u064a\u062c\u0628 \u0623\u0646 \u064a\u0648\u0627\u0641\u0642 \u0639\u0644\u064a\u0647 \u0645\u062f\u064a\u0631 (`POST /admin/news/{news}/publish`).\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:write` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`.\n" } }, "tags": [ "Admin" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "title", "body", "language" ], "properties": { "title": { "type": "string", "maxLength": 255 }, "body": { "type": "string", "maxLength": 2048 }, "language": { "type": "string", "enum": [ "tr-TR", "en-US", "ar-SA" ] }, "audience": { "type": "string", "enum": [ "everyone", "customers" ] } } } } } }, "responses": { "201": { "description": "The draft.", "x-i18n": { "tr": { "description": "Taslak." }, "ar": { "description": "\u0627\u0644\u0645\u0633\u0648\u062f\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/News" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/news/{news}": { "get": { "operationId": "getNews", "summary": "Get one news item", "description": "One news item by id. Requires an `admin:read` token whose owner holds the `admin` or\n`super-admin` role.\n", "x-i18n": { "tr": { "summary": "Tek bir duyuruyu getir", "description": "Id ile tek bir duyuru. Sahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:read`\nanahtar\u0131 gerektirir.\n" }, "ar": { "summary": "\u062c\u0644\u0628 \u062e\u0628\u0631 \u0648\u0627\u062d\u062f", "description": "\u062e\u0628\u0631 \u0648\u0627\u062d\u062f \u0628\u062d\u0633\u0628 \u0645\u0639\u0631\u0651\u0641\u0647. \u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648\n`super-admin`.\n" } }, "tags": [ "Admin" ], "parameters": [ { "name": "news", "in": "path", "required": true, "description": "The news item id.", "x-i18n": { "tr": { "description": "Duyurunun id de\u011feri." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u062e\u0628\u0631." } }, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "200": { "description": "The news item.", "x-i18n": { "tr": { "description": "Duyuru." }, "ar": { "description": "\u0627\u0644\u062e\u0628\u0631." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/News" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } } }, "post": { "operationId": "updateNewsDraft", "summary": "Edit a news draft", "description": "Changes only the fields sent (`title`, `body`, `language`, `audience`), each held to the\ncreate rules; an empty body is a `422`, and so is `is_published`, `publish_date` or\n`scheduled_for`. A published item, or a draft somebody scheduled in the panel, cannot be\nedited here and answers `422`. POST rather than PATCH: every write on the staff API is a\nPOST.\n\nRequires an `admin:write` token whose owner holds the `admin` or `super-admin` role.\n", "x-i18n": { "tr": { "summary": "Duyuru tasla\u011f\u0131n\u0131 d\u00fczenle", "description": "Yaln\u0131zca g\u00f6nderilen alanlar\u0131 (`title`, `body`, `language`, `audience`) de\u011fi\u015ftirir; her\nbiri olu\u015fturma kurallar\u0131na tabidir. Bo\u015f bir g\u00f6vde `422` d\u00f6ner; `is_published`,\n`publish_date` ya da `scheduled_for` da \u00f6yle. Yay\u0131mlanm\u0131\u015f bir duyuru ya da panelde\nbirinin zamanlad\u0131\u011f\u0131 bir taslak burada d\u00fczenlenemez ve `422` d\u00f6ner. PATCH de\u011fil POST:\npersonel API'sindeki her yazma i\u015flemi POST'tur.\n\nSahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:write` anahtar\u0131 gerektirir.\n" }, "ar": { "summary": "\u062a\u0639\u062f\u064a\u0644 \u0645\u0633\u0648\u062f\u0629 \u062e\u0628\u0631", "description": "\u064a\u063a\u064a\u0651\u0631 \u0627\u0644\u062d\u0642\u0648\u0644 \u0627\u0644\u0645\u064f\u0631\u0633\u0644\u0629 \u0641\u0642\u0637 (`title` \u0648`body` \u0648`language` \u0648`audience`)\u060c \u0648\u064a\u062e\u0636\u0639 \u0643\u0644 \u0645\u0646\u0647\u0627\n\u0644\u0642\u0648\u0627\u0639\u062f \u0627\u0644\u0625\u0646\u0634\u0627\u0621\u061b \u0648\u0627\u0644\u062c\u0633\u0645 \u0627\u0644\u0641\u0627\u0631\u063a \u064a\u062c\u064a\u0628 \u0628\u0640 `422`\u060c \u0648\u0643\u0630\u0644\u0643 `is_published` \u0623\u0648 `publish_date` \u0623\u0648\n`scheduled_for`. \u0648\u0644\u0627 \u064a\u0645\u0643\u0646 \u0647\u0646\u0627 \u062a\u0639\u062f\u064a\u0644 \u062e\u0628\u0631 \u0645\u0646\u0634\u0648\u0631\u060c \u0648\u0644\u0627 \u0645\u0633\u0648\u062f\u0629 \u062c\u062f\u0648\u0644\u0647\u0627 \u0623\u062d\u062f\u0647\u0645 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0648\u064a\u062c\u064a\u0628\n\u0630\u0644\u0643 \u0628\u0640 `422`. POST \u0644\u0627 PATCH: \u0641\u0643\u0644 \u0639\u0645\u0644\u064a\u0629 \u0643\u062a\u0627\u0628\u0629 \u0641\u064a \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0645\u0648\u0638\u0641\u064a\u0646 \u0647\u064a POST.\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:write` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`.\n" } }, "tags": [ "Admin" ], "parameters": [ { "name": "news", "in": "path", "required": true, "description": "The draft's id.", "x-i18n": { "tr": { "description": "Tasla\u011f\u0131n id de\u011feri." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0645\u0633\u0648\u062f\u0629." } }, "schema": { "type": "integer", "minimum": 1 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "minProperties": 1, "properties": { "title": { "type": "string", "maxLength": 255 }, "body": { "type": "string", "maxLength": 2048 }, "language": { "type": "string", "enum": [ "tr-TR", "en-US", "ar-SA" ] }, "audience": { "type": "string", "enum": [ "everyone", "customers" ] } } } } } }, "responses": { "200": { "description": "The draft, after the edit.", "x-i18n": { "tr": { "description": "D\u00fczenlemeden sonra taslak." }, "ar": { "description": "\u0627\u0644\u0645\u0633\u0648\u062f\u0629 \u0628\u0639\u062f \u0627\u0644\u062a\u0639\u062f\u064a\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/News" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/news/{news}/publish": { "post": { "operationId": "stageNewsPublication", "summary": "Ask for a news item to be published", "description": "Stages the publication of a draft in the approval queue and answers `202`. NOTHING IS\nPUBLISHED OR SENT by this request: an administrator must approve the entry in the panel\n(`approval_url`), and it lapses after 24 hours if nobody does. The `Location` header and\n`staged_action_id` point at `GET /admin/staged-actions/{stagedAction}`, which reports the\noutcome. An item that is already published is refused with `422`. Each request stages a\nnew entry.\n\nRequires an `admin:write` token whose owner holds the `admin` or `super-admin` role.\n", "x-i18n": { "tr": { "summary": "Bir duyurunun yay\u0131mlanmas\u0131n\u0131 iste", "description": "Bir tasla\u011f\u0131n yay\u0131mlanmas\u0131n\u0131 onay kuyru\u011funa al\u0131r ve `202` d\u00f6ner. Bu istek H\u0130\u00c7B\u0130R \u015eEY\u0130\nYAYIMLAMAZ YA DA G\u00d6NDERMEZ: bir y\u00f6neticinin kayd\u0131 panelde onaylamas\u0131 gerekir\n(`approval_url`); kimse onaylamazsa 24 saat sonra s\u00fcresi dolar. `Location` ba\u015fl\u0131\u011f\u0131 ve\n`staged_action_id`, sonucu bildiren `GET /admin/staged-actions/{stagedAction}` u\u00e7\nnoktas\u0131n\u0131 g\u00f6sterir. Zaten yay\u0131mlanm\u0131\u015f bir duyuru `422` ile reddedilir. Her istek yeni bir\nkay\u0131t olu\u015fturur.\n\nSahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:write` anahtar\u0131 gerektirir.\n" }, "ar": { "summary": "\u0637\u0644\u0628 \u0646\u0634\u0631 \u062e\u0628\u0631", "description": "\u064a\u064f\u062f\u0631\u062c \u0646\u0634\u0631 \u0645\u0633\u0648\u062f\u0629 \u0641\u064a \u0642\u0627\u0626\u0645\u0629 \u0627\u0646\u062a\u0638\u0627\u0631 \u0627\u0644\u0645\u0648\u0627\u0641\u0642\u0627\u062a \u0648\u064a\u062c\u064a\u0628 \u0628\u0640 `202`. \u0647\u0630\u0627 \u0627\u0644\u0637\u0644\u0628 \u0644\u0627 \u064a\u0646\u0634\u0631 \u0634\u064a\u0626\u064b\u0627 \u0648\u0644\u0627\n\u064a\u0631\u0633\u0644 \u0634\u064a\u0626\u064b\u0627: \u064a\u062c\u0628 \u0623\u0646 \u064a\u0648\u0627\u0641\u0642 \u0645\u062f\u064a\u0631 \u0639\u0644\u0649 \u0627\u0644\u0633\u062c\u0644 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 (`approval_url`)\u060c \u0648\u062a\u0646\u0642\u0636\u064a \u0645\u0647\u0644\u062a\u0647 \u0628\u0639\u062f 24\n\u0633\u0627\u0639\u0629 \u0625\u0646 \u0644\u0645 \u064a\u0641\u0639\u0644 \u0623\u062d\u062f. \u0648\u062a\u0634\u064a\u0631 \u0627\u0644\u062a\u0631\u0648\u064a\u0633\u0629 `Location` \u0648\u0627\u0644\u0642\u064a\u0645\u0629 `staged_action_id` \u0625\u0644\u0649\n`GET /admin/staged-actions/{stagedAction}` \u0627\u0644\u062a\u064a \u062a\u064f\u0628\u0644\u063a \u0628\u0627\u0644\u0646\u062a\u064a\u062c\u0629. \u0648\u064a\u064f\u0631\u0641\u0636 \u0627\u0644\u062e\u0628\u0631 \u0627\u0644\u0645\u0646\u0634\u0648\u0631 \u0623\u0635\u0644\u064b\u0627\n\u0628\u0627\u0644\u0631\u0645\u0632 `422`. \u0648\u0643\u0644 \u0637\u0644\u0628 \u064a\u064f\u0646\u0634\u0626 \u0633\u062c\u0644\u064b\u0627 \u062c\u062f\u064a\u062f\u064b\u0627.\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:write` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`.\n" } }, "tags": [ "Admin" ], "parameters": [ { "name": "news", "in": "path", "required": true, "description": "The draft's id.", "x-i18n": { "tr": { "description": "Tasla\u011f\u0131n id de\u011feri." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0645\u0633\u0648\u062f\u0629." } }, "schema": { "type": "integer", "minimum": 1 } } ], "responses": { "202": { "description": "Staged; nothing has happened yet.", "x-i18n": { "tr": { "description": "Kuyru\u011fa al\u0131nd\u0131; hen\u00fcz hi\u00e7bir \u015fey olmad\u0131." }, "ar": { "description": "\u0623\u064f\u062f\u0631\u062c \u0641\u064a \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631\u061b \u0644\u0645 \u064a\u062d\u062f\u062b \u0634\u064a\u0621 \u0628\u0639\u062f." } }, "headers": { "Location": { "description": "Where to poll for the outcome.", "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/StagedActionReceipt" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "422": { "$ref": "#/components/responses/ValidationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/work-queues": { "get": { "operationId": "listWorkQueues", "summary": "List what is waiting on a person", "description": "Every operator queue \u2014 the erasure queue, privacy requests, failed payments, dunning,\nreferral rewards, partner applications and trainings, open tickets, join requests, held\npartner rebates, the invoice worklist and price notices \u2014 with how many items wait and\nsince when. Zeroes are included, in a fixed order, so an absent queue never reads as an\nempty one. Counts only: nobody is named, so no access-log row is written. The same figures\nthe admin board and the admin MCP server read. The one money figure, the referrals\nqueue's `amount`, is `Money` in minor units like the rest of this API \u2014 the MCP twin\nprints the same figure as a plain decimal.\n\nRequires an `admin:read` token whose owner holds the `admin` or `super-admin` role.\n", "x-i18n": { "tr": { "summary": "Bir ki\u015fiyi bekleyen i\u015fleri listele", "description": "Her operat\u00f6r kuyru\u011fu \u2014 silme kuyru\u011fu, gizlilik talepleri, ba\u015far\u0131s\u0131z \u00f6demeler, tahsilat\ntakibi, tavsiye \u00f6d\u00fclleri, ortakl\u0131k ba\u015fvurular\u0131 ve e\u011fitimleri, a\u00e7\u0131k destek talepleri,\nkat\u0131l\u0131m istekleri, bekletilen ortak hakedi\u015fleri, fatura i\u015f listesi ve fiyat bildirimleri\n\u2014 ka\u00e7 \u00f6\u011fenin ne zamandan beri bekledi\u011fiyle birlikte. S\u0131f\u0131rlar da sabit bir s\u0131rayla yer\nal\u0131r; b\u00f6ylece eksik bir kuyruk hi\u00e7bir zaman bo\u015f san\u0131lmaz. Yaln\u0131zca say\u0131lard\u0131r: kimsenin\nad\u0131 ge\u00e7mez, bu y\u00fczden eri\u015fim g\u00fcnl\u00fc\u011f\u00fcne sat\u0131r yaz\u0131lmaz. Y\u00f6netim panosunun ve y\u00f6netici MCP\nsunucusunun okudu\u011fu rakamlar\u0131n ayn\u0131s\u0131d\u0131r. Tek parasal de\u011fer olan `referrals` kuyru\u011funun\n`amount` alan\u0131, bu API'nin geri kalan\u0131 gibi alt birimde bir `Money` nesnesidir \u2014 MCP\nikizi ayn\u0131 de\u011feri d\u00fcz bir ondal\u0131k say\u0131 olarak yazar.\n\nSahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:read` anahtar\u0131 gerektirir.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0645\u0627 \u064a\u0646\u062a\u0638\u0631 \u062a\u062f\u062e\u0651\u0644 \u0634\u062e\u0635", "description": "\u0643\u0644 \u0642\u0627\u0626\u0645\u0629 \u0627\u0646\u062a\u0638\u0627\u0631 \u0644\u062f\u0649 \u0627\u0644\u0645\u0634\u063a\u0651\u0644 \u2014 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0645\u062d\u0648\u060c \u0648\u0637\u0644\u0628\u0627\u062a \u0627\u0644\u062e\u0635\u0648\u0635\u064a\u0629\u060c \u0648\u0627\u0644\u0645\u062f\u0641\u0648\u0639\u0627\u062a \u0627\u0644\u0641\u0627\u0634\u0644\u0629\u060c \u0648\u0645\u062a\u0627\u0628\u0639\u0629\n\u0627\u0644\u062a\u062d\u0635\u064a\u0644\u060c \u0648\u0645\u0643\u0627\u0641\u0622\u062a \u0627\u0644\u0625\u062d\u0627\u0644\u0629\u060c \u0648\u0637\u0644\u0628\u0627\u062a \u0627\u0644\u0634\u0631\u0627\u0643\u0629 \u0648\u062f\u0648\u0631\u0627\u062a\u0647\u0627 \u0627\u0644\u062a\u062f\u0631\u064a\u0628\u064a\u0629\u060c \u0648\u062a\u0630\u0627\u0643\u0631 \u0627\u0644\u062f\u0639\u0645 \u0627\u0644\u0645\u0641\u062a\u0648\u062d\u0629\u060c\n\u0648\u0637\u0644\u0628\u0627\u062a \u0627\u0644\u0627\u0646\u0636\u0645\u0627\u0645\u060c \u0648\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0627\u0644\u0634\u0631\u0643\u0627\u0621 \u0627\u0644\u0645\u062d\u062a\u062c\u0632\u0629\u060c \u0648\u0642\u0627\u0626\u0645\u0629 \u0639\u0645\u0644 \u0627\u0644\u0641\u0648\u0627\u062a\u064a\u0631\u060c \u0648\u0625\u0634\u0639\u0627\u0631\u0627\u062a \u0627\u0644\u0623\u0633\u0639\u0627\u0631 \u2014 \u0645\u0639\n\u0639\u062f\u062f \u0627\u0644\u0639\u0646\u0627\u0635\u0631 \u0627\u0644\u0645\u0646\u062a\u0638\u0631\u0629 \u0648\u0645\u0646\u0630 \u0645\u062a\u0649. \u0648\u062a\u064f\u062f\u0631\u062c \u0627\u0644\u0623\u0635\u0641\u0627\u0631 \u0623\u064a\u0636\u064b\u0627 \u0628\u062a\u0631\u062a\u064a\u0628 \u062b\u0627\u0628\u062a\u060c \u0641\u0644\u0627 \u062a\u064f\u0642\u0631\u0623 \u0642\u0627\u0626\u0645\u0629 \u063a\u0627\u0626\u0628\u0629\n\u0639\u0644\u0649 \u0623\u0646\u0647\u0627 \u0641\u0627\u0631\u063a\u0629. \u0623\u0639\u062f\u0627\u062f \u0641\u0642\u0637: \u0644\u0627 \u064a\u064f\u0630\u0643\u0631 \u0627\u0633\u0645 \u0623\u062d\u062f\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627 \u064a\u064f\u0643\u062a\u0628 \u0633\u0637\u0631 \u0641\u064a \u0633\u062c\u0644 \u0627\u0644\u0648\u0635\u0648\u0644. \u0648\u0647\u064a\n\u0627\u0644\u0623\u0631\u0642\u0627\u0645 \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u062a\u064a \u062a\u0642\u0631\u0624\u0647\u0627 \u0644\u0648\u062d\u0629 \u0627\u0644\u0625\u062f\u0627\u0631\u0629 \u0648\u062e\u0627\u062f\u0645 MCP \u0627\u0644\u0625\u062f\u0627\u0631\u064a. \u0648\u0627\u0644\u0631\u0642\u0645 \u0627\u0644\u0645\u0627\u0644\u064a \u0627\u0644\u0648\u062d\u064a\u062f\u060c \u0623\u064a\n`amount` \u0641\u064a \u0642\u0627\u0626\u0645\u0629 `referrals`\u060c \u0643\u0627\u0626\u0646 `Money` \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0645\u062b\u0644 \u0628\u0642\u064a\u0629 \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u2014 \u0623\u0645\u0627\n\u0646\u0638\u064a\u0631\u0647 \u0641\u064a MCP \u0641\u064a\u0637\u0628\u0639 \u0627\u0644\u0631\u0642\u0645 \u0646\u0641\u0633\u0647 \u0639\u062f\u062f\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u062f\u064a\u064b\u0627.\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`.\n" } }, "tags": [ "Admin" ], "responses": { "200": { "description": "Every queue, zeroes included.", "x-i18n": { "tr": { "description": "S\u0131f\u0131rlar dahil her kuyruk." }, "ar": { "description": "\u0643\u0644 \u0642\u0648\u0627\u0626\u0645 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631\u060c \u0628\u0645\u0627 \u0641\u064a\u0647\u0627 \u0627\u0644\u0623\u0635\u0641\u0627\u0631." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/WorkQueue" } }, "meta": { "type": "object", "required": [ "checked_at" ], "properties": { "checked_at": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/admin/health": { "get": { "operationId": "getSystemHealth", "summary": "Read the installation's health", "description": "One read for the installation's health: the application version, failed queue jobs\n(count, and the most recent by job name and exception class only \u2014 never the payload or\nthe message, which can quote a customer's record), queue depth and whether Horizon runs,\nevery scheduled command with its cadence, next due time and last FAILURE in 30 days,\npending database migrations, and which configuration keys changed recently (never their\nvalues). C2 records a scheduled command's failures, not its successes, so there is no last\nsuccessful run. The same report the admin MCP server's `get_system_health` returns.\n\nRequires an `admin:read` token whose owner holds the `admin` or `super-admin` role.\n", "x-i18n": { "tr": { "summary": "Kurulumun sa\u011fl\u0131k durumunu oku", "description": "Kurulumun sa\u011fl\u0131\u011f\u0131 i\u00e7in tek bir okuma: uygulama s\u00fcr\u00fcm\u00fc; ba\u015far\u0131s\u0131z kuyruk i\u015fleri (say\u0131s\u0131 ve\nen yenileri, yaln\u0131zca i\u015f ad\u0131 ve istisna s\u0131n\u0131f\u0131yla \u2014 bir m\u00fc\u015fterinin kayd\u0131n\u0131 aktarabilecek\ny\u00fck ya da ileti asla verilmez); kuyruk derinli\u011fi ve Horizon'un \u00e7al\u0131\u015f\u0131p \u00e7al\u0131\u015fmad\u0131\u011f\u0131; her\nzamanlanm\u0131\u015f komutun s\u0131kl\u0131\u011f\u0131, bir sonraki \u00e7al\u0131\u015fma zaman\u0131 ve son 30 g\u00fcndeki son\nBA\u015eARISIZLI\u011eI; bekleyen veritaban\u0131 ge\u00e7i\u015fleri; son zamanlarda de\u011fi\u015fen yap\u0131land\u0131rma\nanahtarlar\u0131 (de\u011ferleri asla verilmez). C2 zamanlanm\u0131\u015f bir komutun ba\u015far\u0131s\u0131zl\u0131klar\u0131n\u0131\nkaydeder, ba\u015far\u0131lar\u0131n\u0131 kaydetmez; bu y\u00fczden son ba\u015far\u0131l\u0131 \u00e7al\u0131\u015fma bilgisi yoktur. Y\u00f6netici\nMCP sunucusundaki `get_system_health` arac\u0131n\u0131n d\u00f6nd\u00fcrd\u00fc\u011f\u00fc raporun ayn\u0131s\u0131d\u0131r.\n\nSahibi `admin` veya `super-admin` rol\u00fcn\u00fc ta\u015f\u0131yan bir `admin:read` anahtar\u0131 gerektirir.\n" }, "ar": { "summary": "\u0642\u0631\u0627\u0621\u0629 \u062d\u0627\u0644\u0629 \u0633\u0644\u0627\u0645\u0629 \u0627\u0644\u062a\u062b\u0628\u064a\u062a", "description": "\u0642\u0631\u0627\u0621\u0629 \u0648\u0627\u062d\u062f\u0629 \u0644\u0633\u0644\u0627\u0645\u0629 \u0627\u0644\u062a\u062b\u0628\u064a\u062a: \u0625\u0635\u062f\u0627\u0631 \u0627\u0644\u062a\u0637\u0628\u064a\u0642\u061b \u0648\u0645\u0647\u0627\u0645 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631 \u0627\u0644\u0641\u0627\u0634\u0644\u0629 (\u0639\u062f\u062f\u0647\u0627 \u0648\u0623\u062d\u062f\u062b\u0647\u0627\u060c\n\u0628\u0627\u0633\u0645 \u0627\u0644\u0645\u0647\u0645\u0629 \u0648\u0635\u0646\u0641 \u0627\u0644\u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u0641\u0642\u0637 \u2014 \u0648\u0644\u0627 \u062a\u064f\u0639\u0637\u0649 \u0627\u0644\u062d\u0645\u0648\u0644\u0629 \u0623\u0648 \u0627\u0644\u0631\u0633\u0627\u0644\u0629 \u0623\u0628\u062f\u064b\u0627\u060c \u0625\u0630 \u0642\u062f \u062a\u0642\u062a\u0628\u0633 \u0633\u062c\u0644\n\u0639\u0645\u064a\u0644)\u061b \u0648\u0639\u0645\u0642 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631 \u0648\u0647\u0644 Horizon \u064a\u0639\u0645\u0644\u061b \u0648\u0643\u0644 \u0623\u0645\u0631 \u0645\u062c\u062f\u0648\u0644 \u0645\u0639 \u0648\u062a\u064a\u0631\u062a\u0647 \u0648\u0645\u0648\u0639\u062f \u062a\u0634\u063a\u064a\u0644\u0647 \u0627\u0644\u062a\u0627\u0644\u064a\n\u0648\u0622\u062e\u0631 \u0625\u062e\u0641\u0627\u0642 \u0644\u0647 \u062e\u0644\u0627\u0644 30 \u064a\u0648\u0645\u064b\u0627\u061b \u0648\u062a\u0631\u062d\u064a\u0644\u0627\u062a \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0644\u0645\u0639\u0644\u0651\u0642\u0629\u061b \u0648\u0645\u0641\u0627\u062a\u064a\u062d \u0627\u0644\u0625\u0639\u062f\u0627\u062f \u0627\u0644\u062a\u064a\n\u062a\u063a\u064a\u0651\u0631\u062a \u0645\u0624\u062e\u0631\u064b\u0627 (\u062f\u0648\u0646 \u0642\u064a\u0645\u0647\u0627 \u0623\u0628\u062f\u064b\u0627). \u064a\u0633\u062c\u0651\u0644 C2 \u0625\u062e\u0641\u0627\u0642\u0627\u062a \u0627\u0644\u0623\u0645\u0631 \u0627\u0644\u0645\u062c\u062f\u0648\u0644 \u0644\u0627 \u0646\u062c\u0627\u062d\u0627\u062a\u0647\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627 \u062a\u0648\u062c\u062f\n\u0645\u0639\u0644\u0648\u0645\u0629 \u0639\u0646 \u0622\u062e\u0631 \u062a\u0634\u063a\u064a\u0644 \u0646\u0627\u062c\u062d. \u0648\u0647\u0648 \u0627\u0644\u062a\u0642\u0631\u064a\u0631 \u0646\u0641\u0633\u0647 \u0627\u0644\u0630\u064a \u062a\u0639\u064a\u062f\u0647 \u0623\u062f\u0627\u0629 `get_system_health` \u0641\u064a \u062e\u0627\u062f\u0645\nMCP \u0627\u0644\u0625\u062f\u0627\u0631\u064a.\n\n\u064a\u062a\u0637\u0644\u0651\u0628 \u0631\u0645\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `admin:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `admin` \u0623\u0648 `super-admin`.\n" } }, "tags": [ "Admin" ], "responses": { "200": { "description": "The health report.", "x-i18n": { "tr": { "description": "Sa\u011fl\u0131k raporu." }, "ar": { "description": "\u062a\u0642\u0631\u064a\u0631 \u0627\u0644\u0633\u0644\u0627\u0645\u0629." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/SystemHealth" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/support/customers": { "get": { "operationId": "listSupportCustomers", "summary": "List the customers assigned to the calling agent", "description": "Only the customers the calling agent holds a `support_assignments` row for,\nordered by name, each with the capability map the agent holds over them. An agent\nwith no assignments gets an empty page \u2014 never the roster.\n\nA `super-admin` sees every customer instead, matching the panel: both\n`User::supportCan()` and `User::isAssignedTo()` short-circuit for that role, so\nthe assignment matrix is not a constraint on it.\n\nRequires a `support:read` token whose owner holds the `support` (or\n`super-admin`) role. The ability alone is not enough: a token outlives the role\nits holder had when it was minted, so the role is checked on every request.\n\nThe equivalent panel route carries no gate at all \u2014 its filter lives in the\ncontroller \u2014 so an API port that simply queried \"every customer\" would hand the\nwhole install to any `support:read` token. The scoping here is the endpoint's\nsingle most important property and is asserted in both directions by test.\n\nWrites no audit row: it publishes no more about any one customer than a name and\nan email, and the per-customer reads beside it are the ones that log.\n", "x-i18n": { "tr": { "summary": "\u00c7a\u011f\u0131ran temsilciye atanm\u0131\u015f m\u00fc\u015fterileri listele", "description": "Yaln\u0131zca \u00e7a\u011f\u0131ran temsilcinin `support_assignments` sat\u0131r\u0131 bulunan m\u00fc\u015fteriler, ada\ng\u00f6re s\u0131ral\u0131 olarak ve her biri temsilcinin o m\u00fc\u015fteri \u00fczerinde ta\u015f\u0131d\u0131\u011f\u0131 yetki\nharitas\u0131yla birlikte d\u00f6ner. Hi\u00e7 atamas\u0131 olmayan bir temsilci bo\u015f bir sayfa al\u0131r \u2014\nasla m\u00fc\u015fteri listesinin tamam\u0131n\u0131 de\u011fil.\n\nBir `super-admin` ise panelle uyumlu bi\u00e7imde b\u00fct\u00fcn m\u00fc\u015fterileri g\u00f6r\u00fcr: hem\n`User::supportCan()` hem de `User::isAssignedTo()` bu rol i\u00e7in k\u0131sa devre yapar,\ndolay\u0131s\u0131yla atama matrisi onun i\u00e7in bir k\u0131s\u0131t de\u011fildir.\n\nSahibi `support` (ya da `super-admin`) rol\u00fcn\u00fc ta\u015f\u0131yan bir `support:read` anahtar\u0131\ngerekir. \u0130zin tek ba\u015f\u0131na yetmez: bir anahtar, olu\u015fturuldu\u011fu anda sahibinin ta\u015f\u0131d\u0131\u011f\u0131\nrolden daha uzun ya\u015far; bu y\u00fczden rol her istekte yeniden denetlenir.\n\nE\u015fde\u011fer panel yolunda hi\u00e7bir kap\u0131 yoktur \u2014 s\u00fczgeci denetleyicinin i\u00e7inde durur \u2014 bu\ny\u00fczden yaln\u0131zca \u201cb\u00fct\u00fcn m\u00fc\u015fteriler\u201d sorgusunu \u00e7al\u0131\u015ft\u0131ran bir API kar\u015f\u0131l\u0131\u011f\u0131, kurulumun\ntamam\u0131n\u0131 herhangi bir `support:read` anahtar\u0131na a\u00e7ard\u0131. Buradaki kapsamland\u0131rma bu\nu\u00e7 noktan\u0131n en \u00f6nemli \u00f6zelli\u011fidir ve testlerle her iki y\u00f6nde de do\u011frulan\u0131r.\n\nDenetim kayd\u0131 yazmaz: tek bir m\u00fc\u015fteri hakk\u0131nda bir addan ve bir e-posta adresinden\nfazlas\u0131n\u0131 yay\u0131mlamaz; kay\u0131t tutanlar, yan\u0131ndaki m\u00fc\u015fteri bazl\u0131 okumalard\u0131r.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0627\u0644\u0645\u064f\u0633\u0646\u064e\u062f\u064a\u0646 \u0625\u0644\u0649 \u0627\u0644\u0645\u0648\u0638\u0641 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a", "description": "\u0644\u0627 \u064a\u064f\u0631\u062c\u064e\u0639 \u0625\u0644\u0627 \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0627\u0644\u0630\u064a\u0646 \u064a\u0645\u0644\u0643 \u0627\u0644\u0645\u0648\u0638\u0641 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0644\u0647\u0645 \u0635\u0641\u064b\u0627 \u0641\u064a\n`support_assignments`\u060c \u0645\u0631\u062a\u064e\u0651\u0628\u064a\u0646 \u0628\u0627\u0644\u0627\u0633\u0645\u060c \u0648\u0645\u0639 \u0643\u0644 \u0648\u0627\u062d\u062f \u0645\u0646\u0647\u0645 \u062e\u0631\u064a\u0637\u0629 \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0627\u062a \u0627\u0644\u062a\u064a\n\u064a\u062d\u0645\u0644\u0647\u0627 \u0627\u0644\u0645\u0648\u0638\u0641 \u0639\u0644\u064a\u0647. \u0648\u0627\u0644\u0645\u0648\u0638\u0641 \u0627\u0644\u0630\u064a \u0644\u0627 \u0625\u0633\u0646\u0627\u062f \u0644\u0647 \u064a\u062d\u0635\u0644 \u0639\u0644\u0649 \u0635\u0641\u062d\u0629 \u0641\u0627\u0631\u063a\u0629 \u2014 \u0644\u0627 \u0639\u0644\u0649\n\u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0643\u0627\u0645\u0644\u0629 \u0623\u0628\u062f\u064b\u0627.\n\n\u0623\u0645\u0627 `super-admin` \u0641\u064a\u0631\u0649 \u062c\u0645\u064a\u0639 \u0627\u0644\u0639\u0645\u0644\u0627\u0621\u060c \u0645\u0637\u0627\u0628\u0642\u0629\u064b \u0644\u0644\u0648\u062d\u0629: \u0625\u0630 \u064a\u062a\u062c\u0627\u0648\u0632 \u0643\u0644\u064c\u0651 \u0645\u0646\n`User::supportCan()` \u0648`User::isAssignedTo()` \u0627\u0644\u0641\u062d\u0635 \u0644\u0647\u0630\u0627 \u0627\u0644\u062f\u0648\u0631\u060c \u0641\u0644\u0627 \u062a\u0643\u0648\u0646\n\u0645\u0635\u0641\u0648\u0641\u0629 \u0627\u0644\u0625\u0633\u0646\u0627\u062f \u0642\u064a\u062f\u064b\u0627 \u0639\u0644\u064a\u0647.\n\n\u064a\u062a\u0637\u0644\u0628 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u0631\u0645\u0632\u064b\u0627 \u0645\u0645\u064a\u0632\u064b\u0627 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `support:read` \u064a\u062d\u0645\u0644 \u0635\u0627\u062d\u0628\u0647 \u062f\u0648\u0631 `support` (\u0623\u0648\n`super-admin`). \u0648\u0644\u0627 \u062a\u0643\u0641\u064a \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 \u0648\u062d\u062f\u0647\u0627: \u0641\u0627\u0644\u0631\u0645\u0632 \u0627\u0644\u0645\u0645\u064a\u0632 \u064a\u0628\u0642\u0649 \u0628\u0639\u062f \u0627\u0644\u062f\u0648\u0631 \u0627\u0644\u0630\u064a \u0643\u0627\u0646\n\u064a\u062d\u0645\u0644\u0647 \u0635\u0627\u062d\u0628\u0647 \u0639\u0646\u062f \u0625\u0635\u062f\u0627\u0631\u0647\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u064f\u0641\u062d\u0635 \u0627\u0644\u062f\u0648\u0631 \u0645\u0639 \u0643\u0644 \u0637\u0644\u0628.\n\n\u0627\u0644\u0645\u0633\u0627\u0631 \u0627\u0644\u0645\u0642\u0627\u0628\u0644 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0644\u0627 \u064a\u062d\u0645\u0644 \u0623\u064a \u0628\u0648\u0651\u0627\u0628\u0629 \u2014 \u0625\u0630 \u064a\u0639\u064a\u0634 \u0627\u0644\u0645\u0631\u0634\u0650\u0651\u062d \u062f\u0627\u062e\u0644 \u0627\u0644\u0645\u062a\u062d\u0643\u0651\u0645 \u2014\n\u0648\u0644\u0630\u0644\u0643 \u0641\u0625\u0646 \u0646\u0642\u0644\u064b\u0627 \u0625\u0644\u0649 \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u0629 \u064a\u0643\u062a\u0641\u064a \u0628\u0627\u0644\u0627\u0633\u062a\u0639\u0644\u0627\u0645 \u0639\u0646 \u00ab\u0643\u0644 \u0627\u0644\u0639\u0645\u0644\u0627\u0621\u00bb \u0643\u0627\u0646\n\u0633\u064a\u0633\u0644\u0651\u0645 \u0627\u0644\u062a\u0646\u0635\u064a\u0628 \u0628\u0623\u0643\u0645\u0644\u0647 \u0644\u0623\u064a \u0631\u0645\u0632 \u0645\u0645\u064a\u0632 \u0628\u0635\u0644\u0627\u062d\u064a\u0629 `support:read`. \u062a\u062d\u062f\u064a\u062f \u0627\u0644\u0646\u0637\u0627\u0642 \u0647\u0646\u0627 \u0647\u0648 \u0623\u0647\u0645\u0651 \u062e\u0627\u0635\u064a\u0629\n\u0641\u064a \u0646\u0642\u0637\u0629 \u0627\u0644\u0646\u0647\u0627\u064a\u0629 \u0647\u0630\u0647\u060c \u0648\u062a\u0624\u0643\u0651\u062f\u0647 \u0627\u0644\u0627\u062e\u062a\u0628\u0627\u0631\u0627\u062a \u0641\u064a \u0627\u0644\u0627\u062a\u062c\u0627\u0647\u064a\u0646.\n\n\u0644\u0627 \u064a\u0643\u062a\u0628 \u0633\u062c\u0644\u0651 \u062a\u062f\u0642\u064a\u0642: \u0641\u0647\u0648 \u0644\u0627 \u064a\u0646\u0634\u0631 \u0639\u0646 \u0623\u064a \u0639\u0645\u064a\u0644 \u0623\u0643\u062b\u0631 \u0645\u0646 \u0627\u0633\u0645 \u0648\u0628\u0631\u064a\u062f \u0625\u0644\u0643\u062a\u0631\u0648\u0646\u064a\u060c\n\u0648\u0627\u0644\u0642\u0631\u0627\u0621\u0627\u062a \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643\u0644 \u0639\u0645\u064a\u0644 \u0628\u062c\u0627\u0646\u0628\u0647 \u0647\u064a \u0627\u0644\u062a\u064a \u062a\u064f\u0633\u062c\u064e\u0651\u0644.\n" } }, "tags": [ "Support" ], "parameters": [ { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of the agent's assigned customers.", "x-i18n": { "tr": { "description": "Temsilciye atanm\u0131\u015f m\u00fc\u015fterilerden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0627\u0644\u0645\u064f\u0633\u0646\u064e\u062f\u064a\u0646 \u0625\u0644\u0649 \u0627\u0644\u0645\u0648\u0638\u0641." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/SupportCustomer" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/support/customers/{user}": { "get": { "operationId": "getSupportCustomer", "summary": "Get one assigned customer", "description": "The cross-domain dashboard for one assigned customer: the record, the capability\nmap, and database-derived counts of their instances, volumes, DNS zones,\nsubscriptions, invoices and tickets.\n\nGated on the assignment alone \u2014 not on any per-domain capability \u2014 which matches\nthe panel deliberately. The point of this record is to tell an agent *where* a\ncustomer's problem might be before they have a domain to look in, so gating it at\n`account,view` would break the dashboard for a cloud-only agent. The per-domain\ncollections beside this path each require their own capability.\n\nBecause the gate is that broad, the payload is narrower than the admin\nequivalent: `phone` is not published here. An agent whose assignment reads `none`\non all five domains can reach this record, and the panel does hand them a phone\nnumber for it; the API being stricter than the panel is allowed, the reverse is\nnot.\n\nA customer the agent is not assigned to is a `403`, not a `404` \u2014 the assignment\ngate runs before anything looks the record up, and that matches the panel's\nanswer. An id that does not exist at all is a `403` for the same reason, and that\nis the intended answer: it makes \"no such account\" and \"not yours to see\"\nindistinguishable. Nothing on the support surface returns `404`.\n\nWrites an `account.pii_read` audit row, exactly as the equivalent panel page\ndoes, and is charged against a tighter rate-limit budget for that reason.\n", "x-i18n": { "tr": { "summary": "Atanm\u0131\u015f bir m\u00fc\u015fteriyi getir", "description": "Atanm\u0131\u015f bir m\u00fc\u015fteri i\u00e7in alanlar aras\u0131 g\u00f6sterge paneli: m\u00fc\u015fteri kayd\u0131, yetki\nharitas\u0131 ve veritaban\u0131ndan t\u00fcretilen sanal makina, disk, DNS alan\u0131, abonelik, fatura\nve destek talebi say\u0131lar\u0131.\n\nYaln\u0131zca atamaya bak\u0131l\u0131r \u2014 alan bazl\u0131 hi\u00e7bir yetkiye bak\u0131lmaz \u2014 ve bu, panelle\nbilin\u00e7li olarak ayn\u0131d\u0131r. Bu kayd\u0131n amac\u0131, destek temsilcisine bakaca\u011f\u0131 alan\u0131\nse\u00e7meden \u00f6nce m\u00fc\u015fterinin sorununun *nerede* olabilece\u011fini s\u00f6ylemektir; bu y\u00fczden\neri\u015fimi `account,view` ile kapatmak, yaln\u0131zca bulut alan\u0131nda \u00e7al\u0131\u015fan bir temsilci\ni\u00e7in g\u00f6sterge panelini i\u015flevsiz b\u0131rak\u0131rd\u0131. Bu yolun yan\u0131ndaki alan bazl\u0131\nkoleksiyonlar\u0131n her biri kendi yetkisini ister.\n\nKap\u0131 bu kadar geni\u015f oldu\u011fu i\u00e7in d\u00f6nen veri, y\u00f6netici kar\u015f\u0131l\u0131\u011f\u0131ndan daha dard\u0131r:\n`phone` burada yay\u0131mlanmaz. Be\u015f alan\u0131n hepsinde atamas\u0131 `none` olan bir temsilci bu\nkayda eri\u015febilir ve panel ona bir telefon numaras\u0131 verir; API'nin panelden daha kat\u0131\nolmas\u0131 kabul edilebilir, tersi de\u011fildir.\n\nTemsilcinin atanmad\u0131\u011f\u0131 bir m\u00fc\u015fteri `403` verir, `404` de\u011fil \u2014 atama kap\u0131s\u0131, kayd\u0131\narayan hi\u00e7bir \u015fey \u00e7al\u0131\u015fmadan \u00f6nce i\u015fler ve bu, panelin verdi\u011fi yan\u0131tla ayn\u0131d\u0131r. Hi\u00e7\nvar olmayan bir id de ayn\u0131 nedenle `403` verir ve istenen yan\u0131t budur: \u201cb\u00f6yle bir\nhesap yok\u201d ile \u201cbunu g\u00f6rmeye yetkiniz yok\u201d birbirinden ay\u0131rt edilemez hale gelir.\nDestek aray\u00fcz\u00fcnde hi\u00e7bir \u015fey `404` d\u00f6nd\u00fcrmez.\n\nT\u0131pk\u0131 e\u015fde\u011fer panel sayfas\u0131 gibi bir `account.pii_read` denetim kayd\u0131 yazar ve bu\nnedenle daha dar bir istek s\u0131n\u0131r\u0131 b\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr.\n" }, "ar": { "summary": "\u062c\u0644\u0628 \u0639\u0645\u064a\u0644 \u0645\u064f\u0633\u0646\u064e\u062f \u0648\u0627\u062d\u062f", "description": "\u0644\u0648\u062d\u0629 \u0645\u0639\u0644\u0648\u0645\u0627\u062a \u0634\u0627\u0645\u0644\u0629 \u0644\u0639\u0645\u064a\u0644 \u0645\u064f\u0633\u0646\u064e\u062f \u0648\u0627\u062d\u062f: \u0633\u062c\u0644\u0651 \u0627\u0644\u0639\u0645\u064a\u0644\u060c \u0648\u062e\u0631\u064a\u0637\u0629 \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0627\u062a\u060c \u0648\u0623\u0639\u062f\u0627\u062f\n\u0623\u062c\u0647\u0632\u062a\u0647 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0648\u0623\u0642\u0631\u0627\u0635\u0647 \u0648\u0645\u0646\u0627\u0637\u0642 DNS \u0648\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a\u0647 \u0648\u0641\u0648\u0627\u062a\u064a\u0631\u0647 \u0648\u062a\u0630\u0627\u0643\u0631\u0647\u060c \u0645\u062d\u0633\u0648\u0628\u0629 \u0645\u0646\n\u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a.\n\n\u0627\u0644\u0628\u0648\u0651\u0627\u0628\u0629 \u0647\u0646\u0627 \u0647\u064a \u0627\u0644\u0625\u0633\u0646\u0627\u062f \u0648\u062d\u062f\u0647 \u2014 \u0644\u0627 \u0623\u064a \u0635\u0644\u0627\u062d\u064a\u0629 \u062e\u0627\u0635\u0629 \u0628\u0645\u062c\u0627\u0644 \u2014 \u0648\u0647\u0630\u0627 \u0645\u0637\u0627\u0628\u0642 \u0644\u0644\u0648\u062d\u0629 \u0639\u0646\n\u0642\u0635\u062f. \u0627\u0644\u063a\u0631\u0636 \u0645\u0646 \u0647\u0630\u0627 \u0627\u0644\u0633\u062c\u0644\u0651 \u0623\u0646 \u064a\u062f\u0644\u0651 \u0645\u0648\u0638\u0641 \u0627\u0644\u062f\u0639\u0645 \u0639\u0644\u0649 *\u0623\u064a\u0646* \u0642\u062f \u062a\u0643\u0648\u0646 \u0645\u0634\u0643\u0644\u0629 \u0627\u0644\u0639\u0645\u064a\u0644 \u0642\u0628\u0644\n\u0623\u0646 \u064a\u0639\u0631\u0641 \u0627\u0644\u0645\u062c\u0627\u0644 \u0627\u0644\u0630\u064a \u064a\u0628\u062d\u062b \u0641\u064a\u0647\u061b \u0648\u0644\u0630\u0644\u0643 \u0641\u0625\u0646 \u0627\u0634\u062a\u0631\u0627\u0637 `account,view` \u0643\u0627\u0646 \u0633\u064a\u064f\u0639\u0637\u0651\u0644 \u0644\u0648\u062d\u0629\n\u0627\u0644\u0645\u0639\u0644\u0648\u0645\u0627\u062a \u0639\u0644\u0649 \u0645\u0648\u0638\u0641 \u0644\u0627 \u064a\u0639\u0645\u0644 \u0625\u0644\u0627 \u0641\u064a \u0645\u062c\u0627\u0644 \u0627\u0644\u0633\u062d\u0627\u0628\u0629. \u0623\u0645\u0627 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643\u0644 \u0645\u062c\u0627\u0644\n\u0628\u062c\u0627\u0646\u0628 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631 \u0641\u064a\u062a\u0637\u0644\u0628 \u0643\u0644\u064c\u0651 \u0645\u0646\u0647\u0627 \u0635\u0644\u0627\u062d\u064a\u062a\u0647 \u0627\u0644\u062e\u0627\u0635\u0629.\n\n\u0648\u0644\u0623\u0646 \u0627\u0644\u0628\u0648\u0651\u0627\u0628\u0629 \u0628\u0647\u0630\u0627 \u0627\u0644\u0627\u062a\u0633\u0627\u0639\u060c \u0641\u0625\u0646 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u0629 \u0647\u0646\u0627 \u0623\u0636\u064a\u0642 \u0645\u0646 \u0646\u0638\u064a\u0631\u062a\u0647\u0627 \u0641\u064a \u0648\u0627\u062c\u0647\u0629\n\u0627\u0644\u0645\u062f\u064a\u0631: \u0644\u0627 \u064a\u064f\u0646\u0634\u064e\u0631 \u0627\u0644\u062d\u0642\u0644 `phone`. \u0641\u0645\u0648\u0638\u0641 \u0627\u0644\u062f\u0639\u0645 \u0627\u0644\u0630\u064a \u064a\u0642\u0631\u0623 \u0625\u0633\u0646\u0627\u062f\u0647 `none` \u0641\u064a\n\u0627\u0644\u0645\u062c\u0627\u0644\u0627\u062a \u0627\u0644\u062e\u0645\u0633\u0629 \u062c\u0645\u064a\u0639\u0647\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0627\u0644\u0648\u0635\u0648\u0644 \u0625\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0633\u062c\u0644\u0651\u060c \u0648\u0627\u0644\u0644\u0648\u062d\u0629 \u062a\u0639\u0637\u064a\u0647 \u0631\u0642\u0645 \u0627\u0644\u0647\u0627\u062a\u0641\n\u0641\u0639\u0644\u064b\u0627\u061b \u0648\u064a\u064f\u0633\u0645\u062d \u0628\u0623\u0646 \u062a\u0643\u0648\u0646 \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u0629 \u0623\u0634\u062f\u0651 \u0635\u0631\u0627\u0645\u0629 \u0645\u0646 \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0644\u0627 \u0627\u0644\u0639\u0643\u0633.\n\n\u0627\u0644\u0639\u0645\u064a\u0644 \u063a\u064a\u0631 \u0627\u0644\u0645\u064f\u0633\u0646\u064e\u062f \u0625\u0644\u0649 \u0627\u0644\u0645\u0648\u0638\u0641 \u064a\u064f\u062c\u0627\u0628 \u0628\u0640 `403` \u0644\u0627 `404` \u2014 \u0625\u0630 \u062a\u0639\u0645\u0644 \u0628\u0648\u0651\u0627\u0628\u0629 \u0627\u0644\u0625\u0633\u0646\u0627\u062f\n\u0642\u0628\u0644 \u0623\u0646 \u064a\u0628\u062d\u062b \u0623\u064a \u0634\u064a\u0621 \u0639\u0646 \u0627\u0644\u0633\u062c\u0644\u0651\u060c \u0648\u0647\u0630\u0627 \u064a\u0637\u0627\u0628\u0642 \u062c\u0648\u0627\u0628 \u0627\u0644\u0644\u0648\u062d\u0629. \u0648\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u063a\u064a\u0631 \u0627\u0644\u0645\u0648\u062c\u0648\u062f\n\u0623\u0635\u0644\u064b\u0627 \u064a\u064f\u062c\u0627\u0628 \u0628\u0640 `403` \u0644\u0644\u0633\u0628\u0628 \u0646\u0641\u0633\u0647\u060c \u0648\u0647\u0630\u0627 \u0647\u0648 \u0627\u0644\u062c\u0648\u0627\u0628 \u0627\u0644\u0645\u0642\u0635\u0648\u062f: \u0641\u0647\u0648 \u064a\u062c\u0639\u0644 \"\u0644\u0627 \u0648\u062c\u0648\u062f \u0644\u0647\u0630\u0627\n\u0627\u0644\u062d\u0633\u0627\u0628\" \u0648\u00ab\u0644\u064a\u0633 \u0645\u0646 \u062d\u0642\u0643 \u0627\u0644\u0627\u0637\u0644\u0627\u0639\u00bb \u063a\u064a\u0631 \u0642\u0627\u0628\u0644\u064a\u0646 \u0644\u0644\u062a\u0645\u064a\u064a\u0632. \u0644\u0627 \u0634\u064a\u0621 \u0641\u064a \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u062f\u0639\u0645 \u064a\u064f\u0631\u062c\u0639\n`404`.\n\n\u064a\u0643\u062a\u0628 \u0633\u062c\u0644\u0651 \u062a\u062f\u0642\u064a\u0642 `account.pii_read` \u062a\u0645\u0627\u0645\u064b\u0627 \u0643\u0645\u0627 \u062a\u0641\u0639\u0644 \u0635\u0641\u062d\u0629 \u0627\u0644\u0644\u0648\u062d\u0629 \u0627\u0644\u0645\u0642\u0627\u0628\u0644\u0629\u060c \u0648\u0644\u0647\u0630\u0627\n\u0627\u0644\u0633\u0628\u0628 \u064a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 \u062d\u062f\u0651 \u0645\u0639\u062f\u0651\u0644 \u0637\u0644\u0628\u0627\u062a \u0623\u0636\u064a\u0642.\n" } }, "tags": [ "Support" ], "parameters": [ { "$ref": "#/components/parameters/CustomerId" } ], "responses": { "200": { "description": "The customer.", "x-i18n": { "tr": { "description": "M\u00fc\u015fteri." }, "ar": { "description": "\u0627\u0644\u0639\u0645\u064a\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data" ], "properties": { "data": { "$ref": "#/components/schemas/SupportCustomerDetail" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/support/customers/{user}/instances": { "get": { "operationId": "listSupportCustomerInstances", "summary": "List an assigned customer's virtual machines", "description": "Identical in payload to the admin equivalent \u2014 the same `Instance`\nrepresentation the customer's own `/instances` returns \u2014 and identical in how it\nis served: the customer-scoped cloud service, its non-reconciling reader, no\n`refresh` variant. Only the gate stack differs.\n\nRequires at least `view` on the `cloud` domain of an assignment covering this\ncustomer. An agent assigned to the customer but holding `none` on `cloud` is a\n`403`, as is an agent with no assignment at all.\n\nWrites a `cloud.pii_read` audit row and is charged against the tighter privileged\nread budget.\n\nAn unknown id, or one the agent is not assigned to, is a `403` \u2014 the gate runs\nbefore anything looks the record up, so \"no such account\" and \"not yours to see\"\nstay indistinguishable. Nothing on the support surface returns `404`.\n", "x-i18n": { "tr": { "summary": "Atanm\u0131\u015f bir m\u00fc\u015fterinin sanal makinalar\u0131n\u0131 listele", "description": "Y\u00fck bak\u0131m\u0131ndan y\u00f6netici e\u015fde\u011feriyle ayn\u0131d\u0131r \u2014 m\u00fc\u015fterinin kendi `/instances` u\u00e7\nnoktas\u0131n\u0131n d\u00f6nd\u00fcrd\u00fc\u011f\u00fc `Instance` g\u00f6steriminin ayn\u0131s\u0131 \u2014 ve sunulu\u015f bi\u00e7imi de ayn\u0131d\u0131r:\nm\u00fc\u015fteri kapsaml\u0131 bulut servisi, onun e\u015fitleme yapmayan okuyucusu, `refresh` bi\u00e7imi\nyok. Yaln\u0131zca \u00f6n\u00fcndeki eri\u015fim kap\u0131lar\u0131 farkl\u0131d\u0131r.\n\nBu m\u00fc\u015fteriyi kapsayan bir ataman\u0131n `cloud` alan\u0131nda en az `view` d\u00fczeyi gerekir.\nM\u00fc\u015fteriye atanm\u0131\u015f ama `cloud` alan\u0131nda `none` ta\u015f\u0131yan bir temsilci `403` al\u0131r; hi\u00e7\natamas\u0131 olmayan bir temsilci de \u00f6yle.\n\nBir `cloud.pii_read` denetim kayd\u0131 yazar ve daha dar olan ayr\u0131cal\u0131kl\u0131 okuma\nb\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr.\n\nBilinmeyen bir id ya da temsilcinin atanmad\u0131\u011f\u0131 bir id `403` d\u00f6ner \u2014 kap\u0131, kayda\nbak\u0131lmadan \u00f6nce \u00e7al\u0131\u015f\u0131r; b\u00f6ylece \u201cb\u00f6yle bir hesap yok\u201d ile \u201cbunu g\u00f6rmeye yetkiniz\nyok\u201d ay\u0131rt edilemez kal\u0131r. Destek aray\u00fcz\u00fcnde hi\u00e7bir u\u00e7 nokta `404` d\u00f6nd\u00fcrmez.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0644\u0639\u0645\u064a\u0644 \u0645\u064f\u0633\u0646\u064e\u062f", "description": "\u0645\u0637\u0627\u0628\u0642\u0629 \u0644\u0644\u0646\u0638\u064a\u0631\u0629 \u0627\u0644\u0625\u062f\u0627\u0631\u064a\u0629 \u0641\u064a \u0627\u0644\u062d\u0645\u0648\u0644\u0629 \u2014 \u0627\u0644\u062a\u0645\u062b\u064a\u0644 `Instance` \u0646\u0641\u0633\u0647 \u0627\u0644\u0630\u064a \u064a\u0639\u064a\u062f\u0647 \u0645\u0633\u0627\u0631\n`/instances` \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u0639\u0645\u064a\u0644 \u2014 \u0648\u0645\u0637\u0627\u0628\u0642\u0629 \u0643\u0630\u0644\u0643 \u0641\u064a \u0637\u0631\u064a\u0642\u0629 \u062a\u0642\u062f\u064a\u0645\u0647\u0627: \u062e\u062f\u0645\u0629 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0641\u064a\n\u0646\u0637\u0627\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u060c \u0648\u0642\u0627\u0631\u0626\u0647\u0627 \u0627\u0644\u0630\u064a \u0644\u0627 \u064a\u0637\u0627\u0628\u0642\u060c \u0648\u0644\u0627 \u0635\u064a\u063a\u0629 `refresh`. \u0648\u0644\u0627 \u064a\u062e\u062a\u0644\u0641 \u0633\u0648\u0649 \u0645\u0643\u062f\u0633\n\u0627\u0644\u0628\u0648\u0627\u0628\u0627\u062a.\n\n\u0648\u062a\u062a\u0637\u0644\u0628 \u0645\u0633\u062a\u0648\u0649 `view` \u0639\u0644\u0649 \u0627\u0644\u0623\u0642\u0644 \u0641\u064a \u0645\u062c\u0627\u0644 `cloud` \u0645\u0646 \u0625\u0633\u0646\u0627\u062f \u064a\u063a\u0637\u064a \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u064a\u0644.\n\u0648\u0627\u0644\u0645\u0648\u0638\u0641 \u0627\u0644\u0645\u064f\u0633\u0646\u064e\u062f \u0625\u0644\u0649 \u0627\u0644\u0639\u0645\u064a\u0644 \u0644\u0643\u0646\u0647 \u064a\u062d\u0645\u0644 `none` \u0639\u0644\u0649 `cloud` \u064a\u062a\u0644\u0642\u0649 `403`\u060c \u0648\u0643\u0630\u0644\u0643\n\u0627\u0644\u0645\u0648\u0638\u0641 \u0627\u0644\u0630\u064a \u0644\u0627 \u0625\u0633\u0646\u0627\u062f \u0644\u0647 \u0623\u0635\u0644\u064b\u0627.\n\n\u0648\u062a\u0643\u062a\u0628 \u0633\u062c\u0644 \u062a\u062f\u0642\u064a\u0642 `cloud.pii_read` \u0648\u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0645\u0645\u064a\u0632\u0629 \u0627\u0644\u0623\u0636\u064a\u0642.\n\n\u0648\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u063a\u064a\u0631 \u0627\u0644\u0645\u0639\u0631\u0648\u0641\u060c \u0623\u0648 \u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0630\u064a \u0644\u0627 \u064a\u0634\u0645\u0644\u0647 \u0625\u0633\u0646\u0627\u062f \u0627\u0644\u0645\u0648\u0638\u0641\u060c \u064a\u062c\u064a\u0628 \u0628\u0640 `403` \u2014\n\u0625\u0630 \u062a\u0639\u0645\u0644 \u0627\u0644\u0628\u0648\u0627\u0628\u0629 \u0642\u0628\u0644 \u0623\u0646 \u064a\u0628\u062d\u062b \u0623\u064a \u0634\u064a\u0621 \u0639\u0646 \u0627\u0644\u0633\u062c\u0644\u060c \u0641\u064a\u0628\u0642\u0649 \u00ab\u0644\u0627 \u0648\u062c\u0648\u062f \u0644\u0647\u0630\u0627 \u0627\u0644\u062d\u0633\u0627\u0628\u00bb\n\u0648\u00ab\u0644\u064a\u0633 \u0645\u0646 \u062d\u0642\u0643 \u0631\u0624\u064a\u062a\u0647\u00bb \u063a\u064a\u0631 \u0642\u0627\u0628\u0644\u064a\u0646 \u0644\u0644\u062a\u0645\u064a\u064a\u0632. \u0648\u0644\u0627 \u0634\u064a\u0621 \u0641\u064a \u0633\u0637\u062d \u0627\u0644\u062f\u0639\u0645 \u064a\u0639\u064a\u062f `404`.\n" } }, "tags": [ "Support" ], "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of the customer's virtual machines.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin sanal makinalar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0644\u0644\u0639\u0645\u064a\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Instance" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/support/customers/{user}/dns-zones": { "get": { "operationId": "listSupportCustomerDNSZones", "summary": "List an assigned customer's DNS zones", "description": "Identical in payload and in service resolution to the admin equivalent; only the\ngate stack differs. Requires at least `view` on the `dns` domain of an assignment\ncovering this customer.\n\nNo `refresh` parameter: the reconciling sibling deletes local zones \u2014 and\ncascades to their records \u2014 that PowerDNS's live listing no longer contains,\nbefore its own update flag is consulted.\n\nWrites a `dns.pii_read` audit row and is charged against the tighter privileged\nread budget.\n\nAn unknown id, or one the agent is not assigned to, is a `403` \u2014 the gate runs\nbefore anything looks the record up, so \"no such account\" and \"not yours to see\"\nstay indistinguishable. Nothing on the support surface returns `404`.\n", "x-i18n": { "tr": { "summary": "Atanm\u0131\u015f bir m\u00fc\u015fterinin DNS alanlar\u0131n\u0131 listele", "description": "Y\u00fck ve servis \u00e7\u00f6z\u00fcmlemesi bak\u0131m\u0131ndan y\u00f6netici e\u015fde\u011feriyle ayn\u0131d\u0131r; yaln\u0131zca \u00f6n\u00fcndeki\neri\u015fim kap\u0131lar\u0131 farkl\u0131d\u0131r. Bu m\u00fc\u015fteriyi kapsayan bir ataman\u0131n `dns` alan\u0131nda en az\n`view` d\u00fczeyi gerekir.\n\n`refresh` parametresi yoktur: e\u015fitleyici e\u015fi, PowerDNS'in canl\u0131 listesinde art\u0131k\nbulunmayan yerel DNS alanlar\u0131n\u0131 \u2014 ve art arda onlar\u0131n kay\u0131tlar\u0131n\u0131 \u2014 kendi g\u00fcncelleme\nbayra\u011f\u0131na bak\u0131lmadan \u00f6nce siler.\n\nBir `dns.pii_read` denetim kayd\u0131 yazar ve daha dar olan ayr\u0131cal\u0131kl\u0131 okuma\nb\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr.\n\nBilinmeyen bir id ya da temsilcinin atanmad\u0131\u011f\u0131 bir id `403` d\u00f6ner \u2014 kap\u0131, kayda\nbak\u0131lmadan \u00f6nce \u00e7al\u0131\u015f\u0131r; b\u00f6ylece \u201cb\u00f6yle bir hesap yok\u201d ile \u201cbunu g\u00f6rmeye yetkiniz\nyok\u201d ay\u0131rt edilemez kal\u0131r. Destek aray\u00fcz\u00fcnde hi\u00e7bir u\u00e7 nokta `404` d\u00f6nd\u00fcrmez.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0645\u0646\u0627\u0637\u0642 DNS \u0644\u0639\u0645\u064a\u0644 \u0645\u064f\u0633\u0646\u064e\u062f", "description": "\u0645\u0637\u0627\u0628\u0642\u0629 \u0644\u0644\u0646\u0638\u064a\u0631\u0629 \u0627\u0644\u0625\u062f\u0627\u0631\u064a\u0629 \u0641\u064a \u0627\u0644\u062d\u0645\u0648\u0644\u0629 \u0648\u0641\u064a \u062d\u0644\u0651 \u0627\u0644\u062e\u062f\u0645\u0629\u061b \u0648\u0644\u0627 \u064a\u062e\u062a\u0644\u0641 \u0633\u0648\u0649 \u0645\u0643\u062f\u0633\n\u0627\u0644\u0628\u0648\u0627\u0628\u0627\u062a. \u0648\u062a\u062a\u0637\u0644\u0628 \u0645\u0633\u062a\u0648\u0649 `view` \u0639\u0644\u0649 \u0627\u0644\u0623\u0642\u0644 \u0641\u064a \u0645\u062c\u0627\u0644 `dns` \u0645\u0646 \u0625\u0633\u0646\u0627\u062f \u064a\u063a\u0637\u064a \u0647\u0630\u0627\n\u0627\u0644\u0639\u0645\u064a\u0644.\n\n\u0648\u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh`: \u0641\u0627\u0644\u0646\u0633\u062e\u0629 \u0627\u0644\u062a\u064a \u062a\u064f\u062c\u0631\u064a \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u062a\u062d\u0630\u0641 \u0627\u0644\u0645\u0646\u0627\u0637\u0642 \u0627\u0644\u0645\u062d\u0644\u064a\u0629 \u2014\n\u0648\u062a\u062a\u0633\u0644\u0633\u0644 \u0625\u0644\u0649 \u0633\u062c\u0644\u0627\u062a\u0647\u0627 \u2014 \u0627\u0644\u062a\u064a \u0644\u0645 \u062a\u0639\u062f \u0642\u0627\u0626\u0645\u0629 PowerDNS \u0627\u0644\u062d\u064a\u0629 \u062a\u062a\u0636\u0645\u0646\u0647\u0627\u060c \u0642\u0628\u0644 \u0627\u0644\u0631\u062c\u0648\u0639\n\u0625\u0644\u0649 \u0631\u0627\u064a\u0629 \u0627\u0644\u062a\u062d\u062f\u064a\u062b \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0647\u0627.\n\n\u0648\u062a\u0643\u062a\u0628 \u0633\u062c\u0644 \u062a\u062f\u0642\u064a\u0642 `dns.pii_read` \u0648\u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0645\u0645\u064a\u0632\u0629 \u0627\u0644\u0623\u0636\u064a\u0642.\n\n\u0648\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u063a\u064a\u0631 \u0627\u0644\u0645\u0639\u0631\u0648\u0641\u060c \u0623\u0648 \u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0630\u064a \u0644\u0627 \u064a\u0634\u0645\u0644\u0647 \u0625\u0633\u0646\u0627\u062f \u0627\u0644\u0645\u0648\u0638\u0641\u060c \u064a\u062c\u064a\u0628 \u0628\u0640 `403` \u2014\n\u0625\u0630 \u062a\u0639\u0645\u0644 \u0627\u0644\u0628\u0648\u0627\u0628\u0629 \u0642\u0628\u0644 \u0623\u0646 \u064a\u0628\u062d\u062b \u0623\u064a \u0634\u064a\u0621 \u0639\u0646 \u0627\u0644\u0633\u062c\u0644\u060c \u0641\u064a\u0628\u0642\u0649 \u00ab\u0644\u0627 \u0648\u062c\u0648\u062f \u0644\u0647\u0630\u0627 \u0627\u0644\u062d\u0633\u0627\u0628\u00bb\n\u0648\u00ab\u0644\u064a\u0633 \u0645\u0646 \u062d\u0642\u0643 \u0631\u0624\u064a\u062a\u0647\u00bb \u063a\u064a\u0631 \u0642\u0627\u0628\u0644\u064a\u0646 \u0644\u0644\u062a\u0645\u064a\u064a\u0632. \u0648\u0644\u0627 \u0634\u064a\u0621 \u0641\u064a \u0633\u0637\u062d \u0627\u0644\u062f\u0639\u0645 \u064a\u0639\u064a\u062f `404`.\n" } }, "tags": [ "Support" ], "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of the customer's DNS zones.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin DNS alanlar\u0131ndan bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0645\u0646\u0627\u0637\u0642 DNS \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u0639\u0645\u064a\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/DNSZone" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/support/customers/{user}/subscriptions": { "get": { "operationId": "listSupportCustomerSubscriptions", "summary": "List an assigned customer's subscriptions", "description": "Identical in payload and in service resolution to the admin equivalent; only the\ngate stack differs. Requires at least `view` on the `billing` domain of an\nassignment covering this customer. Money is always a minor-unit integer with its\ncurrency, never a float.\n\nNo `refresh` parameter, and this is the sharpest case for it: the reconciling\nsibling terminates subscriptions whose linked resource has moved, promotes every\npending subscription to deployed and erases its failure reason, deletes\nroot-volume subscriptions together with their payments, and fires orphan events\nthat dial the provider \u2014 all inside one transaction.\n\nWrites a `billing.pii_read` audit row and is charged against the tighter\nprivileged read budget.\n\nAn unknown id, or one the agent is not assigned to, is a `403` \u2014 the gate runs\nbefore anything looks the record up, so \"no such account\" and \"not yours to see\"\nstay indistinguishable. Nothing on the support surface returns `404`.\n", "x-i18n": { "tr": { "summary": "Atanm\u0131\u015f bir m\u00fc\u015fterinin aboneliklerini listele", "description": "Y\u00fck ve servis \u00e7\u00f6z\u00fcmlemesi bak\u0131m\u0131ndan y\u00f6netici e\u015fde\u011feriyle ayn\u0131d\u0131r; yaln\u0131zca \u00f6n\u00fcndeki\neri\u015fim kap\u0131lar\u0131 farkl\u0131d\u0131r. Bu m\u00fc\u015fteriyi kapsayan bir ataman\u0131n `billing` alan\u0131nda en\naz `view` d\u00fczeyi gerekir. Para her zaman para biriminin alt birimi cinsinden bir tam\nsay\u0131 olarak, para birimiyle birlikte verilir; asla ondal\u0131kl\u0131 say\u0131 olarak de\u011fil.\n\n`refresh` parametresi yoktur ve bunun en keskin \u00f6rne\u011fi budur: e\u015fitleyici e\u015fi, ba\u011fl\u0131\nkayna\u011f\u0131 ta\u015f\u0131nm\u0131\u015f abonelikleri sonland\u0131r\u0131r, bekleyen her aboneli\u011fi deployed durumuna\ny\u00fckseltip ba\u015far\u0131s\u0131zl\u0131k nedenini siler, k\u00f6k disk aboneliklerini \u00f6demeleriyle birlikte\nsiler ve sa\u011flay\u0131c\u0131y\u0131 arayan sahipsiz kaynak olaylar\u0131 tetikler \u2014 hepsi tek bir\nveritaban\u0131 i\u015flemi i\u00e7inde.\n\nBir `billing.pii_read` denetim kayd\u0131 yazar ve daha dar olan ayr\u0131cal\u0131kl\u0131 okuma\nb\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr.\n\nBilinmeyen bir id ya da temsilcinin atanmad\u0131\u011f\u0131 bir id `403` d\u00f6ner \u2014 kap\u0131, kayda\nbak\u0131lmadan \u00f6nce \u00e7al\u0131\u015f\u0131r; b\u00f6ylece \u201cb\u00f6yle bir hesap yok\u201d ile \u201cbunu g\u00f6rmeye yetkiniz\nyok\u201d ay\u0131rt edilemez kal\u0131r. Destek aray\u00fcz\u00fcnde hi\u00e7bir u\u00e7 nokta `404` d\u00f6nd\u00fcrmez.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0639\u0645\u064a\u0644 \u0645\u064f\u0633\u0646\u064e\u062f", "description": "\u0645\u0637\u0627\u0628\u0642\u0629 \u0644\u0644\u0646\u0638\u064a\u0631\u0629 \u0627\u0644\u0625\u062f\u0627\u0631\u064a\u0629 \u0641\u064a \u0627\u0644\u062d\u0645\u0648\u0644\u0629 \u0648\u0641\u064a \u062d\u0644\u0651 \u0627\u0644\u062e\u062f\u0645\u0629\u061b \u0648\u0644\u0627 \u064a\u062e\u062a\u0644\u0641 \u0633\u0648\u0649 \u0645\u0643\u062f\u0633\n\u0627\u0644\u0628\u0648\u0627\u0628\u0627\u062a. \u0648\u062a\u062a\u0637\u0644\u0628 \u0645\u0633\u062a\u0648\u0649 `view` \u0639\u0644\u0649 \u0627\u0644\u0623\u0642\u0644 \u0641\u064a \u0645\u062c\u0627\u0644 `billing` \u0645\u0646 \u0625\u0633\u0646\u0627\u062f \u064a\u063a\u0637\u064a \u0647\u0630\u0627\n\u0627\u0644\u0639\u0645\u064a\u0644. \u0648\u0627\u0644\u0645\u0628\u0627\u0644\u063a \u062f\u0627\u0626\u0645\u064b\u0627 \u0639\u062f\u062f \u0635\u062d\u064a\u062d \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629 \u0645\u0639 \u0639\u0645\u0644\u062a\u0647\u0627\u060c \u0644\u0627 \u0639\u062f\u062f\n\u0639\u0634\u0631\u064a \u0623\u0628\u062f\u064b\u0627.\n\n\u0648\u0644\u0627 \u064a\u0648\u062c\u062f \u0645\u0639\u0627\u0645\u0644 `refresh`\u060c \u0648\u0647\u0630\u0647 \u0623\u0648\u0636\u062d \u062d\u0627\u0644\u0629 \u062a\u0628\u0631\u0631 \u063a\u064a\u0627\u0628\u0647\u0627: \u0641\u0627\u0644\u0646\u0633\u062e\u0629 \u0627\u0644\u062a\u064a \u062a\u064f\u062c\u0631\u064a\n\u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u062a\u064f\u0646\u0647\u064a \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u062a\u064a \u0627\u0646\u062a\u0642\u0644 \u0645\u0648\u0631\u062f\u0647\u0627 \u0627\u0644\u0645\u0631\u062a\u0628\u0637\u060c \u0648\u062a\u0631\u0641\u0639 \u0643\u0644 \u0627\u0634\u062a\u0631\u0627\u0643 \u0645\u0639\u0644\u0651\u0642 \u0625\u0644\u0649\ndeployed \u0648\u062a\u0645\u062d\u0648 \u0633\u0628\u0628 \u0641\u0634\u0644\u0647\u060c \u0648\u062a\u062d\u0630\u0641 \u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u0623\u0642\u0631\u0627\u0635 \u0627\u0644\u062c\u0630\u0631\u064a\u0629 \u0645\u0639 \u062f\u0641\u0639\u0627\u062a\u0647\u0627\u060c \u0648\u062a\u064f\u0637\u0644\u0642\n\u0623\u062d\u062f\u0627\u062b \u0627\u0644\u0645\u0648\u0627\u0631\u062f \u0627\u0644\u064a\u062a\u064a\u0645\u0629 \u0627\u0644\u062a\u064a \u062a\u062a\u0635\u0644 \u0628\u0627\u0644\u0645\u0632\u0648\u0651\u062f \u2014 \u0643\u0644 \u0630\u0644\u0643 \u062f\u0627\u062e\u0644 \u0645\u0639\u0627\u0645\u0644\u0629 \u0648\u0627\u062d\u062f\u0629.\n\n\u0648\u062a\u0643\u062a\u0628 \u0633\u062c\u0644 \u062a\u062f\u0642\u064a\u0642 `billing.pii_read` \u0648\u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0645\u0645\u064a\u0632\u0629\n\u0627\u0644\u0623\u0636\u064a\u0642.\n\n\u0648\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u063a\u064a\u0631 \u0627\u0644\u0645\u0639\u0631\u0648\u0641\u060c \u0623\u0648 \u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0630\u064a \u0644\u0627 \u064a\u0634\u0645\u0644\u0647 \u0625\u0633\u0646\u0627\u062f \u0627\u0644\u0645\u0648\u0638\u0641\u060c \u064a\u062c\u064a\u0628 \u0628\u0640 `403` \u2014\n\u0625\u0630 \u062a\u0639\u0645\u0644 \u0627\u0644\u0628\u0648\u0627\u0628\u0629 \u0642\u0628\u0644 \u0623\u0646 \u064a\u0628\u062d\u062b \u0623\u064a \u0634\u064a\u0621 \u0639\u0646 \u0627\u0644\u0633\u062c\u0644\u060c \u0641\u064a\u0628\u0642\u0649 \u00ab\u0644\u0627 \u0648\u062c\u0648\u062f \u0644\u0647\u0630\u0627 \u0627\u0644\u062d\u0633\u0627\u0628\u00bb\n\u0648\u00ab\u0644\u064a\u0633 \u0645\u0646 \u062d\u0642\u0643 \u0631\u0624\u064a\u062a\u0647\u00bb \u063a\u064a\u0631 \u0642\u0627\u0628\u0644\u064a\u0646 \u0644\u0644\u062a\u0645\u064a\u064a\u0632. \u0648\u0644\u0627 \u0634\u064a\u0621 \u0641\u064a \u0633\u0637\u062d \u0627\u0644\u062f\u0639\u0645 \u064a\u0639\u064a\u062f `404`.\n" } }, "tags": [ "Support" ], "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of the customer's subscriptions.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin aboneliklerinden bir sayfa." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u0639\u0645\u064a\u0644." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/Subscription" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } }, "/support/customers/{user}/audit-logs": { "get": { "operationId": "listSupportCustomerAuditLogs", "summary": "List an assigned customer's audit trail", "description": "The rows whose data subject is this customer, newest first, filtered to the\ndomains the calling agent holds at least `view` on.\n\nTwo gates, both required: an assignment covering this customer, and `account`\nat `view` \u2014 the same pair the equivalent panel page carries. The per-domain\nfilter inside is what stops a tickets-only agent from reading that customer's\nbilling rows once they are in. An agent holding `view` on nothing sees **zero**\nrows, not every row: the empty domain list is an explicit \"no domains\", never a\nmissing constraint.\n\nThe `auth`, `shop`, `privacy`, `partner` and `system` domains have no\nsupport-assignment equivalent and are therefore never visible here, whatever the\nagent holds. A data-subject request is between the customer and the controller,\nand a partner's commercial terms are between the partner and the business.\n\n`changes`, `context`, `hash` and `previous_hash` are not published; see the\n`AuditLog` schema for why.\n\nUnlike the panel's equivalent page, this **does** write an `account.pii_read`\nrow of its own and is charged against the tighter privileged read budget. Every\n`{user}`-scoped staff read on this API leaves a trail, without exception \u2014 a rule\nwith one exemption is a rule that rots, and reading somebody's whole audit history\nis not the access to leave unrecorded. It does mean a client paging this\ncollection appends to it.\n", "x-i18n": { "tr": { "summary": "Atanm\u0131\u015f bir m\u00fc\u015fterinin denetim kay\u0131tlar\u0131n\u0131 listele", "description": "Veri sahibi bu m\u00fc\u015fteri olan kay\u0131tlar; en yenisi ba\u015fta olmak \u00fczere ve \u00e7a\u011f\u0131ran\ntemsilcinin en az `view` d\u00fczeyinde yetkili oldu\u011fu alanlarla s\u0131n\u0131rlanarak.\n\n\u0130kisi de zorunlu iki kap\u0131: bu m\u00fc\u015fteriyi kapsayan bir atama ve `view` d\u00fczeyinde\n`account` \u2014 paneldeki e\u015fde\u011fer sayfan\u0131n ta\u015f\u0131d\u0131\u011f\u0131 \u00e7iftin ayn\u0131s\u0131. \u0130\u00e7erideki alan bazl\u0131\ns\u00fczge\u00e7 ise, yaln\u0131zca destek taleplerine yetkili bir temsilcinin i\u00e7eri girdikten\nsonra o m\u00fc\u015fterinin faturaland\u0131rma kay\u0131tlar\u0131n\u0131 okumas\u0131n\u0131 engelleyen \u015feydir. Hi\u00e7bir\nalanda `view` d\u00fczeyi olmayan bir temsilci her kayd\u0131 de\u011fil, **s\u0131f\u0131r** kay\u0131t g\u00f6r\u00fcr:\nbo\u015f alan listesi a\u00e7\u0131k\u00e7a \u201chi\u00e7bir alan\u201d demektir, eksik bir k\u0131s\u0131t de\u011fil.\n\n`auth`, `shop`, `privacy`, `partner` ve `system` alanlar\u0131n\u0131n destek atamalar\u0131nda bir\nkar\u015f\u0131l\u0131\u011f\u0131 yoktur; bu y\u00fczden temsilci ne ta\u015f\u0131rsa ta\u015f\u0131s\u0131n burada hi\u00e7 g\u00f6r\u00fcnmezler. Veri\nsahibi ba\u015fvurusu m\u00fc\u015fteri ile veri sorumlusu aras\u0131ndad\u0131r; bir i\u015f orta\u011f\u0131n\u0131n ticari\nko\u015fullar\u0131 ise i\u015f orta\u011f\u0131 ile \u015firket aras\u0131ndad\u0131r.\n\n`changes`, `context`, `hash` ve `previous_hash` alanlar\u0131 yay\u0131mlanmaz; nedeni i\u00e7in\n`AuditLog` \u015femas\u0131na bak\u0131n.\n\nPaneldeki e\u015fde\u011fer sayfan\u0131n aksine bu u\u00e7 nokta, kendi `account.pii_read` kayd\u0131n\u0131\n**yazar** ve daha dar olan ayr\u0131cal\u0131kl\u0131 okuma b\u00fct\u00e7esinden d\u00fc\u015f\u00fcl\u00fcr. Bu API'de `{user}`\nkapsam\u0131ndaki her personel okumas\u0131 istisnas\u0131z iz b\u0131rak\u0131r \u2014 tek istisnas\u0131 olan kural\n\u00e7\u00fcr\u00fcyen kurald\u0131r ve birinin b\u00fct\u00fcn denetim ge\u00e7mi\u015fini okumak, kay\u0131ts\u0131z b\u0131rak\u0131lacak\neri\u015fim de\u011fildir. Bu da \u015fu demektir: bu koleksiyonu sayfalayan bir istemci\nkoleksiyona kay\u0131t ekler.\n" }, "ar": { "summary": "\u0633\u0631\u062f \u0633\u062c\u0644 \u0627\u0644\u062a\u062f\u0642\u064a\u0642 \u0644\u0639\u0645\u064a\u0644 \u0645\u064f\u0633\u0646\u064e\u062f", "description": "\u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u062a\u064a \u064a\u0643\u0648\u0646 \u0635\u0627\u062d\u0628 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0641\u064a\u0647\u0627 \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u064a\u0644\u060c \u0627\u0644\u0623\u062d\u062f\u062b \u0623\u0648\u0644\u064b\u0627\u060c \u0645\u064f\u0631\u0634\u064e\u0651\u062d\u0629 \u0625\u0644\u0649\n\u0627\u0644\u0645\u062c\u0627\u0644\u0627\u062a \u0627\u0644\u062a\u064a \u064a\u0645\u0644\u0643 \u0641\u064a\u0647\u0627 \u0645\u0648\u0638\u0641 \u0627\u0644\u062f\u0639\u0645 \u0627\u0644\u0637\u0627\u0644\u0628 \u0645\u0633\u062a\u0648\u0649 `view` \u0639\u0644\u0649 \u0627\u0644\u0623\u0642\u0644.\n\n\u0628\u0648\u0627\u0628\u062a\u0627\u0646\u060c \u0648\u0643\u0644\u062a\u0627\u0647\u0645\u0627 \u0645\u0637\u0644\u0648\u0628\u0629: \u0625\u0633\u0646\u0627\u062f \u064a\u063a\u0637\u064a \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u064a\u0644\u060c \u0648\u0645\u0633\u062a\u0648\u0649 `view` \u0639\u0644\u0649 `account`\n\u2014 \u0648\u0647\u0648 \u0627\u0644\u0632\u0648\u062c \u0646\u0641\u0633\u0647 \u0627\u0644\u0630\u064a \u062a\u062d\u0645\u0644\u0647 \u0627\u0644\u0635\u0641\u062d\u0629 \u0627\u0644\u0645\u0643\u0627\u0641\u0626\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629. \u0648\u0627\u0644\u0645\u0631\u0634\u0650\u0651\u062d \u0644\u0643\u0644 \u0645\u062c\u0627\u0644 \u0641\u064a\n\u0627\u0644\u062f\u0627\u062e\u0644 \u0647\u0648 \u0645\u0627 \u064a\u0645\u0646\u0639 \u0645\u0648\u0638\u0641\u064b\u0627 \u0644\u0627 \u064a\u0645\u0644\u0643 \u0633\u0648\u0649 \u0627\u0644\u062a\u0630\u0627\u0643\u0631 \u0645\u0646 \u0642\u0631\u0627\u0621\u0629 \u0633\u062c\u0644\u0627\u062a \u0641\u0648\u062a\u0631\u0629 \u0630\u0644\u0643 \u0627\u0644\u0639\u0645\u064a\u0644\n\u0628\u0639\u062f \u062f\u062e\u0648\u0644\u0647. \u0648\u0627\u0644\u0645\u0648\u0638\u0641 \u0627\u0644\u0630\u064a \u0644\u0627 \u064a\u0645\u0644\u0643 `view` \u0639\u0644\u0649 \u0623\u064a \u0645\u062c\u0627\u0644 \u064a\u0631\u0649 **\u0635\u0641\u0631** \u0633\u062c\u0644\u060c \u0644\u0627 \u0643\u0644\n\u0627\u0644\u0633\u062c\u0644\u0627\u062a: \u0641\u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0645\u062c\u0627\u0644\u0627\u062a \u0627\u0644\u0641\u0627\u0631\u063a\u0629 \u062a\u0639\u0646\u064a \u0635\u0631\u0627\u062d\u0629\u064b \u00ab\u0644\u0627 \u0645\u062c\u0627\u0644\u0627\u062a\u00bb\u060c \u0644\u0627 \u0642\u064a\u062f\u064b\u0627 \u0645\u0641\u0642\u0648\u062f\u064b\u0627.\n\n\u0648\u0644\u0627 \u0645\u0642\u0627\u0628\u0644 \u0641\u064a \u0625\u0633\u0646\u0627\u062f\u0627\u062a \u0627\u0644\u062f\u0639\u0645 \u0644\u0644\u0645\u062c\u0627\u0644\u0627\u062a `auth` \u0648`shop` \u0648`privacy` \u0648`partner`\n\u0648`system`\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627 \u062a\u0638\u0647\u0631 \u0647\u0646\u0627 \u0623\u0628\u062f\u064b\u0627 \u0645\u0647\u0645\u0627 \u0643\u0627\u0646\u062a \u0635\u0644\u0627\u062d\u064a\u0627\u062a \u0627\u0644\u0645\u0648\u0638\u0641. \u0641\u0637\u0644\u0628 \u0635\u0627\u062d\u0628\n\u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0634\u0623\u0646 \u0628\u064a\u0646 \u0627\u0644\u0639\u0645\u064a\u0644 \u0648\u0627\u0644\u0645\u0633\u0624\u0648\u0644 \u0639\u0646 \u0627\u0644\u0645\u0639\u0627\u0644\u062c\u0629\u060c \u0648\u0627\u0644\u0634\u0631\u0648\u0637 \u0627\u0644\u062a\u062c\u0627\u0631\u064a\u0629 \u0644\u0644\u0634\u0631\u064a\u0643 \u0634\u0623\u0646 \u0628\u064a\u0646\n\u0627\u0644\u0634\u0631\u064a\u0643 \u0648\u0627\u0644\u0634\u0631\u0643\u0629.\n\n\u0648\u0644\u0627 \u062a\u064f\u0646\u0634\u0631 \u0627\u0644\u062d\u0642\u0648\u0644 `changes` \u0648`context` \u0648`hash` \u0648`previous_hash`\u061b \u0648\u0627\u0646\u0638\u0631 \u0645\u062e\u0637\u0637\n`AuditLog` \u0644\u0645\u0639\u0631\u0641\u0629 \u0627\u0644\u0633\u0628\u0628.\n\n\u0648\u062e\u0644\u0627\u0641\u064b\u0627 \u0644\u0644\u0635\u0641\u062d\u0629 \u0627\u0644\u0645\u0643\u0627\u0641\u0626\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u062a\u0643\u062a\u0628 \u0647\u0630\u0647 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 **\u0641\u0639\u0644\u064b\u0627** \u0633\u062c\u0644\n`account.pii_read` \u062e\u0627\u0635\u064b\u0627 \u0628\u0647\u0627\u060c \u0648\u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0645\u0645\u064a\u0632\u0629 \u0627\u0644\u0623\u0636\u064a\u0642. \u0641\u0643\u0644\n\u0642\u0631\u0627\u0621\u0629 \u0645\u0648\u0638\u0641 \u0641\u064a \u0646\u0637\u0627\u0642 `{user}` \u0639\u0644\u0649 \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u062a\u062a\u0631\u0643 \u0623\u062b\u0631\u064b\u0627 \u0628\u0644\u0627 \u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u2014 \u0641\u0627\u0644\u0642\u0627\u0639\u062f\u0629\n\u0630\u0627\u062a \u0627\u0644\u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u0627\u0644\u0648\u0627\u062d\u062f \u0642\u0627\u0639\u062f\u0629 \u0622\u064a\u0644\u0629 \u0625\u0644\u0649 \u0627\u0644\u062a\u0639\u0641\u0646\u060c \u0648\u0642\u0631\u0627\u0621\u0629 \u062a\u0627\u0631\u064a\u062e \u0627\u0644\u062a\u062f\u0642\u064a\u0642 \u0627\u0644\u0643\u0627\u0645\u0644 \u0644\u0634\u062e\u0635\n\u0645\u0627 \u0644\u064a\u0633\u062a \u0627\u0644\u0648\u0635\u0648\u0644 \u0627\u0644\u0630\u064a \u064a\u064f\u062a\u0631\u0643 \u0628\u0644\u0627 \u062a\u0633\u062c\u064a\u0644. \u0648\u064a\u0639\u0646\u064a \u0630\u0644\u0643 \u0623\u0646 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u064a\u062a\u0635\u0641\u062d \u0635\u0641\u062d\u0627\u062a \u0647\u0630\u0647\n\u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0629 \u064a\u0636\u064a\u0641 \u0625\u0644\u064a\u0647\u0627.\n" } }, "tags": [ "Support" ], "parameters": [ { "$ref": "#/components/parameters/CustomerId" }, { "$ref": "#/components/parameters/Page" }, { "$ref": "#/components/parameters/PerPage" } ], "responses": { "200": { "description": "A page of the customer's audit rows, in the domains the agent may see.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin denetim kay\u0131tlar\u0131ndan bir sayfa; temsilcinin g\u00f6rebildi\u011fi alanlarda." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0645\u0646 \u0633\u062c\u0644\u0627\u062a \u062a\u062f\u0642\u064a\u0642 \u0627\u0644\u0639\u0645\u064a\u0644\u060c \u0641\u064a \u0627\u0644\u0645\u062c\u0627\u0644\u0627\u062a \u0627\u0644\u062a\u064a \u064a\u062c\u0648\u0632 \u0644\u0644\u0645\u0648\u0638\u0641 \u0631\u0624\u064a\u062a\u0647\u0627." } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "data", "meta", "links" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AuditLog" } }, "meta": { "$ref": "#/components/schemas/PaginationMeta" }, "links": { "$ref": "#/components/schemas/PaginationLinks" } } } } } }, "401": { "$ref": "#/components/responses/Unauthorized" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "A Sanctum personal access token." } }, "schemas": { "Error": { "type": "object", "description": "An RFC 9457 problem detail document.", "x-i18n": { "tr": { "description": "RFC 9457 bi\u00e7iminde bir sorun ayr\u0131nt\u0131s\u0131 belgesi." }, "ar": { "description": "\u0645\u0633\u062a\u0646\u062f \u062a\u0641\u0635\u064a\u0644 \u0645\u0634\u0643\u0644\u0629 \u0648\u0641\u0642 RFC 9457." } }, "required": [ "type", "title", "status", "detail", "instance" ], "properties": { "type": { "type": "string", "format": "uri", "description": "A stable URI identifying the error class. One per status code.", "x-i18n": { "tr": { "description": "Hata s\u0131n\u0131f\u0131n\u0131 belirten kal\u0131c\u0131 bir URI. Her durum kodu i\u00e7in bir tane." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 URI \u062b\u0627\u0628\u062a \u064a\u062d\u062f\u062f \u0635\u0646\u0641 \u0627\u0644\u062e\u0637\u0623. \u0648\u0627\u062d\u062f \u0644\u0643\u0644 \u0631\u0645\u0632 \u062d\u0627\u0644\u0629." } }, "example": "https://cloud.core.gen.tr/api/errors/validation-failed" }, "title": { "type": "string", "example": "Validation failed" }, "status": { "type": "integer", "example": 422 }, "detail": { "type": "string", "description": "A human-readable explanation for this specific occurrence. For 5xx responses\nthis is a fixed, non-specific string in production \u2014 internal detail is logged,\nnever served.\n", "x-i18n": { "tr": { "description": "Bu belirli duruma ili\u015fkin, insan taraf\u0131ndan okunabilir bir a\u00e7\u0131klama. 5xx\nyan\u0131tlar\u0131nda \u00fcretim ortam\u0131nda sabit ve belirsiz bir metindir \u2014 i\u00e7 ayr\u0131nt\u0131lar\ng\u00fcnl\u00fc\u011fe yaz\u0131l\u0131r, asla sunulmaz.\n" }, "ar": { "description": "\u0634\u0631\u062d \u0645\u0642\u0631\u0648\u0621 \u0644\u0644\u0628\u0634\u0631 \u0644\u0647\u0630\u0647 \u0627\u0644\u062d\u0627\u0644\u0629 \u0628\u0639\u064a\u0646\u0647\u0627. \u0648\u0641\u064a \u0627\u0633\u062a\u062c\u0627\u0628\u0627\u062a 5xx \u064a\u0643\u0648\u0646 \u0646\u0635\u064b\u0627 \u062b\u0627\u0628\u062a\u064b\u0627 \u063a\u064a\u0631\n\u0645\u062d\u062f\u064e\u0651\u062f \u0641\u064a \u0628\u064a\u0626\u0629 \u0627\u0644\u0625\u0646\u062a\u0627\u062c \u2014 \u0625\u0630 \u062a\u064f\u0633\u062c\u064e\u0651\u0644 \u0627\u0644\u062a\u0641\u0627\u0635\u064a\u0644 \u0627\u0644\u062f\u0627\u062e\u0644\u064a\u0629 \u0641\u064a \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0648\u0644\u0627\n\u062a\u064f\u0642\u062f\u064e\u0651\u0645 \u0623\u0628\u062f\u064b\u0627.\n" } }, "example": "The name field is required." }, "instance": { "type": "string", "description": "The path of the request that failed.", "x-i18n": { "tr": { "description": "Ba\u015far\u0131s\u0131z olan iste\u011fin yolu." }, "ar": { "description": "\u0645\u0633\u0627\u0631 \u0627\u0644\u0637\u0644\u0628 \u0627\u0644\u0630\u064a \u0623\u062e\u0641\u0642." } }, "example": "/api/v1/me" }, "errors": { "type": "object", "nullable": true, "description": "Present only on 422. Field name to list of messages.", "x-i18n": { "tr": { "description": "Yaln\u0131zca 422 yan\u0131t\u0131nda bulunur. Alan ad\u0131ndan mesaj listesine e\u015fleme." }, "ar": { "description": "\u0644\u0627 \u064a\u0638\u0647\u0631 \u0625\u0644\u0627 \u0641\u064a 422. \u064a\u0631\u0628\u0637 \u0627\u0633\u0645 \u0627\u0644\u062d\u0642\u0644 \u0628\u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0631\u0633\u0627\u0626\u0644." } }, "additionalProperties": { "type": "array", "items": { "type": "string" } } } } }, "Money": { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } }, "User": { "type": "object", "required": [ "id", "name", "email", "type", "email_verified_at", "created_at", "roles", "abilities" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the account.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Hesap var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u062d\u0633\u0627\u0628." } }, "example": 42 }, "name": { "type": "string", "example": "Ada Lovelace" }, "email": { "type": "string", "format": "email", "example": "ada@example.test" }, "type": { "type": "string", "enum": [ "user", "admin", "support" ] }, "language": { "type": "string", "nullable": true, "example": "tr" }, "phone": { "type": "string", "nullable": true, "example": "+905551234567" }, "email_verified_at": { "type": "string", "format": "date-time", "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "roles": { "type": "array", "items": { "type": "string" }, "example": [ "user" ] }, "abilities": { "type": "array", "description": "The abilities carried by the token used for this request.", "x-i18n": { "tr": { "description": "Bu istekte kullan\u0131lan anahtar\u0131n ta\u015f\u0131d\u0131\u011f\u0131 izinler." }, "ar": { "description": "\u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0627\u062a \u0627\u0644\u062a\u064a \u064a\u062d\u0645\u0644\u0647\u0627 \u0627\u0644\u0631\u0645\u0632 \u0627\u0644\u0645\u0645\u064a\u0632 \u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645 \u0641\u064a \u0647\u0630\u0627 \u0627\u0644\u0637\u0644\u0628." } }, "items": { "type": "string" }, "example": [ "account:read", "cloud:read" ] } } }, "Instance": { "type": "object", "required": [ "id", "name", "hostname", "state", "hypervisor", "template", "ip_address", "gateway", "mac_address", "network_id", "is_locked", "created_at", "provisioned_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the machine.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Sanal makina var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a." } }, "example": 17 }, "name": { "type": "string", "example": "web-1" }, "hostname": { "type": "string", "nullable": true }, "state": { "type": "string", "description": "Normalised lifecycle state. `starting`, `stopping`, `migrating` and `expunging`\nare transitional \u2014 poll until the state settles.\n", "x-i18n": { "tr": { "description": "Normalle\u015ftirilmi\u015f ya\u015fam d\u00f6ng\u00fcs\u00fc durumu. `starting`, `stopping`, `migrating`\nve `expunging` ge\u00e7i\u015f durumlar\u0131d\u0131r \u2014 durum yerine oturana kadar yoklay\u0131n.\n" }, "ar": { "description": "\u062d\u0627\u0644\u0629 \u062f\u0648\u0631\u0629 \u0627\u0644\u062d\u064a\u0627\u0629 \u0628\u0639\u062f \u062a\u0648\u062d\u064a\u062f\u0647\u0627. \u0648\u0627\u0644\u062d\u0627\u0644\u0627\u062a `starting` \u0648`stopping` \u0648`migrating`\n\u0648`expunging` \u0627\u0646\u062a\u0642\u0627\u0644\u064a\u0629 \u2014 \u0627\u0633\u062a\u0637\u0644\u0639\u0647\u0627 \u0625\u0644\u0649 \u0623\u0646 \u062a\u0633\u062a\u0642\u0631 \u0627\u0644\u062d\u0627\u0644\u0629.\n" } }, "enum": [ "running", "stopped", "starting", "stopping", "migrating", "shutdown", "destroyed", "expunging", "error", "unknown" ] }, "hypervisor": { "type": "string", "nullable": true }, "template": { "type": "string", "nullable": true }, "ip_address": { "type": "string", "nullable": true, "example": "10.0.0.14" }, "gateway": { "type": "string", "nullable": true }, "mac_address": { "type": "string", "nullable": true }, "network_id": { "type": "integer", "nullable": true, "description": "The network this machine's first NIC is on. An account has been able to hold\nmore than one network since 2026-08-25, so this is what says which. Null on a\nrow the reconciler has not attributed yet, which a client should read as the\naccount's default network.\n", "x-i18n": { "tr": { "description": "Bu sanal makinan\u0131n ilk a\u011f arabiriminin ba\u011fl\u0131 oldu\u011fu a\u011f. 2026-08-25'ten bu\nyana bir hesap birden fazla a\u011f tutabildi\u011fi i\u00e7in hangisi oldu\u011funu s\u00f6yleyen\nalan budur. E\u015fitleyicinin hen\u00fcz ili\u015fkilendirmedi\u011fi bir sat\u0131rda null olur;\nistemci bunu hesab\u0131n varsay\u0131lan a\u011f\u0131 olarak okumal\u0131d\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0634\u0628\u0643\u0629 \u0627\u0644\u062a\u064a \u062a\u0648\u062c\u062f \u0639\u0644\u064a\u0647\u0627 \u0623\u0648\u0644 \u0628\u0637\u0627\u0642\u0629 \u0634\u0628\u0643\u0629 \u0644\u0647\u0630\u0627 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a. \u0641\u0645\u0646\u0630 2026-08-25 \u0635\u0627\u0631\n\u0628\u0625\u0645\u0643\u0627\u0646 \u0627\u0644\u062d\u0633\u0627\u0628 \u0623\u0646 \u064a\u0645\u0644\u0643 \u0623\u0643\u062b\u0631 \u0645\u0646 \u0634\u0628\u0643\u0629\u060c \u0648\u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644 \u0647\u0648 \u0627\u0644\u0630\u064a \u064a\u062d\u062f\u062f \u0623\u064a\u064e\u0651\u0647\u0627. \u0648\u062a\u0643\u0648\u0646\n\u0642\u064a\u0645\u062a\u0647 null \u0641\u064a \u0635\u0641\u064d\u0651 \u0644\u0645 \u064a\u064e\u0646\u0633\u0650\u0628\u0647 \u0627\u0644\u0645\u064f\u0637\u0627\u0628\u0650\u0642 \u0628\u0639\u062f\u060c \u0648\u0639\u0644\u0649 \u0627\u0644\u0639\u0645\u064a\u0644 \u0623\u0646 \u064a\u0642\u0631\u0623 \u0630\u0644\u0643 \u0639\u0644\u0649\n\u0623\u0646\u0647 \u0627\u0644\u0634\u0628\u0643\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0644\u0644\u062d\u0633\u0627\u0628.\n" } }, "example": 3 }, "is_locked": { "type": "boolean", "description": "True when the owning subscription is unpaid or suspended. Every mutation is\nrefused with 403 while this holds.\n", "x-i18n": { "tr": { "description": "Sahibi olan abonelik \u00f6denmemi\u015f ya da ask\u0131ya al\u0131nm\u0131\u015fsa true olur. Bu durum\ns\u00fcrd\u00fc\u011f\u00fc s\u00fcrece her de\u011fi\u015fiklik 403 ile reddedilir.\n" }, "ar": { "description": "\u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 true \u0639\u0646\u062f\u0645\u0627 \u064a\u0643\u0648\u0646 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0645\u0627\u0644\u0643 \u063a\u064a\u0631 \u0645\u062f\u0641\u0648\u0639 \u0623\u0648 \u0645\u0648\u0642\u0648\u0641\u064b\u0627. \u0648\u064a\u064f\u0631\u0641\u0636 \u0643\u0644\n\u062a\u0639\u062f\u064a\u0644 \u0628\u0640 403 \u0645\u0627 \u062f\u0627\u0645\u062a \u0647\u0630\u0647 \u0627\u0644\u062d\u0627\u0644\u0629 \u0642\u0627\u0626\u0645\u0629.\n" } } }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "provisioned_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When the cloud reported the machine created.", "x-i18n": { "tr": { "description": "Bulutun sanal makinan\u0131n olu\u015fturuldu\u011funu bildirdi\u011fi an." }, "ar": { "description": "\u0648\u0642\u062a \u0625\u0628\u0644\u0627\u063a \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0628\u0623\u0646 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0642\u062f \u0623\u064f\u0646\u0634\u0626." } } } } }, "InstancePassword": { "type": "object", "required": [ "password" ], "properties": { "password": { "type": "string", "nullable": true, "description": "The instance's stored root/administrator password. `null` when the owning\nsubscription is locked (unpaid or suspended) and the caller is not staff, or\nwhen no password has ever been set (a template that is not password-enabled).\n", "x-i18n": { "tr": { "description": "Sanal makinan\u0131n kay\u0131tl\u0131 root/y\u00f6netici parolas\u0131. Sahibi olan abonelik\nkilitliyse (\u00f6denmemi\u015f ya da ask\u0131ya al\u0131nm\u0131\u015f) ve \u00e7a\u011f\u0131ran personel de\u011filse, ya\nda hi\u00e7 parola tan\u0131mlanmam\u0131\u015fsa (parola deste\u011fi olmayan bir \u015fablon) `null`\nolur.\n" }, "ar": { "description": "\u0643\u0644\u0645\u0629 \u0645\u0631\u0648\u0631 \u0627\u0644\u062c\u0630\u0631/\u0627\u0644\u0645\u062f\u064a\u0631 \u0627\u0644\u0645\u062e\u0632\u064e\u0651\u0646\u0629 \u0644\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a. \u0648\u062a\u0643\u0648\u0646 `null` \u0639\u0646\u062f\u0645\u0627 \u064a\u0643\u0648\u0646\n\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0645\u0627\u0644\u0643 \u0645\u0642\u0641\u0644\u064b\u0627 (\u063a\u064a\u0631 \u0645\u062f\u0641\u0648\u0639 \u0623\u0648 \u0645\u0648\u0642\u0648\u0641) \u0648\u0644\u0627 \u064a\u0643\u0648\u0646 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0645\u0646 \u0627\u0644\u0645\u0648\u0638\u0641\u064a\u0646\u060c\n\u0623\u0648 \u0639\u0646\u062f\u0645\u0627 \u0644\u0627 \u062a\u0643\u0648\u0646 \u0642\u062f \u0636\u064f\u0628\u0637\u062a \u0643\u0644\u0645\u0629 \u0645\u0631\u0648\u0631 \u0642\u0637 (\u0642\u0627\u0644\u0628 \u0644\u0627 \u064a\u062f\u0639\u0645 \u0643\u0644\u0645\u0627\u062a \u0627\u0644\u0645\u0631\u0648\u0631).\n" } }, "example": "sup3rs3cret" } } }, "InstanceConsole": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "nullable": true, "description": "A one-time URL for an interactive console session, minted fresh on every\ncall. `null` when the cloud could not create a session (the SDK's own\n`CreateConsoleEndpointResponse` is a superset of this \u2014 it also carries\n`success`, `jobid`, `jobstatus` and `websocket` fields \u2014 but the API surface\nexposes only the URL a client actually needs to open a session).\n", "x-i18n": { "tr": { "description": "Etkile\u015fimli bir konsol oturumu i\u00e7in tek kullan\u0131ml\u0131k URL; her \u00e7a\u011fr\u0131da\nyeniden \u00fcretilir. Bulut bir oturum olu\u015fturamad\u0131\u011f\u0131nda `null` olur\n(SDK'n\u0131n kendi `CreateConsoleEndpointResponse` yan\u0131t\u0131 bunun bir \u00fcst\nk\u00fcmesidir \u2014 ayr\u0131ca `success`, `jobid`, `jobstatus` ve `websocket`\nalanlar\u0131n\u0131 da ta\u015f\u0131r \u2014 ama API aray\u00fcz\u00fc yaln\u0131zca bir istemcinin oturumu a\u00e7mak\ni\u00e7in ger\u00e7ekten ihtiya\u00e7 duydu\u011fu URL'yi a\u00e7ar).\n" }, "ar": { "description": "\u0639\u0646\u0648\u0627\u0646 URL \u064a\u064f\u0633\u062a\u062e\u062f\u0645 \u0645\u0631\u0629 \u0648\u0627\u062d\u062f\u0629 \u0644\u062c\u0644\u0633\u0629 \u0637\u0631\u0641\u064a\u0629 \u062a\u0641\u0627\u0639\u0644\u064a\u0629\u060c \u0648\u064a\u064f\u0635\u062f\u064e\u0631 \u062c\u062f\u064a\u062f\u064b\u0627 \u0645\u0639 \u0643\u0644\n\u0627\u0633\u062a\u062f\u0639\u0627\u0621. \u0648\u062a\u0643\u0648\u0646 \u0642\u064a\u0645\u062a\u0647 `null` \u0639\u0646\u062f\u0645\u0627 \u062a\u0639\u062c\u0632 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0639\u0646 \u0625\u0646\u0634\u0627\u0621 \u062c\u0644\u0633\u0629 (\u0625\u0630 \u0625\u0646\n`CreateConsoleEndpointResponse` \u0641\u064a \u062d\u0632\u0645\u0629 \u0627\u0644\u062a\u0637\u0648\u064a\u0631 \u0645\u062c\u0645\u0648\u0639\u0629 \u0623\u0648\u0633\u0639 \u0645\u0646 \u0647\u0630\u0647 \u2014 \u0641\u0647\u064a\n\u062a\u062d\u0645\u0644 \u0623\u064a\u0636\u064b\u0627 \u0627\u0644\u062d\u0642\u0648\u0644 `success` \u0648`jobid` \u0648`jobstatus` \u0648`websocket` \u2014 \u0644\u0643\u0646 \u0648\u0627\u062c\u0647\u0629\n\u0627\u0644\u0628\u0631\u0645\u062c\u0629 \u0644\u0627 \u062a\u0643\u0634\u0641 \u0625\u0644\u0627 \u0627\u0644\u0639\u0646\u0648\u0627\u0646 \u0627\u0644\u0630\u064a \u064a\u062d\u062a\u0627\u062c\u0647 \u0627\u0644\u0639\u0645\u064a\u0644 \u0641\u0639\u0644\u064b\u0627 \u0644\u0641\u062a\u062d \u0627\u0644\u062c\u0644\u0633\u0629).\n" } }, "example": "https://console.core.gen.tr/session/abc123" } } }, "Volume": { "type": "object", "required": [ "id", "name", "type", "state", "size", "template", "instance_id", "instance_name", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the volume.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Disk var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u0642\u0631\u0635." } }, "example": 42 }, "name": { "type": "string", "nullable": true, "example": "data-1" }, "type": { "type": "string", "nullable": true, "description": "The cloud's own volume type, e.g. `ROOT` or `DATADISK`.", "x-i18n": { "tr": { "description": "Bulutun kendi disk t\u00fcr\u00fc; \u00f6rne\u011fin `ROOT` ya da `DATADISK`." }, "ar": { "description": "\u0646\u0648\u0639 \u0627\u0644\u0642\u0631\u0635 \u0644\u062f\u0649 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0646\u0641\u0633\u0647\u0627\u060c \u0645\u062b\u0644 `ROOT` \u0623\u0648 `DATADISK`." } }, "example": "DATADISK" }, "state": { "type": "string", "description": "Normalised lifecycle state. `creating`, `migrating`, `snapshotting`, `copying`,\n`expunging`, `attaching` and `detaching` are transitional \u2014 poll until the state\nsettles.\n", "x-i18n": { "tr": { "description": "Normalle\u015ftirilmi\u015f ya\u015fam d\u00f6ng\u00fcs\u00fc durumu. `creating`, `migrating`, `snapshotting`,\n`copying`, `expunging`, `attaching` ve `detaching` ge\u00e7i\u015f durumlar\u0131d\u0131r \u2014 durum\nyerine oturana kadar yoklay\u0131n.\n" }, "ar": { "description": "\u062d\u0627\u0644\u0629 \u062f\u0648\u0631\u0629 \u0627\u0644\u062d\u064a\u0627\u0629 \u0628\u0639\u062f \u0627\u0644\u062a\u0648\u062d\u064a\u062f. \u0627\u0644\u0642\u064a\u0645 `creating` \u0648`migrating` \u0648`snapshotting`\n\u0648`copying` \u0648`expunging` \u0648`attaching` \u0648`detaching` \u0627\u0646\u062a\u0642\u0627\u0644\u064a\u0629 \u2014 \u0627\u0633\u062a\u0639\u0644\u0645 \u062f\u0648\u0631\u064a\u064b\u0627\n\u0625\u0644\u0649 \u0623\u0646 \u062a\u0633\u062a\u0642\u0631 \u0627\u0644\u062d\u0627\u0644\u0629.\n" } }, "enum": [ "allocated", "creating", "ready", "migrating", "snapshotting", "uploaded", "uploaderror", "copying", "attaching", "detaching", "destroy", "expunging", "expunged", "corrupted", "unknown" ] }, "size": { "type": "integer", "description": "Size in bytes.", "x-i18n": { "tr": { "description": "Bayt cinsinden boyut." }, "ar": { "description": "\u0627\u0644\u062d\u062c\u0645 \u0628\u0627\u0644\u0628\u0627\u064a\u062a." } }, "example": 21474836480 }, "template": { "type": "string", "nullable": true, "description": "The template the volume was created from, if any.", "x-i18n": { "tr": { "description": "Diskin olu\u015fturuldu\u011fu \u015fablon, varsa." }, "ar": { "description": "\u0627\u0644\u0642\u0627\u0644\u0628 \u0627\u0644\u0630\u064a \u0623\u064f\u0646\u0634\u0626 \u0645\u0646\u0647 \u0627\u0644\u0642\u0631\u0635\u060c \u0625\u0646 \u0648\u064f\u062c\u062f." } } }, "instance_id": { "type": "integer", "nullable": true, "description": "The id of the instance this volume is attached to (see `GET /instances/{id}`),\nor `null` when detached.\n", "x-i18n": { "tr": { "description": "Bu diskin ba\u011fl\u0131 oldu\u011fu sanal makinan\u0131n kimli\u011fi (bkz. `GET /instances/{id}`);\nba\u011fl\u0131 de\u011filse `null`.\n" }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0627\u0644\u0630\u064a \u064a\u0631\u062a\u0628\u0637 \u0628\u0647 \u0647\u0630\u0627 \u0627\u0644\u0642\u0631\u0635 (\u0627\u0646\u0638\u0631 `GET /instances/{id}`)\u060c\n\u0623\u0648 `null` \u0639\u0646\u062f \u0641\u0635\u0644\u0647.\n" } }, "example": 17 }, "instance_name": { "type": "string", "nullable": true, "description": "The attached instance's display name, as last observed.", "x-i18n": { "tr": { "description": "Son g\u00f6zlendi\u011fi h\u00e2liyle ba\u011fl\u0131 sanal makinan\u0131n g\u00f6r\u00fcnen ad\u0131." }, "ar": { "description": "\u0627\u0644\u0627\u0633\u0645 \u0627\u0644\u0645\u0639\u0631\u0648\u0636 \u0644\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0627\u0644\u0645\u0631\u062a\u0628\u0637\u060c \u0628\u062d\u0633\u0628 \u0622\u062e\u0631 \u0631\u0635\u062f." } } }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "Snapshot": { "type": "object", "required": [ "id", "volume_id", "name", "state", "type", "interval_type", "size", "restore_count", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier of the snapshot.", "x-i18n": { "tr": { "description": "Anl\u0131k g\u00f6r\u00fcnt\u00fcn\u00fcn kal\u0131c\u0131 kimli\u011fi." }, "ar": { "description": "\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u062b\u0627\u0628\u062a \u0644\u0644\u0651\u0642\u0637\u0629." } }, "example": 31 }, "volume_id": { "type": "integer", "nullable": true, "description": "The disk this snapshot was taken of (see `GET /volumes/{id}`).", "x-i18n": { "tr": { "description": "Bu anl\u0131k g\u00f6r\u00fcnt\u00fcn\u00fcn al\u0131nd\u0131\u011f\u0131 disk (bkz. `GET /volumes/{id}`)." }, "ar": { "description": "\u0627\u0644\u0642\u0631\u0635 \u0627\u0644\u0630\u064a \u0623\u064f\u062e\u0630\u062a \u0645\u0646\u0647 \u0647\u0630\u0647 \u0627\u0644\u0644\u0642\u0637\u0629 (\u0627\u0646\u0638\u0631 `GET /volumes/{id}`)." } }, "example": 12 }, "name": { "type": "string", "nullable": true, "description": "The label given when the snapshot was taken, if any.", "x-i18n": { "tr": { "description": "Anl\u0131k g\u00f6r\u00fcnt\u00fc al\u0131n\u0131rken verilen etiket, varsa." }, "ar": { "description": "\u0627\u0644\u062a\u0633\u0645\u064a\u0629 \u0627\u0644\u062a\u064a \u0623\u064f\u0639\u0637\u064a\u062a \u0639\u0646\u062f \u0623\u062e\u0630 \u0627\u0644\u0644\u0642\u0637\u0629\u060c \u0625\u0646 \u0648\u064f\u062c\u062f\u062a." } }, "example": "before-upgrade" }, "state": { "type": "string", "nullable": true, "description": "The cloud's own state for the snapshot, as last observed. `Creating` means it was\nrequested and is still being taken.\n", "x-i18n": { "tr": { "description": "Son g\u00f6zlendi\u011fi h\u00e2liyle bulutun anl\u0131k g\u00f6r\u00fcnt\u00fc i\u00e7in bildirdi\u011fi durum. `Creating`,\nistendi\u011fi ve h\u00e2l\u00e2 al\u0131nmakta oldu\u011fu anlam\u0131na gelir.\n" }, "ar": { "description": "\u062d\u0627\u0644\u0629 \u0627\u0644\u0644\u0642\u0637\u0629 \u0644\u062f\u0649 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0646\u0641\u0633\u0647\u0627 \u0628\u062d\u0633\u0628 \u0622\u062e\u0631 \u0631\u0635\u062f. \u0648\u062a\u0639\u0646\u064a `Creating` \u0623\u0646\u0647\u0627 \u0637\u064f\u0644\u0628\u062a \u0648\u0645\u0627 \u0632\u0627\u0644\n\u0623\u062e\u0630\u0647\u0627 \u062c\u0627\u0631\u064a\u064b\u0627.\n" } }, "example": "BackedUp" }, "type": { "type": "string", "enum": [ "manual", "recurring" ], "description": "`manual` was taken on request and counts against the snapshot limit; `recurring` was\ntaken by a retention schedule, which also removes the oldest past its count.\n", "x-i18n": { "tr": { "description": "`manual` istek \u00fczerine al\u0131nm\u0131\u015ft\u0131r ve anl\u0131k g\u00f6r\u00fcnt\u00fc s\u0131n\u0131r\u0131ndan d\u00fc\u015fer; `recurring` bir\nsaklama plan\u0131yla al\u0131nm\u0131\u015ft\u0131r ve plan, say\u0131s\u0131n\u0131 a\u015fan en eskisini kendisi siler.\n" }, "ar": { "description": "`manual` \u0623\u064f\u062e\u0630\u062a \u0628\u0637\u0644\u0628 \u0648\u062a\u064f\u062d\u062a\u0633\u0628 \u0636\u0645\u0646 \u062d\u062f\u0651 \u0627\u0644\u0644\u0642\u0637\u0627\u062a\u061b \u0648`recurring` \u0623\u062e\u0630\u0647\u0627 \u062c\u062f\u0648\u0644 \u0627\u062d\u062a\u0641\u0627\u0638\u060c \u0648\u0647\u0648\n\u064a\u062d\u0630\u0641 \u0623\u0642\u062f\u0645\u0647\u0627 \u0645\u062a\u0649 \u062a\u062c\u0627\u0648\u0632 \u0639\u062f\u062f\u0647\u0627 \u0645\u0627 \u062d\u062f\u0651\u062f\u0647.\n" } } }, "interval_type": { "type": "string", "nullable": true, "description": "For a recurring snapshot, the schedule that took it (for example `DAILY`).", "x-i18n": { "tr": { "description": "Tekrarlanan bir anl\u0131k g\u00f6r\u00fcnt\u00fcde, onu alan plan (\u00f6rne\u011fin `DAILY`)." }, "ar": { "description": "\u0641\u064a \u0627\u0644\u0644\u0642\u0637\u0629 \u0627\u0644\u0645\u062a\u0643\u0631\u0651\u0631\u0629\u060c \u0627\u0644\u062c\u062f\u0648\u0644 \u0627\u0644\u0630\u064a \u0623\u062e\u0630\u0647\u0627 (\u0645\u062b\u0644 `DAILY`)." } }, "example": "DAILY" }, "size": { "type": "integer", "nullable": true, "description": "Size in bytes, once the cloud reports it.", "x-i18n": { "tr": { "description": "Bulut bildirdi\u011finde, bayt cinsinden boyut." }, "ar": { "description": "\u0627\u0644\u062d\u062c\u0645 \u0628\u0627\u0644\u0628\u0627\u064a\u062a\u060c \u0645\u062a\u0649 \u0623\u0628\u0644\u063a\u062a \u0639\u0646\u0647 \u0627\u0644\u0633\u062d\u0627\u0628\u0629." } }, "example": 5368709120 }, "restore_count": { "type": "integer", "description": "How many times a new disk has been made from this snapshot.", "x-i18n": { "tr": { "description": "Bu anl\u0131k g\u00f6r\u00fcnt\u00fcden ka\u00e7 kez yeni bir disk olu\u015fturuldu\u011fu." }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u0645\u0631\u0627\u062a \u0627\u0644\u062a\u064a \u0623\u064f\u0646\u0634\u0626 \u0641\u064a\u0647\u0627 \u0642\u0631\u0635 \u062c\u062f\u064a\u062f \u0645\u0646 \u0647\u0630\u0647 \u0627\u0644\u0644\u0642\u0637\u0629." } }, "example": 0 }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "Iso": { "type": "object", "required": [ "id", "name", "description", "size", "bits", "bootable", "is_ready", "is_public", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the ISO record.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. ISO kayd\u0131 var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0633\u062c\u0644\u0651 ISO." } }, "example": 5 }, "name": { "type": "string", "nullable": true, "example": "debian-12-netinst" }, "description": { "type": "string", "nullable": true }, "size": { "type": "integer", "description": "Size in bytes.", "x-i18n": { "tr": { "description": "Bayt cinsinden boyut." }, "ar": { "description": "\u0627\u0644\u062d\u062c\u0645 \u0628\u0627\u0644\u0628\u0627\u064a\u062a." } }, "example": 662700032 }, "bits": { "type": "integer", "example": 64 }, "bootable": { "type": "boolean" }, "is_ready": { "type": "boolean", "description": "Whether the cloud has finished preparing this ISO for use.", "x-i18n": { "tr": { "description": "Bulutun bu ISO'yu kullan\u0131ma haz\u0131rlamay\u0131 bitirip bitirmedi\u011fi." }, "ar": { "description": "\u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646\u062a \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0642\u062f \u0623\u0646\u0647\u062a \u062a\u0647\u064a\u0626\u0629 \u0647\u0630\u0627 \u0627\u0644\u0640 ISO \u0644\u0644\u0627\u0633\u062a\u062e\u062f\u0627\u0645." } } }, "is_public": { "type": "boolean", "description": "Visible to every customer, not just its uploader. A private ISO belonging to\nanother customer is indistinguishable from one that does not exist (see the\n404 response on `GET /isos/{iso}`).\n", "x-i18n": { "tr": { "description": "Yaln\u0131zca y\u00fckleyene de\u011fil, her m\u00fc\u015fteriye g\u00f6r\u00fcn\u00fcr. Ba\u015fka bir m\u00fc\u015fteriye ait\n\u00f6zel bir ISO, var olmayan bir ISO'dan ay\u0131rt edilemez\n(bkz. `GET /isos/{iso}` \u00fczerindeki 404 yan\u0131t\u0131).\n" }, "ar": { "description": "\u0638\u0627\u0647\u0631 \u0644\u0643\u0644 \u0627\u0644\u0639\u0645\u0644\u0627\u0621 \u0644\u0627 \u0644\u0645\u0646 \u0631\u0641\u0639\u0647 \u0648\u062d\u062f\u0647. \u0648\u0627\u0644\u0640 ISO \u0627\u0644\u062e\u0627\u0635 \u0627\u0644\u0639\u0627\u0626\u062f \u0644\u0639\u0645\u064a\u0644 \u0622\u062e\u0631 \u0644\u0627 \u064a\u0645\u0643\u0646\n\u062a\u0645\u064a\u064a\u0632\u0647 \u0639\u0646 ISO \u063a\u064a\u0631 \u0645\u0648\u062c\u0648\u062f \u0623\u0635\u0644\u064b\u0627 (\u0627\u0646\u0638\u0631 \u0627\u0633\u062a\u062c\u0627\u0628\u0629 404 \u0641\u064a `GET /isos/{iso}`).\n" } } }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "Template": { "type": "object", "required": [ "id", "name", "slug", "description", "size", "format", "os", "avatar", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the template.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. \u015eablon var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u0642\u0627\u0644\u0628." } }, "example": 3 }, "name": { "type": "string", "nullable": true, "example": "Ubuntu 24.04 LTS" }, "slug": { "type": "string", "nullable": true, "example": "ubuntu-24-04-lts" }, "description": { "type": "string", "nullable": true }, "size": { "type": "integer", "description": "Size in bytes.", "x-i18n": { "tr": { "description": "Bayt cinsinden boyut." }, "ar": { "description": "\u0627\u0644\u062d\u062c\u0645 \u0628\u0627\u0644\u0628\u0627\u064a\u062a." } }, "example": 2684354560 }, "format": { "type": "string", "nullable": true, "example": "qcow2" }, "os": { "type": "string", "nullable": true }, "avatar": { "type": "string", "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "ComputeOffering": { "type": "object", "required": [ "id", "name", "description", "cpu_number", "cpu_speed", "memory", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the offering.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Tan\u0131m var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u062a\u0639\u0631\u064a\u0641." } }, "example": 2 }, "name": { "type": "string", "nullable": true, "example": "2 vCPU / 4 GB" }, "description": { "type": "string", "nullable": true }, "cpu_number": { "type": "integer", "example": 2 }, "cpu_speed": { "type": "integer", "description": "Clock speed in MHz.", "x-i18n": { "tr": { "description": "MHz cinsinden saat h\u0131z\u0131." }, "ar": { "description": "\u0633\u0631\u0639\u0629 \u0627\u0644\u0645\u0639\u0627\u0644\u062c \u0628\u0627\u0644\u0645\u064a\u063a\u0627\u0647\u0631\u062a\u0632." } }, "example": 2000 }, "memory": { "type": "integer", "description": "Memory in MB.", "x-i18n": { "tr": { "description": "MB cinsinden bellek." }, "ar": { "description": "\u0627\u0644\u0630\u0627\u0643\u0631\u0629 \u0628\u0627\u0644\u0645\u064a\u063a\u0627\u0628\u0627\u064a\u062a." } }, "example": 4096 }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "DiskOffering": { "type": "object", "required": [ "id", "name", "description", "disk_size", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the offering.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Tan\u0131m var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u062a\u0639\u0631\u064a\u0641." } }, "example": 1 }, "name": { "type": "string", "nullable": true, "example": "20 GB" }, "description": { "type": "string", "nullable": true }, "disk_size": { "type": "integer", "description": "Size in GB.", "x-i18n": { "tr": { "description": "GB cinsinden boyut." }, "ar": { "description": "\u0627\u0644\u062d\u062c\u0645 \u0628\u0627\u0644\u063a\u064a\u063a\u0627\u0628\u0627\u064a\u062a." } }, "example": 20 }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "IngressRule": { "type": "object", "required": [ "id", "instance_id", "public_ip_address", "public_port_start", "public_port_end", "protocol", "state", "private_port_start", "private_port_end", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the rule.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Kural var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u0642\u0627\u0639\u062f\u0629." } }, "example": 5 }, "instance_id": { "type": "integer", "nullable": true, "description": "The id of the instance this rule forwards to (see `GET /instances/{id}`).", "x-i18n": { "tr": { "description": "Bu kural\u0131n y\u00f6nlendirdi\u011fi sanal makinan\u0131n kimli\u011fi (bkz. `GET /instances/{id}`)." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0627\u0644\u0630\u064a \u062a\u064f\u0648\u062c\u0650\u0651\u0647 \u0625\u0644\u064a\u0647 \u0647\u0630\u0647 \u0627\u0644\u0642\u0627\u0639\u062f\u0629 (\u0627\u0646\u0638\u0631 `GET /instances/{id}`)." } }, "example": 17 }, "public_ip_address": { "type": "string", "nullable": true, "description": "One of the caller's own public IP addresses.", "x-i18n": { "tr": { "description": "\u00c7a\u011f\u0131ran\u0131n kendi kamusal IP adreslerinden biri." }, "ar": { "description": "\u0623\u062d\u062f \u0639\u0646\u0627\u0648\u064a\u0646 IP \u0627\u0644\u0639\u0627\u0645\u0629 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a." } }, "example": "203.0.113.10" }, "public_port_start": { "type": "integer", "minimum": 1, "maximum": 65535, "nullable": true }, "public_port_end": { "type": "integer", "minimum": 1, "maximum": 65535, "nullable": true }, "protocol": { "type": "string", "enum": [ "tcp", "udp", "icmp" ] }, "state": { "type": "string", "nullable": true, "description": "The cloud's own rule state, as last observed.", "x-i18n": { "tr": { "description": "Son g\u00f6zlendi\u011fi h\u00e2liyle bulutun kendi kural durumu." }, "ar": { "description": "\u062d\u0627\u0644\u0629 \u0627\u0644\u0642\u0627\u0639\u062f\u0629 \u0644\u062f\u0649 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0646\u0641\u0633\u0647\u0627\u060c \u0628\u062d\u0633\u0628 \u0622\u062e\u0631 \u0631\u0635\u062f." } }, "example": "Active" }, "private_port_start": { "type": "integer", "minimum": 1, "maximum": 65535, "nullable": true }, "private_port_end": { "type": "integer", "minimum": 1, "maximum": 65535, "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "EgressRule": { "type": "object", "required": [ "id", "source_cidr", "destination_cidr", "protocol", "port_start", "port_end", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the rule.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Kural var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u0642\u0627\u0639\u062f\u0629." } }, "example": 9 }, "source_cidr": { "type": "string", "nullable": true, "description": "The source CIDR block traffic must originate from.", "x-i18n": { "tr": { "description": "Trafi\u011fin \u00e7\u0131kmak zorunda oldu\u011fu kaynak CIDR blo\u011fu." }, "ar": { "description": "\u0643\u062a\u0644\u0629 CIDR \u0627\u0644\u0645\u0635\u062f\u0631 \u0627\u0644\u062a\u064a \u064a\u062c\u0628 \u0623\u0646 \u062a\u0646\u0637\u0644\u0642 \u0645\u0646\u0647\u0627 \u062d\u0631\u0643\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a." } }, "example": "10.0.0.0/24" }, "destination_cidr": { "type": "string", "nullable": true, "description": "The destination CIDR block traffic is permitted toward.", "x-i18n": { "tr": { "description": "Trafi\u011fe izin verilen hedef CIDR blo\u011fu." }, "ar": { "description": "\u0643\u062a\u0644\u0629 CIDR \u0627\u0644\u0648\u062c\u0647\u0629 \u0627\u0644\u0645\u0633\u0645\u0648\u062d \u0628\u0627\u0644\u062a\u0648\u062c\u0647 \u0625\u0644\u064a\u0647\u0627." } }, "example": "0.0.0.0/0" }, "protocol": { "type": "string", "enum": [ "tcp", "udp", "icmp" ] }, "port_start": { "type": "integer", "minimum": 1, "maximum": 65535, "nullable": true }, "port_end": { "type": "integer", "minimum": 1, "maximum": 65535, "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "PublicIPAddress": { "type": "object", "required": [ "id", "ip_address", "is_source_nat", "is_static_nat", "state", "allocated", "reverse_record", "network_id", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the address.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Adres var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u0639\u0646\u0648\u0627\u0646." } }, "example": 4 }, "ip_address": { "type": "string", "nullable": true, "example": "203.0.113.10" }, "is_source_nat": { "type": "boolean", "description": "Whether this address is the source NAT IP for its network.", "x-i18n": { "tr": { "description": "Bu adresin, ba\u011fl\u0131 oldu\u011fu a\u011f\u0131n kaynak NAT adresi olup olmad\u0131\u011f\u0131." }, "ar": { "description": "\u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646 \u0647\u0630\u0627 \u0627\u0644\u0639\u0646\u0648\u0627\u0646 \u0647\u0648 \u0639\u0646\u0648\u0627\u0646 source NAT \u0627\u0644\u062e\u0627\u0635 \u0628\u0634\u0628\u0643\u062a\u0647." } } }, "is_static_nat": { "type": "boolean", "description": "Whether this address has a static NAT rule.", "x-i18n": { "tr": { "description": "Bu adreste statik bir NAT kural\u0131 bulunup bulunmad\u0131\u011f\u0131." }, "ar": { "description": "\u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646\u062a \u0644\u0647\u0630\u0627 \u0627\u0644\u0639\u0646\u0648\u0627\u0646 \u0642\u0627\u0639\u062f\u0629 static NAT." } } }, "state": { "type": "string", "nullable": true, "description": "The cloud's own address state, as last observed.", "x-i18n": { "tr": { "description": "Son g\u00f6zlendi\u011fi h\u00e2liyle bulutun kendi adres durumu." }, "ar": { "description": "\u062d\u0627\u0644\u0629 \u0627\u0644\u0639\u0646\u0648\u0627\u0646 \u0644\u062f\u0649 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0646\u0641\u0633\u0647\u0627\u060c \u0628\u062d\u0633\u0628 \u0622\u062e\u0631 \u0631\u0635\u062f." } }, "example": "Allocated" }, "allocated": { "type": "string", "format": "date-time", "nullable": true }, "reverse_record": { "type": "string", "nullable": true, "description": "The PTR record the DNS service answers for this address, or `null` if none is set.\nSet it with `PATCH /public-ip-addresses/{id}`.\n", "x-i18n": { "tr": { "description": "DNS servisinin bu adres i\u00e7in yan\u0131tlad\u0131\u011f\u0131 PTR kayd\u0131; hi\u00e7biri tan\u0131ml\u0131 de\u011filse `null`.\n`PATCH /public-ip-addresses/{id}` ile ayarlay\u0131n.\n" }, "ar": { "description": "\u0633\u062c\u0644 PTR \u0627\u0644\u0630\u064a \u062a\u062c\u064a\u0628 \u0628\u0647 \u062e\u062f\u0645\u0629 DNS \u0639\u0646 \u0647\u0630\u0627 \u0627\u0644\u0639\u0646\u0648\u0627\u0646\u060c \u0623\u0648 `null` \u0625\u0646 \u0644\u0645 \u064a\u064f\u0636\u0628\u0637 \u0623\u064a \u0633\u062c\u0644.\n\u0627\u0636\u0628\u0637\u0647 \u0639\u0628\u0631 `PATCH /public-ip-addresses/{id}`.\n" } }, "example": "host.example.com." }, "network_id": { "type": "integer", "nullable": true, "description": "The network this address is associated with. An account has been able to hold\nmore than one network since 2026-08-25, so this is what says which \u2014 including\nfor `is_source_nat`, which is per network, not per account. Null on a row the\nreconciler has not attributed yet.\n", "x-i18n": { "tr": { "description": "Bu adresin ili\u015fkilendirildi\u011fi a\u011f. Bir hesap 2026-08-25 tarihinden beri birden\nfazla a\u011f tutabildi\u011fi i\u00e7in hangisi oldu\u011funu s\u00f6yleyen alan budur \u2014 hesap ba\u015f\u0131na\nde\u011fil a\u011f ba\u015f\u0131na i\u015fleyen `is_source_nat` i\u00e7in de. E\u015fitleyicinin hen\u00fcz\nili\u015fkilendirmedi\u011fi bir sat\u0131rda null olur.\n" }, "ar": { "description": "\u0627\u0644\u0634\u0628\u0643\u0629 \u0627\u0644\u062a\u064a \u064a\u0631\u062a\u0628\u0637 \u0628\u0647\u0627 \u0647\u0630\u0627 \u0627\u0644\u0639\u0646\u0648\u0627\u0646. \u0635\u0627\u0631 \u0628\u0625\u0645\u0643\u0627\u0646 \u0627\u0644\u062d\u0633\u0627\u0628 \u0623\u0646 \u064a\u0645\u0644\u0643 \u0623\u0643\u062b\u0631 \u0645\u0646 \u0634\u0628\u0643\u0629 \u0645\u0646\u0630\n2026-08-25\u060c \u0648\u0644\u0630\u0644\u0643 \u0641\u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644 \u0647\u0648 \u0645\u0627 \u064a\u062d\u062f\u0651\u062f \u0623\u064a\u0647\u0627 \u2014 \u0628\u0645\u0627 \u0641\u064a \u0630\u0644\u0643 \u0628\u0627\u0644\u0646\u0633\u0628\u0629 \u0625\u0644\u0649\n`is_source_nat` \u0627\u0644\u0630\u064a \u064a\u064f\u062d\u0633\u0628 \u0644\u0643\u0644 \u0634\u0628\u0643\u0629 \u0644\u0627 \u0644\u0643\u0644 \u062d\u0633\u0627\u0628. \u062a\u0643\u0648\u0646 \u0642\u064a\u0645\u062a\u0647 null \u0641\u064a \u0635\u0641 \u0644\u0645\n\u062a\u0646\u0633\u0628\u0647 \u0627\u0644\u0645\u064f\u0637\u0627\u0628\u0650\u0642 \u0628\u0639\u062f.\n" } }, "example": 3 }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "Vpn": { "type": "object", "required": [ "id", "public_ip", "preshared_key", "state", "client_ip_range", "network_id", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the VPN.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. VPN var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u0640VPN." } }, "example": 2 }, "public_ip": { "type": "string", "nullable": true, "description": "The public IP address the VPN endpoint listens on.", "x-i18n": { "tr": { "description": "VPN u\u00e7 noktas\u0131n\u0131n dinledi\u011fi kamusal IP adresi." }, "ar": { "description": "\u0639\u0646\u0648\u0627\u0646 IP \u0627\u0644\u0639\u0627\u0645 \u0627\u0644\u0630\u064a \u062a\u0633\u062a\u0645\u0639 \u0639\u0644\u064a\u0647 \u0646\u0642\u0637\u0629 \u0646\u0647\u0627\u064a\u0629 VPN." } }, "example": "203.0.113.10" }, "preshared_key": { "type": "string", "nullable": true, "description": "The IPsec pre-shared key a VPN client authenticates with.", "x-i18n": { "tr": { "description": "Bir VPN istemcisinin kimlik do\u011frulamada kulland\u0131\u011f\u0131 IPsec \u00f6n payla\u015f\u0131ml\u0131 anahtar\u0131." }, "ar": { "description": "\u0645\u0641\u062a\u0627\u062d IPsec \u0627\u0644\u0645\u0634\u062a\u0631\u064e\u0643 \u0645\u0633\u0628\u0642\u064b\u0627 \u0627\u0644\u0630\u064a \u064a\u0633\u062a\u0648\u062b\u0642 \u0628\u0647 \u0639\u0645\u064a\u0644 VPN." } } }, "state": { "type": "string", "nullable": true, "description": "The cloud's own VPN state, as last observed.", "x-i18n": { "tr": { "description": "Son g\u00f6zlendi\u011fi h\u00e2liyle bulutun kendi VPN durumu." }, "ar": { "description": "\u062d\u0627\u0644\u0629 VPN \u0644\u062f\u0649 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0646\u0641\u0633\u0647\u0627\u060c \u0628\u062d\u0633\u0628 \u0622\u062e\u0631 \u0631\u0635\u062f." } }, "example": "Running" }, "client_ip_range": { "type": "string", "nullable": true, "description": "The CIDR block addresses are leased from.", "x-i18n": { "tr": { "description": "Adreslerin kiraland\u0131\u011f\u0131 CIDR blo\u011fu." }, "ar": { "description": "\u0643\u062a\u0644\u0629 CIDR \u0627\u0644\u062a\u064a \u062a\u064f\u0624\u062c\u064e\u0651\u0631 \u0645\u0646\u0647\u0627 \u0627\u0644\u0639\u0646\u0627\u0648\u064a\u0646." } }, "example": "10.0.0.0/24" }, "network_id": { "type": "integer", "nullable": true, "description": "The network this VPN endpoint serves. An account has been able to hold more than\none network since 2026-08-25, and VPN users are account-wide, so without this a\nclient cannot tell which network a key reaches. Null on a row the reconciler has\nnot attributed yet.\n", "x-i18n": { "tr": { "description": "Bu VPN u\u00e7 noktas\u0131n\u0131n hizmet verdi\u011fi a\u011f. Bir hesap 2026-08-25 tarihinden beri\nbirden fazla a\u011f tutabiliyor ve VPN kullan\u0131c\u0131lar\u0131 hesap genelinde tan\u0131ml\u0131; bu\nalan olmadan bir istemci, bir anahtar\u0131n hangi a\u011fa ula\u015ft\u0131\u011f\u0131n\u0131 s\u00f6yleyemez.\nE\u015fitleyicinin hen\u00fcz ili\u015fkilendirmedi\u011fi bir sat\u0131rda null olur.\n" }, "ar": { "description": "\u0627\u0644\u0634\u0628\u0643\u0629 \u0627\u0644\u062a\u064a \u062a\u062e\u062f\u0645\u0647\u0627 \u0646\u0642\u0637\u0629 \u0646\u0647\u0627\u064a\u0629 VPN \u0647\u0630\u0647. \u0635\u0627\u0631 \u0628\u0625\u0645\u0643\u0627\u0646 \u0627\u0644\u062d\u0633\u0627\u0628 \u0623\u0646 \u064a\u0645\u0644\u0643 \u0623\u0643\u062b\u0631 \u0645\u0646 \u0634\u0628\u0643\u0629\n\u0645\u0646\u0630 2026-08-25\u060c \u0648\u0645\u0633\u062a\u062e\u062f\u0645\u0648 VPN \u0645\u0639\u0631\u064e\u0651\u0641\u0648\u0646 \u0639\u0644\u0649 \u0645\u0633\u062a\u0648\u0649 \u0627\u0644\u062d\u0633\u0627\u0628 \u0643\u0644\u0647\u060c \u0641\u0645\u0646 \u062f\u0648\u0646 \u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644\n\u0644\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0627\u0644\u0639\u0645\u064a\u0644 \u0645\u0639\u0631\u0641\u0629 \u0627\u0644\u0634\u0628\u0643\u0629 \u0627\u0644\u062a\u064a \u064a\u0635\u0644 \u0625\u0644\u064a\u0647\u0627 \u0645\u0641\u062a\u0627\u062d \u0645\u0627. \u062a\u0643\u0648\u0646 \u0642\u064a\u0645\u062a\u0647 null \u0641\u064a \u0635\u0641\n\u0644\u0645 \u062a\u0646\u0633\u0628\u0647 \u0627\u0644\u0645\u064f\u0637\u0627\u0628\u0650\u0642 \u0628\u0639\u062f.\n" } }, "example": 3 }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "VpnUser": { "type": "object", "required": [ "id", "username", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the VPN user.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. VPN kullan\u0131c\u0131s\u0131 var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0645\u0633\u062a\u062e\u062f\u0645 VPN." } }, "example": 3 }, "username": { "type": "string", "example": "jdoe" }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "AffinityGroup": { "type": "object", "required": [ "id", "name", "description", "affinity_type", "instance_ids", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the group.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Grup var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0629." } }, "example": 1 }, "name": { "type": "string", "description": "Unique across every customer's affinity groups.", "x-i18n": { "tr": { "description": "B\u00fct\u00fcn m\u00fc\u015fterilerin uyum gruplar\u0131 aras\u0131nda benzersizdir." }, "ar": { "description": "\u0641\u0631\u064a\u062f \u0639\u0644\u0649 \u0645\u0633\u062a\u0648\u0649 \u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0627\u0644\u062a\u0642\u0627\u0631\u0628 \u0644\u062f\u0649 \u062c\u0645\u064a\u0639 \u0627\u0644\u0639\u0645\u0644\u0627\u0621." } }, "example": "web-tier" }, "description": { "type": "string", "nullable": true }, "affinity_type": { "type": "string", "enum": [ "Host Affinity", "Host Anti-Affinity" ] }, "instance_ids": { "type": "array", "description": "The ids of the caller's instances currently in this group.", "x-i18n": { "tr": { "description": "\u00c7a\u011f\u0131ran\u0131n h\u00e2lihaz\u0131rda bu grupta bulunan sanal makinalar\u0131n\u0131n kimlikleri." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641\u0627\u062a \u0627\u0644\u0623\u062c\u0647\u0632\u0629 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 \u0644\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0627\u0644\u0645\u0648\u062c\u0648\u062f\u0629 \u062d\u0627\u0644\u064a\u064b\u0627 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0629." } }, "items": { "type": "integer" }, "example": [ 17, 24 ] }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "DNSZone": { "type": "object", "required": [ "id", "name", "serial", "nameservers", "kind", "records_count", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the zone.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. DNS alan\u0131 var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u0645\u0646\u0637\u0642\u0629." } }, "example": 9 }, "name": { "type": "string", "description": "The zone's domain name, without a trailing dot.", "x-i18n": { "tr": { "description": "DNS alan\u0131n\u0131n etki alan\u0131 ad\u0131; sonunda nokta olmadan." }, "ar": { "description": "\u0627\u0633\u0645 \u0627\u0644\u0646\u0637\u0627\u0642 \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u0645\u0646\u0637\u0642\u0629\u060c \u062f\u0648\u0646 \u0646\u0642\u0637\u0629 \u0641\u064a \u0622\u062e\u0631\u0647." } }, "example": "example.com" }, "serial": { "type": "string", "nullable": true, "description": "The DNS service's own SOA serial, as last observed. Bumps on every record\nwrite on the provider side; carries no information about who changed what.\n", "x-i18n": { "tr": { "description": "Son g\u00f6zlendi\u011fi h\u00e2liyle DNS servisinin kendi SOA seri numaras\u0131. Sa\u011flay\u0131c\u0131\ntaraf\u0131nda her kay\u0131t yaz\u0131m\u0131nda artar; kimin neyi de\u011fi\u015ftirdi\u011fine dair hi\u00e7bir\nbilgi ta\u015f\u0131maz.\n" }, "ar": { "description": "\u0627\u0644\u0631\u0642\u0645 \u0627\u0644\u062a\u0633\u0644\u0633\u0644\u064a \u0644\u0633\u062c\u0644\u0651 SOA \u0644\u062f\u0649 \u062e\u062f\u0645\u0629 DNS \u0646\u0641\u0633\u0647\u0627\u060c \u0628\u062d\u0633\u0628 \u0622\u062e\u0631 \u0631\u0635\u062f. \u0648\u064a\u0632\u062f\u0627\u062f \u0645\u0639 \u0643\u0644\n\u0643\u062a\u0627\u0628\u0629 \u0633\u062c\u0644\u0651 \u0644\u062f\u0649 \u0627\u0644\u0645\u0632\u0648\u0651\u062f\u061b \u0648\u0644\u0627 \u064a\u062d\u0645\u0644 \u0623\u064a \u0645\u0639\u0644\u0648\u0645\u0629 \u0639\u0645\u0651\u0646 \u063a\u064a\u0651\u0631 \u0645\u0627\u0630\u0627.\n" } }, "example": "2024010101" }, "nameservers": { "type": "array", "items": { "type": "string" }, "description": "The nameservers the DNS service answers for this zone, as last observed.", "x-i18n": { "tr": { "description": "Son g\u00f6zlendi\u011fi h\u00e2liyle, DNS servisinin bu DNS alan\u0131 i\u00e7in yan\u0131tlad\u0131\u011f\u0131 ad sunucular\u0131." }, "ar": { "description": "\u062e\u0648\u0627\u062f\u0645 \u0627\u0644\u0623\u0633\u0645\u0627\u0621 \u0627\u0644\u062a\u064a \u062a\u062c\u064a\u0628 \u0628\u0647\u0627 \u062e\u062f\u0645\u0629 DNS \u0639\u0646 \u0647\u0630\u0647 \u0627\u0644\u0645\u0646\u0637\u0642\u0629\u060c \u0628\u062d\u0633\u0628 \u0622\u062e\u0631 \u0631\u0635\u062f." } }, "example": [ "ns1.cloud.core.gen.tr", "ns2.cloud.core.gen.tr" ] }, "kind": { "type": "string", "nullable": true, "description": "The DNS service's own zone kind, as last observed.", "x-i18n": { "tr": { "description": "Son g\u00f6zlendi\u011fi h\u00e2liyle DNS servisinin kendi DNS alan\u0131 t\u00fcr\u00fc." }, "ar": { "description": "\u0646\u0648\u0639 \u0627\u0644\u0645\u0646\u0637\u0642\u0629 \u0644\u062f\u0649 \u062e\u062f\u0645\u0629 DNS \u0646\u0641\u0633\u0647\u0627\u060c \u0628\u062d\u0633\u0628 \u0622\u062e\u0631 \u0631\u0635\u062f." } }, "example": "Native" }, "records_count": { "type": "integer", "description": "How many records this zone has. Fetch `GET /dns-zones/{zone}/records` for the\nrecords themselves \u2014 deliberately not embedded here, so listing zones does not\nalso transfer every one of their (up to 255) records.\n", "x-i18n": { "tr": { "description": "Bu DNS alan\u0131n\u0131n ka\u00e7 kayd\u0131 oldu\u011fu. Kay\u0131tlar\u0131n kendisi i\u00e7in\n`GET /dns-zones/{zone}/records` \u00e7a\u011fr\u0131s\u0131n\u0131 kullan\u0131n \u2014 kay\u0131tlar burada\nbilin\u00e7li olarak g\u00f6m\u00fcl\u00fc de\u011fildir; b\u00f6ylece alanlar\u0131 listelemek, her birinin\n(en \u00e7ok 255) kayd\u0131n\u0131 da ta\u015f\u0131maz.\n" }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0645\u0646\u0637\u0642\u0629. \u0627\u0637\u0644\u0628 `GET /dns-zones/{zone}/records` \u0644\u0644\u062d\u0635\u0648\u0644 \u0639\u0644\u0649\n\u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0646\u0641\u0633\u0647\u0627 \u2014 \u0641\u0647\u064a \u063a\u064a\u0631 \u0645\u0636\u0645\u064e\u0651\u0646\u0629 \u0647\u0646\u0627 \u0639\u0646 \u0642\u0635\u062f\u060c \u062d\u062a\u0649 \u0644\u0627 \u064a\u064e\u0646\u0642\u0644 \u0633\u0631\u062f\u064f \u0627\u0644\u0645\u0646\u0627\u0637\u0642 \u0643\u0630\u0644\u0643\n\u0643\u0644 \u0633\u062c\u0644\u0651 \u0645\u0646 \u0633\u062c\u0644\u0627\u062a\u0647\u0627 (\u062d\u062a\u0649 255 \u0633\u062c\u0644\u064b\u0627).\n" } }, "example": 3 }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "DNSRecord": { "type": "object", "required": [ "id", "zone_id", "name", "type", "data", "ttl", "comment", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the record.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Kay\u0131t var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u0633\u062c\u0644\u0651." } }, "example": 21 }, "zone_id": { "type": "integer", "description": "The id of the zone this record belongs to (see `GET /dns-zones/{zone}`).", "x-i18n": { "tr": { "description": "Bu kayd\u0131n ait oldu\u011fu DNS alan\u0131n\u0131n kimli\u011fi (bkz. `GET /dns-zones/{zone}`)." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0645\u0646\u0637\u0642\u0629 \u0627\u0644\u062a\u064a \u064a\u0646\u062a\u0645\u064a \u0625\u0644\u064a\u0647\u0627 \u0647\u0630\u0627 \u0627\u0644\u0633\u062c\u0644\u0651 (\u0627\u0646\u0638\u0631 `GET /dns-zones/{zone}`)." } }, "example": 9 }, "name": { "type": "string", "description": "The record's owner name. A relative value (e.g. `www`) is auto-qualified\nagainst the zone's own name; an already fully-qualified value (trailing dot,\ne.g. `www.example.com.`) is used as-is.\n", "x-i18n": { "tr": { "description": "Kayd\u0131n sahip ad\u0131. G\u00f6reli bir de\u011fer (\u00f6rne\u011fin `www`) DNS alan\u0131n\u0131n kendi ad\u0131na g\u00f6re\notomatik olarak nitelenir; zaten tam nitelenmi\u015f bir de\u011fer (sonunda nokta, \u00f6rne\u011fin\n`www.example.com.`) oldu\u011fu gibi kullan\u0131l\u0131r.\n" }, "ar": { "description": "\u0627\u0633\u0645 \u0645\u0627\u0644\u0643 \u0627\u0644\u0633\u062c\u0644\u0651. \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0646\u0633\u0628\u064a\u0629 (\u0645\u062b\u0644 `www`) \u062a\u064f\u0633\u062a\u0643\u0645\u0644 \u062a\u0644\u0642\u0627\u0626\u064a\u064b\u0627 \u0628\u0627\u0633\u0645 \u0627\u0644\u0645\u0646\u0637\u0642\u0629\n\u0646\u0641\u0633\u0647\u0627\u061b \u0623\u0645\u0627 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0645\u0624\u0647\u064e\u0651\u0644\u0629 \u0628\u0627\u0644\u0643\u0627\u0645\u0644 (\u0628\u0646\u0642\u0637\u0629 \u0641\u064a \u0622\u062e\u0631\u0647\u0627\u060c \u0645\u062b\u0644 `www.example.com.`)\n\u0641\u062a\u064f\u0633\u062a\u062e\u062f\u0645 \u0643\u0645\u0627 \u0647\u064a.\n" } }, "example": "www.example.com." }, "type": { "type": "string", "enum": [ "A", "CNAME", "MX", "PTR", "SRV", "TXT" ], "description": "The six record types this API accepts. `AAAA` is deliberately absent \u2014 an\nexisting product gap the panel does not offer either.\n", "x-i18n": { "tr": { "description": "Bu API'nin kabul etti\u011fi alt\u0131 kay\u0131t t\u00fcr\u00fc. `AAAA` bilin\u00e7li olarak yoktur \u2014\npanelin de sunmad\u0131\u011f\u0131, \u00fcr\u00fcnde var olan bir eksiktir.\n" }, "ar": { "description": "\u0623\u0646\u0648\u0627\u0639 \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0633\u062a\u0629 \u0627\u0644\u062a\u064a \u062a\u0642\u0628\u0644\u0647\u0627 \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629. \u0648`AAAA` \u063a\u0627\u0626\u0628 \u0639\u0646 \u0642\u0635\u062f \u2014\n\u0648\u0647\u064a \u062b\u063a\u0631\u0629 \u0642\u0627\u0626\u0645\u0629 \u0641\u064a \u0627\u0644\u0645\u0646\u062a\u062c \u0644\u0627 \u062a\u0642\u062f\u0651\u0645\u0647\u0627 \u0627\u0644\u0644\u0648\u062d\u0629 \u0623\u064a\u0636\u064b\u0627.\n" } } }, "data": { "type": "string", "maxLength": 4096, "description": "The record's content, e.g. an IP address for an `A` record. For `TXT`, this\nis the decoded value as originally submitted \u2014 at rest it is stored as\nRFC-1035-encoded character-strings (quoted, split into \u2264255-octet chunks),\nbut this API always returns the plain value.\n", "x-i18n": { "tr": { "description": "Kayd\u0131n i\u00e7eri\u011fi; \u00f6rne\u011fin bir `A` kayd\u0131 i\u00e7in bir IP adresi. `TXT` i\u00e7in bu,\nilk g\u00f6nderildi\u011fi h\u00e2liyle \u00e7\u00f6z\u00fclm\u00fc\u015f de\u011ferdir \u2014 saklan\u0131rken RFC-1035\nkodlamas\u0131yla karakter dizileri olarak (t\u0131rnakl\u0131 ve en \u00e7ok 255 sekizliklik\npar\u00e7alara b\u00f6l\u00fcnm\u00fc\u015f) tutulur, ama bu API her zaman d\u00fcz de\u011feri d\u00f6nd\u00fcr\u00fcr.\n" }, "ar": { "description": "\u0645\u062d\u062a\u0648\u0649 \u0627\u0644\u0633\u062c\u0644\u0651\u060c \u0645\u062b\u0644 \u0639\u0646\u0648\u0627\u0646 IP \u0644\u0633\u062c\u0644\u0651 `A`. \u0623\u0645\u0627 \u0641\u064a `TXT` \u0641\u0647\u0630\u0647 \u0647\u064a \u0627\u0644\u0642\u064a\u0645\u0629 \u0628\u0639\u062f \u0641\u0643\u0651\n\u062a\u0631\u0645\u064a\u0632\u0647\u0627 \u0643\u0645\u0627 \u0623\u064f\u0631\u0633\u0644\u062a \u0623\u0635\u0644\u064b\u0627 \u2014 \u0625\u0630 \u062a\u064f\u062e\u0632\u064e\u0651\u0646 \u0633\u0627\u0643\u0646\u0629\u064b \u0639\u0644\u0649 \u0647\u064a\u0626\u0629 \u0633\u0644\u0627\u0633\u0644 \u0645\u062d\u0627\u0631\u0641 \u0645\u0631\u0645\u064e\u0651\u0632\u0629\n\u0648\u0641\u0642 RFC-1035 (\u0628\u064a\u0646 \u0639\u0644\u0627\u0645\u062a\u064a \u0627\u0642\u062a\u0628\u0627\u0633 \u0648\u0645\u0642\u0633\u064e\u0651\u0645\u0629 \u0625\u0644\u0649 \u0623\u062c\u0632\u0627\u0621 \u0644\u0627 \u062a\u062a\u062c\u0627\u0648\u0632 255 \u062b\u064f\u0645\u0627\u0646\u064a)\u060c\n\u0644\u0643\u0646 \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u062a\u064f\u0631\u062c\u0650\u0639 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0635\u0631\u064a\u062d\u0629 \u062f\u0627\u0626\u0645\u064b\u0627.\n" } }, "example": "203.0.113.5" }, "ttl": { "type": "integer", "description": "Always `3600` today \u2014 the provider integration hardcodes it, and no create or\nupdate path accepts a client-supplied value.\n", "x-i18n": { "tr": { "description": "Bug\u00fcn her zaman `3600`'d\u00fcr \u2014 sa\u011flay\u0131c\u0131 t\u00fcmle\u015ftirmesi bu de\u011feri sabit tutar\nve ne olu\u015fturma ne de g\u00fcncelleme yolu istemciden gelen bir de\u011feri kabul\neder.\n" }, "ar": { "description": "\u0642\u064a\u0645\u062a\u0647 \u0627\u0644\u064a\u0648\u0645 `3600` \u062f\u0627\u0626\u0645\u064b\u0627 \u2014 \u0625\u0630 \u064a\u062b\u0628\u0651\u062a\u0647\u0627 \u062a\u0643\u0627\u0645\u0644 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0641\u064a \u0627\u0644\u0634\u064a\u0641\u0631\u0629\u060c \u0648\u0644\u0627 \u064a\u0642\u0628\u0644\n\u0623\u064a \u0645\u0633\u0627\u0631 \u0625\u0646\u0634\u0627\u0621 \u0623\u0648 \u062a\u062d\u062f\u064a\u062b \u0642\u064a\u0645\u0629\u064b \u064a\u0631\u0633\u0644\u0647\u0627 \u0627\u0644\u0639\u0645\u064a\u0644.\n" } }, "example": 3600 }, "comment": { "type": "string", "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "PaymentPlan": { "type": "object", "description": "A billing plan nested under its product. Not independently addressable \u2014\n`PaymentPlanPolicy` refuses a customer every ability, so a plan is meaningless\napart from the product it belongs to.\n", "x-i18n": { "tr": { "description": "\u00dcr\u00fcn\u00fcn\u00fcn alt\u0131nda yer alan bir \u00f6deme plan\u0131. Kendi ba\u015f\u0131na adreslenemez \u2014\n`PaymentPlanPolicy` m\u00fc\u015fteriye her izni reddeder; dolay\u0131s\u0131yla bir plan, ait\noldu\u011fu \u00fcr\u00fcnden ayr\u0131 d\u00fc\u015f\u00fcn\u00fcld\u00fc\u011f\u00fcnde anlams\u0131zd\u0131r.\n" }, "ar": { "description": "\u062e\u0637\u0629 \u0641\u0648\u062a\u0631\u0629 \u0645\u064f\u0636\u0645\u064e\u0651\u0646\u0629 \u062a\u062d\u062a \u0645\u0646\u062a\u062c\u0647\u0627. \u0644\u0627 \u064a\u0645\u0643\u0646 \u0627\u0644\u0648\u0635\u0648\u0644 \u0625\u0644\u064a\u0647\u0627 \u0628\u0634\u0643\u0644 \u0645\u0633\u062a\u0642\u0644 \u2014\n\u0625\u0630 \u064a\u0631\u0641\u0636 `PaymentPlanPolicy` \u0643\u0644 \u0635\u0644\u0627\u062d\u064a\u0629 \u0644\u0644\u0639\u0645\u064a\u0644\u060c \u0641\u0627\u0644\u062e\u0637\u0629 \u0628\u0644\u0627 \u0645\u0639\u0646\u0649 \u0628\u0645\u0639\u0632\u0644 \u0639\u0646\n\u0627\u0644\u0645\u0646\u062a\u062c \u0627\u0644\u0630\u064a \u062a\u0646\u062a\u0645\u064a \u0625\u0644\u064a\u0647.\n" } }, "required": [ "id", "period", "price" ], "properties": { "id": { "type": "integer", "example": 12 }, "period": { "type": "string", "description": "The plan's billing period. `undefined` and `default` are catalogue values\nthat exist in storage but carry no billing cadence of their own; an\nunrecognised raw value also maps to `undefined` rather than leaking an int.\n", "x-i18n": { "tr": { "description": "Plan\u0131n \u00f6deme d\u00f6nemi. `undefined` ve `default`, veritaban\u0131nda bulunan ancak\nkendilerine ait bir \u00f6deme s\u0131kl\u0131\u011f\u0131 ta\u015f\u0131mayan katalog de\u011ferleridir; tan\u0131nmayan\nham bir de\u011fer de bir tamsay\u0131 s\u0131zd\u0131rmak yerine `undefined` de\u011ferine e\u015flenir.\n" }, "ar": { "description": "\u062f\u0648\u0631\u0629 \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u062e\u0637\u0629. \u0627\u0644\u0642\u064a\u0645\u062a\u0627\u0646 `undefined` \u0648`default` \u0642\u064a\u0645\u062a\u0627\u0646 \u0641\u064a \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c\n\u0645\u0648\u062c\u0648\u062f\u062a\u0627\u0646 \u0641\u064a \u0627\u0644\u062a\u062e\u0632\u064a\u0646 \u0644\u0643\u0646\u0647\u0645\u0627 \u0644\u0627 \u062a\u062d\u0645\u0644\u0627\u0646 \u0623\u064a \u0648\u062a\u064a\u0631\u0629 \u0641\u0648\u062a\u0631\u0629 \u062e\u0627\u0635\u0629 \u0628\u0647\u0645\u0627\u061b \u0643\u0645\u0627 \u062a\u064f\u0631\u0628\u0637 \u0623\u064a\n\u0642\u064a\u0645\u0629 \u062e\u0627\u0645 \u063a\u064a\u0631 \u0645\u0639\u0631\u0648\u0641\u0629 \u0628\u0640 `undefined` \u0628\u062f\u0644\u064b\u0627 \u0645\u0646 \u062a\u0633\u0631\u064a\u0628 \u0639\u062f\u062f \u0635\u062d\u064a\u062d.\n" } }, "enum": [ "undefined", "daily", "weekly", "monthly", "biannually", "annually", "ends", "default" ], "example": "monthly" }, "price": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "USD, unconditionally. Catalogue prices are never converted for a caller's\nlocale \u2014 only the panel's own display layer does that, and this API never\ncalls it.\n", "x-i18n": { "tr": { "description": "Ko\u015fulsuz olarak USD. Katalog fiyatlar\u0131 \u00e7a\u011f\u0131ran\u0131n diline g\u00f6re asla \u00e7evrilmez \u2014\nbunu yaln\u0131zca panelin kendi g\u00f6r\u00fcnt\u00fcleme katman\u0131 yapar ve bu API o katman\u0131\nhi\u00e7bir zaman \u00e7a\u011f\u0131rmaz.\n" }, "ar": { "description": "\u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a \u062f\u0627\u0626\u0645\u064b\u0627. \u0644\u0627 \u062a\u064f\u062d\u0648\u064e\u0651\u0644 \u0623\u0633\u0639\u0627\u0631 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c \u0623\u0628\u062f\u064b\u0627 \u0648\u0641\u0642 \u0644\u063a\u0629 \u0627\u0644\u0645\u064f\u0633\u062a\u062f\u0639\u064a \u2014\n\u0641\u0630\u0644\u0643 \u0645\u0646 \u0639\u0645\u0644 \u0637\u0628\u0642\u0629 \u0627\u0644\u0639\u0631\u0636 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0648\u062d\u062f\u0647\u0627\u060c \u0648\u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0644\u0627 \u062a\u0633\u062a\u062f\u0639\u064a\u0647\u0627\n\u0625\u0637\u0644\u0627\u0642\u064b\u0627.\n" } } } } }, "VirtualMachineProduct": { "type": "object", "required": [ "id", "name", "description", "is_published", "template_id", "compute_offering_id", "disk_offering_id", "payment_plans", "created_at" ], "properties": { "id": { "type": "integer", "example": 101 }, "name": { "type": "string", "example": "Ubuntu 24.04, 2 vCPU / 2GB, 20 vCPU / 2GB, 20GB" }, "description": { "type": "string" }, "is_published": { "type": "boolean", "description": "Always `true` for a row this endpoint returns \u2014 unpublished products are\nfiltered out of the list and 404 on `GET /virtual-machine-products/{id}`,\nmatching `VirtualMachineProductPolicy::view()`. Published anyway, for a\nclient that only wants to poll one endpoint.\n", "x-i18n": { "tr": { "description": "Bu u\u00e7 noktan\u0131n d\u00f6nd\u00fcrd\u00fc\u011f\u00fc her sat\u0131r i\u00e7in her zaman `true` \u2014 yay\u0131mlanmam\u0131\u015f\n\u00fcr\u00fcnler listeden s\u00fcz\u00fcl\u00fcr ve `GET /virtual-machine-products/{id}` \u00e7a\u011fr\u0131s\u0131nda 404\nd\u00f6ner; `VirtualMachineProductPolicy::view()` ile ayn\u0131 davran\u0131\u015f. Yine de,\nyaln\u0131zca tek bir u\u00e7 noktay\u0131 yoklamak isteyen istemciler i\u00e7in yay\u0131mlan\u0131r.\n" }, "ar": { "description": "\u062f\u0627\u0626\u0645\u064b\u0627 `true` \u0644\u0623\u064a \u0635\u0641 \u062a\u0639\u064a\u062f\u0647 \u0646\u0642\u0637\u0629 \u0627\u0644\u0646\u0647\u0627\u064a\u0629 \u0647\u0630\u0647 \u2014 \u0641\u0627\u0644\u0645\u0646\u062a\u062c\u0627\u062a \u063a\u064a\u0631 \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u0629 \u062a\u064f\u0633\u062a\u0628\u0639\u062f\n\u0645\u0646 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0648\u062a\u0639\u064a\u062f 404 \u0639\u0644\u0649 `GET /virtual-machine-products/{id}`\u060c \u0645\u0637\u0627\u0628\u0642\u0629\u064b\n\u0644\u0640`VirtualMachineProductPolicy::view()`. \u0648\u0645\u0639 \u0630\u0644\u0643 \u064a\u064f\u0646\u0634\u0631 \u0627\u0644\u062d\u0642\u0644\u060c \u0645\u0646 \u0623\u062c\u0644 \u0639\u0645\u064a\u0644 \u0644\u0627\n\u064a\u0631\u064a\u062f \u0633\u0648\u0649 \u0627\u0633\u062a\u0639\u0644\u0627\u0645 \u0646\u0642\u0637\u0629 \u0646\u0647\u0627\u064a\u0629 \u0648\u0627\u062d\u062f\u0629.\n" } } }, "template_id": { "type": "integer", "description": "Join key for `GET /templates/{id}`.", "x-i18n": { "tr": { "description": "E\u015fle\u015ftirme anahtar\u0131; `GET /templates/{id}` ile kullan\u0131l\u0131r." }, "ar": { "description": "\u0645\u0641\u062a\u0627\u062d \u0631\u0628\u0637 \u0645\u0639 `GET /templates/{id}`." } }, "example": 7 }, "compute_offering_id": { "type": "integer", "description": "Join key for `GET /compute-offerings`.", "x-i18n": { "tr": { "description": "E\u015fle\u015ftirme anahtar\u0131; `GET /compute-offerings` ile kullan\u0131l\u0131r." }, "ar": { "description": "\u0645\u0641\u062a\u0627\u062d \u0631\u0628\u0637 \u0645\u0639 `GET /compute-offerings`." } }, "example": 3 }, "disk_offering_id": { "type": "integer", "description": "Join key for `GET /disk-offerings`.", "x-i18n": { "tr": { "description": "E\u015fle\u015ftirme anahtar\u0131; `GET /disk-offerings` ile kullan\u0131l\u0131r." }, "ar": { "description": "\u0645\u0641\u062a\u0627\u062d \u0631\u0628\u0637 \u0645\u0639 `GET /disk-offerings`." } }, "example": 5 }, "payment_plans": { "type": "array", "items": { "type": "object", "description": "A billing plan nested under its product. Not independently addressable \u2014\n`PaymentPlanPolicy` refuses a customer every ability, so a plan is meaningless\napart from the product it belongs to.\n", "x-i18n": { "tr": { "description": "\u00dcr\u00fcn\u00fcn\u00fcn alt\u0131nda yer alan bir \u00f6deme plan\u0131. Kendi ba\u015f\u0131na adreslenemez \u2014\n`PaymentPlanPolicy` m\u00fc\u015fteriye her izni reddeder; dolay\u0131s\u0131yla bir plan, ait\noldu\u011fu \u00fcr\u00fcnden ayr\u0131 d\u00fc\u015f\u00fcn\u00fcld\u00fc\u011f\u00fcnde anlams\u0131zd\u0131r.\n" }, "ar": { "description": "\u062e\u0637\u0629 \u0641\u0648\u062a\u0631\u0629 \u0645\u064f\u0636\u0645\u064e\u0651\u0646\u0629 \u062a\u062d\u062a \u0645\u0646\u062a\u062c\u0647\u0627. \u0644\u0627 \u064a\u0645\u0643\u0646 \u0627\u0644\u0648\u0635\u0648\u0644 \u0625\u0644\u064a\u0647\u0627 \u0628\u0634\u0643\u0644 \u0645\u0633\u062a\u0642\u0644 \u2014\n\u0625\u0630 \u064a\u0631\u0641\u0636 `PaymentPlanPolicy` \u0643\u0644 \u0635\u0644\u0627\u062d\u064a\u0629 \u0644\u0644\u0639\u0645\u064a\u0644\u060c \u0641\u0627\u0644\u062e\u0637\u0629 \u0628\u0644\u0627 \u0645\u0639\u0646\u0649 \u0628\u0645\u0639\u0632\u0644 \u0639\u0646\n\u0627\u0644\u0645\u0646\u062a\u062c \u0627\u0644\u0630\u064a \u062a\u0646\u062a\u0645\u064a \u0625\u0644\u064a\u0647.\n" } }, "required": [ "id", "period", "price" ], "properties": { "id": { "type": "integer", "example": 12 }, "period": { "type": "string", "description": "The plan's billing period. `undefined` and `default` are catalogue values\nthat exist in storage but carry no billing cadence of their own; an\nunrecognised raw value also maps to `undefined` rather than leaking an int.\n", "x-i18n": { "tr": { "description": "Plan\u0131n \u00f6deme d\u00f6nemi. `undefined` ve `default`, veritaban\u0131nda bulunan ancak\nkendilerine ait bir \u00f6deme s\u0131kl\u0131\u011f\u0131 ta\u015f\u0131mayan katalog de\u011ferleridir; tan\u0131nmayan\nham bir de\u011fer de bir tamsay\u0131 s\u0131zd\u0131rmak yerine `undefined` de\u011ferine e\u015flenir.\n" }, "ar": { "description": "\u062f\u0648\u0631\u0629 \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u062e\u0637\u0629. \u0627\u0644\u0642\u064a\u0645\u062a\u0627\u0646 `undefined` \u0648`default` \u0642\u064a\u0645\u062a\u0627\u0646 \u0641\u064a \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c\n\u0645\u0648\u062c\u0648\u062f\u062a\u0627\u0646 \u0641\u064a \u0627\u0644\u062a\u062e\u0632\u064a\u0646 \u0644\u0643\u0646\u0647\u0645\u0627 \u0644\u0627 \u062a\u062d\u0645\u0644\u0627\u0646 \u0623\u064a \u0648\u062a\u064a\u0631\u0629 \u0641\u0648\u062a\u0631\u0629 \u062e\u0627\u0635\u0629 \u0628\u0647\u0645\u0627\u061b \u0643\u0645\u0627 \u062a\u064f\u0631\u0628\u0637 \u0623\u064a\n\u0642\u064a\u0645\u0629 \u062e\u0627\u0645 \u063a\u064a\u0631 \u0645\u0639\u0631\u0648\u0641\u0629 \u0628\u0640 `undefined` \u0628\u062f\u0644\u064b\u0627 \u0645\u0646 \u062a\u0633\u0631\u064a\u0628 \u0639\u062f\u062f \u0635\u062d\u064a\u062d.\n" } }, "enum": [ "undefined", "daily", "weekly", "monthly", "biannually", "annually", "ends", "default" ], "example": "monthly" }, "price": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "USD, unconditionally. Catalogue prices are never converted for a caller's\nlocale \u2014 only the panel's own display layer does that, and this API never\ncalls it.\n", "x-i18n": { "tr": { "description": "Ko\u015fulsuz olarak USD. Katalog fiyatlar\u0131 \u00e7a\u011f\u0131ran\u0131n diline g\u00f6re asla \u00e7evrilmez \u2014\nbunu yaln\u0131zca panelin kendi g\u00f6r\u00fcnt\u00fcleme katman\u0131 yapar ve bu API o katman\u0131\nhi\u00e7bir zaman \u00e7a\u011f\u0131rmaz.\n" }, "ar": { "description": "\u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a \u062f\u0627\u0626\u0645\u064b\u0627. \u0644\u0627 \u062a\u064f\u062d\u0648\u064e\u0651\u0644 \u0623\u0633\u0639\u0627\u0631 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c \u0623\u0628\u062f\u064b\u0627 \u0648\u0641\u0642 \u0644\u063a\u0629 \u0627\u0644\u0645\u064f\u0633\u062a\u062f\u0639\u064a \u2014\n\u0641\u0630\u0644\u0643 \u0645\u0646 \u0639\u0645\u0644 \u0637\u0628\u0642\u0629 \u0627\u0644\u0639\u0631\u0636 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0648\u062d\u062f\u0647\u0627\u060c \u0648\u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0644\u0627 \u062a\u0633\u062a\u062f\u0639\u064a\u0647\u0627\n\u0625\u0637\u0644\u0627\u0642\u064b\u0627.\n" } } } } } }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "VolumeProduct": { "type": "object", "required": [ "id", "name", "description", "is_published", "disk_offering_id", "payment_plans", "created_at" ], "properties": { "id": { "type": "integer", "example": 55 }, "name": { "type": "string", "example": "100GB data volume" }, "description": { "type": "string" }, "is_published": { "type": "boolean", "description": "Always `true` for a row this endpoint returns \u2014 unpublished products are\nfiltered out of the list and 404 on `GET /volume-products/{id}`, matching\n`VolumeProductPolicy::view()`.\n", "x-i18n": { "tr": { "description": "Bu u\u00e7 noktan\u0131n d\u00f6nd\u00fcrd\u00fc\u011f\u00fc her sat\u0131r i\u00e7in her zaman `true` \u2014 yay\u0131mlanmam\u0131\u015f\n\u00fcr\u00fcnler listeden s\u00fcz\u00fcl\u00fcr ve `GET /volume-products/{id}` \u00e7a\u011fr\u0131s\u0131nda 404 d\u00f6ner;\n`VolumeProductPolicy::view()` ile ayn\u0131 davran\u0131\u015f.\n" }, "ar": { "description": "\u062f\u0627\u0626\u0645\u064b\u0627 `true` \u0644\u0623\u064a \u0635\u0641 \u062a\u0639\u064a\u062f\u0647 \u0646\u0642\u0637\u0629 \u0627\u0644\u0646\u0647\u0627\u064a\u0629 \u0647\u0630\u0647 \u2014 \u0641\u0627\u0644\u0645\u0646\u062a\u062c\u0627\u062a \u063a\u064a\u0631 \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u0629 \u062a\u064f\u0633\u062a\u0628\u0639\u062f\n\u0645\u0646 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0648\u062a\u0639\u064a\u062f 404 \u0639\u0644\u0649 `GET /volume-products/{id}`\u060c \u0645\u0637\u0627\u0628\u0642\u0629\u064b\n\u0644\u0640`VolumeProductPolicy::view()`.\n" } } }, "disk_offering_id": { "type": "integer", "description": "Join key for `GET /disk-offerings`.", "x-i18n": { "tr": { "description": "E\u015fle\u015ftirme anahtar\u0131; `GET /disk-offerings` ile kullan\u0131l\u0131r." }, "ar": { "description": "\u0645\u0641\u062a\u0627\u062d \u0631\u0628\u0637 \u0645\u0639 `GET /disk-offerings`." } }, "example": 5 }, "payment_plans": { "type": "array", "items": { "type": "object", "description": "A billing plan nested under its product. Not independently addressable \u2014\n`PaymentPlanPolicy` refuses a customer every ability, so a plan is meaningless\napart from the product it belongs to.\n", "x-i18n": { "tr": { "description": "\u00dcr\u00fcn\u00fcn\u00fcn alt\u0131nda yer alan bir \u00f6deme plan\u0131. Kendi ba\u015f\u0131na adreslenemez \u2014\n`PaymentPlanPolicy` m\u00fc\u015fteriye her izni reddeder; dolay\u0131s\u0131yla bir plan, ait\noldu\u011fu \u00fcr\u00fcnden ayr\u0131 d\u00fc\u015f\u00fcn\u00fcld\u00fc\u011f\u00fcnde anlams\u0131zd\u0131r.\n" }, "ar": { "description": "\u062e\u0637\u0629 \u0641\u0648\u062a\u0631\u0629 \u0645\u064f\u0636\u0645\u064e\u0651\u0646\u0629 \u062a\u062d\u062a \u0645\u0646\u062a\u062c\u0647\u0627. \u0644\u0627 \u064a\u0645\u0643\u0646 \u0627\u0644\u0648\u0635\u0648\u0644 \u0625\u0644\u064a\u0647\u0627 \u0628\u0634\u0643\u0644 \u0645\u0633\u062a\u0642\u0644 \u2014\n\u0625\u0630 \u064a\u0631\u0641\u0636 `PaymentPlanPolicy` \u0643\u0644 \u0635\u0644\u0627\u062d\u064a\u0629 \u0644\u0644\u0639\u0645\u064a\u0644\u060c \u0641\u0627\u0644\u062e\u0637\u0629 \u0628\u0644\u0627 \u0645\u0639\u0646\u0649 \u0628\u0645\u0639\u0632\u0644 \u0639\u0646\n\u0627\u0644\u0645\u0646\u062a\u062c \u0627\u0644\u0630\u064a \u062a\u0646\u062a\u0645\u064a \u0625\u0644\u064a\u0647.\n" } }, "required": [ "id", "period", "price" ], "properties": { "id": { "type": "integer", "example": 12 }, "period": { "type": "string", "description": "The plan's billing period. `undefined` and `default` are catalogue values\nthat exist in storage but carry no billing cadence of their own; an\nunrecognised raw value also maps to `undefined` rather than leaking an int.\n", "x-i18n": { "tr": { "description": "Plan\u0131n \u00f6deme d\u00f6nemi. `undefined` ve `default`, veritaban\u0131nda bulunan ancak\nkendilerine ait bir \u00f6deme s\u0131kl\u0131\u011f\u0131 ta\u015f\u0131mayan katalog de\u011ferleridir; tan\u0131nmayan\nham bir de\u011fer de bir tamsay\u0131 s\u0131zd\u0131rmak yerine `undefined` de\u011ferine e\u015flenir.\n" }, "ar": { "description": "\u062f\u0648\u0631\u0629 \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u062e\u0637\u0629. \u0627\u0644\u0642\u064a\u0645\u062a\u0627\u0646 `undefined` \u0648`default` \u0642\u064a\u0645\u062a\u0627\u0646 \u0641\u064a \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c\n\u0645\u0648\u062c\u0648\u062f\u062a\u0627\u0646 \u0641\u064a \u0627\u0644\u062a\u062e\u0632\u064a\u0646 \u0644\u0643\u0646\u0647\u0645\u0627 \u0644\u0627 \u062a\u062d\u0645\u0644\u0627\u0646 \u0623\u064a \u0648\u062a\u064a\u0631\u0629 \u0641\u0648\u062a\u0631\u0629 \u062e\u0627\u0635\u0629 \u0628\u0647\u0645\u0627\u061b \u0643\u0645\u0627 \u062a\u064f\u0631\u0628\u0637 \u0623\u064a\n\u0642\u064a\u0645\u0629 \u062e\u0627\u0645 \u063a\u064a\u0631 \u0645\u0639\u0631\u0648\u0641\u0629 \u0628\u0640 `undefined` \u0628\u062f\u0644\u064b\u0627 \u0645\u0646 \u062a\u0633\u0631\u064a\u0628 \u0639\u062f\u062f \u0635\u062d\u064a\u062d.\n" } }, "enum": [ "undefined", "daily", "weekly", "monthly", "biannually", "annually", "ends", "default" ], "example": "monthly" }, "price": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "USD, unconditionally. Catalogue prices are never converted for a caller's\nlocale \u2014 only the panel's own display layer does that, and this API never\ncalls it.\n", "x-i18n": { "tr": { "description": "Ko\u015fulsuz olarak USD. Katalog fiyatlar\u0131 \u00e7a\u011f\u0131ran\u0131n diline g\u00f6re asla \u00e7evrilmez \u2014\nbunu yaln\u0131zca panelin kendi g\u00f6r\u00fcnt\u00fcleme katman\u0131 yapar ve bu API o katman\u0131\nhi\u00e7bir zaman \u00e7a\u011f\u0131rmaz.\n" }, "ar": { "description": "\u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a \u062f\u0627\u0626\u0645\u064b\u0627. \u0644\u0627 \u062a\u064f\u062d\u0648\u064e\u0651\u0644 \u0623\u0633\u0639\u0627\u0631 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c \u0623\u0628\u062f\u064b\u0627 \u0648\u0641\u0642 \u0644\u063a\u0629 \u0627\u0644\u0645\u064f\u0633\u062a\u062f\u0639\u064a \u2014\n\u0641\u0630\u0644\u0643 \u0645\u0646 \u0639\u0645\u0644 \u0637\u0628\u0642\u0629 \u0627\u0644\u0639\u0631\u0636 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0648\u062d\u062f\u0647\u0627\u060c \u0648\u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0644\u0627 \u062a\u0633\u062a\u062f\u0639\u064a\u0647\u0627\n\u0625\u0637\u0644\u0627\u0642\u064b\u0627.\n" } } } } } }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "Subscription": { "type": "object", "required": [ "id", "name", "description", "item_type", "status", "is_locked", "is_superseded", "is_administrative", "is_refundable", "period_ends_at", "is_scaling", "resize_history", "instance_id", "volume_id", "public_ip_address_id", "network_id", "payment_plan_id", "credit_card_id", "next_id", "price", "effective_price", "started_at", "ended_at", "created_at" ], "properties": { "id": { "type": "integer", "example": 4821 }, "name": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "item_type": { "type": "string", "description": "Which of the six product types this subscription bought, or `none` when the\nrow links no product at all. Every value `Subscription::getItemTypeAttribute()`\ncan return is listed here: `ipAddress` has been reachable since 2026-08-09 and\n`service`/`network` since 2026-08-19, and the list endpoint applies no\nproduct-type filter, so a strictly-generated client must accept all seven.\n", "x-i18n": { "tr": { "description": "Bu aboneli\u011fin alt\u0131 \u00fcr\u00fcn t\u00fcr\u00fcnden hangisini sat\u0131n ald\u0131\u011f\u0131; sat\u0131r hi\u00e7bir \u00fcr\u00fcne\nba\u011fl\u0131 de\u011filse `none`. `Subscription::getItemTypeAttribute()` metodunun\nd\u00f6nd\u00fcrebilece\u011fi her de\u011fer burada listelenmi\u015ftir: `ipAddress` 2026-08-09,\n`service`/`network` ise 2026-08-19 tarihinden beri eri\u015filebilir ve liste u\u00e7\nnoktas\u0131 hi\u00e7bir \u00fcr\u00fcn t\u00fcr\u00fc filtresi uygulamaz; bu y\u00fczden kat\u0131 bi\u00e7imde \u00fcretilmi\u015f\nbir istemci yedi de\u011ferin tamam\u0131n\u0131 kabul etmelidir.\n" }, "ar": { "description": "\u0623\u064a\u064c\u0651 \u0645\u0646 \u0623\u0646\u0648\u0627\u0639 \u0627\u0644\u0645\u0646\u062a\u062c\u0627\u062a \u0627\u0644\u0633\u062a\u0629 \u0627\u0634\u062a\u0631\u0627\u0647 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u060c \u0623\u0648 `none` \u0639\u0646\u062f\u0645\u0627 \u0644\u0627 \u064a\u0631\u062a\u0628\u0637\n\u0627\u0644\u0635\u0641 \u0628\u0623\u064a \u0645\u0646\u062a\u062c \u0625\u0637\u0644\u0627\u0642\u064b\u0627. \u0648\u0643\u0644 \u0642\u064a\u0645\u0629 \u064a\u0645\u0643\u0646 \u0623\u0646 \u064a\u0639\u064a\u062f\u0647\u0627\n`Subscription::getItemTypeAttribute()` \u0645\u0630\u0643\u0648\u0631\u0629 \u0647\u0646\u0627: \u0641\u0640`ipAddress` \u0645\u062a\u0627\u062d \u0645\u0646\u0630\n2026-08-09 \u0648`service`/`network` \u0645\u0646\u0630 2026-08-19\u060c \u0648\u0646\u0642\u0637\u0629 \u0627\u0644\u0646\u0647\u0627\u064a\u0629 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u0642\u0627\u0626\u0645\u0629\n\u0644\u0627 \u062a\u0637\u0628\u0651\u0642 \u0623\u064a \u0645\u0631\u0634\u0651\u062d \u0639\u0644\u0649 \u0646\u0648\u0639 \u0627\u0644\u0645\u0646\u062a\u062c\u060c \u0648\u0644\u0630\u0644\u0643 \u0639\u0644\u0649 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0648\u0644\u064e\u0651\u062f \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0646 \u064a\u0642\u0628\u0644\n\u0627\u0644\u0623\u0646\u0648\u0627\u0639 \u0627\u0644\u0633\u0628\u0639\u0629 \u062c\u0645\u064a\u0639\u0647\u0627.\n" } }, "enum": [ "virtualMachine", "volume", "domainName", "ipAddress", "service", "network", "none" ] }, "status": { "type": "string", "description": "The base lifecycle status, decoded from a bitmask that also carries\n`is_superseded`/`is_administrative` as separate flags (published as their\nown boolean fields below, not folded into this value).\n\n`failed` is reserved: `Subscription::failed()` currently writes `deployed`,\nnot `failed`, and that write is itself rolled back by the transaction it\nruns in, so no subscription reaches this value today. A failed deployment\nis observable only as a `pending` subscription that never settles \u2014 a\npoller must not assume `pending` means \"still in progress\" past a\nreasonable timeout.\n", "x-i18n": { "tr": { "description": "Temel ya\u015fam d\u00f6ng\u00fcs\u00fc durumu; `is_superseded`/`is_administrative` bayraklar\u0131n\u0131 da\nayr\u0131 ayr\u0131 ta\u015f\u0131yan bir bit maskesinden \u00e7\u00f6z\u00fcl\u00fcr (bu bayraklar a\u015fa\u011f\u0131da kendi boole\nalanlar\u0131 olarak yay\u0131mlan\u0131r, bu de\u011ferin i\u00e7ine katlanmaz).\n\n`failed` ayr\u0131lm\u0131\u015f bir de\u011ferdir: `Subscription::failed()` \u015fu anda `failed` de\u011fil\n`deployed` yazar ve bu yazma da i\u00e7inde \u00e7al\u0131\u015ft\u0131\u011f\u0131 i\u015flem taraf\u0131ndan geri al\u0131n\u0131r;\ndolay\u0131s\u0131yla bug\u00fcn hi\u00e7bir abonelik bu de\u011fere ula\u015fmaz. Ba\u015far\u0131s\u0131z bir kurulum\nyaln\u0131zca hi\u00e7 tamamlanmayan `pending` bir abonelik olarak g\u00f6zlenebilir \u2014 yoklama\nyapan bir istemci, makul bir zaman a\u015f\u0131m\u0131ndan sonra `pending` de\u011ferini \u201ch\u00e2l\u00e2\ns\u00fcr\u00fcyor\u201d diye okumamal\u0131d\u0131r.\n" }, "ar": { "description": "\u062d\u0627\u0644\u0629 \u062f\u0648\u0631\u0629 \u0627\u0644\u062d\u064a\u0627\u0629 \u0627\u0644\u0623\u0633\u0627\u0633\u064a\u0629\u060c \u0648\u062a\u064f\u0641\u0643\u0651 \u0645\u0646 \u0642\u0646\u0627\u0639 \u0628\u062a\u0651\u064a \u064a\u062d\u0645\u0644 \u0623\u064a\u0636\u064b\u0627 `is_superseded`\n\u0648`is_administrative` \u0643\u0631\u0627\u064a\u062a\u064a\u0646 \u0645\u0646\u0641\u0635\u0644\u062a\u064a\u0646 (\u062a\u064f\u0646\u0634\u0631\u0627\u0646 \u0623\u062f\u0646\u0627\u0647 \u0643\u062d\u0642\u0644\u064a\u0646 \u0645\u0646\u0637\u0642\u064a\u064a\u0646 \u0645\u0633\u062a\u0642\u0644\u064a\u0646\u060c\n\u0648\u0644\u0627 \u062a\u064f\u062f\u0645\u062c\u0627\u0646 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0642\u064a\u0645\u0629).\n\n\u0648\u0627\u0644\u0642\u064a\u0645\u0629 `failed` \u0645\u062d\u062c\u0648\u0632\u0629: \u0625\u0630 \u064a\u0643\u062a\u0628 `Subscription::failed()` \u062d\u0627\u0644\u064a\u064b\u0627 `deployed` \u0644\u0627\n`failed`\u060c \u0648\u062a\u0644\u0643 \u0627\u0644\u0643\u062a\u0627\u0628\u0629 \u0646\u0641\u0633\u0647\u0627 \u062a\u062a\u0631\u0627\u062c\u0639 \u0645\u0639 \u0627\u0644\u0645\u0639\u0627\u0645\u0644\u0629 \u0627\u0644\u062a\u064a \u062a\u062c\u0631\u064a \u062f\u0627\u062e\u0644\u0647\u0627\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627\n\u064a\u0628\u0644\u063a \u0623\u064a \u0627\u0634\u062a\u0631\u0627\u0643 \u0647\u0630\u0647 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u064a\u0648\u0645. \u0648\u0644\u0627 \u064a\u0638\u0647\u0631 \u0627\u0644\u0625\u062e\u0641\u0627\u0642 \u0641\u064a \u0627\u0644\u0646\u0634\u0631 \u0625\u0644\u0627 \u0639\u0644\u0649 \u0647\u064a\u0626\u0629 \u0627\u0634\u062a\u0631\u0627\u0643\n`pending` \u0644\u0627 \u064a\u0633\u062a\u0642\u0631 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0648\u0639\u0644\u0649 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u064a\u0633\u062a\u0639\u0644\u0645 \u062f\u0648\u0631\u064a\u064b\u0627 \u0623\u0644\u0651\u0627 \u064a\u0641\u062a\u0631\u0636 \u0623\u0646\n`pending` \u062a\u0639\u0646\u064a \u00ab\u0644\u0627 \u064a\u0632\u0627\u0644 \u0642\u064a\u062f \u0627\u0644\u062a\u0646\u0641\u064a\u0630\u00bb \u0628\u0639\u062f \u0645\u0647\u0644\u0629 \u0645\u0639\u0642\u0648\u0644\u0629.\n" } }, "enum": [ "new", "pending", "failed", "deployed", "locked", "terminated", "scaling", "unknown" ] }, "is_locked": { "type": "boolean", "description": "Every mutation is refused while this holds \u2014 an unpaid or suspended subscription.", "x-i18n": { "tr": { "description": "Bu ge\u00e7erliyken her de\u011fi\u015fiklik reddedilir \u2014 \u00f6denmemi\u015f ya da ask\u0131ya al\u0131nm\u0131\u015f bir abonelik." }, "ar": { "description": "\u062a\u064f\u0631\u0641\u0636 \u0643\u0644 \u0639\u0645\u0644\u064a\u0629 \u062a\u0639\u062f\u064a\u0644 \u0645\u0627 \u062f\u0627\u0645 \u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644 \u0635\u062d\u064a\u062d\u064b\u0627 \u2014 \u0627\u0634\u062a\u0631\u0627\u0643 \u063a\u064a\u0631 \u0645\u062f\u0641\u0648\u0639 \u0623\u0648 \u0645\u0648\u0642\u0648\u0641." } } }, "is_superseded": { "type": "boolean", "description": "Replaced by a later subscription (a scale, typically). See `next_id`.", "x-i18n": { "tr": { "description": "Yerini daha sonraki bir abonelik alm\u0131\u015ft\u0131r (genellikle bir \u00f6l\u00e7eklendirme). Bkz. `next_id`." }, "ar": { "description": "\u062d\u0644\u0651 \u0645\u062d\u0644\u0651\u0647 \u0627\u0634\u062a\u0631\u0627\u0643 \u0644\u0627\u062d\u0642 (\u0639\u0645\u0644\u064a\u0629 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645 \u0639\u0627\u062f\u0629\u064b). \u0627\u0646\u0638\u0631 `next_id`." } } }, "is_administrative": { "type": "boolean", "description": "Comped or provider-created rather than sold; contributes nothing to billing.", "x-i18n": { "tr": { "description": "Sat\u0131lm\u0131\u015f de\u011fil; bedelsiz verilmi\u015f ya da sa\u011flay\u0131c\u0131 taraf\u0131ndan olu\u015fturulmu\u015f. Faturalamaya hi\u00e7bir katk\u0131s\u0131 yoktur." }, "ar": { "description": "\u0645\u062c\u0627\u0646\u064a \u0623\u0648 \u0623\u0646\u0634\u0623\u0647 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0628\u062f\u0644 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0645\u0628\u064a\u0639\u064b\u0627\u061b \u0644\u0627 \u064a\u0633\u0627\u0647\u0645 \u0641\u064a \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0625\u0637\u0644\u0627\u0642\u064b\u0627." } } }, "is_refundable": { "type": "boolean", "description": "Whether the refund flow would currently accept this subscription \u2014 the\nsame derived answer the panel shows, not a raw flag: a subscription whose\nattached service work has already been scheduled or delivered is NOT\nrefundable however new it is. Refund doors themselves are out of scope for\nthis phase; this field is informational.\nA resized subscription answers `false`: what a full refund of a resized\ncontract should pay back is an open question, and cancelling is what the\ncustomer can actually do. Also `false` while an invoice-cancellation refund\nrequest is open on the line.\n", "x-i18n": { "tr": { "description": "\u0130ade ak\u0131\u015f\u0131n\u0131n bu aboneli\u011fi \u015fu anda kabul edip etmeyece\u011fi \u2014 paneldeki ile ayn\u0131\nt\u00fcretilmi\u015f yan\u0131t, ham bir bayrak de\u011fil: ba\u011fl\u0131 hizmet \u00e7al\u0131\u015fmas\u0131 planlanm\u0131\u015f veya\nteslim edilmi\u015f bir abonelik, ne kadar yeni olursa olsun iade edilemez. \u0130ade u\u00e7\nnoktalar\u0131n\u0131n kendisi bu a\u015faman\u0131n kapsam\u0131 d\u0131\u015f\u0131ndad\u0131r; bu alan yaln\u0131zca bilgi\nama\u00e7l\u0131d\u0131r. Yeniden boyutland\u0131r\u0131lm\u0131\u015f bir abonelik `false` yan\u0131t\u0131n\u0131 verir:\nyeniden boyutland\u0131r\u0131lm\u0131\u015f bir s\u00f6zle\u015fmenin tam iadesinin ne \u00f6demesi gerekti\u011fi a\u00e7\u0131k\nbir sorudur ve m\u00fc\u015fterinin ger\u00e7ekten yapabilece\u011fi \u015fey iptaldir.\n" }, "ar": { "description": "\u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646 \u0645\u0633\u0627\u0631 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0633\u064a\u0642\u0628\u0644 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u062d\u0627\u0644\u064a\u064b\u0627 \u2014 \u0648\u0647\u0648 \u0627\u0644\u062c\u0648\u0627\u0628 \u0627\u0644\u0645\u0634\u062a\u0642 \u0646\u0641\u0633\u0647\n\u0627\u0644\u0630\u064a \u062a\u0639\u0631\u0636\u0647 \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0644\u0627 \u0631\u0627\u064a\u0629 \u062e\u0627\u0645\u064b\u0627: \u0641\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u062c\u064f\u062f\u0648\u0650\u0644 \u0639\u0645\u0644 \u062e\u062f\u0645\u062a\u0647 \u0623\u0648 \u0633\u064f\u0644\u0650\u0651\u0645 \u0644\u0627\n\u064a\u0642\u0628\u0644 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0645\u0647\u0645\u0627 \u0643\u0627\u0646 \u062d\u062f\u064a\u062b\u064b\u0627. \u0623\u0645\u0627 \u0623\u0628\u0648\u0627\u0628 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0646\u0641\u0633\u0647\u0627 \u0641\u062e\u0627\u0631\u062c \u0646\u0637\u0627\u0642 \u0647\u0630\u0647\n\u0627\u0644\u0645\u0631\u062d\u0644\u0629\u061b \u0648\u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644 \u0644\u0644\u0639\u0644\u0645 \u0641\u0642\u0637. \u0648\u064a\u062c\u064a\u0628 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u062c\u0631\u0649 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645\u0647 \u0628\u0640`false`:\n\u0641\u0645\u0627 \u064a\u0646\u0628\u063a\u064a \u0623\u0646 \u064a\u0639\u064a\u062f\u0647 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644 \u0644\u0639\u0642\u062f \u062c\u0631\u0649 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645\u0647 \u0633\u0624\u0627\u0644 \u0645\u0641\u062a\u0648\u062d\u060c \u0648\u0627\u0644\u0625\u0644\u063a\u0627\u0621 \u0647\u0648\n\u0645\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0627\u0644\u0639\u0645\u064a\u0644 \u0641\u0639\u0644\u0647 \u0641\u0639\u0644\u064b\u0627.\n" } } }, "refund_needs_invoice_cancellation": { "type": "boolean", "description": "True when the refund window is open but an e-Ar\u015fiv/e-Fatura invoice has already been\nissued for the purchase: the invoice must be cancelled before the money can go back,\nso a refund goes through an invoice-cancellation request in the panel rather than\nstraight to the card.\n", "x-i18n": { "tr": { "description": "\u0130ade s\u00fcresi a\u00e7\u0131k oldu\u011fu h\u00e2lde sat\u0131n alma i\u00e7in e-Ar\u015fiv/e-Fatura faturas\u0131 zaten\nkesilmi\u015fse do\u011frudur: para iade edilmeden \u00f6nce faturan\u0131n iptal edilmesi gerekir; bu\ny\u00fczden iade do\u011frudan karta de\u011fil, paneldeki fatura iptali talebi \u00fczerinden yap\u0131l\u0131r.\n" }, "ar": { "description": "\u064a\u0643\u0648\u0646 \u0635\u062d\u064a\u062d\u064b\u0627 \u062d\u064a\u0646 \u062a\u0643\u0648\u0646 \u0645\u0647\u0644\u0629 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0645\u0641\u062a\u0648\u062d\u0629 \u0644\u0643\u0646 \u0641\u0627\u062a\u0648\u0631\u0629 e-Ar\u015fiv/e-Fatura \u0642\u062f \u0635\u062f\u0631\u062a\n\u0628\u0627\u0644\u0641\u0639\u0644 \u0644\u0639\u0645\u0644\u064a\u0629 \u0627\u0644\u0634\u0631\u0627\u0621: \u064a\u062c\u0628 \u0625\u0644\u063a\u0627\u0621 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0642\u0628\u0644 \u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u0645\u0627\u0644\u060c \u0644\u0630\u0627 \u064a\u0645\u0631 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0639\u0628\u0631\n\u0637\u0644\u0628 \u0625\u0644\u063a\u0627\u0621 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0628\u062f\u0644\u064b\u0627 \u0645\u0646 \u0627\u0644\u0630\u0647\u0627\u0628 \u0645\u0628\u0627\u0634\u0631\u0629 \u0625\u0644\u0649 \u0627\u0644\u0628\u0637\u0627\u0642\u0629.\n" } } }, "period_ends_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When the paid period ends and this subscription renews. A resize never moves\nit \u2014 an upscale charges the difference and a downscale refunds it, and the\ndate stays where it was. `null` on a row that has never carried the override.\n", "x-i18n": { "tr": { "description": "\u00d6denmi\u015f d\u00f6nemin bitti\u011fi ve bu aboneli\u011fin yenilendi\u011fi tarih. Yeniden\nboyutland\u0131rma bu tarihi hi\u00e7bir zaman de\u011fi\u015ftirmez \u2014 y\u00fckseltme fark\u0131 tahsil\neder, k\u00fc\u00e7\u00fcltme fark\u0131 iade eder ve tarih oldu\u011fu yerde kal\u0131r. Bu ge\u00e7ersiz\nk\u0131lmay\u0131 hi\u00e7 ta\u015f\u0131mam\u0131\u015f bir sat\u0131rda `null` olur.\n" }, "ar": { "description": "\u0645\u0648\u0639\u062f \u0627\u0646\u062a\u0647\u0627\u0621 \u0627\u0644\u0641\u062a\u0631\u0629 \u0627\u0644\u0645\u062f\u0641\u0648\u0639\u0629 \u0648\u062a\u062c\u062f\u064a\u062f \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643. \u0648\u0644\u0627 \u064a\u062d\u0631\u0651\u0643\u0647 \u062a\u063a\u064a\u064a\u0631 \u0627\u0644\u062d\u062c\u0645 \u0623\u0628\u062f\u064b\u0627\n\u2014 \u0641\u0627\u0644\u062a\u0631\u0642\u064a\u0629 \u062a\u062e\u0635\u0645 \u0627\u0644\u0641\u0631\u0642 \u0648\u0627\u0644\u062a\u062e\u0641\u064a\u0636 \u064a\u0631\u062f\u0651\u0647\u060c \u0648\u064a\u0628\u0642\u0649 \u0627\u0644\u062a\u0627\u0631\u064a\u062e \u0641\u064a \u0645\u0643\u0627\u0646\u0647. \u0648\u064a\u0643\u0648\u0646 `null` \u0641\u064a\n\u0633\u062c\u0644 \u0644\u0645 \u064a\u062d\u0645\u0644 \u0647\u0630\u0627 \u0627\u0644\u062a\u062c\u0627\u0648\u0632 \u0642\u0637.\n" } } }, "is_scaling": { "type": "boolean", "description": "A resize is being applied to this subscription right now. It is a temporary\nlock, not a state of the contract: the machine is being rebuilt at its new\nsize and mutations are refused until it clears.\n", "x-i18n": { "tr": { "description": "Bu abonelikte \u015fu anda bir yeniden boyutland\u0131rma uygulan\u0131yor. Bu, s\u00f6zle\u015fmenin\nbir durumu de\u011fil ge\u00e7ici bir kilittir: makine yeni boyutunda yeniden kuruluyor\nve kilit kalkana kadar de\u011fi\u015fiklikler reddedilir.\n" }, "ar": { "description": "\u064a\u062c\u0631\u064a \u0627\u0644\u0622\u0646 \u062a\u0637\u0628\u064a\u0642 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645 \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643. \u0648\u0647\u0648 \u0642\u0641\u0644 \u0645\u0624\u0642\u062a \u0644\u0627 \u062d\u0627\u0644\u0629 \u0645\u0646 \u062d\u0627\u0644\u0627\u062a\n\u0627\u0644\u0639\u0642\u062f: \u0625\u0630 \u064a\u064f\u0639\u0627\u062f \u0628\u0646\u0627\u0621 \u0627\u0644\u062c\u0647\u0627\u0632 \u0628\u062d\u062c\u0645\u0647 \u0627\u0644\u062c\u062f\u064a\u062f \u0648\u062a\u064f\u0631\u0641\u0636 \u0627\u0644\u062a\u0639\u062f\u064a\u0644\u0627\u062a \u062d\u062a\u0649 \u064a\u0646\u0642\u0636\u064a \u0627\u0644\u0642\u0641\u0644.\n" } } }, "resize_history": { "type": "array", "nullable": true, "description": "Every step of this subscription's resize chain, newest first \u2014 what each step\ncharged and what it refunded, and where the refund went. Sent by\n`GET /subscriptions/{id}` only; `null` in the list, because building it walks\nthe whole chain and queries per member. Every figure inside is a `Money`, every\ncurrency an ISO code, and both statuses are the same closed string sets\n`GET /payments` and `GET /refunds` publish \u2014 so a refund seen here and the same\nrefund seen at `GET /refunds` agree field for field.\n", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string", "nullable": true }, "item_type": { "type": "string" }, "product_id": { "type": "integer", "nullable": true }, "event": { "type": "string" }, "from_name": { "type": "string", "nullable": true }, "effective_price": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ] }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "ended_at": { "type": "string", "format": "date-time", "nullable": true }, "period_ends_at": { "type": "string", "format": "date-time", "nullable": true }, "charge": { "type": "object", "nullable": true, "properties": { "payment_id": { "type": "integer" }, "currency": { "type": "string", "minLength": 3, "maxLength": 3 }, "total": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true }, "status": { "type": "string", "enum": [ "new", "payed", "failed", "canceled", "expired", "refunded", "partially_refunded", "unknown" ] }, "is_superseded": { "type": "boolean" }, "is_administrative": { "type": "boolean" }, "paid_at": { "type": "string", "format": "date-time", "nullable": true } } }, "refunds": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "payment_id": { "type": "integer" }, "currency": { "type": "string", "minLength": 3, "maxLength": 3 }, "amount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true }, "amount_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true }, "destination": { "type": "string", "nullable": true }, "status": { "type": "string", "enum": [ "new", "done", "failed", "pending", "unknown" ] }, "expires_at": { "type": "string", "format": "date-time", "nullable": true } } } } } }, "x-i18n": { "tr": { "description": "Bu aboneli\u011fin yeniden boyutland\u0131rma zincirindeki her ad\u0131m, en yenisi \u00f6nce \u2014\nher ad\u0131m\u0131n ne tahsil etti\u011fi, ne iade etti\u011fi ve iadenin nereye gitti\u011fi.\nYaln\u0131zca `GET /subscriptions/{id}` g\u00f6nderir; listede `null` olur, \u00e7\u00fcnk\u00fc bunu\nkurmak t\u00fcm zinciri dola\u015f\u0131r ve her \u00fcye i\u00e7in sorgu yapar. \u0130\u00e7indeki her tutar bir\n`Money`, her para birimi bir ISO kodudur ve iki durum alan\u0131 da `GET /payments`\nile `GET /refunds` u\u00e7 noktalar\u0131n\u0131n yay\u0131mlad\u0131\u011f\u0131 kapal\u0131 de\u011fer k\u00fcmelerinin\nayn\u0131s\u0131d\u0131r \u2014 b\u00f6ylece burada g\u00f6r\u00fclen bir iade ile `GET /refunds` alt\u0131nda g\u00f6r\u00fclen\nayn\u0131 iade alan alan uyu\u015fur.\n" }, "ar": { "description": "\u0643\u0644 \u062e\u0637\u0648\u0629 \u0641\u064a \u0633\u0644\u0633\u0644\u0629 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u060c \u0645\u0646 \u0627\u0644\u0623\u062d\u062f\u062b \u0625\u0644\u0649 \u0627\u0644\u0623\u0642\u062f\u0645 \u2014 \u0645\u0627 \u062e\u0635\u0645\u062a\u0647 \u0643\u0644\n\u062e\u0637\u0648\u0629 \u0648\u0645\u0627 \u0631\u062f\u0651\u062a\u0647 \u0648\u0625\u0644\u0649 \u0623\u064a\u0646 \u0630\u0647\u0628 \u0627\u0644\u0631\u062f. \u0644\u0627 \u064a\u0631\u0633\u0644\u0647\u0627 \u0625\u0644\u0627 `GET /subscriptions/{id}`\u060c\n\u0648\u062a\u0643\u0648\u0646 `null` \u0641\u064a \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0644\u0623\u0646 \u0628\u0646\u0627\u0621\u0647\u0627 \u064a\u0645\u0634\u064a \u0639\u0644\u0649 \u0627\u0644\u0633\u0644\u0633\u0644\u0629 \u0643\u0627\u0645\u0644\u0629 \u0648\u064a\u0633\u062a\u0639\u0644\u0645 \u0644\u0643\u0644 \u0639\u0636\u0648\n\u0641\u064a\u0647\u0627. \u0648\u0643\u0644 \u0645\u0628\u0644\u063a \u062f\u0627\u062e\u0644\u0647\u0627 \u0645\u0646 \u0646\u0648\u0639 `Money`\u060c \u0648\u0643\u0644 \u0639\u0645\u0644\u0629 \u0631\u0645\u0632 ISO\u060c \u0648\u062d\u0642\u0644\u0627 \u0627\u0644\u062d\u0627\u0644\u0629 \u0647\u0645\u0627\n\u0627\u0644\u0645\u062c\u0645\u0648\u0639\u062a\u0627\u0646 \u0627\u0644\u0645\u063a\u0644\u0642\u062a\u0627\u0646 \u0646\u0641\u0633\u0627\u0647\u0645\u0627 \u0627\u0644\u0644\u062a\u0627\u0646 \u064a\u0646\u0634\u0631\u0647\u0645\u0627 `GET /payments` \u0648`GET /refunds` \u2014\n\u0641\u064a\u062a\u0637\u0627\u0628\u0642 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0645\u0631\u0626\u064a \u0647\u0646\u0627 \u0645\u0639 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0646\u0641\u0633\u0647 \u0641\u064a `GET /refunds` \u062d\u0642\u0644\u064b\u0627 \u0628\u062d\u0642\u0644.\n" } } }, "instance_id": { "type": "integer", "nullable": true, "description": "The id of the linked instance (see `GET /instances/{id}`), for a `virtualMachine` subscription.", "x-i18n": { "tr": { "description": "Bir `virtualMachine` aboneli\u011finde, ba\u011fl\u0131 sanal makinan\u0131n kimli\u011fi (bkz. `GET /instances/{id}`)." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0627\u0644\u0645\u0631\u062a\u0628\u0637 (\u0627\u0646\u0638\u0631 `GET /instances/{id}`) \u0641\u064a \u0627\u0634\u062a\u0631\u0627\u0643 \u0645\u0646 \u0646\u0648\u0639 `virtualMachine`." } }, "example": 17 }, "volume_id": { "type": "integer", "nullable": true, "description": "The id of the linked volume (see `GET /volumes/{id}`), for a `volume` subscription.", "x-i18n": { "tr": { "description": "Bir `volume` aboneli\u011finde, ba\u011fl\u0131 diskin kimli\u011fi (bkz. `GET /volumes/{id}`)." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0642\u0631\u0635 \u0627\u0644\u0645\u0631\u062a\u0628\u0637 (\u0627\u0646\u0638\u0631 `GET /volumes/{id}`) \u0641\u064a \u0627\u0634\u062a\u0631\u0627\u0643 \u0645\u0646 \u0646\u0648\u0639 `volume`." } } }, "public_ip_address_id": { "type": "integer", "nullable": true, "description": "The id of the linked public address (see `GET /public-ip-addresses/{id}`), for an\n`ipAddress` subscription. The same pointer `instance_id`/`volume_id` are for their\nproduct types: the row records both the product bought and the resource it became.\n", "x-i18n": { "tr": { "description": "Bir `ipAddress` aboneli\u011finde, ba\u011fl\u0131 kamusal adresin kimli\u011fi\n(bkz. `GET /public-ip-addresses/{id}`). `instance_id`/`volume_id` alanlar\u0131 kendi\n\u00fcr\u00fcn t\u00fcrleri i\u00e7in ne ise bu da odur: sat\u0131r, hem sat\u0131n al\u0131nan \u00fcr\u00fcn\u00fc hem de o\n\u00fcr\u00fcn\u00fcn d\u00f6n\u00fc\u015ft\u00fc\u011f\u00fc kayna\u011f\u0131 kaydeder.\n" }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0639\u0646\u0648\u0627\u0646 \u0627\u0644\u0639\u0627\u0645 \u0627\u0644\u0645\u0631\u062a\u0628\u0637 (\u0627\u0646\u0638\u0631 `GET /public-ip-addresses/{id}`) \u0641\u064a \u0627\u0634\u062a\u0631\u0627\u0643\n\u0645\u0646 \u0646\u0648\u0639 `ipAddress`. \u0648\u0647\u0648 \u0627\u0644\u0645\u0624\u0634\u0651\u0631 \u0630\u0627\u062a\u0647 \u0627\u0644\u0630\u064a \u064a\u0645\u062b\u0651\u0644\u0647 `instance_id`/`volume_id`\n\u0644\u0646\u0648\u0639\u064e\u064a \u0627\u0644\u0645\u0646\u062a\u062c \u0627\u0644\u062e\u0627\u0635\u064e\u0651\u064a\u0646 \u0628\u0647\u0645\u0627: \u0641\u0627\u0644\u0635\u0641 \u064a\u0633\u062c\u0651\u0644 \u0627\u0644\u0645\u0646\u062a\u062c \u0627\u0644\u0645\u0634\u062a\u0631\u0649 \u0648\u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0630\u064a \u0635\u0627\u0631 \u0625\u0644\u064a\u0647.\n" } }, "example": 4 }, "network_id": { "type": "integer", "nullable": true, "description": "The id of the network this subscription BOUGHT, for a `network` subscription \u2014\nnot the network another product deploys into, which is not published. Null until\nthe provider reports the network created, and nulled again if it is later removed.\n", "x-i18n": { "tr": { "description": "Bir `network` aboneli\u011finde, bu aboneli\u011fin SATIN ALDI\u011eI a\u011f\u0131n kimli\u011fi \u2014 ba\u015fka bir\n\u00fcr\u00fcn\u00fcn i\u00e7ine kuruldu\u011fu a\u011f de\u011fil; o a\u011f yay\u0131mlanmaz. Sa\u011flay\u0131c\u0131 a\u011f\u0131n olu\u015fturuldu\u011funu\nbildirene kadar null olur ve a\u011f sonradan kald\u0131r\u0131l\u0131rsa yeniden null yap\u0131l\u0131r.\n" }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0634\u0628\u0643\u0629 \u0627\u0644\u062a\u064a \u0627\u0634\u062a\u0631\u0627\u0647\u0627 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0646\u0641\u0633\u0647\u060c \u0641\u064a \u0627\u0634\u062a\u0631\u0627\u0643 \u0645\u0646 \u0646\u0648\u0639 `network` \u2014 \u0644\u0627\n\u0627\u0644\u0634\u0628\u0643\u0629 \u0627\u0644\u062a\u064a \u064a\u064f\u0646\u0634\u0631 \u062f\u0627\u062e\u0644\u0647\u0627 \u0645\u0646\u062a\u062c \u0622\u062e\u0631\u060c \u0641\u062a\u0644\u0643 \u0644\u0627 \u062a\u064f\u0646\u0634\u0631 \u0647\u0646\u0627. \u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 null \u0625\u0644\u0649 \u0623\u0646\n\u064a\u064f\u0628\u0644\u0651\u063a \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0628\u0625\u0646\u0634\u0627\u0621 \u0627\u0644\u0634\u0628\u0643\u0629\u060c \u0648\u062a\u0639\u0648\u062f null \u0625\u0646 \u0623\u064f\u0632\u064a\u0644\u062a \u0644\u0627\u062d\u0642\u064b\u0627.\n" } } }, "payment_plan_id": { "type": "integer", "nullable": true }, "credit_card_id": { "type": "integer", "nullable": true }, "next_id": { "type": "integer", "nullable": true, "description": "The id of the subscription that superseded this one, or `null`. Stands in\nfor the panel's `history` field, which is omitted here \u2014 it is an N+1 walk\nof the whole ancestor chain. A client that wants the chain follows this\npointer (and `is_superseded`) itself.\n", "x-i18n": { "tr": { "description": "Bu aboneli\u011fin yerine ge\u00e7en aboneli\u011fin kimli\u011fi ya da `null`. Panelin burada\nyay\u0131mlanmayan `history` alan\u0131n\u0131n yerini tutar \u2014 o alan, b\u00fct\u00fcn ata zincirini\ndola\u015fan bir N+1 sorgusudur. Zinciri isteyen bir istemci, bu i\u015faret\u00e7iyi (ve\n`is_superseded` alan\u0131n\u0131) kendisi izler.\n" }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u062d\u0644\u0651 \u0645\u062d\u0644\u0651 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u060c \u0623\u0648 `null`. \u064a\u0642\u0648\u0645 \u0645\u0642\u0627\u0645 \u062d\u0642\u0644 `history`\n\u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0648\u0647\u0648 \u062d\u0642\u0644 \u0645\u064f\u063a\u0641\u064e\u0644 \u0647\u0646\u0627 \u2014 \u0625\u0630 \u064a\u0645\u062b\u0651\u0644 \u0645\u0631\u0648\u0631\u064b\u0627 \u0645\u0646 \u0646\u0648\u0639 N+1 \u0639\u0644\u0649 \u0633\u0644\u0633\u0644\u0629 \u0627\u0644\u0623\u0633\u0644\u0627\u0641\n\u0643\u0627\u0645\u0644\u0629. \u0648\u0639\u0644\u0649 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u064a\u0631\u064a\u062f \u0627\u0644\u0633\u0644\u0633\u0644\u0629 \u0623\u0646 \u064a\u062a\u062a\u0628\u0651\u0639 \u0647\u0630\u0627 \u0627\u0644\u0645\u0624\u0634\u0651\u0631\n(\u0648`is_superseded`) \u0628\u0646\u0641\u0633\u0647.\n" } } }, "price": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "USD, unconditionally \u2014 the linked payment plan's list price, before any coupon.", "x-i18n": { "tr": { "description": "Ko\u015fulsuz olarak USD \u2014 ba\u011fl\u0131 \u00f6deme plan\u0131n\u0131n liste fiyat\u0131, herhangi bir kupon uygulanmadan \u00f6nce." }, "ar": { "description": "\u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a \u062f\u0627\u0626\u0645\u064b\u0627 \u2014 \u0633\u0639\u0631 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0644\u062e\u0637\u0629 \u0627\u0644\u062f\u0641\u0639 \u0627\u0644\u0645\u0631\u062a\u0628\u0637\u0629\u060c \u0642\u0628\u0644 \u0623\u064a \u0642\u0633\u064a\u0645\u0629." } } }, "effective_price": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "USD, unconditionally \u2014 the price after the best currently-valid coupon, if any.", "x-i18n": { "tr": { "description": "Ko\u015fulsuz olarak USD \u2014 varsa ge\u00e7erli en iyi kupon uyguland\u0131ktan sonraki fiyat." }, "ar": { "description": "\u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a \u062f\u0627\u0626\u0645\u064b\u0627 \u2014 \u0627\u0644\u0633\u0639\u0631 \u0628\u0639\u062f \u0623\u0641\u0636\u0644 \u0642\u0633\u064a\u0645\u0629 \u0633\u0627\u0631\u064a\u0629 \u062d\u0627\u0644\u064a\u064b\u0627\u060c \u0625\u0646 \u0648\u064f\u062c\u062f\u062a." } } }, "started_at": { "type": "string", "format": "date-time" }, "ended_at": { "type": "string", "format": "date-time" }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "Payment": { "type": "object", "required": [ "id", "status", "is_superseded", "is_administrative", "currency", "amount", "subtotal", "taxes", "discount", "applied_balance", "credit_basis", "taxable_base", "list_total", "catalogue_discount", "refunds", "refunded_total", "refunded_credit_total", "net_after_refunds", "settled_by_payment_id", "is_dues", "covered_interest", "subscription_ids", "failure_reason", "failure_count", "created_at", "paid_at" ], "properties": { "id": { "type": "integer", "example": 9042 }, "status": { "type": "string", "enum": [ "new", "payed", "failed", "canceled", "expired", "refunded", "partially_refunded", "unknown" ] }, "is_superseded": { "type": "boolean", "description": "This payment has been REPLACED and asks for nothing. Two things produce it: a\ncontract whose bill was rewritten, and a bill rolled into a dues payment \u2014 read\n`settled_by_payment_id` to tell them apart, and to learn which payment now\ncarries the debt. `status` is deliberately left as it was, so an absorbed bill\nstill reads `new`.\n", "x-i18n": { "tr": { "description": "Bu \u00f6demenin yerini bir ba\u015fkas\u0131 alm\u0131\u015ft\u0131r ve art\u0131k hi\u00e7bir tutar talep etmez. Bunu\niki durum \u00fcretir: faturas\u0131 yeniden d\u00fczenlenen bir s\u00f6zle\u015fme ve toplu bor\u00e7\n\u00f6demesine d\u00e2hil edilen bir fatura \u2014 hangisi oldu\u011funu ve borcu art\u0131k hangi\n\u00f6demenin ta\u015f\u0131d\u0131\u011f\u0131n\u0131 anlamak i\u00e7in `settled_by_payment_id` alan\u0131n\u0131 okuyun.\n`status` bilerek oldu\u011fu gibi b\u0131rak\u0131l\u0131r; bu y\u00fczden d\u00e2hil edilmi\u015f bir fatura h\u00e2l\u00e2\n`new` g\u00f6r\u00fcn\u00fcr.\n" }, "ar": { "description": "\u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u062d\u0644\u0651\u062a \u0645\u062d\u0644\u0651\u0647\u0627 \u062f\u0641\u0639\u0629 \u0623\u062e\u0631\u0649 \u0648\u0644\u0645 \u062a\u0639\u062f \u062a\u0637\u0627\u0644\u0628 \u0628\u0634\u064a\u0621. \u0648\u064a\u0646\u0634\u0623 \u0630\u0644\u0643 \u0639\u0646 \u062d\u0627\u0644\u062a\u064a\u0646: \u0639\u0642\u062f\n\u0623\u064f\u0639\u064a\u062f\u062a \u0641\u0648\u062a\u0631\u062a\u0647\u060c \u0648\u0641\u0627\u062a\u0648\u0631\u0629 \u0636\u064f\u0645\u0651\u062a \u0625\u0644\u0649 \u062f\u0641\u0639\u0629 \u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0645\u062c\u0645\u0651\u0639\u0629 \u2014 \u0627\u0642\u0631\u0623\n`settled_by_payment_id` \u0644\u062a\u0645\u064a\u064a\u0632 \u0627\u0644\u062d\u0627\u0644\u062a\u064a\u0646 \u0648\u0644\u0645\u0639\u0631\u0641\u0629 \u0623\u064a \u062f\u0641\u0639\u0629 \u062a\u062d\u0645\u0644 \u0627\u0644\u062f\u064a\u0646 \u0627\u0644\u0622\u0646. \u0648\u064a\u064f\u062a\u0631\u0643\n`status` \u0643\u0645\u0627 \u0647\u0648 \u0639\u0646 \u0642\u0635\u062f\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u0628\u0642\u0649 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0627\u0644\u0645\u0636\u0645\u0648\u0645\u0629 \u0628\u0642\u064a\u0645\u0629 `new`.\n" } } }, "is_administrative": { "type": "boolean", "description": "Comped or provider-created; contributes nothing to billing.", "x-i18n": { "tr": { "description": "Bedelsiz verilmi\u015f ya da sa\u011flay\u0131c\u0131 taraf\u0131ndan olu\u015fturulmu\u015f; faturalamaya hi\u00e7bir katk\u0131s\u0131 yoktur." }, "ar": { "description": "\u0645\u062c\u0627\u0646\u064a \u0623\u0648 \u0623\u0646\u0634\u0623\u0647 \u0627\u0644\u0645\u0632\u0648\u0651\u062f\u061b \u0644\u0627 \u064a\u0633\u0627\u0647\u0645 \u0641\u064a \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0625\u0637\u0644\u0627\u0642\u064b\u0627." } } }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "description": "Decided once, at payment creation, from the customer's language at that\nmoment \u2014 never re-derived later. Two payments from the same customer can\ncarry different currencies if their language changed in between.\n", "x-i18n": { "tr": { "description": "\u00d6deme olu\u015fturulurken, o andaki m\u00fc\u015fteri diline g\u00f6re bir kez belirlenir \u2014 sonradan\nasla yeniden t\u00fcretilmez. Ayn\u0131 m\u00fc\u015fterinin iki \u00f6demesi, arada dili de\u011fi\u015ftiyse\nfarkl\u0131 para birimleri ta\u015f\u0131yabilir.\n" }, "ar": { "description": "\u062a\u064f\u062d\u062f\u064e\u0651\u062f \u0645\u0631\u0629 \u0648\u0627\u062d\u062f\u0629 \u0639\u0646\u062f \u0625\u0646\u0634\u0627\u0621 \u0627\u0644\u062f\u0641\u0639\u0629\u060c \u0627\u0646\u0637\u0644\u0627\u0642\u064b\u0627 \u0645\u0646 \u0644\u063a\u0629 \u0627\u0644\u0639\u0645\u064a\u0644 \u0641\u064a \u062a\u0644\u0643 \u0627\u0644\u0644\u062d\u0638\u0629 \u2014 \u0648\u0644\u0627\n\u062a\u064f\u0634\u062a\u0642 \u0645\u062c\u062f\u062f\u064b\u0627 \u0628\u0639\u062f \u0630\u0644\u0643. \u0648\u0642\u062f \u062a\u062d\u0645\u0644 \u062f\u0641\u0639\u062a\u0627\u0646 \u0644\u0644\u0639\u0645\u064a\u0644 \u0646\u0641\u0633\u0647 \u0639\u0645\u0644\u062a\u064a\u0646 \u0645\u062e\u062a\u0644\u0641\u062a\u064a\u0646 \u0625\u0646 \u062a\u063a\u064a\u064e\u0651\u0631\u062a\n\u0644\u063a\u062a\u0647 \u0628\u064a\u0646\u0647\u0645\u0627.\n" } }, "example": "TRY" }, "amount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The total, in `currency`. `null` when this payment has never been\nrecalculated \u2014 recalculating is a write (it caches the breakdown and an\nexchange rate), so a plain `GET` never triggers it. Pass `?refresh=true`\nto force a recalculation; it counts against the tighter refresh budget.\n", "x-i18n": { "tr": { "description": "`currency` cinsinden toplam. Bu \u00f6deme hi\u00e7 yeniden hesaplanmad\u0131ysa `null` olur \u2014\nyeniden hesaplamak bir yazma i\u015flemidir (d\u00f6k\u00fcm\u00fc ve bir d\u00f6viz kurunu \u00f6nbelle\u011fe\nal\u0131r), bu y\u00fczden d\u00fcz bir `GET` bunu asla tetiklemez. Yeniden hesaplamay\u0131\nzorlamak i\u00e7in `?refresh=true` g\u00f6nderin; bu istek, daha dar olan yenileme\nb\u00fct\u00e7esinden d\u00fc\u015fer.\n" }, "ar": { "description": "\u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a \u0628\u0639\u0645\u0644\u0629 `currency`. \u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0625\u0646 \u0644\u0645 \u064a\u064f\u0639\u064e\u062f \u062d\u0633\u0627\u0628 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u0642\u0637 \u2014\n\u0641\u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u062d\u0633\u0627\u0628 \u0639\u0645\u0644\u064a\u0629 \u0643\u062a\u0627\u0628\u0629 (\u062a\u062e\u0632\u0651\u0646 \u0627\u0644\u062a\u0641\u0635\u064a\u0644 \u0648\u0633\u0639\u0631 \u0627\u0644\u0635\u0631\u0641 \u0641\u064a \u0630\u0627\u0643\u0631\u0629 \u0645\u0624\u0642\u062a\u0629)\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627\n\u064a\u064f\u0637\u0644\u0642\u0647\u0627 \u0637\u0644\u0628 `GET` \u0639\u0627\u062f\u064a \u0623\u0628\u062f\u064b\u0627. \u0623\u0631\u0633\u0644 `?refresh=true` \u0644\u0641\u0631\u0636 \u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u062d\u0633\u0627\u0628\u061b \u0648\u064a\u064f\u062d\u062a\u0633\u0628\n\u0630\u0644\u0643 \u0645\u0646 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0627\u0644\u062a\u062d\u062f\u064a\u062b \u0627\u0644\u0623\u0636\u064a\u0642.\n" } } }, "subtotal": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "Same nullability rule as `amount`, and for the same reason.", "x-i18n": { "tr": { "description": "De\u011ferin null olabilme kural\u0131 `amount` ile ayn\u0131d\u0131r; gerek\u00e7esi de ayn\u0131d\u0131r." }, "ar": { "description": "\u0642\u0627\u0639\u062f\u0629 \u0642\u0627\u0628\u0644\u064a\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0644\u0623\u0646 \u062a\u0643\u0648\u0646 null \u0647\u064a \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642\u0629 \u0639\u0644\u0649 `amount`\u060c \u0648\u0644\u0644\u0633\u0628\u0628 \u0646\u0641\u0633\u0647." } } }, "taxes": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The VAT, charged on `taxable_base` rather than on `subtotal` wherever\n`credit_basis` is `net`. Same nullability rule as `amount`.\n", "x-i18n": { "tr": { "description": "KDV. `credit_basis` de\u011feri `net` olan her \u00f6demede `subtotal` \u00fczerinden de\u011fil,\n`taxable_base` \u00fczerinden hesaplan\u0131r. De\u011ferin null olabilme kural\u0131 `amount` ile\nayn\u0131d\u0131r.\n" }, "ar": { "description": "\u0636\u0631\u064a\u0628\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0645\u0636\u0627\u0641\u0629\u060c \u0648\u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 `taxable_base` \u0644\u0627 \u0639\u0644\u0649 `subtotal` \u0643\u0644\u0645\u0627 \u0643\u0627\u0646\n`credit_basis` \u064a\u0633\u0627\u0648\u064a `net`. \u0648\u0642\u0627\u0639\u062f\u0629 \u0642\u0627\u0628\u0644\u064a\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0644\u0623\u0646 \u062a\u0643\u0648\u0646 null \u0647\u064a \u0646\u0641\u0633\u0647\u0627\n\u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642\u0629 \u0639\u0644\u0649 `amount`.\n" } } }, "discount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "Granted account credit applied to this payment as a DISCOUNT ON THE NET \u2014 an\niskonto, not a payment. It reduces the taxable base, so the VAT in `taxes` is\ncharged on `taxable_base` and not on `subtotal`. Read `credit_basis` before\nreconciling: on a payment charged before 2026-09-17 this figure was subtracted\nfrom the VAT-inclusive gross instead, and is replayed as it was charged. Same\nnullability rule as `amount`.\n", "x-i18n": { "tr": { "description": "Bu \u00f6demeye uygulanan hediye hesap kredisi \u2014 bir \u00f6deme de\u011fil, NET TUTAR \u00dcZER\u0130NDEN\n\u0130SKONTO. Matrah\u0131 d\u00fc\u015f\u00fcr\u00fcr; bu y\u00fczden `taxes` i\u00e7indeki KDV, `subtotal` \u00fczerinden\nde\u011fil `taxable_base` \u00fczerinden hesaplan\u0131r. Mutabakat yapmadan \u00f6nce `credit_basis`\nalan\u0131n\u0131 okuyun: 17.09.2026 \u00f6ncesinde tahsil edilmi\u015f bir \u00f6demede bu tutar KDV d\u00e2hil\nbr\u00fctten d\u00fc\u015f\u00fcl\u00fcyordu ve o \u00f6deme tahsil edildi\u011fi bi\u00e7imiyle korunur. De\u011ferin null\nolabilme kural\u0131 `amount` ile ayn\u0131d\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0631\u0635\u064a\u062f \u0627\u0644\u0645\u0645\u0646\u0648\u062d \u0644\u0644\u062d\u0633\u0627\u0628 \u0648\u0627\u0644\u0645\u064f\u0637\u0628\u064e\u0651\u0642 \u0639\u0644\u0649 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u0628\u0648\u0635\u0641\u0647 \u062e\u0635\u0645\u064b\u0627 \u0639\u0644\u0649 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a \u2014\n\u062e\u0635\u0645\u060c \u0644\u0627 \u062f\u0641\u0639\u0629. \u0641\u0647\u0648 \u064a\u064f\u0646\u0642\u0635 \u0627\u0644\u0648\u0639\u0627\u0621 \u0627\u0644\u0636\u0631\u064a\u0628\u064a\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u064f\u062d\u062a\u0633\u0628 \u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0641\u064a `taxes` \u0639\u0644\u0649\n`taxable_base` \u0644\u0627 \u0639\u0644\u0649 `subtotal`. \u0627\u0642\u0631\u0623 `credit_basis` \u0642\u0628\u0644 \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629: \u0641\u0641\u064a \u062f\u0641\u0639\u0629\n\u062d\u064f\u0635\u0650\u0651\u0644\u062a \u0642\u0628\u0644 2026-09-17 \u0643\u0627\u0646 \u0647\u0630\u0627 \u0627\u0644\u0645\u0628\u0644\u063a \u064a\u064f\u0637\u0631\u062d \u0645\u0646 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a \u0634\u0627\u0645\u0644 \u0627\u0644\u0636\u0631\u064a\u0628\u0629\u060c \u0648\u062a\u064f\u0639\u0631\u0636 \u062a\u0644\u0643\n\u0627\u0644\u062f\u0641\u0639\u0629 \u0643\u0645\u0627 \u062d\u064f\u0635\u0650\u0651\u0644\u062a. \u0648\u0642\u0627\u0639\u062f\u0629 \u0642\u0627\u0628\u0644\u064a\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0644\u0623\u0646 \u062a\u0643\u0648\u0646 null \u0647\u064a \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642\u0629 \u0639\u0644\u0649 `amount`.\n" } } }, "applied_balance": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The same figure as `discount`, under the name the billing surfaces use for it.\nSame nullability rule as `amount`.\n", "x-i18n": { "tr": { "description": "`discount` ile ayn\u0131 tutar; faturalama ekranlar\u0131n\u0131n bu tutar i\u00e7in kulland\u0131\u011f\u0131 adla.\nDe\u011ferin null olabilme kural\u0131 `amount` ile ayn\u0131d\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0646\u0641\u0633\u0647 \u0627\u0644\u0648\u0627\u0631\u062f \u0641\u064a `discount`\u060c \u0628\u0627\u0644\u0627\u0633\u0645 \u0627\u0644\u0630\u064a \u062a\u0633\u062a\u0639\u0645\u0644\u0647 \u0634\u0627\u0634\u0627\u062a \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0644\u0647. \u0648\u0642\u0627\u0639\u062f\u0629\n\u0642\u0627\u0628\u0644\u064a\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0644\u0623\u0646 \u062a\u0643\u0648\u0646 null \u0647\u064a \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642\u0629 \u0639\u0644\u0649 `amount`.\n" } } }, "credit_basis": { "type": "string", "enum": [ "net", "gross" ], "nullable": true, "description": "Which arithmetic produced `discount`. `net`: the credit was taken off the net as\nan iskonto, so `taxable_base` = `subtotal` \u2212 `discount`, `taxes` is the rate's\nshare of `taxable_base`, and `amount` = `taxable_base` + `taxes`. `gross`: the\ncredit was subtracted from the VAT-inclusive gross and the tax was charged on the\nwhole net. `null` on a payment whose stored breakdown predates the distinction \u2014\nthose were charged on the gross basis; the value is not defaulted, because\n\"predates the field\" and \"explicitly priced on the gross\" are different facts.\n", "x-i18n": { "tr": { "description": "`discount` tutar\u0131n\u0131n hangi y\u00f6ntemle hesapland\u0131\u011f\u0131. `net`: kredi, net tutardan\niskonto olarak d\u00fc\u015f\u00fclm\u00fc\u015ft\u00fcr; dolay\u0131s\u0131yla `taxable_base` = `subtotal` \u2212 `discount`,\n`taxes` bu matrah\u0131n oran\u0131 kadard\u0131r ve `amount` = `taxable_base` + `taxes`.\n`gross`: kredi KDV d\u00e2hil br\u00fctten d\u00fc\u015f\u00fclm\u00fc\u015f, vergi ise net tutar\u0131n tamam\u0131 \u00fczerinden\nhesaplanm\u0131\u015ft\u0131r. Saklanan d\u00f6k\u00fcm\u00fc bu ayr\u0131mdan \u00f6nceye dayanan bir \u00f6demede `null`\nolur; o \u00f6demeler br\u00fct y\u00f6ntemiyle tahsil edilmi\u015ftir. De\u011fer varsay\u0131lana\n\u00e7ekilmez: \"alan hen\u00fcz yoktu\" ile \"a\u00e7\u0131k\u00e7a br\u00fct \u00fczerinden fiyatland\u0131\" farkl\u0131\nolgulard\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0637\u0631\u064a\u0642\u0629 \u0627\u0644\u062d\u0633\u0627\u0628\u064a\u0629 \u0627\u0644\u062a\u064a \u0623\u0646\u062a\u062c\u062a `discount`. `net`: \u062e\u064f\u0635\u0645 \u0627\u0644\u0631\u0635\u064a\u062f \u0645\u0646 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a\n\u0628\u0648\u0635\u0641\u0647 \u062e\u0635\u0645\u064b\u0627\u060c \u0641\u064a\u0643\u0648\u0646 `taxable_base` = `subtotal` \u2212 `discount`\u060c \u0648\u062a\u0643\u0648\u0646 `taxes` \u0646\u0633\u0628\u0629\n\u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0645\u0646 \u0647\u0630\u0627 \u0627\u0644\u0648\u0639\u0627\u0621\u060c \u0648\u064a\u0643\u0648\u0646 `amount` = `taxable_base` + `taxes`. `gross`: \u0637\u064f\u0631\u062d\n\u0627\u0644\u0631\u0635\u064a\u062f \u0645\u0646 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a \u0634\u0627\u0645\u0644 \u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0648\u0627\u062d\u062a\u064f\u0633\u0628\u062a \u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0639\u0644\u0649 \u0643\u0627\u0645\u0644 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a. \u0648\u062a\u0643\u0648\u0646\n\u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0641\u064a \u062f\u0641\u0639\u0629 \u064a\u0639\u0648\u062f \u062a\u0641\u0635\u064a\u0644\u0647\u0627 \u0627\u0644\u0645\u062e\u0632\u064e\u0651\u0646 \u0625\u0644\u0649 \u0645\u0627 \u0642\u0628\u0644 \u0647\u0630\u0627 \u0627\u0644\u062a\u0645\u064a\u064a\u0632\u061b \u0648\u062a\u0644\u0643 \u0627\u0644\u062f\u0641\u0639\u0627\u062a\n\u062d\u064f\u0635\u0650\u0651\u0644\u062a \u0628\u0637\u0631\u064a\u0642\u0629 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a. \u0648\u0644\u0627 \u062a\u064f\u0633\u062a\u0628\u062f\u0644 \u0627\u0644\u0642\u064a\u0645\u0629 \u0628\u0642\u064a\u0645\u0629 \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629\u060c \u0644\u0623\u0646 \"\u0627\u0644\u062d\u0642\u0644 \u0644\u0645 \u064a\u0643\u0646\n\u0645\u0648\u062c\u0648\u062f\u064b\u0627\" \u0648\"\u0633\u064f\u0639\u0650\u0651\u0631\u062a \u0635\u0631\u0627\u062d\u0629\u064b \u0639\u0644\u0649 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a\" \u0648\u0627\u0642\u0639\u062a\u0627\u0646 \u0645\u062e\u062a\u0644\u0641\u062a\u0627\u0646.\n" } } }, "taxable_base": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The amount the VAT in `taxes` is charged on \u2014 `subtotal` less the credit iskonto\nin `discount`. `amount` is this plus `taxes`, exactly, to the minor unit. `null`\non a stored breakdown written before the field existed, and on a payment that has\nnever been recalculated; nothing is re-derived to fill it in.\n\nIt is `null` EXACTLY WHEN `credit_basis` IS `null`, and the two are one fact: a\nbreakdown that took its credit off the gross has no matrah to state, because the VAT\non it was charged on the whole net. So a reader may branch on either field alone,\nand a `credit_basis` of `null` beside a figure here \u2014 a mixed breakdown, where a bill\npriced today absorbed a line charged under the old rule \u2014 will never be sent: the\nmatrah would not reconcile with the `taxes` beside it.\n", "x-i18n": { "tr": { "description": "`taxes` i\u00e7indeki KDV'nin \u00fczerinden hesapland\u0131\u011f\u0131 tutar \u2014 `subtotal` eksi\n`discount` i\u00e7indeki kredi iskontosu. `amount`, bu tutar ile `taxes` toplam\u0131na\nkuru\u015funa kadar e\u015fittir. Saklanan d\u00f6k\u00fcm bu alan var olmadan \u00f6nce yaz\u0131lm\u0131\u015fsa ya da\n\u00f6deme hi\u00e7 yeniden hesaplanmam\u0131\u015fsa `null` olur; alan\u0131 doldurmak i\u00e7in hi\u00e7bir tutar\nyeniden t\u00fcretilmez.\n\nBu alan, TAM OLARAK `credit_basis` alan\u0131n\u0131n `null` oldu\u011fu durumlarda `null`'d\u0131r;\nikisi tek bir olgudur: kredisi br\u00fctten d\u00fc\u015f\u00fclm\u00fc\u015f bir d\u00f6k\u00fcm\u00fcn bildirece\u011fi bir matrah\nyoktur, \u00e7\u00fcnk\u00fc KDV net tutar\u0131n tamam\u0131 \u00fczerinden hesaplanm\u0131\u015ft\u0131r. Bu y\u00fczden okuyucu\niki alandan yaln\u0131zca birine bakarak dallanabilir; `credit_basis` alan\u0131 `null` iken\nburada bir tutar bulunan karma bir d\u00f6k\u00fcm \u2014 bug\u00fcn fiyatlanan bir faturan\u0131n eski\nkuralla tahsil edilmi\u015f bir sat\u0131r\u0131 devralmas\u0131 \u2014 hi\u00e7bir zaman g\u00f6nderilmez: b\u00f6yle bir\nmatrah, yan\u0131ndaki `taxes` ile uyu\u015fmazd\u0131.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0630\u064a \u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u064a\u0647 \u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0627\u0644\u0648\u0627\u0631\u062f\u0629 \u0641\u064a `taxes` \u2014 \u0623\u064a `subtotal` \u0645\u0637\u0631\u0648\u062d\u064b\u0627 \u0645\u0646\u0647\n\u062e\u0635\u0645 \u0627\u0644\u0631\u0635\u064a\u062f \u0627\u0644\u0648\u0627\u0631\u062f \u0641\u064a `discount`. \u0648\u064a\u0633\u0627\u0648\u064a `amount` \u0647\u0630\u0627 \u0627\u0644\u0645\u0628\u0644\u063a \u0645\u0636\u0627\u0641\u064b\u0627 \u0625\u0644\u064a\u0647 `taxes`\n\u0628\u0627\u0644\u0636\u0628\u0637 \u0648\u062d\u062a\u0649 \u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0635\u063a\u0631\u0649. \u0648\u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0625\u0646 \u0643\u064f\u062a\u0628 \u0627\u0644\u062a\u0641\u0635\u064a\u0644 \u0627\u0644\u0645\u062e\u0632\u064e\u0651\u0646 \u0642\u0628\u0644 \u0648\u062c\u0648\u062f\n\u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644\u060c \u0623\u0648 \u0625\u0646 \u0644\u0645 \u064a\u064f\u0639\u064e\u062f \u062d\u0633\u0627\u0628 \u0627\u0644\u062f\u0641\u0639\u0629 \u0642\u0637\u061b \u0648\u0644\u0627 \u064a\u064f\u0634\u062a\u0642 \u0634\u064a\u0621 \u0644\u0645\u0644\u0626\u0647.\n\n\u0648\u062a\u0643\u0648\u0646 `null` \u062a\u0645\u0627\u0645\u064b\u0627 \u062d\u064a\u0646 \u062a\u0643\u0648\u0646 `credit_basis` \u0647\u064a `null`\u060c \u0641\u0627\u0644\u062d\u0642\u0644\u0627\u0646 \u0623\u0645\u0631 \u0648\u0627\u062d\u062f: \u0627\u0644\u062a\u0641\u0635\u064a\u0644\n\u0627\u0644\u0630\u064a \u062e\u064f\u0635\u0645 \u0631\u0635\u064a\u062f\u0647 \u0645\u0646 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a \u0644\u064a\u0633 \u0644\u0647 \u0648\u0639\u0627\u0621 \u0636\u0631\u064a\u0628\u064a \u064a\u064f\u0630\u0643\u0631\u060c \u0644\u0623\u0646 \u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0627\u062d\u062a\u064f\u0633\u0628\u062a \u0639\u0644\u0649 \u0643\u0627\u0645\u0644\n\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a. \u0648\u0644\u0630\u0644\u0643 \u064a\u0645\u0643\u0646 \u0644\u0644\u0642\u0627\u0631\u0626 \u0623\u0646 \u064a\u062a\u0641\u0631\u064e\u0651\u0639 \u0639\u0644\u0649 \u0623\u064a\u0651 \u0645\u0646 \u0627\u0644\u062d\u0642\u0644\u064a\u0646 \u0648\u062d\u062f\u0647\u060c \u0648\u0644\u0646 \u064a\u064f\u0631\u0633\u064e\u0644\n\u0623\u0628\u062f\u064b\u0627 \u062a\u0641\u0635\u064a\u0644 \u0645\u062e\u062a\u0644\u0637 \u062a\u0643\u0648\u0646 \u0641\u064a\u0647 `credit_basis` \u0647\u064a `null` \u0648\u064a\u062d\u0645\u0644 \u0647\u0646\u0627 \u0642\u064a\u0645\u0629 \u2014 \u0623\u064a \u0641\u0627\u062a\u0648\u0631\u0629\n\u0633\u064f\u0639\u0650\u0651\u0631\u062a \u0627\u0644\u064a\u0648\u0645 \u0648\u0627\u0633\u062a\u0648\u0639\u0628\u062a \u0633\u0637\u0631\u064b\u0627 \u062d\u064f\u0635\u0650\u0651\u0644 \u0628\u0627\u0644\u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0642\u062f\u064a\u0645\u0629 \u2014 \u0644\u0623\u0646 \u0630\u0644\u0643 \u0627\u0644\u0648\u0639\u0627\u0621 \u0644\u0646 \u064a\u062a\u0648\u0627\u0641\u0642 \u0645\u0639\n`taxes` \u0627\u0644\u0645\u062c\u0627\u0648\u0631\u0629 \u0644\u0647.\n" } } }, "list_total": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "What this payment's lines cost at CATALOGUE price, before any coupon, partner rate\nor agreed price. `list_total` \u2212 `catalogue_discount` = `subtotal`. `null` on a\nstored breakdown written before the field existed; it is never re-derived from\ntoday's catalogue, which would restate a completed sale.\n", "x-i18n": { "tr": { "description": "Bu \u00f6demedeki sat\u0131rlar\u0131n; kupon, i\u015f orta\u011f\u0131 oran\u0131 veya anla\u015fmal\u0131 fiyat\nuygulanmadan \u00f6nceki KATALOG fiyat\u0131 toplam\u0131. `list_total` \u2212\n`catalogue_discount` = `subtotal`. Saklanan d\u00f6k\u00fcm bu alan var olmadan \u00f6nce\nyaz\u0131lm\u0131\u015fsa `null` olur; tamamlanm\u0131\u015f bir sat\u0131\u015f\u0131 yeniden ifade edece\u011fi i\u00e7in\nbug\u00fcnk\u00fc katalogdan asla yeniden t\u00fcretilmez.\n" }, "ar": { "description": "\u0645\u0627 \u062a\u0628\u0644\u063a\u0647 \u0628\u0646\u0648\u062f \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u0628\u0633\u0639\u0631 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c\u060c \u0642\u0628\u0644 \u0623\u064a \u0642\u0633\u064a\u0645\u0629 \u0623\u0648 \u0646\u0633\u0628\u0629 \u0634\u0631\u064a\u0643 \u0623\u0648 \u0633\u0639\u0631 \u0645\u062a\u0641\u0642\n\u0639\u0644\u064a\u0647. \u0648\u064a\u0643\u0648\u0646 `list_total` \u2212 `catalogue_discount` = `subtotal`. \u0648\u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629\n`null` \u0625\u0646 \u0643\u064f\u062a\u0628 \u0627\u0644\u062a\u0641\u0635\u064a\u0644 \u0627\u0644\u0645\u062e\u0632\u064e\u0651\u0646 \u0642\u0628\u0644 \u0648\u062c\u0648\u062f \u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644\u061b \u0648\u0644\u0627 \u064a\u064f\u0634\u062a\u0642 \u0623\u0628\u062f\u064b\u0627 \u0645\u0646 \u0643\u062a\u0627\u0644\u0648\u062c\n\u0627\u0644\u064a\u0648\u0645\u060c \u0625\u0630 \u0625\u0646 \u0630\u0644\u0643 \u064a\u064f\u0639\u064a\u062f \u062a\u0642\u0631\u064a\u0631 \u0628\u064a\u0639 \u0645\u0643\u062a\u0645\u0644.\n" } } }, "catalogue_discount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "What a coupon, a partner rate or an agreed price took off the catalogue price\nBEFORE the tax base was formed \u2014 reported separately from `discount`, which is the\ncredit iskonto taken off the net afterwards. Same nullability rule as `list_total`.\n", "x-i18n": { "tr": { "description": "Bir kuponun, i\u015f orta\u011f\u0131 oran\u0131n\u0131n veya anla\u015fmal\u0131 fiyat\u0131n, matrah olu\u015fmadan \u00d6NCE\nkatalog fiyat\u0131ndan d\u00fc\u015ft\u00fc\u011f\u00fc tutar \u2014 sonras\u0131nda net tutardan d\u00fc\u015f\u00fclen kredi\niskontosu olan `discount` alan\u0131ndan ayr\u0131 raporlan\u0131r. De\u011ferin null olabilme\nkural\u0131 `list_total` ile ayn\u0131d\u0131r.\n" }, "ar": { "description": "\u0645\u0627 \u062d\u0633\u0645\u062a\u0647 \u0642\u0633\u064a\u0645\u0629 \u0623\u0648 \u0646\u0633\u0628\u0629 \u0634\u0631\u064a\u0643 \u0623\u0648 \u0633\u0639\u0631 \u0645\u062a\u0641\u0642 \u0639\u0644\u064a\u0647 \u0645\u0646 \u0633\u0639\u0631 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c \u0642\u0628\u0644 \u062a\u0643\u0648\u064a\u0646 \u0627\u0644\u0648\u0639\u0627\u0621\n\u0627\u0644\u0636\u0631\u064a\u0628\u064a \u2014 \u0648\u064a\u064f\u0630\u0643\u0631 \u0645\u0646\u0641\u0635\u0644\u064b\u0627 \u0639\u0646 `discount` \u0627\u0644\u0630\u064a \u0647\u0648 \u062e\u0635\u0645 \u0627\u0644\u0631\u0635\u064a\u062f \u0627\u0644\u0645\u0637\u0631\u0648\u062d \u0645\u0646 \u0627\u0644\u0645\u0628\u0644\u063a\n\u0627\u0644\u0635\u0627\u0641\u064a \u0628\u0639\u062f \u0630\u0644\u0643. \u0648\u0642\u0627\u0639\u062f\u0629 \u0642\u0627\u0628\u0644\u064a\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0644\u0623\u0646 \u062a\u0643\u0648\u0646 null \u0647\u064a \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642\u0629 \u0639\u0644\u0649\n`list_total`.\n" } } }, "refunds": { "type": "array", "items": { "type": "object", "required": [ "id", "subscription_id", "scale_subscription_id", "payment_id", "status", "kind", "destination", "currency", "amount", "amount_usd", "reason", "failure_reason", "failure_count", "created_at", "settled_at" ], "properties": { "id": { "type": "integer", "example": 88 }, "subscription_id": { "type": "integer", "nullable": true, "description": "The subscription this refund ended. `null` on a partial refund, which\nnames its subscription through `scale_subscription_id` instead \u2014 see\n`GET /subscriptions/{id}`.\n", "x-i18n": { "tr": { "description": "Bu iadenin sonland\u0131rd\u0131\u011f\u0131 abonelik. K\u0131smi bir iadede `null` olur; o iade\naboneli\u011fini `scale_subscription_id` \u00fczerinden bildirir \u2014 bkz.\n`GET /subscriptions/{id}`.\n" }, "ar": { "description": "\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u0623\u0646\u0647\u0627\u0647 \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f. \u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u062c\u0632\u0626\u064a\u060c\n\u0641\u0647\u0648 \u064a\u0630\u0643\u0631 \u0627\u0634\u062a\u0631\u0627\u0643\u0647 \u0639\u0628\u0631 `scale_subscription_id` \u2014 \u0627\u0646\u0638\u0631\n`GET /subscriptions/{id}`.\n" } } }, "scale_subscription_id": { "type": "integer", "nullable": true, "description": "The subscription a downscale produced, when this refund gave back the\nunused part of a period. `null` on a full refund.\n", "x-i18n": { "tr": { "description": "Bu iade, bir d\u00f6nemin kullan\u0131lmam\u0131\u015f k\u0131sm\u0131n\u0131 geri verdi\u011finde, k\u00fc\u00e7\u00fcltmenin\nolu\u015fturdu\u011fu abonelik. Tam iadelerde `null` olur.\n" }, "ar": { "description": "\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u0646\u062a\u062c \u0639\u0646 \u0627\u0644\u062a\u062e\u0641\u064a\u0636\u060c \u062d\u064a\u0646 \u0623\u0639\u0627\u062f \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u062c\u0632\u0621 \u063a\u064a\u0631 \u0627\u0644\u0645\u0633\u062a\u0647\u0644\u0643 \u0645\u0646\n\u0627\u0644\u0641\u062a\u0631\u0629. \u0648\u064a\u0643\u0648\u0646 `null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644.\n" } } }, "payment_id": { "type": "integer", "nullable": true, "description": "See `GET /payments/{id}`.", "x-i18n": { "tr": { "description": "Bkz. `GET /payments/{id}`." }, "ar": { "description": "\u0627\u0646\u0638\u0631 `GET /payments/{id}`." } } }, "status": { "type": "string", "enum": [ "new", "done", "failed", "pending", "unknown" ] }, "kind": { "type": "string", "nullable": true, "description": "`downscale` when this is the partial refund of a resized subscription;\n`consolidated_capture` when it returns a charge that landed on a bill one\npayment for everything the account owed had already absorbed;\n`null` for a full refund that ended the contract.\n", "x-i18n": { "tr": { "description": "Yeniden boyutland\u0131r\u0131lm\u0131\u015f bir aboneli\u011fin k\u0131smi iadesiyse `downscale`;\nhesab\u0131n t\u00fcm borcunu kapsayan tek \u00f6demeye aktar\u0131lm\u0131\u015f bir faturadan yap\u0131lan\n\u00e7ekimin iadesiyse `consolidated_capture`; s\u00f6zle\u015fmeyi sonland\u0131ran tam bir\niadede `null`.\n" }, "ar": { "description": "\u062a\u0643\u0648\u0646 `downscale` \u0625\u0646 \u0643\u0627\u0646 \u0647\u0630\u0627 \u0627\u0633\u062a\u0631\u062f\u0627\u062f\u064b\u0627 \u062c\u0632\u0626\u064a\u064b\u0627 \u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u062c\u0631\u0649 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645\u0647\u060c\n\u0648`consolidated_capture` \u0625\u0646 \u0643\u0627\u0646\u062a \u062a\u064f\u0631\u062c\u0639 \u0645\u0628\u0644\u063a\u064b\u0627 \u062e\u064f\u0635\u0645 \u0645\u0646 \u0641\u0627\u062a\u0648\u0631\u0629 \u0633\u0628\u0642 \u0636\u0645\u0651\u0647\u0627 \u0625\u0644\u0649\n\u062f\u0641\u0639\u0629 \u0648\u0627\u062d\u062f\u0629 \u062a\u063a\u0637\u064a \u0643\u0644 \u0645\u0627 \u0639\u0644\u0649 \u0627\u0644\u062d\u0633\u0627\u0628\u060c \u0648`null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644 \u0627\u0644\u0630\u064a \u0623\u0646\u0647\u0649 \u0627\u0644\u0639\u0642\u062f.\n" } } }, "destination": { "type": "string", "nullable": true, "description": "Where the money went: `card` back to the card that paid, `credit` to the\naccount's balance as a granted credit. `null` on a full refund and on a\ncard attempt that failed \u2014 nothing went anywhere on it.\n", "x-i18n": { "tr": { "description": "Paran\u0131n nereye gitti\u011fi: `card` \u00f6demeyi yapan karta, `credit` hesab\u0131n\nbakiyesine hediye kredi olarak. Tam iadelerde ve ba\u015far\u0131s\u0131z olan bir kart\ndenemesinde `null` olur \u2014 o denemede hi\u00e7bir yere para gitmemi\u015ftir.\n" }, "ar": { "description": "\u0648\u062c\u0647\u0629 \u0627\u0644\u0645\u0627\u0644: `card` \u0625\u0644\u0649 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0627\u0644\u062a\u064a \u062f\u0641\u0639\u062a\u060c \u0648`credit` \u0625\u0644\u0649 \u0631\u0635\u064a\u062f \u0627\u0644\u062d\u0633\u0627\u0628\n\u0643\u0631\u0635\u064a\u062f \u0645\u0645\u0646\u0648\u062d. \u0648\u062a\u0643\u0648\u0646 `null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644 \u0648\u0641\u064a \u0645\u062d\u0627\u0648\u0644\u0629 \u0628\u0637\u0627\u0642\u0629 \u0641\u0627\u0634\u0644\u0629 \u2014\n\u0625\u0630 \u0644\u0645 \u064a\u0630\u0647\u0628 \u0641\u064a\u0647\u0627 \u0634\u064a\u0621 \u0625\u0644\u0649 \u0623\u064a \u0645\u0643\u0627\u0646.\n" } } }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "description": "The currency `amount` is stated in \u2014 the refunded payment's own.", "x-i18n": { "tr": { "description": "`amount` alan\u0131n\u0131n para birimi \u2014 iade edilen \u00f6demenin kendi para birimi." }, "ar": { "description": "\u0639\u0645\u0644\u0629 \u0627\u0644\u062d\u0642\u0644 `amount` \u2014 \u0648\u0647\u064a \u0639\u0645\u0644\u0629 \u0627\u0644\u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u0631\u062f\u0629 \u0646\u0641\u0633\u0647\u0627." } }, "example": "TRY" }, "amount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "What this refund returns, in `currency` \u2014 the figure the card statement\nshows. `null` when the row states no figure and there is no payment to\nprice it against.\n", "x-i18n": { "tr": { "description": "Bu iadenin geri verdi\u011fi tutar, `currency` cinsinden \u2014 kart ekstresinde\ng\u00f6r\u00fcnen tutar. Sat\u0131r bir tutar bildirmiyorsa ve fiyatlanaca\u011f\u0131 bir \u00f6deme\nyoksa `null` olur.\n" }, "ar": { "description": "\u0645\u0627 \u064a\u0639\u064a\u062f\u0647 \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0628\u0639\u0645\u0644\u0629 `currency` \u2014 \u0648\u0647\u0648 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0630\u064a \u064a\u0638\u0647\u0631 \u0641\u064a \u0643\u0634\u0641\n\u0627\u0644\u0628\u0637\u0627\u0642\u0629. \u0648\u064a\u0643\u0648\u0646 `null` \u0625\u0646 \u0644\u0645 \u064a\u0630\u0643\u0631 \u0627\u0644\u0633\u062c\u0644 \u0645\u0628\u0644\u063a\u064b\u0627 \u0648\u0644\u0645 \u062a\u0648\u062c\u062f \u062f\u0641\u0639\u0629 \u064a\u064f\u0633\u0639\u064e\u0651\u0631 \u0645\u0642\u0627\u0628\u0644\u0647\u0627.\n" } } }, "amount_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The same refund in USD, frozen when it was made. `null` on rows that\npredate the column.\n", "x-i18n": { "tr": { "description": "Ayn\u0131 iadenin, yap\u0131ld\u0131\u011f\u0131 anda dondurulmu\u015f USD tutar\u0131. S\u00fctundan \u00f6nce\nolu\u015fturulmu\u015f sat\u0131rlarda `null` olur.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0646\u0641\u0633\u0647 \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a\u060c \u0645\u062c\u0645\u064e\u0651\u062f\u064b\u0627 \u0644\u062d\u0638\u0629 \u062a\u0646\u0641\u064a\u0630 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f. \u0648\u064a\u0643\u0648\u0646 `null`\n\u0641\u064a \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0633\u0627\u0628\u0642\u0629 \u0644\u0648\u062c\u0648\u062f \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u0648\u062f.\n" } } }, "reason": { "type": "string", "nullable": true, "description": "What this refund was for, as it is printed on the document.", "x-i18n": { "tr": { "description": "Bu iadenin gerek\u00e7esi, belgeye bas\u0131ld\u0131\u011f\u0131 bi\u00e7imiyle." }, "ar": { "description": "\u0633\u0628\u0628 \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f\u060c \u0643\u0645\u0627 \u064a\u064f\u0637\u0628\u0639 \u0639\u0644\u0649 \u0627\u0644\u0645\u0633\u062a\u0646\u062f." } } }, "failure_reason": { "type": "string", "nullable": true }, "failure_count": { "type": "integer", "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "settled_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When the money actually moved. A partial refund is planned inside the\nresize's own transaction and settled afterwards, so this can be later than\n`created_at`. `null` while it has not settled and on rows that predate the\ncolumn \u2014 never substituted with `created_at`.\n", "x-i18n": { "tr": { "description": "Paran\u0131n ger\u00e7ekten hareket etti\u011fi an. K\u0131smi bir iade, yeniden\nboyutland\u0131rman\u0131n kendi i\u015flemi i\u00e7inde planlan\u0131r ve sonras\u0131nda tamamlan\u0131r;\nbu y\u00fczden bu tarih `created_at`'ten sonra olabilir. Tamamlanmad\u0131k\u00e7a ve\ns\u00fctundan \u00f6nce olu\u015fturulmu\u015f sat\u0131rlarda `null` olur \u2014 yerine asla\n`created_at` konmaz.\n" }, "ar": { "description": "\u0648\u0642\u062a \u0627\u0646\u062a\u0642\u0627\u0644 \u0627\u0644\u0645\u0627\u0644 \u0641\u0639\u0644\u064a\u064b\u0627. \u064a\u064f\u062e\u0637\u064e\u0651\u0637 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u062c\u0632\u0626\u064a \u062f\u0627\u062e\u0644 \u0645\u0639\u0627\u0645\u0644\u0629 \u062a\u063a\u064a\u064a\u0631 \u0627\u0644\u062d\u062c\u0645\n\u0646\u0641\u0633\u0647\u0627 \u0648\u064a\u064f\u0633\u0648\u064e\u0651\u0649 \u0628\u0639\u062f\u0647\u0627\u060c \u0648\u0644\u0630\u0644\u0643 \u0642\u062f \u064a\u0643\u0648\u0646 \u0647\u0630\u0627 \u0627\u0644\u062a\u0627\u0631\u064a\u062e \u0644\u0627\u062d\u0642\u064b\u0627 \u0644\u0640 `created_at`.\n\u0648\u064a\u0643\u0648\u0646 `null` \u0645\u0627 \u0644\u0645 \u064a\u064f\u0633\u0648\u064e\u0651 \u0648\u0641\u064a \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0633\u0627\u0628\u0642\u0629 \u0644\u0648\u062c\u0648\u062f \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u0648\u062f \u2014 \u0648\u0644\u0627\n\u064a\u064f\u0633\u062a\u0628\u062f\u064e\u0644 \u0628\u0647\u0627 `created_at` \u0623\u0628\u062f\u064b\u0627.\n" } } } } }, "description": "Every refund taken against this payment, oldest first, whatever its state \u2014\nread each one's `status` to see which landed. A downscale returns the unused\npart of a period without ending the sale, so a payment carrying refunds stays\n`paid`: this list is the only signal that money came back.\n", "x-i18n": { "tr": { "description": "Bu \u00f6demeye kar\u015f\u0131 yap\u0131lan her iade, en eskisi \u00f6nce, durumu ne olursa olsun \u2014\nhangisinin ger\u00e7ekle\u015fti\u011fini g\u00f6rmek i\u00e7in her birinin `status` alan\u0131n\u0131 okuyun.\nBir k\u00fc\u00e7\u00fcltme, sat\u0131\u015f\u0131 sonland\u0131rmadan d\u00f6nemin kullan\u0131lmam\u0131\u015f k\u0131sm\u0131n\u0131 geri verir;\nbu y\u00fczden iade ta\u015f\u0131yan bir \u00f6deme `paid` kal\u0131r: paran\u0131n geri geldi\u011fine dair\ntek i\u015faret bu listedir.\n" }, "ar": { "description": "\u0643\u0644 \u0627\u0633\u062a\u0631\u062f\u0627\u062f \u062c\u0631\u0649 \u0639\u0644\u0649 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629\u060c \u0645\u0646 \u0627\u0644\u0623\u0642\u062f\u0645 \u0625\u0644\u0649 \u0627\u0644\u0623\u062d\u062f\u062b\u060c \u0623\u064a\u064b\u0651\u0627 \u0643\u0627\u0646\u062a \u062d\u0627\u0644\u062a\u0647 \u2014 \u0627\u0642\u0631\u0623\n\u0627\u0644\u062d\u0642\u0644 `status` \u0644\u0643\u0644 \u0645\u0646\u0647\u0627 \u0644\u062a\u0639\u0631\u0641 \u0623\u064a\u0647\u0627 \u062a\u0645 \u0641\u0639\u0644\u064b\u0627. \u0641\u0627\u0644\u062a\u062e\u0641\u064a\u0636 \u064a\u0639\u064a\u062f \u0627\u0644\u062c\u0632\u0621 \u063a\u064a\u0631 \u0627\u0644\u0645\u0633\u062a\u0647\u0644\u0643\n\u0645\u0646 \u0627\u0644\u0641\u062a\u0631\u0629 \u062f\u0648\u0646 \u0623\u0646 \u064a\u0646\u0647\u064a \u0627\u0644\u0628\u064a\u0639\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u0628\u0642\u0649 \u0627\u0644\u062f\u0641\u0639\u0629 \u0627\u0644\u062a\u064a \u062a\u062d\u0645\u0644 \u0627\u0633\u062a\u0631\u062f\u0627\u062f\u0627\u062a `paid`:\n\u0648\u0647\u0630\u0647 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0647\u064a \u0627\u0644\u0625\u0634\u0627\u0631\u0629 \u0627\u0644\u0648\u062d\u064a\u062f\u0629 \u0625\u0644\u0649 \u0623\u0646 \u0627\u0644\u0645\u0627\u0644 \u0642\u062f \u0639\u0627\u062f.\n" } } }, "refunded_total": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "What went back to the CARD, in `currency`, counting settled refunds only.\n`0` on the overwhelming majority of payments.\n", "x-i18n": { "tr": { "description": "`currency` cinsinden KARTA geri d\u00f6nen tutar; yaln\u0131zca tamamlanm\u0131\u015f iadeleri\nsayar. \u00d6demelerin b\u00fcy\u00fck \u00e7o\u011funlu\u011funda `0` olur.\n" }, "ar": { "description": "\u0645\u0627 \u0639\u0627\u062f \u0625\u0644\u0649 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0628\u0639\u0645\u0644\u0629 `currency`\u060c \u0645\u062d\u0633\u0648\u0628\u064b\u0627 \u0645\u0646 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f\u0627\u062a \u0627\u0644\u0645\u0643\u062a\u0645\u0644\u0629 \u0648\u062d\u062f\u0647\u0627.\n\u0648\u064a\u0643\u0648\u0646 `0` \u0641\u064a \u0627\u0644\u063a\u0627\u0644\u0628\u064a\u0629 \u0627\u0644\u0639\u0638\u0645\u0649 \u0645\u0646 \u0627\u0644\u062f\u0641\u0639\u0627\u062a.\n" } } }, "refunded_credit_total": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "What went back as account CREDIT, in `currency`. Stated beside the charge and\nnever subtracted from it \u2014 see `net_after_refunds`.\n", "x-i18n": { "tr": { "description": "`currency` cinsinden hesap KRED\u0130S\u0130 olarak geri d\u00f6nen tutar. Tahsilat\u0131n yan\u0131nda\nbelirtilir, ondan asla d\u00fc\u015f\u00fclmez \u2014 bkz. `net_after_refunds`.\n" }, "ar": { "description": "\u0645\u0627 \u0639\u0627\u062f \u0631\u0635\u064a\u062f\u064b\u0627 \u0641\u064a \u0627\u0644\u062d\u0633\u0627\u0628 \u0628\u0639\u0645\u0644\u0629 `currency`. \u064a\u064f\u0630\u0643\u0631 \u0625\u0644\u0649 \u062c\u0627\u0646\u0628 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0645\u062d\u0635\u064e\u0651\u0644 \u0648\u0644\u0627\n\u064a\u064f\u0637\u0631\u062d \u0645\u0646\u0647 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0627\u0646\u0638\u0631 `net_after_refunds`.\n" } } }, "net_after_refunds": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "`amount` less `refunded_total` \u2014 what the card is still out. Account credit is\nnot subtracted. `null` whenever `amount` is `null`, for the same reason.\n", "x-i18n": { "tr": { "description": "`amount` eksi `refunded_total` \u2014 kart\u0131n h\u00e2l\u00e2 \u00f6demi\u015f oldu\u011fu tutar. Hesap kredisi\nd\u00fc\u015f\u00fclmez. `amount` `null` oldu\u011funda, ayn\u0131 gerek\u00e7eyle bu da `null` olur.\n" }, "ar": { "description": "`amount` \u0646\u0627\u0642\u0635 `refunded_total` \u2014 \u0623\u064a \u0645\u0627 \u062f\u0641\u0639\u062a\u0647 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0648\u0644\u0645 \u064a\u0639\u062f. \u0648\u0644\u0627 \u064a\u064f\u0637\u0631\u062d \u0631\u0635\u064a\u062f\n\u0627\u0644\u062d\u0633\u0627\u0628. \u0648\u064a\u0643\u0648\u0646 `null` \u0643\u0644\u0645\u0627 \u0643\u0627\u0646 `amount` \u0628\u0642\u064a\u0645\u0629 `null`\u060c \u0644\u0644\u0633\u0628\u0628 \u0646\u0641\u0633\u0647.\n" } } }, "settled_by_payment_id": { "type": "integer", "nullable": true, "description": "The payment that ABSORBED this bill, or `null` for every ordinary row. A customer\nwho settles everything the account owes in one go gets a single dues payment\n(`is_dues`), and each covered bill is pointed at it here and marked\n`is_superseded`; its own `status` stays `new` and its `amount` stays frozen at\nwhat it was. A client summing what is outstanding must skip a row that carries\nthis, or it counts the same debt twice \u2014 once on the bill and once on the dues\npayment that already covers it.\n", "x-i18n": { "tr": { "description": "Bu faturay\u0131 DEVRALAN \u00f6deme; s\u0131radan her sat\u0131rda `null` olur. Hesab\u0131n borcunun\ntamam\u0131n\u0131 tek seferde kapatan bir m\u00fc\u015fteri i\u00e7in tek bir toplu bor\u00e7 \u00f6demesi\nolu\u015fturulur (`is_dues`) ve kapsanan her fatura burada ona ba\u011flan\u0131p\n`is_superseded` olarak i\u015faretlenir; faturan\u0131n kendi `status` de\u011feri `new`\nkal\u0131r, `amount` de\u011feri de donmu\u015f h\u00e2liyle durur. \u00d6denmemi\u015f borcu toplayan bir\nistemci, bu alan\u0131 ta\u015f\u0131yan sat\u0131r\u0131 atlamal\u0131d\u0131r; aksi h\u00e2lde ayn\u0131 borcu iki kez \u2014\nbir faturada, bir de onu zaten kapsayan toplu bor\u00e7 \u00f6demesinde \u2014 sayar.\n" }, "ar": { "description": "\u0627\u0644\u062f\u0641\u0639\u0629 \u0627\u0644\u062a\u064a \u0636\u0645\u0651\u062a \u0647\u0630\u0647 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629\u060c \u0648\u062a\u0643\u0648\u0646 `null` \u0641\u064a \u0643\u0644 \u0633\u0637\u0631 \u0639\u0627\u062f\u064a. \u0641\u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u064a\u0633\u062f\u0651\u062f\n\u0643\u0644 \u0645\u0627 \u0639\u0644\u0649 \u0627\u0644\u062d\u0633\u0627\u0628 \u062f\u0641\u0639\u0629\u064b \u0648\u0627\u062d\u062f\u0629 \u062a\u064f\u0646\u0634\u0623 \u0644\u0647 \u062f\u0641\u0639\u0629 \u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0645\u062c\u0645\u0651\u0639\u0629 \u0648\u0627\u062d\u062f\u0629 (`is_dues`)\u060c\n\u0648\u062a\u064f\u0631\u0628\u0637 \u0628\u0647\u0627 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0634\u0645\u0648\u0644\u0629 \u0647\u0646\u0627 \u0648\u062a\u064f\u0639\u0644\u064e\u0651\u0645 \u0628\u0640 `is_superseded`\u061b \u0648\u064a\u0628\u0642\u0649 `status`\n\u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 `new` \u0648\u064a\u0628\u0642\u0649 `amount` \u0645\u062c\u0645\u0651\u062f\u064b\u0627 \u0643\u0645\u0627 \u0643\u0627\u0646. \u0648\u0639\u0644\u0649 \u0623\u064a \u0639\u0645\u064a\u0644 \u064a\u062c\u0645\u0639\n\u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0651\u0627\u062a \u0623\u0646 \u064a\u062a\u062e\u0637\u0651\u0649 \u0627\u0644\u0633\u0637\u0631 \u0627\u0644\u0630\u064a \u064a\u062d\u0645\u0644 \u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644\u060c \u0648\u0625\u0644\u0627 \u062d\u064e\u0633\u064e\u0628\u064e \u0627\u0644\u062f\u064a\u0646 \u0646\u0641\u0633\u0647 \u0645\u0631\u062a\u064a\u0646 \u2014\n\u0645\u0631\u0629 \u0639\u0644\u0649 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0648\u0645\u0631\u0629 \u0639\u0644\u0649 \u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0627\u0644\u062a\u064a \u062a\u063a\u0637\u0651\u064a\u0647\u0627 \u0623\u0635\u0644\u064b\u0627.\n" } } }, "is_dues": { "type": "boolean", "description": "This payment IS the consolidation \u2014 one payable covering every open bill the\naccount had when the customer chose to settle them together. The bills it covers\nare the rows whose `settled_by_payment_id` is this payment's `id`. Late-payment\ninterest is never charged on this row itself: it is charged on each covered bill,\non that bill's own clock.\n", "x-i18n": { "tr": { "description": "Bu \u00f6deme, toplu bor\u00e7 \u00f6demesinin kendisidir \u2014 m\u00fc\u015fteri hepsini birlikte kapatmay\u0131\nse\u00e7ti\u011finde hesab\u0131n a\u00e7\u0131k olan b\u00fct\u00fcn faturalar\u0131n\u0131 tek bir \u00f6denecek tutarda\ntoplar. Kapsad\u0131\u011f\u0131 faturalar, `settled_by_payment_id` de\u011feri bu \u00f6demenin `id`\nde\u011feri olan sat\u0131rlard\u0131r. Temerr\u00fct faizi bu sat\u0131r\u0131n kendisine hi\u00e7bir zaman\ni\u015fletilmez; her kapsanan faturaya, o faturan\u0131n kendi s\u00fcresi \u00fczerinden i\u015fletilir.\n" }, "ar": { "description": "\u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u0647\u064a \u0627\u0644\u062a\u062c\u0645\u064a\u0639 \u0646\u0641\u0633\u0647 \u2014 \u0645\u0628\u0644\u063a \u0648\u0627\u062d\u062f \u0645\u0633\u062a\u062d\u0642 \u064a\u063a\u0637\u0651\u064a \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0641\u062a\u0648\u062d\u0629 \u0643\u0627\u0646\u062a \u0639\u0644\u0649\n\u0627\u0644\u062d\u0633\u0627\u0628 \u062d\u064a\u0646 \u0627\u062e\u062a\u0627\u0631 \u0627\u0644\u0639\u0645\u064a\u0644 \u062a\u0633\u062f\u064a\u062f\u0647\u0627 \u0645\u0639\u064b\u0627. \u0648\u0627\u0644\u0641\u0648\u0627\u062a\u064a\u0631 \u0627\u0644\u062a\u064a \u062a\u063a\u0637\u0651\u064a\u0647\u0627 \u0647\u064a \u0627\u0644\u0633\u0637\u0648\u0631 \u0627\u0644\u062a\u064a\n\u064a\u0633\u0627\u0648\u064a \u0641\u064a\u0647\u0627 `settled_by_payment_id` \u0642\u064a\u0645\u0629 `id` \u0644\u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629. \u0648\u0644\u0627 \u062a\u064f\u062d\u062a\u0633\u0628 \u0641\u0627\u0626\u062f\u0629\n\u0627\u0644\u062a\u0623\u062e\u064a\u0631 \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0633\u0637\u0631 \u0625\u0637\u0644\u0627\u0642\u064b\u0627\u060c \u0628\u0644 \u0639\u0644\u0649 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0634\u0645\u0648\u0644\u0629 \u0648\u0641\u0642 \u0645\u062f\u0651\u062a\u0647\u0627 \u0647\u064a.\n" } } }, "covered_interest": { "type": "object", "nullable": true, "description": "WHAT SETTLING THIS DUES PAYMENT WILL CHARGE IN LATE-PAYMENT INTEREST, published\nbefore it is charged. `null` on every payment that is not a dues payment, and on a\ndues payment once it is settled or cancelled \u2014 by then the figures have been charged\nas interest payments of their own and appear in the list like any other payment.\n\nA dues payment carries no interest of its own \u2014 see `is_dues` \u2014 but paying it raises\none further payment per covered bill, each on that bill's own clock. Without this\nfield a client saw the dues payment, saw every absorbed bill still at `status: new`,\nand had no way to learn that settling it would produce more charges; the interest\npayments simply appeared afterwards.\n", "x-i18n": { "tr": { "description": "BU TOPLU BOR\u00c7 \u00d6DEMES\u0130 KAPATILDI\u011eINDA \u0130\u015eLET\u0130LECEK TEMERR\u00dcT FA\u0130Z\u0130, hen\u00fcz tahsil\nedilmeden \u00f6nce yay\u0131mlan\u0131r. Toplu bor\u00e7 \u00f6demesi olmayan her \u00f6demede ve toplu bor\u00e7\n\u00f6demesi kapat\u0131ld\u0131\u011f\u0131nda ya da iptal edildi\u011finde `null` olur \u2014 o noktada tutarlar\nkendi faiz \u00f6demeleri olarak tahsil edilmi\u015f ve listede yerini alm\u0131\u015ft\u0131r.\n\nToplu bor\u00e7 \u00f6demesinin kendi faizi yoktur \u2014 bkz. `is_dues` \u2014 ancak kapat\u0131ld\u0131\u011f\u0131nda\nkapsad\u0131\u011f\u0131 her fatura i\u00e7in, o faturan\u0131n kendi s\u00fcresi \u00fczerinden ayr\u0131 bir \u00f6deme\nolu\u015fturulur. Bu alan olmadan istemci yaln\u0131zca toplu bor\u00e7 \u00f6demesini ve h\u00e2l\u00e2\n`status: new` g\u00f6r\u00fcnen faturalar\u0131 g\u00f6r\u00fcyor, kapatman\u0131n yeni tutarlar do\u011furaca\u011f\u0131n\u0131\nhi\u00e7bir yerden \u00f6\u011frenemiyordu; faiz \u00f6demeleri sonradan ortaya \u00e7\u0131k\u0131yordu.\n" }, "ar": { "description": "\u0645\u0627 \u0633\u062a\u064f\u062d\u0645\u0651\u0644\u0647 \u062a\u0633\u0648\u064a\u0629 \u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0647\u0630\u0647 \u0645\u0646 \u0641\u0627\u0626\u062f\u0629 \u062a\u0623\u062e\u064a\u0631\u060c \u0645\u0646\u0634\u0648\u0631\u064b\u0627 \u0642\u0628\u0644 \u062a\u062d\u0635\u064a\u0644\u0647. \u0648\u064a\u0643\u0648\u0646\n`null` \u0641\u064a \u0643\u0644 \u062f\u0641\u0639\u0629 \u0644\u064a\u0633\u062a \u062f\u0641\u0639\u0629 \u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0645\u062c\u0645\u0651\u0639\u0629\u060c \u0648\u0643\u0630\u0644\u0643 \u0641\u064a \u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0628\u0639\u062f \u062a\u0633\u0648\u064a\u062a\u0647\u0627 \u0623\u0648\n\u0625\u0644\u063a\u0627\u0626\u0647\u0627 \u2014 \u0641\u0639\u0646\u062f\u0626\u0630\u064d \u062a\u0643\u0648\u0646 \u0627\u0644\u0645\u0628\u0627\u0644\u063a \u0642\u062f \u062d\u064f\u0635\u0650\u0651\u0644\u062a \u0643\u062f\u0641\u0639\u0627\u062a \u0641\u0627\u0626\u062f\u0629 \u0645\u0633\u062a\u0642\u0644\u0629 \u0648\u0638\u0647\u0631\u062a \u0641\u064a \u0627\u0644\u0642\u0627\u0626\u0645\u0629.\n\n\u0644\u0627 \u062a\u062d\u0645\u0644 \u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0641\u0627\u0626\u062f\u0629 \u062e\u0627\u0635\u0629 \u0628\u0647\u0627 \u2014 \u0627\u0646\u0638\u0631 `is_dues` \u2014 \u0644\u0643\u0646 \u062a\u0633\u062f\u064a\u062f\u0647\u0627 \u064a\u0646\u0634\u0626 \u062f\u0641\u0639\u0629\n\u0625\u0636\u0627\u0641\u064a\u0629 \u0639\u0646 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0634\u0645\u0648\u0644\u0629\u060c \u0648\u0641\u0642 \u0645\u062f\u0651\u0629 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0647\u064a. \u0648\u0628\u062f\u0648\u0646 \u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644 \u0643\u0627\u0646 \u0627\u0644\u0639\u0645\u064a\u0644\n\u064a\u0631\u0649 \u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0648\u064a\u0631\u0649 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0636\u0645\u0648\u0645\u0629 \u0628\u0642\u064a\u0645\u0629 `status: new` \u062f\u0648\u0646 \u0623\u064a \u0633\u0628\u064a\u0644 \u0644\u0645\u0639\u0631\u0641\u0629\n\u0623\u0646 \u0627\u0644\u062a\u0633\u0648\u064a\u0629 \u0633\u062a\u064f\u0646\u0634\u0626 \u0645\u0628\u0627\u0644\u063a \u0623\u062e\u0631\u0649\u061b \u0641\u0643\u0627\u0646\u062a \u062f\u0641\u0639\u0627\u062a \u0627\u0644\u0641\u0627\u0626\u062f\u0629 \u062a\u0638\u0647\u0631 \u0628\u0639\u062f \u0630\u0644\u0643 \u0641\u062c\u0623\u0629.\n" } }, "required": [ "lines", "total", "total_usd" ], "properties": { "lines": { "type": "array", "description": "One entry per covered bill the interest meter answers on, oldest first \u2014 a 0.00\naccrual is listed too. Entries that will NOT be charged are listed as well \u2014 read\n`payable`.\n", "x-i18n": { "tr": { "description": "Faiz sayac\u0131n\u0131n yan\u0131t verdi\u011fi her kapsanan fatura i\u00e7in bir sat\u0131r; en eski \u00f6nce\n\u2014 0,00 tutarl\u0131 bir sat\u0131r da listelenir. Tahsil ED\u0130LMEYECEK sat\u0131rlar da\nlistelenir \u2014 `payable` alan\u0131n\u0131 okuyun.\n" }, "ar": { "description": "\u0633\u0637\u0631 \u0648\u0627\u062d\u062f \u0639\u0646 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0634\u0645\u0648\u0644\u0629 \u064a\u062c\u064a\u0628 \u0639\u0646\u0647\u0627 \u0639\u062f\u0651\u0627\u062f \u0627\u0644\u0641\u0627\u0626\u062f\u0629\u060c \u0645\u0646 \u0627\u0644\u0623\u0642\u062f\u0645 \u0625\u0644\u0649 \u0627\u0644\u0623\u062d\u062f\u062b \u2014\n\u0648\u064a\u064f\u062f\u0631\u064e\u062c \u0627\u0644\u0633\u0637\u0631 \u062d\u062a\u0649 \u0644\u0648 \u0643\u0627\u0646 \u0645\u0628\u0644\u063a\u0647 0.00. \u0648\u0627\u0644\u0633\u0637\u0648\u0631 \u0627\u0644\u062a\u064a \u0644\u0646 \u062a\u064f\u062d\u0635\u064e\u0651\u0644 \u0645\u062f\u0631\u062c\u0629 \u0623\u064a\u0636\u064b\u0627 \u2014 \u0627\u0642\u0631\u0623 `payable`.\n" } }, "items": { "type": "object", "required": [ "payment_id", "due_at", "days", "amount", "amount_usd", "accrued", "accrued_usd", "payable", "waived", "below_floor" ], "properties": { "payment_id": { "type": "integer", "description": "The covered bill this interest is charged on (`GET /payments/{id}`).", "x-i18n": { "tr": { "description": "Bu faizin i\u015fletildi\u011fi kapsanan fatura (`GET /payments/{id}`)." }, "ar": { "description": "\u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0627\u0644\u0645\u0634\u0645\u0648\u0644\u0629 \u0627\u0644\u062a\u064a \u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u064a\u0647\u0627 \u0647\u0630\u0647 \u0627\u0644\u0641\u0627\u0626\u062f\u0629 (`GET /payments/{id}`)." } } }, "due_at": { "type": "string", "format": "date-time", "description": "When that bill fell due \u2014 the anchor its own meter runs from, which is why\ntwo bills on one dues payment owe different amounts.\n", "x-i18n": { "tr": { "description": "O faturan\u0131n vadesi \u2014 kendi sayac\u0131n\u0131n ba\u015flad\u0131\u011f\u0131 an; ayn\u0131 toplu bor\u00e7\n\u00f6demesindeki iki faturan\u0131n farkl\u0131 tutarlar bor\u00e7lanmas\u0131n\u0131n sebebi budur.\n" }, "ar": { "description": "\u0645\u0648\u0639\u062f \u0627\u0633\u062a\u062d\u0642\u0627\u0642 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u2014 \u0646\u0642\u0637\u0629 \u0628\u062f\u0621 \u0639\u062f\u0651\u0627\u062f\u0647\u0627 \u0627\u0644\u062e\u0627\u0635\u060c \u0648\u0647\u0648 \u0633\u0628\u0628 \u0627\u062e\u062a\u0644\u0627\u0641\n\u0627\u0644\u0645\u0628\u0627\u0644\u063a \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0629 \u0639\u0644\u0649 \u0641\u0627\u062a\u0648\u0631\u062a\u064a\u0646 \u0636\u0645\u0646 \u062f\u0641\u0639\u0629 \u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0648\u0627\u062d\u062f\u0629.\n" } } }, "days": { "type": "number", "format": "float", "description": "Credited days late, fractional \u2014 after any suspended window and any\nprovider outage have been taken off.\n", "x-i18n": { "tr": { "description": "Gecikmenin say\u0131lan g\u00fcn say\u0131s\u0131 (kesirli) \u2014 ask\u0131ya al\u0131nm\u0131\u015f s\u00fcre ve\nsa\u011flay\u0131c\u0131 kaynakl\u0131 kesinti d\u00fc\u015f\u00fcld\u00fckten sonra.\n" }, "ar": { "description": "\u0623\u064a\u0627\u0645 \u0627\u0644\u062a\u0623\u062e\u064a\u0631 \u0627\u0644\u0645\u062d\u062a\u0633\u0628\u0629\u060c \u0628\u0643\u0633\u0648\u0631\u0647\u0627 \u2014 \u0628\u0639\u062f \u062e\u0635\u0645 \u0623\u064a \u0641\u062a\u0631\u0629 \u062a\u0639\u0644\u064a\u0642 \u0648\u0623\u064a \u0627\u0646\u0642\u0637\u0627\u0639 \u0645\u0646\n\u062c\u0647\u0629 \u0627\u0644\u0645\u0632\u0648\u0651\u062f.\n" } } }, "amount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "What settling will CHARGE for that bill, in that bill's own currency: the\naccrued interest with 20% KDV carved out of it (net + KDV is exactly this\nfigure), snapped down one kuru\u015f when the accrual cannot hold an exact\nsplit. It is `accrued` or one kuru\u015f less, never more, and it is what the\nminted interest payment carries and what `total` sums.\n", "x-i18n": { "tr": { "description": "\u00d6deme ger\u00e7ekle\u015fti\u011finde o fatura i\u00e7in TAHS\u0130L ED\u0130LECEK tutar, faturan\u0131n\nkendi para biriminde: i\u015fleyen faizin i\u00e7inden %20 KDV ayr\u0131l\u0131r (matrah +\nKDV tam olarak bu tutard\u0131r); faiz tam b\u00f6l\u00fcnemiyorsa bir kuru\u015f a\u015fa\u011f\u0131\nyuvarlan\u0131r. `accrued` tutar\u0131na e\u015fittir ya da ondan bir kuru\u015f azd\u0131r,\nasla fazla de\u011fildir; olu\u015fturulan faiz \u00f6demesi bu tutar\u0131 ta\u015f\u0131r ve\n`total` bunlar\u0131 toplar.\n" }, "ar": { "description": "\u0645\u0627 \u0633\u064a\u064f\u062d\u0635\u064e\u0651\u0644 \u0639\u0646 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0639\u0646\u062f \u0627\u0644\u062a\u0633\u0648\u064a\u0629\u060c \u0628\u0639\u0645\u0644\u0629 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0646\u0641\u0633\u0647\u0627: \u0627\u0644\u0641\u0627\u0626\u062f\u0629\n\u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0629 \u0648\u0642\u062f \u0627\u0642\u062a\u064f\u0637\u0639\u062a \u0645\u0646\u0647\u0627 \u0636\u0631\u064a\u0628\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0645\u0636\u0627\u0641\u0629 \u0628\u0646\u0633\u0628\u0629 20% (\u0627\u0644\u0635\u0627\u0641\u064a \u0645\u0639\n\u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u064a\u0633\u0627\u0648\u064a \u0647\u0630\u0627 \u0627\u0644\u0645\u0628\u0644\u063a \u062a\u0645\u0627\u0645\u064b\u0627)\u060c \u0645\u0639 \u062a\u0642\u0631\u064a\u0628\u0647 \u0642\u0631\u0634\u064b\u0627 \u0648\u0627\u062d\u062f\u064b\u0627 \u0625\u0644\u0649 \u0627\u0644\u0623\u0633\u0641\u0644 \u0625\u0630\u0627\n\u062a\u0639\u0630\u0651\u0631 \u062a\u0642\u0633\u064a\u0645\u0647 \u062a\u0642\u0633\u064a\u0645\u064b\u0627 \u062f\u0642\u064a\u0642\u064b\u0627. \u064a\u0633\u0627\u0648\u064a `accrued` \u0623\u0648 \u064a\u0642\u0644\u0651 \u0639\u0646\u0647 \u0628\u0642\u0631\u0634 \u0648\u0627\u062d\u062f \u0648\u0644\u0627\n\u064a\u0632\u064a\u062f \u0639\u0644\u064a\u0647 \u0623\u0628\u062f\u064b\u0627\u060c \u0648\u0647\u0648 \u0645\u0627 \u062a\u062d\u0645\u0644\u0647 \u062f\u0641\u0639\u0629 \u0627\u0644\u0641\u0627\u0626\u062f\u0629 \u0627\u0644\u0645\u064f\u0646\u0634\u0623\u0629 \u0648\u0645\u0627 \u064a\u062c\u0645\u0639\u0647 `total`.\n" } } }, "amount_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "The charge in USD: `accrued_usd` carved and snapped the same way. The USD\nfigure is taken back through the rate already frozen on that bill \u2014 never a\nfresh conversion.\n", "x-i18n": { "tr": { "description": "Tahsil edilecek tutar\u0131n USD kar\u015f\u0131l\u0131\u011f\u0131: `accrued_usd` ayn\u0131 \u015fekilde\nayr\u0131l\u0131p yuvarlan\u0131r. USD tutar\u0131 faturada zaten donmu\u015f olan kur \u00fczerinden\nhesaplan\u0131r, g\u00fcncel kurla de\u011fil.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0645\u064f\u062d\u0635\u064e\u0651\u0644 \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631: `accrued_usd` \u0628\u0639\u062f \u0627\u0644\u0627\u0642\u062a\u0637\u0627\u0639 \u0648\u0627\u0644\u062a\u0642\u0631\u064a\u0628 \u0628\u0627\u0644\u0637\u0631\u064a\u0642\u0629\n\u0646\u0641\u0633\u0647\u0627\u060c \u0645\u062d\u0633\u0648\u0628\u064b\u0627 \u0628\u0633\u0639\u0631 \u0627\u0644\u0635\u0631\u0641 \u0627\u0644\u0645\u062c\u0645\u064e\u0651\u062f \u0639\u0644\u0649 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0644\u0627 \u0628\u0633\u0639\u0631 \u062c\u062f\u064a\u062f.\n" } } }, "accrued": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "The interest that ACCRUED on that bill under the contract, in that bill's\nown currency \u2014 the legal figure before KDV is carved out of it. `amount`\nis what is charged for it.\n", "x-i18n": { "tr": { "description": "S\u00f6zle\u015fmeye g\u00f6re o faturaya \u0130\u015eLEYEN faiz, faturan\u0131n kendi para\nbiriminde \u2014 KDV ayr\u0131lmadan \u00f6nceki yasal tutar. Bunun i\u00e7in tahsil\nedilen tutar `amount` alan\u0131ndad\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0641\u0627\u0626\u062f\u0629 \u0627\u0644\u062a\u064a \u0627\u0633\u062a\u062d\u0642\u062a \u0639\u0644\u0649 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0628\u0645\u0648\u062c\u0628 \u0627\u0644\u0639\u0642\u062f\u060c \u0628\u0639\u0645\u0644\u0629 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0646\u0641\u0633\u0647\u0627 \u2014\n\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0642\u0627\u0646\u0648\u0646\u064a \u0642\u0628\u0644 \u0627\u0642\u062a\u0637\u0627\u0639 \u0636\u0631\u064a\u0628\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0645\u0636\u0627\u0641\u0629 \u0645\u0646\u0647. \u0623\u0645\u0627 \u0645\u0627 \u064a\u064f\u062d\u0635\u064e\u0651\u0644 \u0639\u0646\u0647\n\u0641\u0647\u0648 `amount`.\n" } } }, "accrued_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "The accrued interest in USD, back through the rate already frozen on that\nbill \u2014 never a fresh conversion. This is what the de-minimis floor is\ntested against.\n", "x-i18n": { "tr": { "description": "\u0130\u015fleyen faizin USD kar\u015f\u0131l\u0131\u011f\u0131; faturada zaten donmu\u015f olan kur \u00fczerinden\nhesaplan\u0131r, g\u00fcncel kurla de\u011fil. Asgari tahsil e\u015fi\u011fi bu tutara bakar.\n" }, "ar": { "description": "\u0627\u0644\u0641\u0627\u0626\u062f\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0629 \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631\u060c \u0645\u062d\u0633\u0648\u0628\u0629 \u0628\u0633\u0639\u0631 \u0627\u0644\u0635\u0631\u0641 \u0627\u0644\u0645\u062c\u0645\u064e\u0651\u062f \u0639\u0644\u0649 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0644\u0627\n\u0628\u0633\u0639\u0631 \u062c\u062f\u064a\u062f. \u0648\u0647\u0630\u0627 \u0647\u0648 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0630\u064a \u064a\u064f\u0642\u0627\u0633 \u0639\u0644\u064a\u0647 \u0627\u0644\u062d\u062f \u0627\u0644\u0623\u062f\u0646\u0649 \u0644\u0644\u062a\u062d\u0635\u064a\u0644.\n" } } }, "payable": { "type": "boolean", "description": "Whether this line will actually be charged. `false` for a waived accrual\nand for one below the minimum charge; both are still listed, because a\nreal figure about a real debt is never dropped in silence.\n", "x-i18n": { "tr": { "description": "Bu sat\u0131r\u0131n ger\u00e7ekten tahsil edilip edilmeyece\u011fi. Faizi silinmi\u015f ya da\nasgari tutar\u0131n alt\u0131nda kalan sat\u0131rlarda `false` olur; yine de\nlistelenirler, \u00e7\u00fcnk\u00fc ger\u00e7ek bir borca ait ger\u00e7ek bir tutar sessizce\nat\u0131lmaz.\n" }, "ar": { "description": "\u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646 \u0647\u0630\u0627 \u0627\u0644\u0633\u0637\u0631 \u0633\u064a\u064f\u062d\u0635\u064e\u0651\u0644 \u0641\u0639\u0644\u064b\u0627. \u064a\u0643\u0648\u0646 `false` \u0644\u0644\u0641\u0627\u0626\u062f\u0629 \u0627\u0644\u0645\u064f\u0633\u0642\u0637\u0629\n\u0648\u0644\u0644\u0645\u0628\u0644\u063a \u062f\u0648\u0646 \u0627\u0644\u062d\u062f \u0627\u0644\u0623\u062f\u0646\u0649\u061b \u0648\u0645\u0639 \u0630\u0644\u0643 \u064a\u064f\u062f\u0631\u062c \u0627\u0644\u0633\u0637\u0631\u0627\u0646\u060c \u0644\u0623\u0646 \u0645\u0628\u0644\u063a\u064b\u0627 \u062d\u0642\u064a\u0642\u064a\u064b\u0627 \u0639\u0646\n\u062f\u064a\u0646 \u062d\u0642\u064a\u0642\u064a \u0644\u0627 \u064a\u064f\u062d\u0630\u0641 \u0628\u0635\u0645\u062a.\n" } } }, "waived": { "type": "boolean", "description": "Staff have forgiven the interest on that bill.", "x-i18n": { "tr": { "description": "Yetkili personel o faturan\u0131n faizini silmi\u015ftir." }, "ar": { "description": "\u0623\u0633\u0642\u0637 \u0627\u0644\u0645\u0648\u0638\u0641\u0648\u0646 \u0627\u0644\u0641\u0627\u0626\u062f\u0629 \u0639\u0646 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629." } } }, "below_floor": { "type": "boolean", "description": "Something accrued but stays under the minimum charge, so nothing is\ncollected \u2014 not carried forward and not accumulated.\n", "x-i18n": { "tr": { "description": "Bir tutar i\u015flemi\u015f ama asgari tahsil e\u015fi\u011finin alt\u0131nda kald\u0131\u011f\u0131 i\u00e7in\ntahsil edilmez \u2014 ne devreder ne birikir.\n" }, "ar": { "description": "\u062a\u0631\u0627\u0643\u0645 \u0645\u0628\u0644\u063a \u0644\u0643\u0646\u0647 \u062f\u0648\u0646 \u0627\u0644\u062d\u062f \u0627\u0644\u0623\u062f\u0646\u0649 \u0644\u0644\u062a\u062d\u0635\u064a\u0644\u060c \u0641\u0644\u0627 \u064a\u064f\u062d\u0635\u064e\u0651\u0644 \u0634\u064a\u0621 \u2014 \u0648\u0644\u0627 \u064a\u064f\u0631\u062d\u064e\u0651\u0644\n\u0648\u0644\u0627 \u064a\u062a\u0631\u0627\u0643\u0645.\n" } } } } } }, "total": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The sum of the PAYABLE lines, in this payment's `currency`. `null` in the one\ncase the covered bills do not all share it, where there is no single figure to\nstate \u2014 read `total_usd` instead.\n", "x-i18n": { "tr": { "description": "TAHS\u0130L ED\u0130LECEK sat\u0131rlar\u0131n toplam\u0131, bu \u00f6demenin `currency` biriminde.\nKapsanan faturalar\u0131n tamam\u0131 ayn\u0131 para birimini ta\u015f\u0131mad\u0131\u011f\u0131 tek durumda `null`\nolur; b\u00f6yle bir durumda tek bir tutar yaz\u0131lamaz \u2014 `total_usd` alan\u0131n\u0131 okuyun.\n" }, "ar": { "description": "\u0645\u062c\u0645\u0648\u0639 \u0627\u0644\u0633\u0637\u0648\u0631 \u0627\u0644\u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u062a\u062d\u0635\u064a\u0644 \u0628\u0639\u0645\u0644\u0629 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 `currency`. \u0648\u064a\u0643\u0648\u0646 `null` \u0641\u064a\n\u0627\u0644\u062d\u0627\u0644\u0629 \u0627\u0644\u0648\u062d\u064a\u062f\u0629 \u0627\u0644\u062a\u064a \u0644\u0627 \u062a\u062a\u0634\u0627\u0631\u0643 \u0641\u064a\u0647\u0627 \u0627\u0644\u0641\u0648\u0627\u062a\u064a\u0631 \u0627\u0644\u0645\u0634\u0645\u0648\u0644\u0629 \u0627\u0644\u0639\u0645\u0644\u0629 \u0646\u0641\u0633\u0647\u0627\u060c \u0625\u0630 \u0644\u0627\n\u064a\u0648\u062c\u062f \u0645\u0628\u0644\u063a \u0648\u0627\u062d\u062f \u064a\u064f\u0630\u0643\u0631 \u2014 \u0627\u0642\u0631\u0623 `total_usd` \u0639\u0646\u062f\u0626\u0630.\n" } } }, "total_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "The same sum in USD, each line back through its own bill's frozen rate. Always\npresent.\n", "x-i18n": { "tr": { "description": "Ayn\u0131 toplam\u0131n USD kar\u015f\u0131l\u0131\u011f\u0131; her sat\u0131r kendi faturas\u0131n\u0131n donmu\u015f kuruyla\n\u00e7evrilir. Her zaman bulunur.\n" }, "ar": { "description": "\u0627\u0644\u0645\u062c\u0645\u0648\u0639 \u0646\u0641\u0633\u0647 \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631\u060c \u0648\u0643\u0644 \u0633\u0637\u0631 \u0645\u062d\u0633\u0648\u0628 \u0628\u0633\u0639\u0631 \u0627\u0644\u0635\u0631\u0641 \u0627\u0644\u0645\u062c\u0645\u064e\u0651\u062f \u0639\u0644\u0649 \u0641\u0627\u062a\u0648\u0631\u062a\u0647. \u0648\u0647\u0648\n\u0645\u0648\u062c\u0648\u062f \u062f\u0627\u0626\u0645\u064b\u0627.\n" } } } } }, "subscription_ids": { "type": "array", "items": { "type": "integer" }, "description": "The subscriptions this payment covers (see `GET /subscriptions/{id}`).", "x-i18n": { "tr": { "description": "Bu \u00f6demenin kapsad\u0131\u011f\u0131 abonelikler (bkz. `GET /subscriptions/{id}`)." }, "ar": { "description": "\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u062a\u064a \u062a\u063a\u0637\u0651\u064a\u0647\u0627 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 (\u0627\u0646\u0638\u0631 `GET /subscriptions/{id}`)." } } }, "failure_reason": { "type": "string", "nullable": true }, "failure_count": { "type": "integer", "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "paid_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When this payment settled. `null` while it is unpaid, and `null` on rows\nthat predate the column \u2014 never substituted with `created_at`, which would\npublish a guess as a timestamp.\n", "x-i18n": { "tr": { "description": "Bu \u00f6demenin ne zaman tahsil edildi\u011fi. \u00d6deme hen\u00fcz yap\u0131lmam\u0131\u015fken `null` olur;\ns\u00fctundan \u00f6nce olu\u015fturulmu\u015f sat\u0131rlarda da `null` olur \u2014 yerine asla\n`created_at` konmaz, \u00e7\u00fcnk\u00fc bu, bir tahmini zaman damgas\u0131 olarak\nyay\u0131mlamak olurdu.\n" }, "ar": { "description": "\u0648\u0642\u062a \u062a\u0633\u0648\u064a\u0629 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629. \u062a\u0643\u0648\u0646 `null` \u0645\u0627 \u062f\u0627\u0645\u062a \u063a\u064a\u0631 \u0645\u062f\u0641\u0648\u0639\u0629\u060c \u0648`null` \u0623\u064a\u0636\u064b\u0627 \u0641\u064a\n\u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0633\u0627\u0628\u0642\u0629 \u0644\u0648\u062c\u0648\u062f \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u0648\u062f \u2014 \u0648\u0644\u0627 \u064a\u064f\u0633\u062a\u0628\u062f\u064e\u0644 \u0628\u0647\u0627 `created_at` \u0623\u0628\u062f\u064b\u0627\u060c\n\u0641\u0630\u0644\u0643 \u0646\u0634\u0631\u064c \u0644\u062a\u062e\u0645\u064a\u0646 \u0639\u0644\u0649 \u0623\u0646\u0647 \u0637\u0627\u0628\u0639 \u0632\u0645\u0646\u064a.\n" } } } } }, "CreditCard": { "type": "object", "description": "Never carries a PAN, a CVC, or a gateway token. `card_number` is always masked;\nthe CVC is never published at all.\n", "x-i18n": { "tr": { "description": "Hi\u00e7bir zaman kart numaras\u0131n\u0131n tamam\u0131n\u0131 (PAN), CVC'yi ya da \u00f6deme sa\u011flay\u0131c\u0131s\u0131n\u0131n\nanahtar\u0131n\u0131 ta\u015f\u0131maz. `card_number` her zaman maskelidir; CVC hi\u00e7bir bi\u00e7imde\nyay\u0131mlanmaz.\n" }, "ar": { "description": "\u0644\u0627 \u064a\u062d\u0645\u0644 \u0645\u0637\u0644\u0642\u064b\u0627 \u0631\u0642\u0645 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0627\u0644\u0643\u0627\u0645\u0644 (PAN) \u0648\u0644\u0627 \u0631\u0645\u0632 CVC \u0648\u0644\u0627 \u0645\u0641\u062a\u0627\u062d \u0628\u0648\u0627\u0628\u0629 \u0627\u0644\u062f\u0641\u0639.\n\u0648\u0627\u0644\u062d\u0642\u0644 `card_number` \u0645\u064f\u0642\u0646\u064e\u0651\u0639 \u062f\u0627\u0626\u0645\u064b\u0627\u060c \u0623\u0645\u0627 CVC \u0641\u0644\u0627 \u064a\u064f\u0646\u0634\u064e\u0631 \u0625\u0637\u0644\u0627\u0642\u064b\u0627.\n" } }, "required": [ "id", "card_name", "owner", "card_number", "expiration_date", "threeds_authorized", "is_gateway_linked", "created_at" ], "properties": { "id": { "type": "integer", "example": 301 }, "card_name": { "type": "string", "nullable": true, "description": "The customer's own label for the card.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin karta kendi verdi\u011fi ad." }, "ar": { "description": "\u0627\u0644\u062a\u0633\u0645\u064a\u0629 \u0627\u0644\u062a\u064a \u0623\u0637\u0644\u0642\u0647\u0627 \u0627\u0644\u0639\u0645\u064a\u0644 \u0639\u0644\u0649 \u0627\u0644\u0628\u0637\u0627\u0642\u0629." } } }, "owner": { "type": "string", "nullable": true, "description": "The cardholder name as entered at enrolment.", "x-i18n": { "tr": { "description": "Kart kayd\u0131 s\u0131ras\u0131nda girildi\u011fi h\u00e2liyle kart sahibinin ad\u0131." }, "ar": { "description": "\u0627\u0633\u0645 \u062d\u0627\u0645\u0644 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0643\u0645\u0627 \u0623\u064f\u062f\u062e\u0644 \u0639\u0646\u062f \u0627\u0644\u062a\u0633\u062c\u064a\u0644." } } }, "card_number": { "type": "string", "description": "The masked PAN \u2014 a fixed-length string with the middle half replaced by\n`*`. Never the real number; card enrolment and charging both stay in the\npanel.\n", "x-i18n": { "tr": { "description": "Maskelenmi\u015f kart numaras\u0131 \u2014 ortadaki yar\u0131s\u0131 `*` ile de\u011fi\u015ftirilmi\u015f, sabit\nuzunlukta bir dizedir. Asla ger\u00e7ek numara de\u011fildir; kart kayd\u0131 da tahsilat\nda panelde kal\u0131r.\n" }, "ar": { "description": "\u0631\u0642\u0645 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0627\u0644\u0645\u064f\u0642\u0646\u064e\u0651\u0639 \u2014 \u0633\u0644\u0633\u0644\u0629 \u0628\u0637\u0648\u0644 \u062b\u0627\u0628\u062a \u0627\u0633\u062a\u064f\u0628\u062f\u0644 \u0646\u0635\u0641\u0647\u0627 \u0627\u0644\u0623\u0648\u0633\u0637 \u0628\u0640 `*`. \u0648\u0644\u064a\u0633\n\u0627\u0644\u0631\u0642\u0645 \u0627\u0644\u062d\u0642\u064a\u0642\u064a \u0623\u0628\u062f\u064b\u0627\u061b \u0641\u062a\u0633\u062c\u064a\u0644 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0648\u062a\u062d\u0635\u064a\u0644 \u0627\u0644\u0645\u0628\u0627\u0644\u063a \u064a\u0628\u0642\u064a\u0627\u0646 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629.\n" } }, "example": "4111****1111" }, "expiration_date": { "type": "string", "nullable": true, "example": "12/30" }, "threeds_authorized": { "type": "boolean", "description": "Whether a 3-D Secure challenge has ever been completed for this card. It\ndefaults to `false` for every newly enrolled card, and the only way to set\nit is an interactive browser challenge \u2014 so `false` here does not mean\nanything is wrong with the card, only that its first charge will require\none.\n", "x-i18n": { "tr": { "description": "Bu kart i\u00e7in daha \u00f6nce bir 3-D Secure do\u011frulamas\u0131n\u0131n tamamlan\u0131p\ntamamlanmad\u0131\u011f\u0131. Yeni kaydedilen her kartta varsay\u0131lan de\u011feri `false`'tur ve\nbunu ancak taray\u0131c\u0131 \u00fczerinden yap\u0131lan etkile\u015fimli bir do\u011frulama de\u011fi\u015ftirir\n\u2014 dolay\u0131s\u0131yla buradaki `false`, kartta bir sorun oldu\u011fu anlam\u0131na gelmez;\nyaln\u0131zca ilk tahsilat\u0131n b\u00f6yle bir do\u011frulama isteyece\u011fini g\u00f6sterir.\n" }, "ar": { "description": "\u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646 \u0642\u062f \u0627\u0643\u062a\u0645\u0644 \u0644\u0647\u0630\u0647 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u062a\u062d\u0642\u0642 3-D Secure \u0645\u0646 \u0642\u0628\u0644. \u0648\u0642\u064a\u0645\u062a\u0647\u0627\n\u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629 `false` \u0644\u0643\u0644 \u0628\u0637\u0627\u0642\u0629 \u0645\u0633\u062c\u064e\u0651\u0644\u0629 \u062d\u062f\u064a\u062b\u064b\u0627\u060c \u0648\u0644\u0627 \u0633\u0628\u064a\u0644 \u0625\u0644\u0649 \u0636\u0628\u0637\u0647\u0627 \u0625\u0644\u0627 \u0628\u062a\u062d\u0642\u0642\n\u062a\u0641\u0627\u0639\u0644\u064a \u0639\u0628\u0631 \u0627\u0644\u0645\u062a\u0635\u0641\u062d \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 `false` \u0647\u0646\u0627 \u0644\u0627 \u062a\u0639\u0646\u064a \u0623\u0646 \u0628\u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u062e\u0644\u0644\u064b\u0627\u060c \u0628\u0644\n\u062a\u0639\u0646\u064a \u0641\u0642\u0637 \u0623\u0646 \u0623\u0648\u0644 \u0639\u0645\u0644\u064a\u0629 \u062a\u062d\u0635\u064a\u0644 \u0639\u0644\u064a\u0647\u0627 \u0633\u062a\u062a\u0637\u0644\u0628 \u0647\u0630\u0627 \u0627\u0644\u062a\u062d\u0642\u0642.\n" } } }, "is_gateway_linked": { "type": "boolean", "description": "Whether the payment gateway still has a token for this card, as last\nobserved. `false` can mean the gateway has forgotten it (a card enrolled\nlong ago) without this row having been reconciled yet; pass\n`?refresh=true` to ask the gateway directly, which \u2014 unlike this field \u2014\nalso deletes the local row if the gateway confirms it is gone.\n", "x-i18n": { "tr": { "description": "Son g\u00f6zlendi\u011fi h\u00e2liyle, \u00f6deme sa\u011flay\u0131c\u0131s\u0131n\u0131n bu kart i\u00e7in h\u00e2l\u00e2 bir anahtar\u0131\nolup olmad\u0131\u011f\u0131. `false`, \u00f6deme sa\u011flay\u0131c\u0131s\u0131n\u0131n kart\u0131 unuttu\u011fu (uzun s\u00fcre \u00f6nce\nkaydedilmi\u015f bir kart) ama bu sat\u0131r\u0131n hen\u00fcz e\u015fitlenmedi\u011fi anlam\u0131na gelebilir;\ndo\u011frudan \u00f6deme sa\u011flay\u0131c\u0131s\u0131na sormak i\u00e7in `?refresh=true` g\u00f6nderin \u2014 bu alandan\nfarkl\u0131 olarak, \u00f6deme sa\u011flay\u0131c\u0131s\u0131 kart\u0131n gitti\u011fini do\u011frularsa yerel sat\u0131r\u0131 da siler.\n" }, "ar": { "description": "\u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646\u062a \u0628\u0648\u0627\u0628\u0629 \u0627\u0644\u062f\u0641\u0639 \u0644\u0627 \u062a\u0632\u0627\u0644 \u062a\u062d\u062a\u0641\u0638 \u0628\u0645\u0641\u062a\u0627\u062d \u0644\u0647\u0630\u0647 \u0627\u0644\u0628\u0637\u0627\u0642\u0629\u060c \u0628\u062d\u0633\u0628 \u0622\u062e\u0631 \u0631\u0635\u062f.\n\u0648\u0642\u062f \u062a\u0639\u0646\u064a `false` \u0623\u0646 \u0627\u0644\u0628\u0648\u0627\u0628\u0629 \u0646\u0633\u064a\u062a\u0647\u0627 (\u0628\u0637\u0627\u0642\u0629 \u0633\u064f\u062c\u0651\u0644\u062a \u0645\u0646\u0630 \u0632\u0645\u0646) \u062f\u0648\u0646 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0647\u0630\u0627\n\u0627\u0644\u0635\u0641 \u0642\u062f \u0637\u0648\u0628\u0642 \u0628\u0639\u062f\u061b \u0645\u0631\u0650\u0651\u0631 `?refresh=true` \u0644\u0633\u0624\u0627\u0644 \u0627\u0644\u0628\u0648\u0627\u0628\u0629 \u0645\u0628\u0627\u0634\u0631\u0629\u064b\u060c \u0648\u0647\u0648 \u2014\n\u0628\u062e\u0644\u0627\u0641 \u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644 \u2014 \u064a\u062d\u0630\u0641 \u0623\u064a\u0636\u064b\u0627 \u0627\u0644\u0635\u0641 \u0627\u0644\u0645\u062d\u0644\u064a \u0625\u0646 \u0623\u0643\u0651\u062f\u062a \u0627\u0644\u0628\u0648\u0627\u0628\u0629 \u0632\u0648\u0627\u0644\u0647.\n" } } }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "Refund": { "type": "object", "required": [ "id", "subscription_id", "scale_subscription_id", "payment_id", "status", "kind", "destination", "currency", "amount", "amount_usd", "reason", "failure_reason", "failure_count", "created_at", "settled_at" ], "properties": { "id": { "type": "integer", "example": 88 }, "subscription_id": { "type": "integer", "nullable": true, "description": "The subscription this refund ended. `null` on a partial refund, which\nnames its subscription through `scale_subscription_id` instead \u2014 see\n`GET /subscriptions/{id}`.\n", "x-i18n": { "tr": { "description": "Bu iadenin sonland\u0131rd\u0131\u011f\u0131 abonelik. K\u0131smi bir iadede `null` olur; o iade\naboneli\u011fini `scale_subscription_id` \u00fczerinden bildirir \u2014 bkz.\n`GET /subscriptions/{id}`.\n" }, "ar": { "description": "\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u0623\u0646\u0647\u0627\u0647 \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f. \u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u062c\u0632\u0626\u064a\u060c\n\u0641\u0647\u0648 \u064a\u0630\u0643\u0631 \u0627\u0634\u062a\u0631\u0627\u0643\u0647 \u0639\u0628\u0631 `scale_subscription_id` \u2014 \u0627\u0646\u0638\u0631\n`GET /subscriptions/{id}`.\n" } } }, "scale_subscription_id": { "type": "integer", "nullable": true, "description": "The subscription a downscale produced, when this refund gave back the\nunused part of a period. `null` on a full refund.\n", "x-i18n": { "tr": { "description": "Bu iade, bir d\u00f6nemin kullan\u0131lmam\u0131\u015f k\u0131sm\u0131n\u0131 geri verdi\u011finde, k\u00fc\u00e7\u00fcltmenin\nolu\u015fturdu\u011fu abonelik. Tam iadelerde `null` olur.\n" }, "ar": { "description": "\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u0646\u062a\u062c \u0639\u0646 \u0627\u0644\u062a\u062e\u0641\u064a\u0636\u060c \u062d\u064a\u0646 \u0623\u0639\u0627\u062f \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u062c\u0632\u0621 \u063a\u064a\u0631 \u0627\u0644\u0645\u0633\u062a\u0647\u0644\u0643 \u0645\u0646\n\u0627\u0644\u0641\u062a\u0631\u0629. \u0648\u064a\u0643\u0648\u0646 `null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644.\n" } } }, "payment_id": { "type": "integer", "nullable": true, "description": "See `GET /payments/{id}`.", "x-i18n": { "tr": { "description": "Bkz. `GET /payments/{id}`." }, "ar": { "description": "\u0627\u0646\u0638\u0631 `GET /payments/{id}`." } } }, "status": { "type": "string", "enum": [ "new", "done", "failed", "pending", "unknown" ] }, "kind": { "type": "string", "nullable": true, "description": "`downscale` when this is the partial refund of a resized subscription;\n`consolidated_capture` when it returns a charge that landed on a bill one\npayment for everything the account owed had already absorbed;\n`null` for a full refund that ended the contract.\n", "x-i18n": { "tr": { "description": "Yeniden boyutland\u0131r\u0131lm\u0131\u015f bir aboneli\u011fin k\u0131smi iadesiyse `downscale`;\nhesab\u0131n t\u00fcm borcunu kapsayan tek \u00f6demeye aktar\u0131lm\u0131\u015f bir faturadan yap\u0131lan\n\u00e7ekimin iadesiyse `consolidated_capture`; s\u00f6zle\u015fmeyi sonland\u0131ran tam bir\niadede `null`.\n" }, "ar": { "description": "\u062a\u0643\u0648\u0646 `downscale` \u0625\u0646 \u0643\u0627\u0646 \u0647\u0630\u0627 \u0627\u0633\u062a\u0631\u062f\u0627\u062f\u064b\u0627 \u062c\u0632\u0626\u064a\u064b\u0627 \u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u062c\u0631\u0649 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645\u0647\u060c\n\u0648`consolidated_capture` \u0625\u0646 \u0643\u0627\u0646\u062a \u062a\u064f\u0631\u062c\u0639 \u0645\u0628\u0644\u063a\u064b\u0627 \u062e\u064f\u0635\u0645 \u0645\u0646 \u0641\u0627\u062a\u0648\u0631\u0629 \u0633\u0628\u0642 \u0636\u0645\u0651\u0647\u0627 \u0625\u0644\u0649\n\u062f\u0641\u0639\u0629 \u0648\u0627\u062d\u062f\u0629 \u062a\u063a\u0637\u064a \u0643\u0644 \u0645\u0627 \u0639\u0644\u0649 \u0627\u0644\u062d\u0633\u0627\u0628\u060c \u0648`null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644 \u0627\u0644\u0630\u064a \u0623\u0646\u0647\u0649 \u0627\u0644\u0639\u0642\u062f.\n" } } }, "destination": { "type": "string", "nullable": true, "description": "Where the money went: `card` back to the card that paid, `credit` to the\naccount's balance as a granted credit. `null` on a full refund and on a\ncard attempt that failed \u2014 nothing went anywhere on it.\n", "x-i18n": { "tr": { "description": "Paran\u0131n nereye gitti\u011fi: `card` \u00f6demeyi yapan karta, `credit` hesab\u0131n\nbakiyesine hediye kredi olarak. Tam iadelerde ve ba\u015far\u0131s\u0131z olan bir kart\ndenemesinde `null` olur \u2014 o denemede hi\u00e7bir yere para gitmemi\u015ftir.\n" }, "ar": { "description": "\u0648\u062c\u0647\u0629 \u0627\u0644\u0645\u0627\u0644: `card` \u0625\u0644\u0649 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0627\u0644\u062a\u064a \u062f\u0641\u0639\u062a\u060c \u0648`credit` \u0625\u0644\u0649 \u0631\u0635\u064a\u062f \u0627\u0644\u062d\u0633\u0627\u0628\n\u0643\u0631\u0635\u064a\u062f \u0645\u0645\u0646\u0648\u062d. \u0648\u062a\u0643\u0648\u0646 `null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644 \u0648\u0641\u064a \u0645\u062d\u0627\u0648\u0644\u0629 \u0628\u0637\u0627\u0642\u0629 \u0641\u0627\u0634\u0644\u0629 \u2014\n\u0625\u0630 \u0644\u0645 \u064a\u0630\u0647\u0628 \u0641\u064a\u0647\u0627 \u0634\u064a\u0621 \u0625\u0644\u0649 \u0623\u064a \u0645\u0643\u0627\u0646.\n" } } }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "description": "The currency `amount` is stated in \u2014 the refunded payment's own.", "x-i18n": { "tr": { "description": "`amount` alan\u0131n\u0131n para birimi \u2014 iade edilen \u00f6demenin kendi para birimi." }, "ar": { "description": "\u0639\u0645\u0644\u0629 \u0627\u0644\u062d\u0642\u0644 `amount` \u2014 \u0648\u0647\u064a \u0639\u0645\u0644\u0629 \u0627\u0644\u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u0631\u062f\u0629 \u0646\u0641\u0633\u0647\u0627." } }, "example": "TRY" }, "amount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "What this refund returns, in `currency` \u2014 the figure the card statement\nshows. `null` when the row states no figure and there is no payment to\nprice it against.\n", "x-i18n": { "tr": { "description": "Bu iadenin geri verdi\u011fi tutar, `currency` cinsinden \u2014 kart ekstresinde\ng\u00f6r\u00fcnen tutar. Sat\u0131r bir tutar bildirmiyorsa ve fiyatlanaca\u011f\u0131 bir \u00f6deme\nyoksa `null` olur.\n" }, "ar": { "description": "\u0645\u0627 \u064a\u0639\u064a\u062f\u0647 \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0628\u0639\u0645\u0644\u0629 `currency` \u2014 \u0648\u0647\u0648 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0630\u064a \u064a\u0638\u0647\u0631 \u0641\u064a \u0643\u0634\u0641\n\u0627\u0644\u0628\u0637\u0627\u0642\u0629. \u0648\u064a\u0643\u0648\u0646 `null` \u0625\u0646 \u0644\u0645 \u064a\u0630\u0643\u0631 \u0627\u0644\u0633\u062c\u0644 \u0645\u0628\u0644\u063a\u064b\u0627 \u0648\u0644\u0645 \u062a\u0648\u062c\u062f \u062f\u0641\u0639\u0629 \u064a\u064f\u0633\u0639\u064e\u0651\u0631 \u0645\u0642\u0627\u0628\u0644\u0647\u0627.\n" } } }, "amount_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The same refund in USD, frozen when it was made. `null` on rows that\npredate the column.\n", "x-i18n": { "tr": { "description": "Ayn\u0131 iadenin, yap\u0131ld\u0131\u011f\u0131 anda dondurulmu\u015f USD tutar\u0131. S\u00fctundan \u00f6nce\nolu\u015fturulmu\u015f sat\u0131rlarda `null` olur.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0646\u0641\u0633\u0647 \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a\u060c \u0645\u062c\u0645\u064e\u0651\u062f\u064b\u0627 \u0644\u062d\u0638\u0629 \u062a\u0646\u0641\u064a\u0630 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f. \u0648\u064a\u0643\u0648\u0646 `null`\n\u0641\u064a \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0633\u0627\u0628\u0642\u0629 \u0644\u0648\u062c\u0648\u062f \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u0648\u062f.\n" } } }, "reason": { "type": "string", "nullable": true, "description": "What this refund was for, as it is printed on the document.", "x-i18n": { "tr": { "description": "Bu iadenin gerek\u00e7esi, belgeye bas\u0131ld\u0131\u011f\u0131 bi\u00e7imiyle." }, "ar": { "description": "\u0633\u0628\u0628 \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f\u060c \u0643\u0645\u0627 \u064a\u064f\u0637\u0628\u0639 \u0639\u0644\u0649 \u0627\u0644\u0645\u0633\u062a\u0646\u062f." } } }, "failure_reason": { "type": "string", "nullable": true }, "failure_count": { "type": "integer", "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "settled_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When the money actually moved. A partial refund is planned inside the\nresize's own transaction and settled afterwards, so this can be later than\n`created_at`. `null` while it has not settled and on rows that predate the\ncolumn \u2014 never substituted with `created_at`.\n", "x-i18n": { "tr": { "description": "Paran\u0131n ger\u00e7ekten hareket etti\u011fi an. K\u0131smi bir iade, yeniden\nboyutland\u0131rman\u0131n kendi i\u015flemi i\u00e7inde planlan\u0131r ve sonras\u0131nda tamamlan\u0131r;\nbu y\u00fczden bu tarih `created_at`'ten sonra olabilir. Tamamlanmad\u0131k\u00e7a ve\ns\u00fctundan \u00f6nce olu\u015fturulmu\u015f sat\u0131rlarda `null` olur \u2014 yerine asla\n`created_at` konmaz.\n" }, "ar": { "description": "\u0648\u0642\u062a \u0627\u0646\u062a\u0642\u0627\u0644 \u0627\u0644\u0645\u0627\u0644 \u0641\u0639\u0644\u064a\u064b\u0627. \u064a\u064f\u062e\u0637\u064e\u0651\u0637 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u062c\u0632\u0626\u064a \u062f\u0627\u062e\u0644 \u0645\u0639\u0627\u0645\u0644\u0629 \u062a\u063a\u064a\u064a\u0631 \u0627\u0644\u062d\u062c\u0645\n\u0646\u0641\u0633\u0647\u0627 \u0648\u064a\u064f\u0633\u0648\u064e\u0651\u0649 \u0628\u0639\u062f\u0647\u0627\u060c \u0648\u0644\u0630\u0644\u0643 \u0642\u062f \u064a\u0643\u0648\u0646 \u0647\u0630\u0627 \u0627\u0644\u062a\u0627\u0631\u064a\u062e \u0644\u0627\u062d\u0642\u064b\u0627 \u0644\u0640 `created_at`.\n\u0648\u064a\u0643\u0648\u0646 `null` \u0645\u0627 \u0644\u0645 \u064a\u064f\u0633\u0648\u064e\u0651 \u0648\u0641\u064a \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0633\u0627\u0628\u0642\u0629 \u0644\u0648\u062c\u0648\u062f \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u0648\u062f \u2014 \u0648\u0644\u0627\n\u064a\u064f\u0633\u062a\u0628\u062f\u064e\u0644 \u0628\u0647\u0627 `created_at` \u0623\u0628\u062f\u064b\u0627.\n" } } } } }, "BillingAccount": { "type": "object", "required": [ "balance", "due", "due_by_currency", "mixed_currency" ], "properties": { "balance": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "`users.balance` \u2014 USD, unconditionally. Funded by refunds and manual\ncredits; there is no API way to add to it in this phase.\n", "x-i18n": { "tr": { "description": "`users.balance` \u2014 ko\u015fulsuz olarak USD. \u0130adelerle ve elle tan\u0131mlanan\nhediye kredilerle beslenir; bu a\u015famada API \u00fczerinden bakiyeye ekleme\nyapman\u0131n bir yolu yoktur.\n" }, "ar": { "description": "`users.balance` \u2014 \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a \u062f\u0627\u0626\u0645\u064b\u0627. \u064a\u064f\u063a\u0630\u0651\u0649 \u0645\u0646 \u0627\u0644\u0645\u0628\u0627\u0644\u063a \u0627\u0644\u0645\u0633\u062a\u0631\u062f\u0629\n\u0648\u0627\u0644\u0623\u0631\u0635\u062f\u0629 \u0627\u0644\u0645\u0645\u0646\u0648\u062d\u0629 \u064a\u062f\u0648\u064a\u064b\u0627\u061b \u0648\u0644\u0627 \u0633\u0628\u064a\u0644 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0645\u0631\u062d\u0644\u0629 \u0644\u0644\u0625\u0636\u0627\u0641\u0629 \u0625\u0644\u064a\u0647 \u0639\u0628\u0631 \u0648\u0627\u062c\u0647\u0629\n\u0627\u0644\u0628\u0631\u0645\u062c\u0629.\n" } } }, "due": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "The sum of every OPEN bill's own stored total. A bill is open when its base\nstatus is `new` or `failed` AND it has neither been absorbed into another\npayment nor comped, so a client recomputing this figure from `GET /payments`\nmust skip any row carrying `settled_by_payment_id` and any row whose\n`is_administrative` is true \u2014 both keep a base status of `new` or `failed` and\nare published as such.\n\nIndividual bills can carry different currencies if the account's billing\nCOUNTRY changed between orders, and nothing re-derives a frozen bill. When they\ndiffer this is a bare sum of unconverted amounts, labelled with the currency the\naccount's *current* billing country resolves to; read `due_by_currency` for one\nfigure per currency, and `mixed_currency` for when that matters.\n", "x-i18n": { "tr": { "description": "A\u00e7\u0131k olan her faturan\u0131n kendi kay\u0131tl\u0131 toplam\u0131n\u0131n toplam\u0131. Bir fatura, temel\ndurumu `new` ya da `failed` ise ve ba\u015fka bir \u00f6demeye devredilmemi\u015f ya da\nikram olarak kapat\u0131lmam\u0131\u015fsa a\u00e7\u0131kt\u0131r; dolay\u0131s\u0131yla bu tutar\u0131 `GET /payments`\n\u00fczerinden yeniden hesaplayan bir istemci, `settled_by_payment_id` ta\u015f\u0131yan\nsat\u0131rlar\u0131 ve `is_administrative` de\u011feri do\u011fru olan sat\u0131rlar\u0131 atlamal\u0131d\u0131r \u2014\nikisi de temel durumunu `new` ya da `failed` olarak korur ve \u00f6yle yay\u0131mlan\u0131r.\n\nHesab\u0131n fatura \u00dcLKES\u0130 sipari\u015fler aras\u0131nda de\u011fi\u015ftiyse tek tek faturalar farkl\u0131\npara birimleri ta\u015f\u0131yabilir ve dondurulmu\u015f bir fatura yeniden t\u00fcretilmez.\nFarkl\u0131 olduklar\u0131nda bu alan, \u00e7evrilmemi\u015f tutarlar\u0131n d\u00fcz toplam\u0131d\u0131r ve hesab\u0131n\n*g\u00fcncel* fatura \u00fclkesinden \u00e7\u0131kan para birimiyle etiketlenir; her para birimi\ni\u00e7in ayr\u0131 tutar\u0131 `due_by_currency` alan\u0131ndan, bunun ne zaman \u00f6nem ta\u015f\u0131d\u0131\u011f\u0131n\u0131\n`mixed_currency` alan\u0131ndan okuyun.\n" }, "ar": { "description": "\u0645\u062c\u0645\u0648\u0639 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a \u0627\u0644\u0645\u062e\u0632\u064e\u0651\u0646 \u0644\u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0641\u062a\u0648\u062d\u0629. \u0648\u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0641\u062a\u0648\u062d\u0629 \u0639\u0646\u062f\u0645\u0627 \u062a\u0643\u0648\u0646 \u062d\u0627\u0644\u062a\u0647\u0627\n\u0627\u0644\u0623\u0633\u0627\u0633\u064a\u0629 `new` \u0623\u0648 `failed` \u0648\u0644\u0645 \u062a\u064f\u062f\u0645\u062c \u0641\u064a \u062f\u0641\u0639\u0629 \u0623\u062e\u0631\u0649 \u0648\u0644\u0645 \u062a\u064f\u0634\u0637\u0628 \u0645\u062c\u0627\u0645\u0644\u0629\u064b\u061b \u0644\u0630\u0627 \u0639\u0644\u0649\n\u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u064a\u0639\u064a\u062f \u062d\u0633\u0627\u0628 \u0647\u0630\u0627 \u0627\u0644\u0645\u0628\u0644\u063a \u0645\u0646 `GET /payments` \u0623\u0646 \u064a\u062a\u062e\u0637\u0649 \u0623\u064a \u0633\u0637\u0631 \u064a\u062d\u0645\u0644\n`settled_by_payment_id` \u0648\u0623\u064a \u0633\u0637\u0631 \u0642\u064a\u0645\u0629 `is_administrative` \u0641\u064a\u0647 \u0635\u062d\u064a\u062d\u0629 \u2014 \u0641\u0643\u0644\u0627\u0647\u0645\u0627\n\u064a\u062d\u062a\u0641\u0638 \u0628\u062d\u0627\u0644\u0629 \u0623\u0633\u0627\u0633\u064a\u0629 `new` \u0623\u0648 `failed` \u0648\u064a\u064f\u0646\u0634\u0631 \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0646\u062d\u0648.\n\n\u0648\u0642\u062f \u062a\u062d\u0645\u0644 \u0627\u0644\u0641\u0648\u0627\u062a\u064a\u0631 \u0627\u0644\u0645\u0641\u0631\u062f\u0629 \u0639\u0645\u0644\u0627\u062a \u0645\u062e\u062a\u0644\u0641\u0629 \u0625\u0630\u0627 \u062a\u063a\u064a\u0651\u0631 \u0628\u0644\u062f \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u062d\u0633\u0627\u0628 \u0628\u064a\u0646\n\u0627\u0644\u0637\u0644\u0628\u0627\u062a\u060c \u0648\u0644\u0627 \u0634\u064a\u0621 \u064a\u0639\u064a\u062f \u0627\u0634\u062a\u0642\u0627\u0642 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u062c\u0645\u0651\u062f\u0629. \u0648\u0639\u0646\u062f \u0627\u062e\u062a\u0644\u0627\u0641\u0647\u0627 \u064a\u0643\u0648\u0646 \u0647\u0630\u0627 \u0627\u0644\u0645\u0628\u0644\u063a\n\u0645\u062c\u0645\u0648\u0639\u064b\u0627 \u0645\u062c\u0631\u062f\u064b\u0627 \u0644\u0645\u0628\u0627\u0644\u063a \u063a\u064a\u0631 \u0645\u062d\u0648\u064e\u0651\u0644\u0629\u060c \u0645\u0648\u0633\u0648\u0645\u064b\u0627 \u0628\u0627\u0644\u0639\u0645\u0644\u0629 \u0627\u0644\u062a\u064a \u064a\u0624\u062f\u064a \u0625\u0644\u064a\u0647\u0627 \u0628\u0644\u062f \u0627\u0644\u0641\u0648\u062a\u0631\u0629\n*\u0627\u0644\u062d\u0627\u0644\u064a* \u0644\u0644\u062d\u0633\u0627\u0628\u061b \u0641\u0627\u0642\u0631\u0623 `due_by_currency` \u0644\u0644\u062d\u0635\u0648\u0644 \u0639\u0644\u0649 \u0645\u0628\u0644\u063a \u0644\u0643\u0644 \u0639\u0645\u0644\u0629\u060c \u0648\n`mixed_currency` \u0644\u062a\u0639\u0631\u0641 \u0645\u062a\u0649 \u064a\u0643\u0648\u0646 \u0630\u0644\u0643 \u0645\u0647\u0645\u064b\u0627.\n" } } }, "due_by_currency": { "type": "object", "additionalProperties": { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } }, "description": "`due` split by the currency each open bill is denominated in: ISO-4217 code to\nthe sum of that code's open bills. The buckets add up to `due` to the cent, and\nthere is always at least one \u2014 exactly one, equal to `due`, on an account whose\nbills agree about the currency, which is nearly every account.\n", "x-i18n": { "tr": { "description": "`due` tutar\u0131n\u0131n, a\u00e7\u0131k faturalar\u0131n ta\u015f\u0131d\u0131\u011f\u0131 para birimlerine g\u00f6re ayr\u0131lm\u0131\u015f\nh\u00e2li: ISO-4217 kodu ve o koda ait a\u00e7\u0131k faturalar\u0131n toplam\u0131. Gruplar kuru\u015funa\nkadar `due` tutar\u0131n\u0131 verir ve her zaman en az bir grup vard\u0131r; faturalar\u0131 tek\nbir para biriminde olan hesapta \u2014 ki hesaplar\u0131n neredeyse tamam\u0131 b\u00f6yledir \u2014\ntam olarak bir grup bulunur ve o da `due` tutar\u0131na e\u015fittir.\n" }, "ar": { "description": "\u062a\u0642\u0633\u064a\u0645 `due` \u0628\u062d\u0633\u0628 \u0627\u0644\u0639\u0645\u0644\u0629 \u0627\u0644\u062a\u064a \u062d\u064f\u0631\u0651\u0631\u062a \u0628\u0647\u0627 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0641\u062a\u0648\u062d\u0629: \u0631\u0645\u0632 ISO-4217 \u0645\u0642\u0627\u0628\u0644\n\u0645\u062c\u0645\u0648\u0639 \u0627\u0644\u0641\u0648\u0627\u062a\u064a\u0631 \u0627\u0644\u0645\u0641\u062a\u0648\u062d\u0629 \u0628\u0630\u0644\u0643 \u0627\u0644\u0631\u0645\u0632. \u062a\u064f\u062c\u0645\u064e\u0639 \u0647\u0630\u0647 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0641\u062a\u0633\u0627\u0648\u064a `due` \u062d\u062a\u0649\n\u0627\u0644\u0641\u0644\u0633\u060c \u0648\u064a\u0648\u062c\u062f \u062f\u0627\u0626\u0645\u064b\u0627 \u0645\u062c\u0645\u0648\u0639\u0629 \u0648\u0627\u062d\u062f\u0629 \u0639\u0644\u0649 \u0627\u0644\u0623\u0642\u0644 \u2014 \u0648\u0645\u062c\u0645\u0648\u0639\u0629 \u0648\u0627\u062d\u062f\u0629 \u0628\u0627\u0644\u0636\u0628\u0637 \u062a\u0633\u0627\u0648\u064a `due`\n\u0641\u064a \u0627\u0644\u062d\u0633\u0627\u0628 \u0627\u0644\u0630\u064a \u062a\u062a\u0641\u0642 \u0641\u0648\u0627\u062a\u064a\u0631\u0647 \u0639\u0644\u0649 \u0627\u0644\u0639\u0645\u0644\u0629\u060c \u0648\u0647\u0648 \u062d\u0627\u0644 \u0623\u063a\u0644\u0628 \u0627\u0644\u062d\u0633\u0627\u0628\u0627\u062a.\n" } } }, "mixed_currency": { "type": "boolean", "description": "True when the open bills are not all in one currency \u2014 that is, when\n`due_by_currency` holds more than one entry. `due` is then a sum of amounts in\ndifferent currencies and is a conversion of nothing; present `due_by_currency`\ninstead.\n", "x-i18n": { "tr": { "description": "A\u00e7\u0131k faturalar\u0131n tamam\u0131 ayn\u0131 para biriminde de\u011filse, yani `due_by_currency`\nbirden fazla girdi ta\u015f\u0131yorsa do\u011frudur. Bu durumda `due`, farkl\u0131 para\nbirimlerindeki tutarlar\u0131n toplam\u0131d\u0131r ve hi\u00e7bir \u015feyin \u00e7evrimi de\u011fildir;\nm\u00fc\u015fteriye `due_by_currency` g\u00f6sterilmelidir.\n" }, "ar": { "description": "\u064a\u0643\u0648\u0646 \u0635\u062d\u064a\u062d\u064b\u0627 \u0639\u0646\u062f\u0645\u0627 \u0644\u0627 \u062a\u0643\u0648\u0646 \u0627\u0644\u0641\u0648\u0627\u062a\u064a\u0631 \u0627\u0644\u0645\u0641\u062a\u0648\u062d\u0629 \u0643\u0644\u0647\u0627 \u0628\u0639\u0645\u0644\u0629 \u0648\u0627\u062d\u062f\u0629\u060c \u0623\u064a \u0639\u0646\u062f\u0645\u0627 \u064a\u062d\u0645\u0644\n`due_by_currency` \u0623\u0643\u062b\u0631 \u0645\u0646 \u0645\u062f\u062e\u0644. \u0648\u0639\u0646\u062f\u0626\u0630\u064d \u064a\u0643\u0648\u0646 `due` \u0645\u062c\u0645\u0648\u0639 \u0645\u0628\u0627\u0644\u063a \u0628\u0639\u0645\u0644\u0627\u062a \u0645\u062e\u062a\u0644\u0641\u0629\n\u0648\u0644\u064a\u0633 \u062a\u062d\u0648\u064a\u0644\u064b\u0627 \u0644\u0623\u064a \u0634\u064a\u0621\u061b \u0641\u0627\u0639\u0631\u0636 `due_by_currency` \u0628\u062f\u0644\u064b\u0627 \u0645\u0646\u0647.\n" } } } } }, "Order": { "type": "object", "description": "A placed order: the payment that carries it, the subscriptions it bought, what the\ncaller's granted credit will take off it, and what a card is then asked for. Placing\nan order moves no money \u2014 nothing is deployed and no credit is taken until the payment\nis settled on the page `payment_url` names.\n", "x-i18n": { "tr": { "description": "Verilmi\u015f bir sipari\u015f: sipari\u015fi ta\u015f\u0131yan \u00f6deme, sat\u0131n al\u0131nan abonelikler, \u00e7a\u011f\u0131ran\u0131n\nhediye kredisinin sipari\u015ften d\u00fc\u015fece\u011fi tutar ve ard\u0131ndan karttan istenecek tutar.\nSipari\u015f vermek para hareketi yaratmaz: `payment_url` ile belirtilen sayfadan \u00f6deme\nyap\u0131lana kadar ne kurulum ba\u015flar ne de krediden tutar al\u0131n\u0131r.\n" }, "ar": { "description": "\u0637\u0644\u0628 \u0645\u064f\u0646\u0641\u064e\u0651\u0630: \u0627\u0644\u062f\u0641\u0639\u0629 \u0627\u0644\u062a\u064a \u062a\u062d\u0645\u0644\u0647\u060c \u0648\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u062a\u064a \u0627\u0634\u062a\u0631\u0627\u0647\u0627\u060c \u0648\u0645\u0627 \u0633\u064a\u062e\u0635\u0645\u0647 \u0631\u0635\u064a\u062f \u0627\u0644\u0645\u064f\u0633\u062a\u062f\u0639\u064a\n\u0627\u0644\u0645\u0645\u0646\u0648\u062d \u0645\u0646\u0647\u060c \u0648\u0645\u0627 \u064a\u064f\u0637\u0644\u0628 \u0645\u0646 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0628\u0639\u062f \u0630\u0644\u0643. \u0648\u0625\u0646\u0634\u0627\u0621 \u0627\u0644\u0637\u0644\u0628 \u0644\u0627 \u064a\u062d\u0631\u0651\u0643 \u0645\u0627\u0644\u064b\u0627: \u0644\u0627 \u064a\u064f\u0646\u0634\u064e\u0631 \u0634\u064a\u0621\n\u0648\u0644\u0627 \u064a\u064f\u0624\u062e\u0630 \u0631\u0635\u064a\u062f \u062d\u062a\u0649 \u062a\u064f\u0633\u0648\u064e\u0651\u0649 \u0627\u0644\u062f\u0641\u0639\u0629 \u0641\u064a \u0627\u0644\u0635\u0641\u062d\u0629 \u0627\u0644\u062a\u064a \u064a\u0633\u0645\u0651\u064a\u0647\u0627 `payment_url`.\n" } }, "required": [ "payment", "subscriptions", "paid_from_balance", "balance_after", "needs_card", "payable", "credit_applied", "payment_url" ], "properties": { "payment": { "allOf": [ { "type": "object", "required": [ "id", "status", "is_superseded", "is_administrative", "currency", "amount", "subtotal", "taxes", "discount", "applied_balance", "credit_basis", "taxable_base", "list_total", "catalogue_discount", "refunds", "refunded_total", "refunded_credit_total", "net_after_refunds", "settled_by_payment_id", "is_dues", "covered_interest", "subscription_ids", "failure_reason", "failure_count", "created_at", "paid_at" ], "properties": { "id": { "type": "integer", "example": 9042 }, "status": { "type": "string", "enum": [ "new", "payed", "failed", "canceled", "expired", "refunded", "partially_refunded", "unknown" ] }, "is_superseded": { "type": "boolean", "description": "This payment has been REPLACED and asks for nothing. Two things produce it: a\ncontract whose bill was rewritten, and a bill rolled into a dues payment \u2014 read\n`settled_by_payment_id` to tell them apart, and to learn which payment now\ncarries the debt. `status` is deliberately left as it was, so an absorbed bill\nstill reads `new`.\n", "x-i18n": { "tr": { "description": "Bu \u00f6demenin yerini bir ba\u015fkas\u0131 alm\u0131\u015ft\u0131r ve art\u0131k hi\u00e7bir tutar talep etmez. Bunu\niki durum \u00fcretir: faturas\u0131 yeniden d\u00fczenlenen bir s\u00f6zle\u015fme ve toplu bor\u00e7\n\u00f6demesine d\u00e2hil edilen bir fatura \u2014 hangisi oldu\u011funu ve borcu art\u0131k hangi\n\u00f6demenin ta\u015f\u0131d\u0131\u011f\u0131n\u0131 anlamak i\u00e7in `settled_by_payment_id` alan\u0131n\u0131 okuyun.\n`status` bilerek oldu\u011fu gibi b\u0131rak\u0131l\u0131r; bu y\u00fczden d\u00e2hil edilmi\u015f bir fatura h\u00e2l\u00e2\n`new` g\u00f6r\u00fcn\u00fcr.\n" }, "ar": { "description": "\u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u062d\u0644\u0651\u062a \u0645\u062d\u0644\u0651\u0647\u0627 \u062f\u0641\u0639\u0629 \u0623\u062e\u0631\u0649 \u0648\u0644\u0645 \u062a\u0639\u062f \u062a\u0637\u0627\u0644\u0628 \u0628\u0634\u064a\u0621. \u0648\u064a\u0646\u0634\u0623 \u0630\u0644\u0643 \u0639\u0646 \u062d\u0627\u0644\u062a\u064a\u0646: \u0639\u0642\u062f\n\u0623\u064f\u0639\u064a\u062f\u062a \u0641\u0648\u062a\u0631\u062a\u0647\u060c \u0648\u0641\u0627\u062a\u0648\u0631\u0629 \u0636\u064f\u0645\u0651\u062a \u0625\u0644\u0649 \u062f\u0641\u0639\u0629 \u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0645\u062c\u0645\u0651\u0639\u0629 \u2014 \u0627\u0642\u0631\u0623\n`settled_by_payment_id` \u0644\u062a\u0645\u064a\u064a\u0632 \u0627\u0644\u062d\u0627\u0644\u062a\u064a\u0646 \u0648\u0644\u0645\u0639\u0631\u0641\u0629 \u0623\u064a \u062f\u0641\u0639\u0629 \u062a\u062d\u0645\u0644 \u0627\u0644\u062f\u064a\u0646 \u0627\u0644\u0622\u0646. \u0648\u064a\u064f\u062a\u0631\u0643\n`status` \u0643\u0645\u0627 \u0647\u0648 \u0639\u0646 \u0642\u0635\u062f\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u0628\u0642\u0649 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0627\u0644\u0645\u0636\u0645\u0648\u0645\u0629 \u0628\u0642\u064a\u0645\u0629 `new`.\n" } } }, "is_administrative": { "type": "boolean", "description": "Comped or provider-created; contributes nothing to billing.", "x-i18n": { "tr": { "description": "Bedelsiz verilmi\u015f ya da sa\u011flay\u0131c\u0131 taraf\u0131ndan olu\u015fturulmu\u015f; faturalamaya hi\u00e7bir katk\u0131s\u0131 yoktur." }, "ar": { "description": "\u0645\u062c\u0627\u0646\u064a \u0623\u0648 \u0623\u0646\u0634\u0623\u0647 \u0627\u0644\u0645\u0632\u0648\u0651\u062f\u061b \u0644\u0627 \u064a\u0633\u0627\u0647\u0645 \u0641\u064a \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0625\u0637\u0644\u0627\u0642\u064b\u0627." } } }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "description": "Decided once, at payment creation, from the customer's language at that\nmoment \u2014 never re-derived later. Two payments from the same customer can\ncarry different currencies if their language changed in between.\n", "x-i18n": { "tr": { "description": "\u00d6deme olu\u015fturulurken, o andaki m\u00fc\u015fteri diline g\u00f6re bir kez belirlenir \u2014 sonradan\nasla yeniden t\u00fcretilmez. Ayn\u0131 m\u00fc\u015fterinin iki \u00f6demesi, arada dili de\u011fi\u015ftiyse\nfarkl\u0131 para birimleri ta\u015f\u0131yabilir.\n" }, "ar": { "description": "\u062a\u064f\u062d\u062f\u064e\u0651\u062f \u0645\u0631\u0629 \u0648\u0627\u062d\u062f\u0629 \u0639\u0646\u062f \u0625\u0646\u0634\u0627\u0621 \u0627\u0644\u062f\u0641\u0639\u0629\u060c \u0627\u0646\u0637\u0644\u0627\u0642\u064b\u0627 \u0645\u0646 \u0644\u063a\u0629 \u0627\u0644\u0639\u0645\u064a\u0644 \u0641\u064a \u062a\u0644\u0643 \u0627\u0644\u0644\u062d\u0638\u0629 \u2014 \u0648\u0644\u0627\n\u062a\u064f\u0634\u062a\u0642 \u0645\u062c\u062f\u062f\u064b\u0627 \u0628\u0639\u062f \u0630\u0644\u0643. \u0648\u0642\u062f \u062a\u062d\u0645\u0644 \u062f\u0641\u0639\u062a\u0627\u0646 \u0644\u0644\u0639\u0645\u064a\u0644 \u0646\u0641\u0633\u0647 \u0639\u0645\u0644\u062a\u064a\u0646 \u0645\u062e\u062a\u0644\u0641\u062a\u064a\u0646 \u0625\u0646 \u062a\u063a\u064a\u064e\u0651\u0631\u062a\n\u0644\u063a\u062a\u0647 \u0628\u064a\u0646\u0647\u0645\u0627.\n" } }, "example": "TRY" }, "amount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The total, in `currency`. `null` when this payment has never been\nrecalculated \u2014 recalculating is a write (it caches the breakdown and an\nexchange rate), so a plain `GET` never triggers it. Pass `?refresh=true`\nto force a recalculation; it counts against the tighter refresh budget.\n", "x-i18n": { "tr": { "description": "`currency` cinsinden toplam. Bu \u00f6deme hi\u00e7 yeniden hesaplanmad\u0131ysa `null` olur \u2014\nyeniden hesaplamak bir yazma i\u015flemidir (d\u00f6k\u00fcm\u00fc ve bir d\u00f6viz kurunu \u00f6nbelle\u011fe\nal\u0131r), bu y\u00fczden d\u00fcz bir `GET` bunu asla tetiklemez. Yeniden hesaplamay\u0131\nzorlamak i\u00e7in `?refresh=true` g\u00f6nderin; bu istek, daha dar olan yenileme\nb\u00fct\u00e7esinden d\u00fc\u015fer.\n" }, "ar": { "description": "\u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a \u0628\u0639\u0645\u0644\u0629 `currency`. \u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0625\u0646 \u0644\u0645 \u064a\u064f\u0639\u064e\u062f \u062d\u0633\u0627\u0628 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u0642\u0637 \u2014\n\u0641\u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u062d\u0633\u0627\u0628 \u0639\u0645\u0644\u064a\u0629 \u0643\u062a\u0627\u0628\u0629 (\u062a\u062e\u0632\u0651\u0646 \u0627\u0644\u062a\u0641\u0635\u064a\u0644 \u0648\u0633\u0639\u0631 \u0627\u0644\u0635\u0631\u0641 \u0641\u064a \u0630\u0627\u0643\u0631\u0629 \u0645\u0624\u0642\u062a\u0629)\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627\n\u064a\u064f\u0637\u0644\u0642\u0647\u0627 \u0637\u0644\u0628 `GET` \u0639\u0627\u062f\u064a \u0623\u0628\u062f\u064b\u0627. \u0623\u0631\u0633\u0644 `?refresh=true` \u0644\u0641\u0631\u0636 \u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u062d\u0633\u0627\u0628\u061b \u0648\u064a\u064f\u062d\u062a\u0633\u0628\n\u0630\u0644\u0643 \u0645\u0646 \u0645\u064a\u0632\u0627\u0646\u064a\u0629 \u0627\u0644\u062a\u062d\u062f\u064a\u062b \u0627\u0644\u0623\u0636\u064a\u0642.\n" } } }, "subtotal": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "Same nullability rule as `amount`, and for the same reason.", "x-i18n": { "tr": { "description": "De\u011ferin null olabilme kural\u0131 `amount` ile ayn\u0131d\u0131r; gerek\u00e7esi de ayn\u0131d\u0131r." }, "ar": { "description": "\u0642\u0627\u0639\u062f\u0629 \u0642\u0627\u0628\u0644\u064a\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0644\u0623\u0646 \u062a\u0643\u0648\u0646 null \u0647\u064a \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642\u0629 \u0639\u0644\u0649 `amount`\u060c \u0648\u0644\u0644\u0633\u0628\u0628 \u0646\u0641\u0633\u0647." } } }, "taxes": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The VAT, charged on `taxable_base` rather than on `subtotal` wherever\n`credit_basis` is `net`. Same nullability rule as `amount`.\n", "x-i18n": { "tr": { "description": "KDV. `credit_basis` de\u011feri `net` olan her \u00f6demede `subtotal` \u00fczerinden de\u011fil,\n`taxable_base` \u00fczerinden hesaplan\u0131r. De\u011ferin null olabilme kural\u0131 `amount` ile\nayn\u0131d\u0131r.\n" }, "ar": { "description": "\u0636\u0631\u064a\u0628\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0645\u0636\u0627\u0641\u0629\u060c \u0648\u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u0649 `taxable_base` \u0644\u0627 \u0639\u0644\u0649 `subtotal` \u0643\u0644\u0645\u0627 \u0643\u0627\u0646\n`credit_basis` \u064a\u0633\u0627\u0648\u064a `net`. \u0648\u0642\u0627\u0639\u062f\u0629 \u0642\u0627\u0628\u0644\u064a\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0644\u0623\u0646 \u062a\u0643\u0648\u0646 null \u0647\u064a \u0646\u0641\u0633\u0647\u0627\n\u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642\u0629 \u0639\u0644\u0649 `amount`.\n" } } }, "discount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "Granted account credit applied to this payment as a DISCOUNT ON THE NET \u2014 an\niskonto, not a payment. It reduces the taxable base, so the VAT in `taxes` is\ncharged on `taxable_base` and not on `subtotal`. Read `credit_basis` before\nreconciling: on a payment charged before 2026-09-17 this figure was subtracted\nfrom the VAT-inclusive gross instead, and is replayed as it was charged. Same\nnullability rule as `amount`.\n", "x-i18n": { "tr": { "description": "Bu \u00f6demeye uygulanan hediye hesap kredisi \u2014 bir \u00f6deme de\u011fil, NET TUTAR \u00dcZER\u0130NDEN\n\u0130SKONTO. Matrah\u0131 d\u00fc\u015f\u00fcr\u00fcr; bu y\u00fczden `taxes` i\u00e7indeki KDV, `subtotal` \u00fczerinden\nde\u011fil `taxable_base` \u00fczerinden hesaplan\u0131r. Mutabakat yapmadan \u00f6nce `credit_basis`\nalan\u0131n\u0131 okuyun: 17.09.2026 \u00f6ncesinde tahsil edilmi\u015f bir \u00f6demede bu tutar KDV d\u00e2hil\nbr\u00fctten d\u00fc\u015f\u00fcl\u00fcyordu ve o \u00f6deme tahsil edildi\u011fi bi\u00e7imiyle korunur. De\u011ferin null\nolabilme kural\u0131 `amount` ile ayn\u0131d\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0631\u0635\u064a\u062f \u0627\u0644\u0645\u0645\u0646\u0648\u062d \u0644\u0644\u062d\u0633\u0627\u0628 \u0648\u0627\u0644\u0645\u064f\u0637\u0628\u064e\u0651\u0642 \u0639\u0644\u0649 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u0628\u0648\u0635\u0641\u0647 \u062e\u0635\u0645\u064b\u0627 \u0639\u0644\u0649 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a \u2014\n\u062e\u0635\u0645\u060c \u0644\u0627 \u062f\u0641\u0639\u0629. \u0641\u0647\u0648 \u064a\u064f\u0646\u0642\u0635 \u0627\u0644\u0648\u0639\u0627\u0621 \u0627\u0644\u0636\u0631\u064a\u0628\u064a\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u064f\u062d\u062a\u0633\u0628 \u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0641\u064a `taxes` \u0639\u0644\u0649\n`taxable_base` \u0644\u0627 \u0639\u0644\u0649 `subtotal`. \u0627\u0642\u0631\u0623 `credit_basis` \u0642\u0628\u0644 \u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629: \u0641\u0641\u064a \u062f\u0641\u0639\u0629\n\u062d\u064f\u0635\u0650\u0651\u0644\u062a \u0642\u0628\u0644 2026-09-17 \u0643\u0627\u0646 \u0647\u0630\u0627 \u0627\u0644\u0645\u0628\u0644\u063a \u064a\u064f\u0637\u0631\u062d \u0645\u0646 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a \u0634\u0627\u0645\u0644 \u0627\u0644\u0636\u0631\u064a\u0628\u0629\u060c \u0648\u062a\u064f\u0639\u0631\u0636 \u062a\u0644\u0643\n\u0627\u0644\u062f\u0641\u0639\u0629 \u0643\u0645\u0627 \u062d\u064f\u0635\u0650\u0651\u0644\u062a. \u0648\u0642\u0627\u0639\u062f\u0629 \u0642\u0627\u0628\u0644\u064a\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0644\u0623\u0646 \u062a\u0643\u0648\u0646 null \u0647\u064a \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642\u0629 \u0639\u0644\u0649 `amount`.\n" } } }, "applied_balance": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The same figure as `discount`, under the name the billing surfaces use for it.\nSame nullability rule as `amount`.\n", "x-i18n": { "tr": { "description": "`discount` ile ayn\u0131 tutar; faturalama ekranlar\u0131n\u0131n bu tutar i\u00e7in kulland\u0131\u011f\u0131 adla.\nDe\u011ferin null olabilme kural\u0131 `amount` ile ayn\u0131d\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0646\u0641\u0633\u0647 \u0627\u0644\u0648\u0627\u0631\u062f \u0641\u064a `discount`\u060c \u0628\u0627\u0644\u0627\u0633\u0645 \u0627\u0644\u0630\u064a \u062a\u0633\u062a\u0639\u0645\u0644\u0647 \u0634\u0627\u0634\u0627\u062a \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0644\u0647. \u0648\u0642\u0627\u0639\u062f\u0629\n\u0642\u0627\u0628\u0644\u064a\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0644\u0623\u0646 \u062a\u0643\u0648\u0646 null \u0647\u064a \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642\u0629 \u0639\u0644\u0649 `amount`.\n" } } }, "credit_basis": { "type": "string", "enum": [ "net", "gross" ], "nullable": true, "description": "Which arithmetic produced `discount`. `net`: the credit was taken off the net as\nan iskonto, so `taxable_base` = `subtotal` \u2212 `discount`, `taxes` is the rate's\nshare of `taxable_base`, and `amount` = `taxable_base` + `taxes`. `gross`: the\ncredit was subtracted from the VAT-inclusive gross and the tax was charged on the\nwhole net. `null` on a payment whose stored breakdown predates the distinction \u2014\nthose were charged on the gross basis; the value is not defaulted, because\n\"predates the field\" and \"explicitly priced on the gross\" are different facts.\n", "x-i18n": { "tr": { "description": "`discount` tutar\u0131n\u0131n hangi y\u00f6ntemle hesapland\u0131\u011f\u0131. `net`: kredi, net tutardan\niskonto olarak d\u00fc\u015f\u00fclm\u00fc\u015ft\u00fcr; dolay\u0131s\u0131yla `taxable_base` = `subtotal` \u2212 `discount`,\n`taxes` bu matrah\u0131n oran\u0131 kadard\u0131r ve `amount` = `taxable_base` + `taxes`.\n`gross`: kredi KDV d\u00e2hil br\u00fctten d\u00fc\u015f\u00fclm\u00fc\u015f, vergi ise net tutar\u0131n tamam\u0131 \u00fczerinden\nhesaplanm\u0131\u015ft\u0131r. Saklanan d\u00f6k\u00fcm\u00fc bu ayr\u0131mdan \u00f6nceye dayanan bir \u00f6demede `null`\nolur; o \u00f6demeler br\u00fct y\u00f6ntemiyle tahsil edilmi\u015ftir. De\u011fer varsay\u0131lana\n\u00e7ekilmez: \"alan hen\u00fcz yoktu\" ile \"a\u00e7\u0131k\u00e7a br\u00fct \u00fczerinden fiyatland\u0131\" farkl\u0131\nolgulard\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0637\u0631\u064a\u0642\u0629 \u0627\u0644\u062d\u0633\u0627\u0628\u064a\u0629 \u0627\u0644\u062a\u064a \u0623\u0646\u062a\u062c\u062a `discount`. `net`: \u062e\u064f\u0635\u0645 \u0627\u0644\u0631\u0635\u064a\u062f \u0645\u0646 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a\n\u0628\u0648\u0635\u0641\u0647 \u062e\u0635\u0645\u064b\u0627\u060c \u0641\u064a\u0643\u0648\u0646 `taxable_base` = `subtotal` \u2212 `discount`\u060c \u0648\u062a\u0643\u0648\u0646 `taxes` \u0646\u0633\u0628\u0629\n\u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0645\u0646 \u0647\u0630\u0627 \u0627\u0644\u0648\u0639\u0627\u0621\u060c \u0648\u064a\u0643\u0648\u0646 `amount` = `taxable_base` + `taxes`. `gross`: \u0637\u064f\u0631\u062d\n\u0627\u0644\u0631\u0635\u064a\u062f \u0645\u0646 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a \u0634\u0627\u0645\u0644 \u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0648\u0627\u062d\u062a\u064f\u0633\u0628\u062a \u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0639\u0644\u0649 \u0643\u0627\u0645\u0644 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a. \u0648\u062a\u0643\u0648\u0646\n\u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0641\u064a \u062f\u0641\u0639\u0629 \u064a\u0639\u0648\u062f \u062a\u0641\u0635\u064a\u0644\u0647\u0627 \u0627\u0644\u0645\u062e\u0632\u064e\u0651\u0646 \u0625\u0644\u0649 \u0645\u0627 \u0642\u0628\u0644 \u0647\u0630\u0627 \u0627\u0644\u062a\u0645\u064a\u064a\u0632\u061b \u0648\u062a\u0644\u0643 \u0627\u0644\u062f\u0641\u0639\u0627\u062a\n\u062d\u064f\u0635\u0650\u0651\u0644\u062a \u0628\u0637\u0631\u064a\u0642\u0629 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a. \u0648\u0644\u0627 \u062a\u064f\u0633\u062a\u0628\u062f\u0644 \u0627\u0644\u0642\u064a\u0645\u0629 \u0628\u0642\u064a\u0645\u0629 \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629\u060c \u0644\u0623\u0646 \"\u0627\u0644\u062d\u0642\u0644 \u0644\u0645 \u064a\u0643\u0646\n\u0645\u0648\u062c\u0648\u062f\u064b\u0627\" \u0648\"\u0633\u064f\u0639\u0650\u0651\u0631\u062a \u0635\u0631\u0627\u062d\u0629\u064b \u0639\u0644\u0649 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a\" \u0648\u0627\u0642\u0639\u062a\u0627\u0646 \u0645\u062e\u062a\u0644\u0641\u062a\u0627\u0646.\n" } } }, "taxable_base": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The amount the VAT in `taxes` is charged on \u2014 `subtotal` less the credit iskonto\nin `discount`. `amount` is this plus `taxes`, exactly, to the minor unit. `null`\non a stored breakdown written before the field existed, and on a payment that has\nnever been recalculated; nothing is re-derived to fill it in.\n\nIt is `null` EXACTLY WHEN `credit_basis` IS `null`, and the two are one fact: a\nbreakdown that took its credit off the gross has no matrah to state, because the VAT\non it was charged on the whole net. So a reader may branch on either field alone,\nand a `credit_basis` of `null` beside a figure here \u2014 a mixed breakdown, where a bill\npriced today absorbed a line charged under the old rule \u2014 will never be sent: the\nmatrah would not reconcile with the `taxes` beside it.\n", "x-i18n": { "tr": { "description": "`taxes` i\u00e7indeki KDV'nin \u00fczerinden hesapland\u0131\u011f\u0131 tutar \u2014 `subtotal` eksi\n`discount` i\u00e7indeki kredi iskontosu. `amount`, bu tutar ile `taxes` toplam\u0131na\nkuru\u015funa kadar e\u015fittir. Saklanan d\u00f6k\u00fcm bu alan var olmadan \u00f6nce yaz\u0131lm\u0131\u015fsa ya da\n\u00f6deme hi\u00e7 yeniden hesaplanmam\u0131\u015fsa `null` olur; alan\u0131 doldurmak i\u00e7in hi\u00e7bir tutar\nyeniden t\u00fcretilmez.\n\nBu alan, TAM OLARAK `credit_basis` alan\u0131n\u0131n `null` oldu\u011fu durumlarda `null`'d\u0131r;\nikisi tek bir olgudur: kredisi br\u00fctten d\u00fc\u015f\u00fclm\u00fc\u015f bir d\u00f6k\u00fcm\u00fcn bildirece\u011fi bir matrah\nyoktur, \u00e7\u00fcnk\u00fc KDV net tutar\u0131n tamam\u0131 \u00fczerinden hesaplanm\u0131\u015ft\u0131r. Bu y\u00fczden okuyucu\niki alandan yaln\u0131zca birine bakarak dallanabilir; `credit_basis` alan\u0131 `null` iken\nburada bir tutar bulunan karma bir d\u00f6k\u00fcm \u2014 bug\u00fcn fiyatlanan bir faturan\u0131n eski\nkuralla tahsil edilmi\u015f bir sat\u0131r\u0131 devralmas\u0131 \u2014 hi\u00e7bir zaman g\u00f6nderilmez: b\u00f6yle bir\nmatrah, yan\u0131ndaki `taxes` ile uyu\u015fmazd\u0131.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0630\u064a \u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u064a\u0647 \u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0627\u0644\u0648\u0627\u0631\u062f\u0629 \u0641\u064a `taxes` \u2014 \u0623\u064a `subtotal` \u0645\u0637\u0631\u0648\u062d\u064b\u0627 \u0645\u0646\u0647\n\u062e\u0635\u0645 \u0627\u0644\u0631\u0635\u064a\u062f \u0627\u0644\u0648\u0627\u0631\u062f \u0641\u064a `discount`. \u0648\u064a\u0633\u0627\u0648\u064a `amount` \u0647\u0630\u0627 \u0627\u0644\u0645\u0628\u0644\u063a \u0645\u0636\u0627\u0641\u064b\u0627 \u0625\u0644\u064a\u0647 `taxes`\n\u0628\u0627\u0644\u0636\u0628\u0637 \u0648\u062d\u062a\u0649 \u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0635\u063a\u0631\u0649. \u0648\u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0625\u0646 \u0643\u064f\u062a\u0628 \u0627\u0644\u062a\u0641\u0635\u064a\u0644 \u0627\u0644\u0645\u062e\u0632\u064e\u0651\u0646 \u0642\u0628\u0644 \u0648\u062c\u0648\u062f\n\u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644\u060c \u0623\u0648 \u0625\u0646 \u0644\u0645 \u064a\u064f\u0639\u064e\u062f \u062d\u0633\u0627\u0628 \u0627\u0644\u062f\u0641\u0639\u0629 \u0642\u0637\u061b \u0648\u0644\u0627 \u064a\u064f\u0634\u062a\u0642 \u0634\u064a\u0621 \u0644\u0645\u0644\u0626\u0647.\n\n\u0648\u062a\u0643\u0648\u0646 `null` \u062a\u0645\u0627\u0645\u064b\u0627 \u062d\u064a\u0646 \u062a\u0643\u0648\u0646 `credit_basis` \u0647\u064a `null`\u060c \u0641\u0627\u0644\u062d\u0642\u0644\u0627\u0646 \u0623\u0645\u0631 \u0648\u0627\u062d\u062f: \u0627\u0644\u062a\u0641\u0635\u064a\u0644\n\u0627\u0644\u0630\u064a \u062e\u064f\u0635\u0645 \u0631\u0635\u064a\u062f\u0647 \u0645\u0646 \u0627\u0644\u0625\u062c\u0645\u0627\u0644\u064a \u0644\u064a\u0633 \u0644\u0647 \u0648\u0639\u0627\u0621 \u0636\u0631\u064a\u0628\u064a \u064a\u064f\u0630\u0643\u0631\u060c \u0644\u0623\u0646 \u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u0627\u062d\u062a\u064f\u0633\u0628\u062a \u0639\u0644\u0649 \u0643\u0627\u0645\u0644\n\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a. \u0648\u0644\u0630\u0644\u0643 \u064a\u0645\u0643\u0646 \u0644\u0644\u0642\u0627\u0631\u0626 \u0623\u0646 \u064a\u062a\u0641\u0631\u064e\u0651\u0639 \u0639\u0644\u0649 \u0623\u064a\u0651 \u0645\u0646 \u0627\u0644\u062d\u0642\u0644\u064a\u0646 \u0648\u062d\u062f\u0647\u060c \u0648\u0644\u0646 \u064a\u064f\u0631\u0633\u064e\u0644\n\u0623\u0628\u062f\u064b\u0627 \u062a\u0641\u0635\u064a\u0644 \u0645\u062e\u062a\u0644\u0637 \u062a\u0643\u0648\u0646 \u0641\u064a\u0647 `credit_basis` \u0647\u064a `null` \u0648\u064a\u062d\u0645\u0644 \u0647\u0646\u0627 \u0642\u064a\u0645\u0629 \u2014 \u0623\u064a \u0641\u0627\u062a\u0648\u0631\u0629\n\u0633\u064f\u0639\u0650\u0651\u0631\u062a \u0627\u0644\u064a\u0648\u0645 \u0648\u0627\u0633\u062a\u0648\u0639\u0628\u062a \u0633\u0637\u0631\u064b\u0627 \u062d\u064f\u0635\u0650\u0651\u0644 \u0628\u0627\u0644\u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0642\u062f\u064a\u0645\u0629 \u2014 \u0644\u0623\u0646 \u0630\u0644\u0643 \u0627\u0644\u0648\u0639\u0627\u0621 \u0644\u0646 \u064a\u062a\u0648\u0627\u0641\u0642 \u0645\u0639\n`taxes` \u0627\u0644\u0645\u062c\u0627\u0648\u0631\u0629 \u0644\u0647.\n" } } }, "list_total": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "What this payment's lines cost at CATALOGUE price, before any coupon, partner rate\nor agreed price. `list_total` \u2212 `catalogue_discount` = `subtotal`. `null` on a\nstored breakdown written before the field existed; it is never re-derived from\ntoday's catalogue, which would restate a completed sale.\n", "x-i18n": { "tr": { "description": "Bu \u00f6demedeki sat\u0131rlar\u0131n; kupon, i\u015f orta\u011f\u0131 oran\u0131 veya anla\u015fmal\u0131 fiyat\nuygulanmadan \u00f6nceki KATALOG fiyat\u0131 toplam\u0131. `list_total` \u2212\n`catalogue_discount` = `subtotal`. Saklanan d\u00f6k\u00fcm bu alan var olmadan \u00f6nce\nyaz\u0131lm\u0131\u015fsa `null` olur; tamamlanm\u0131\u015f bir sat\u0131\u015f\u0131 yeniden ifade edece\u011fi i\u00e7in\nbug\u00fcnk\u00fc katalogdan asla yeniden t\u00fcretilmez.\n" }, "ar": { "description": "\u0645\u0627 \u062a\u0628\u0644\u063a\u0647 \u0628\u0646\u0648\u062f \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u0628\u0633\u0639\u0631 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c\u060c \u0642\u0628\u0644 \u0623\u064a \u0642\u0633\u064a\u0645\u0629 \u0623\u0648 \u0646\u0633\u0628\u0629 \u0634\u0631\u064a\u0643 \u0623\u0648 \u0633\u0639\u0631 \u0645\u062a\u0641\u0642\n\u0639\u0644\u064a\u0647. \u0648\u064a\u0643\u0648\u0646 `list_total` \u2212 `catalogue_discount` = `subtotal`. \u0648\u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629\n`null` \u0625\u0646 \u0643\u064f\u062a\u0628 \u0627\u0644\u062a\u0641\u0635\u064a\u0644 \u0627\u0644\u0645\u062e\u0632\u064e\u0651\u0646 \u0642\u0628\u0644 \u0648\u062c\u0648\u062f \u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644\u061b \u0648\u0644\u0627 \u064a\u064f\u0634\u062a\u0642 \u0623\u0628\u062f\u064b\u0627 \u0645\u0646 \u0643\u062a\u0627\u0644\u0648\u062c\n\u0627\u0644\u064a\u0648\u0645\u060c \u0625\u0630 \u0625\u0646 \u0630\u0644\u0643 \u064a\u064f\u0639\u064a\u062f \u062a\u0642\u0631\u064a\u0631 \u0628\u064a\u0639 \u0645\u0643\u062a\u0645\u0644.\n" } } }, "catalogue_discount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "What a coupon, a partner rate or an agreed price took off the catalogue price\nBEFORE the tax base was formed \u2014 reported separately from `discount`, which is the\ncredit iskonto taken off the net afterwards. Same nullability rule as `list_total`.\n", "x-i18n": { "tr": { "description": "Bir kuponun, i\u015f orta\u011f\u0131 oran\u0131n\u0131n veya anla\u015fmal\u0131 fiyat\u0131n, matrah olu\u015fmadan \u00d6NCE\nkatalog fiyat\u0131ndan d\u00fc\u015ft\u00fc\u011f\u00fc tutar \u2014 sonras\u0131nda net tutardan d\u00fc\u015f\u00fclen kredi\niskontosu olan `discount` alan\u0131ndan ayr\u0131 raporlan\u0131r. De\u011ferin null olabilme\nkural\u0131 `list_total` ile ayn\u0131d\u0131r.\n" }, "ar": { "description": "\u0645\u0627 \u062d\u0633\u0645\u062a\u0647 \u0642\u0633\u064a\u0645\u0629 \u0623\u0648 \u0646\u0633\u0628\u0629 \u0634\u0631\u064a\u0643 \u0623\u0648 \u0633\u0639\u0631 \u0645\u062a\u0641\u0642 \u0639\u0644\u064a\u0647 \u0645\u0646 \u0633\u0639\u0631 \u0627\u0644\u0643\u062a\u0627\u0644\u0648\u062c \u0642\u0628\u0644 \u062a\u0643\u0648\u064a\u0646 \u0627\u0644\u0648\u0639\u0627\u0621\n\u0627\u0644\u0636\u0631\u064a\u0628\u064a \u2014 \u0648\u064a\u064f\u0630\u0643\u0631 \u0645\u0646\u0641\u0635\u0644\u064b\u0627 \u0639\u0646 `discount` \u0627\u0644\u0630\u064a \u0647\u0648 \u062e\u0635\u0645 \u0627\u0644\u0631\u0635\u064a\u062f \u0627\u0644\u0645\u0637\u0631\u0648\u062d \u0645\u0646 \u0627\u0644\u0645\u0628\u0644\u063a\n\u0627\u0644\u0635\u0627\u0641\u064a \u0628\u0639\u062f \u0630\u0644\u0643. \u0648\u0642\u0627\u0639\u062f\u0629 \u0642\u0627\u0628\u0644\u064a\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0644\u0623\u0646 \u062a\u0643\u0648\u0646 null \u0647\u064a \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u0645\u0637\u0628\u064e\u0651\u0642\u0629 \u0639\u0644\u0649\n`list_total`.\n" } } }, "refunds": { "type": "array", "items": { "type": "object", "required": [ "id", "subscription_id", "scale_subscription_id", "payment_id", "status", "kind", "destination", "currency", "amount", "amount_usd", "reason", "failure_reason", "failure_count", "created_at", "settled_at" ], "properties": { "id": { "type": "integer", "example": 88 }, "subscription_id": { "type": "integer", "nullable": true, "description": "The subscription this refund ended. `null` on a partial refund, which\nnames its subscription through `scale_subscription_id` instead \u2014 see\n`GET /subscriptions/{id}`.\n", "x-i18n": { "tr": { "description": "Bu iadenin sonland\u0131rd\u0131\u011f\u0131 abonelik. K\u0131smi bir iadede `null` olur; o iade\naboneli\u011fini `scale_subscription_id` \u00fczerinden bildirir \u2014 bkz.\n`GET /subscriptions/{id}`.\n" }, "ar": { "description": "\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u0623\u0646\u0647\u0627\u0647 \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f. \u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 `null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u062c\u0632\u0626\u064a\u060c\n\u0641\u0647\u0648 \u064a\u0630\u0643\u0631 \u0627\u0634\u062a\u0631\u0627\u0643\u0647 \u0639\u0628\u0631 `scale_subscription_id` \u2014 \u0627\u0646\u0638\u0631\n`GET /subscriptions/{id}`.\n" } } }, "scale_subscription_id": { "type": "integer", "nullable": true, "description": "The subscription a downscale produced, when this refund gave back the\nunused part of a period. `null` on a full refund.\n", "x-i18n": { "tr": { "description": "Bu iade, bir d\u00f6nemin kullan\u0131lmam\u0131\u015f k\u0131sm\u0131n\u0131 geri verdi\u011finde, k\u00fc\u00e7\u00fcltmenin\nolu\u015fturdu\u011fu abonelik. Tam iadelerde `null` olur.\n" }, "ar": { "description": "\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u0646\u062a\u062c \u0639\u0646 \u0627\u0644\u062a\u062e\u0641\u064a\u0636\u060c \u062d\u064a\u0646 \u0623\u0639\u0627\u062f \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u062c\u0632\u0621 \u063a\u064a\u0631 \u0627\u0644\u0645\u0633\u062a\u0647\u0644\u0643 \u0645\u0646\n\u0627\u0644\u0641\u062a\u0631\u0629. \u0648\u064a\u0643\u0648\u0646 `null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644.\n" } } }, "payment_id": { "type": "integer", "nullable": true, "description": "See `GET /payments/{id}`.", "x-i18n": { "tr": { "description": "Bkz. `GET /payments/{id}`." }, "ar": { "description": "\u0627\u0646\u0638\u0631 `GET /payments/{id}`." } } }, "status": { "type": "string", "enum": [ "new", "done", "failed", "pending", "unknown" ] }, "kind": { "type": "string", "nullable": true, "description": "`downscale` when this is the partial refund of a resized subscription;\n`consolidated_capture` when it returns a charge that landed on a bill one\npayment for everything the account owed had already absorbed;\n`null` for a full refund that ended the contract.\n", "x-i18n": { "tr": { "description": "Yeniden boyutland\u0131r\u0131lm\u0131\u015f bir aboneli\u011fin k\u0131smi iadesiyse `downscale`;\nhesab\u0131n t\u00fcm borcunu kapsayan tek \u00f6demeye aktar\u0131lm\u0131\u015f bir faturadan yap\u0131lan\n\u00e7ekimin iadesiyse `consolidated_capture`; s\u00f6zle\u015fmeyi sonland\u0131ran tam bir\niadede `null`.\n" }, "ar": { "description": "\u062a\u0643\u0648\u0646 `downscale` \u0625\u0646 \u0643\u0627\u0646 \u0647\u0630\u0627 \u0627\u0633\u062a\u0631\u062f\u0627\u062f\u064b\u0627 \u062c\u0632\u0626\u064a\u064b\u0627 \u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u062c\u0631\u0649 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645\u0647\u060c\n\u0648`consolidated_capture` \u0625\u0646 \u0643\u0627\u0646\u062a \u062a\u064f\u0631\u062c\u0639 \u0645\u0628\u0644\u063a\u064b\u0627 \u062e\u064f\u0635\u0645 \u0645\u0646 \u0641\u0627\u062a\u0648\u0631\u0629 \u0633\u0628\u0642 \u0636\u0645\u0651\u0647\u0627 \u0625\u0644\u0649\n\u062f\u0641\u0639\u0629 \u0648\u0627\u062d\u062f\u0629 \u062a\u063a\u0637\u064a \u0643\u0644 \u0645\u0627 \u0639\u0644\u0649 \u0627\u0644\u062d\u0633\u0627\u0628\u060c \u0648`null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644 \u0627\u0644\u0630\u064a \u0623\u0646\u0647\u0649 \u0627\u0644\u0639\u0642\u062f.\n" } } }, "destination": { "type": "string", "nullable": true, "description": "Where the money went: `card` back to the card that paid, `credit` to the\naccount's balance as a granted credit. `null` on a full refund and on a\ncard attempt that failed \u2014 nothing went anywhere on it.\n", "x-i18n": { "tr": { "description": "Paran\u0131n nereye gitti\u011fi: `card` \u00f6demeyi yapan karta, `credit` hesab\u0131n\nbakiyesine hediye kredi olarak. Tam iadelerde ve ba\u015far\u0131s\u0131z olan bir kart\ndenemesinde `null` olur \u2014 o denemede hi\u00e7bir yere para gitmemi\u015ftir.\n" }, "ar": { "description": "\u0648\u062c\u0647\u0629 \u0627\u0644\u0645\u0627\u0644: `card` \u0625\u0644\u0649 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0627\u0644\u062a\u064a \u062f\u0641\u0639\u062a\u060c \u0648`credit` \u0625\u0644\u0649 \u0631\u0635\u064a\u062f \u0627\u0644\u062d\u0633\u0627\u0628\n\u0643\u0631\u0635\u064a\u062f \u0645\u0645\u0646\u0648\u062d. \u0648\u062a\u0643\u0648\u0646 `null` \u0641\u064a \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644 \u0648\u0641\u064a \u0645\u062d\u0627\u0648\u0644\u0629 \u0628\u0637\u0627\u0642\u0629 \u0641\u0627\u0634\u0644\u0629 \u2014\n\u0625\u0630 \u0644\u0645 \u064a\u0630\u0647\u0628 \u0641\u064a\u0647\u0627 \u0634\u064a\u0621 \u0625\u0644\u0649 \u0623\u064a \u0645\u0643\u0627\u0646.\n" } } }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "description": "The currency `amount` is stated in \u2014 the refunded payment's own.", "x-i18n": { "tr": { "description": "`amount` alan\u0131n\u0131n para birimi \u2014 iade edilen \u00f6demenin kendi para birimi." }, "ar": { "description": "\u0639\u0645\u0644\u0629 \u0627\u0644\u062d\u0642\u0644 `amount` \u2014 \u0648\u0647\u064a \u0639\u0645\u0644\u0629 \u0627\u0644\u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u0631\u062f\u0629 \u0646\u0641\u0633\u0647\u0627." } }, "example": "TRY" }, "amount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "What this refund returns, in `currency` \u2014 the figure the card statement\nshows. `null` when the row states no figure and there is no payment to\nprice it against.\n", "x-i18n": { "tr": { "description": "Bu iadenin geri verdi\u011fi tutar, `currency` cinsinden \u2014 kart ekstresinde\ng\u00f6r\u00fcnen tutar. Sat\u0131r bir tutar bildirmiyorsa ve fiyatlanaca\u011f\u0131 bir \u00f6deme\nyoksa `null` olur.\n" }, "ar": { "description": "\u0645\u0627 \u064a\u0639\u064a\u062f\u0647 \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0628\u0639\u0645\u0644\u0629 `currency` \u2014 \u0648\u0647\u0648 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0630\u064a \u064a\u0638\u0647\u0631 \u0641\u064a \u0643\u0634\u0641\n\u0627\u0644\u0628\u0637\u0627\u0642\u0629. \u0648\u064a\u0643\u0648\u0646 `null` \u0625\u0646 \u0644\u0645 \u064a\u0630\u0643\u0631 \u0627\u0644\u0633\u062c\u0644 \u0645\u0628\u0644\u063a\u064b\u0627 \u0648\u0644\u0645 \u062a\u0648\u062c\u062f \u062f\u0641\u0639\u0629 \u064a\u064f\u0633\u0639\u064e\u0651\u0631 \u0645\u0642\u0627\u0628\u0644\u0647\u0627.\n" } } }, "amount_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The same refund in USD, frozen when it was made. `null` on rows that\npredate the column.\n", "x-i18n": { "tr": { "description": "Ayn\u0131 iadenin, yap\u0131ld\u0131\u011f\u0131 anda dondurulmu\u015f USD tutar\u0131. S\u00fctundan \u00f6nce\nolu\u015fturulmu\u015f sat\u0131rlarda `null` olur.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0646\u0641\u0633\u0647 \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a\u060c \u0645\u062c\u0645\u064e\u0651\u062f\u064b\u0627 \u0644\u062d\u0638\u0629 \u062a\u0646\u0641\u064a\u0630 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f. \u0648\u064a\u0643\u0648\u0646 `null`\n\u0641\u064a \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0633\u0627\u0628\u0642\u0629 \u0644\u0648\u062c\u0648\u062f \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u0648\u062f.\n" } } }, "reason": { "type": "string", "nullable": true, "description": "What this refund was for, as it is printed on the document.", "x-i18n": { "tr": { "description": "Bu iadenin gerek\u00e7esi, belgeye bas\u0131ld\u0131\u011f\u0131 bi\u00e7imiyle." }, "ar": { "description": "\u0633\u0628\u0628 \u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f\u060c \u0643\u0645\u0627 \u064a\u064f\u0637\u0628\u0639 \u0639\u0644\u0649 \u0627\u0644\u0645\u0633\u062a\u0646\u062f." } } }, "failure_reason": { "type": "string", "nullable": true }, "failure_count": { "type": "integer", "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "settled_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When the money actually moved. A partial refund is planned inside the\nresize's own transaction and settled afterwards, so this can be later than\n`created_at`. `null` while it has not settled and on rows that predate the\ncolumn \u2014 never substituted with `created_at`.\n", "x-i18n": { "tr": { "description": "Paran\u0131n ger\u00e7ekten hareket etti\u011fi an. K\u0131smi bir iade, yeniden\nboyutland\u0131rman\u0131n kendi i\u015flemi i\u00e7inde planlan\u0131r ve sonras\u0131nda tamamlan\u0131r;\nbu y\u00fczden bu tarih `created_at`'ten sonra olabilir. Tamamlanmad\u0131k\u00e7a ve\ns\u00fctundan \u00f6nce olu\u015fturulmu\u015f sat\u0131rlarda `null` olur \u2014 yerine asla\n`created_at` konmaz.\n" }, "ar": { "description": "\u0648\u0642\u062a \u0627\u0646\u062a\u0642\u0627\u0644 \u0627\u0644\u0645\u0627\u0644 \u0641\u0639\u0644\u064a\u064b\u0627. \u064a\u064f\u062e\u0637\u064e\u0651\u0637 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u062c\u0632\u0626\u064a \u062f\u0627\u062e\u0644 \u0645\u0639\u0627\u0645\u0644\u0629 \u062a\u063a\u064a\u064a\u0631 \u0627\u0644\u062d\u062c\u0645\n\u0646\u0641\u0633\u0647\u0627 \u0648\u064a\u064f\u0633\u0648\u064e\u0651\u0649 \u0628\u0639\u062f\u0647\u0627\u060c \u0648\u0644\u0630\u0644\u0643 \u0642\u062f \u064a\u0643\u0648\u0646 \u0647\u0630\u0627 \u0627\u0644\u062a\u0627\u0631\u064a\u062e \u0644\u0627\u062d\u0642\u064b\u0627 \u0644\u0640 `created_at`.\n\u0648\u064a\u0643\u0648\u0646 `null` \u0645\u0627 \u0644\u0645 \u064a\u064f\u0633\u0648\u064e\u0651 \u0648\u0641\u064a \u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0633\u0627\u0628\u0642\u0629 \u0644\u0648\u062c\u0648\u062f \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u0648\u062f \u2014 \u0648\u0644\u0627\n\u064a\u064f\u0633\u062a\u0628\u062f\u064e\u0644 \u0628\u0647\u0627 `created_at` \u0623\u0628\u062f\u064b\u0627.\n" } } } } }, "description": "Every refund taken against this payment, oldest first, whatever its state \u2014\nread each one's `status` to see which landed. A downscale returns the unused\npart of a period without ending the sale, so a payment carrying refunds stays\n`paid`: this list is the only signal that money came back.\n", "x-i18n": { "tr": { "description": "Bu \u00f6demeye kar\u015f\u0131 yap\u0131lan her iade, en eskisi \u00f6nce, durumu ne olursa olsun \u2014\nhangisinin ger\u00e7ekle\u015fti\u011fini g\u00f6rmek i\u00e7in her birinin `status` alan\u0131n\u0131 okuyun.\nBir k\u00fc\u00e7\u00fcltme, sat\u0131\u015f\u0131 sonland\u0131rmadan d\u00f6nemin kullan\u0131lmam\u0131\u015f k\u0131sm\u0131n\u0131 geri verir;\nbu y\u00fczden iade ta\u015f\u0131yan bir \u00f6deme `paid` kal\u0131r: paran\u0131n geri geldi\u011fine dair\ntek i\u015faret bu listedir.\n" }, "ar": { "description": "\u0643\u0644 \u0627\u0633\u062a\u0631\u062f\u0627\u062f \u062c\u0631\u0649 \u0639\u0644\u0649 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629\u060c \u0645\u0646 \u0627\u0644\u0623\u0642\u062f\u0645 \u0625\u0644\u0649 \u0627\u0644\u0623\u062d\u062f\u062b\u060c \u0623\u064a\u064b\u0651\u0627 \u0643\u0627\u0646\u062a \u062d\u0627\u0644\u062a\u0647 \u2014 \u0627\u0642\u0631\u0623\n\u0627\u0644\u062d\u0642\u0644 `status` \u0644\u0643\u0644 \u0645\u0646\u0647\u0627 \u0644\u062a\u0639\u0631\u0641 \u0623\u064a\u0647\u0627 \u062a\u0645 \u0641\u0639\u0644\u064b\u0627. \u0641\u0627\u0644\u062a\u062e\u0641\u064a\u0636 \u064a\u0639\u064a\u062f \u0627\u0644\u062c\u0632\u0621 \u063a\u064a\u0631 \u0627\u0644\u0645\u0633\u062a\u0647\u0644\u0643\n\u0645\u0646 \u0627\u0644\u0641\u062a\u0631\u0629 \u062f\u0648\u0646 \u0623\u0646 \u064a\u0646\u0647\u064a \u0627\u0644\u0628\u064a\u0639\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u0628\u0642\u0649 \u0627\u0644\u062f\u0641\u0639\u0629 \u0627\u0644\u062a\u064a \u062a\u062d\u0645\u0644 \u0627\u0633\u062a\u0631\u062f\u0627\u062f\u0627\u062a `paid`:\n\u0648\u0647\u0630\u0647 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0647\u064a \u0627\u0644\u0625\u0634\u0627\u0631\u0629 \u0627\u0644\u0648\u062d\u064a\u062f\u0629 \u0625\u0644\u0649 \u0623\u0646 \u0627\u0644\u0645\u0627\u0644 \u0642\u062f \u0639\u0627\u062f.\n" } } }, "refunded_total": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "What went back to the CARD, in `currency`, counting settled refunds only.\n`0` on the overwhelming majority of payments.\n", "x-i18n": { "tr": { "description": "`currency` cinsinden KARTA geri d\u00f6nen tutar; yaln\u0131zca tamamlanm\u0131\u015f iadeleri\nsayar. \u00d6demelerin b\u00fcy\u00fck \u00e7o\u011funlu\u011funda `0` olur.\n" }, "ar": { "description": "\u0645\u0627 \u0639\u0627\u062f \u0625\u0644\u0649 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0628\u0639\u0645\u0644\u0629 `currency`\u060c \u0645\u062d\u0633\u0648\u0628\u064b\u0627 \u0645\u0646 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f\u0627\u062a \u0627\u0644\u0645\u0643\u062a\u0645\u0644\u0629 \u0648\u062d\u062f\u0647\u0627.\n\u0648\u064a\u0643\u0648\u0646 `0` \u0641\u064a \u0627\u0644\u063a\u0627\u0644\u0628\u064a\u0629 \u0627\u0644\u0639\u0638\u0645\u0649 \u0645\u0646 \u0627\u0644\u062f\u0641\u0639\u0627\u062a.\n" } } }, "refunded_credit_total": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "What went back as account CREDIT, in `currency`. Stated beside the charge and\nnever subtracted from it \u2014 see `net_after_refunds`.\n", "x-i18n": { "tr": { "description": "`currency` cinsinden hesap KRED\u0130S\u0130 olarak geri d\u00f6nen tutar. Tahsilat\u0131n yan\u0131nda\nbelirtilir, ondan asla d\u00fc\u015f\u00fclmez \u2014 bkz. `net_after_refunds`.\n" }, "ar": { "description": "\u0645\u0627 \u0639\u0627\u062f \u0631\u0635\u064a\u062f\u064b\u0627 \u0641\u064a \u0627\u0644\u062d\u0633\u0627\u0628 \u0628\u0639\u0645\u0644\u0629 `currency`. \u064a\u064f\u0630\u0643\u0631 \u0625\u0644\u0649 \u062c\u0627\u0646\u0628 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0645\u062d\u0635\u064e\u0651\u0644 \u0648\u0644\u0627\n\u064a\u064f\u0637\u0631\u062d \u0645\u0646\u0647 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0627\u0646\u0638\u0631 `net_after_refunds`.\n" } } }, "net_after_refunds": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "`amount` less `refunded_total` \u2014 what the card is still out. Account credit is\nnot subtracted. `null` whenever `amount` is `null`, for the same reason.\n", "x-i18n": { "tr": { "description": "`amount` eksi `refunded_total` \u2014 kart\u0131n h\u00e2l\u00e2 \u00f6demi\u015f oldu\u011fu tutar. Hesap kredisi\nd\u00fc\u015f\u00fclmez. `amount` `null` oldu\u011funda, ayn\u0131 gerek\u00e7eyle bu da `null` olur.\n" }, "ar": { "description": "`amount` \u0646\u0627\u0642\u0635 `refunded_total` \u2014 \u0623\u064a \u0645\u0627 \u062f\u0641\u0639\u062a\u0647 \u0627\u0644\u0628\u0637\u0627\u0642\u0629 \u0648\u0644\u0645 \u064a\u0639\u062f. \u0648\u0644\u0627 \u064a\u064f\u0637\u0631\u062d \u0631\u0635\u064a\u062f\n\u0627\u0644\u062d\u0633\u0627\u0628. \u0648\u064a\u0643\u0648\u0646 `null` \u0643\u0644\u0645\u0627 \u0643\u0627\u0646 `amount` \u0628\u0642\u064a\u0645\u0629 `null`\u060c \u0644\u0644\u0633\u0628\u0628 \u0646\u0641\u0633\u0647.\n" } } }, "settled_by_payment_id": { "type": "integer", "nullable": true, "description": "The payment that ABSORBED this bill, or `null` for every ordinary row. A customer\nwho settles everything the account owes in one go gets a single dues payment\n(`is_dues`), and each covered bill is pointed at it here and marked\n`is_superseded`; its own `status` stays `new` and its `amount` stays frozen at\nwhat it was. A client summing what is outstanding must skip a row that carries\nthis, or it counts the same debt twice \u2014 once on the bill and once on the dues\npayment that already covers it.\n", "x-i18n": { "tr": { "description": "Bu faturay\u0131 DEVRALAN \u00f6deme; s\u0131radan her sat\u0131rda `null` olur. Hesab\u0131n borcunun\ntamam\u0131n\u0131 tek seferde kapatan bir m\u00fc\u015fteri i\u00e7in tek bir toplu bor\u00e7 \u00f6demesi\nolu\u015fturulur (`is_dues`) ve kapsanan her fatura burada ona ba\u011flan\u0131p\n`is_superseded` olarak i\u015faretlenir; faturan\u0131n kendi `status` de\u011feri `new`\nkal\u0131r, `amount` de\u011feri de donmu\u015f h\u00e2liyle durur. \u00d6denmemi\u015f borcu toplayan bir\nistemci, bu alan\u0131 ta\u015f\u0131yan sat\u0131r\u0131 atlamal\u0131d\u0131r; aksi h\u00e2lde ayn\u0131 borcu iki kez \u2014\nbir faturada, bir de onu zaten kapsayan toplu bor\u00e7 \u00f6demesinde \u2014 sayar.\n" }, "ar": { "description": "\u0627\u0644\u062f\u0641\u0639\u0629 \u0627\u0644\u062a\u064a \u0636\u0645\u0651\u062a \u0647\u0630\u0647 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629\u060c \u0648\u062a\u0643\u0648\u0646 `null` \u0641\u064a \u0643\u0644 \u0633\u0637\u0631 \u0639\u0627\u062f\u064a. \u0641\u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u064a\u0633\u062f\u0651\u062f\n\u0643\u0644 \u0645\u0627 \u0639\u0644\u0649 \u0627\u0644\u062d\u0633\u0627\u0628 \u062f\u0641\u0639\u0629\u064b \u0648\u0627\u062d\u062f\u0629 \u062a\u064f\u0646\u0634\u0623 \u0644\u0647 \u062f\u0641\u0639\u0629 \u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0645\u062c\u0645\u0651\u0639\u0629 \u0648\u0627\u062d\u062f\u0629 (`is_dues`)\u060c\n\u0648\u062a\u064f\u0631\u0628\u0637 \u0628\u0647\u0627 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0634\u0645\u0648\u0644\u0629 \u0647\u0646\u0627 \u0648\u062a\u064f\u0639\u0644\u064e\u0651\u0645 \u0628\u0640 `is_superseded`\u061b \u0648\u064a\u0628\u0642\u0649 `status`\n\u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 `new` \u0648\u064a\u0628\u0642\u0649 `amount` \u0645\u062c\u0645\u0651\u062f\u064b\u0627 \u0643\u0645\u0627 \u0643\u0627\u0646. \u0648\u0639\u0644\u0649 \u0623\u064a \u0639\u0645\u064a\u0644 \u064a\u062c\u0645\u0639\n\u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0651\u0627\u062a \u0623\u0646 \u064a\u062a\u062e\u0637\u0651\u0649 \u0627\u0644\u0633\u0637\u0631 \u0627\u0644\u0630\u064a \u064a\u062d\u0645\u0644 \u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644\u060c \u0648\u0625\u0644\u0627 \u062d\u064e\u0633\u064e\u0628\u064e \u0627\u0644\u062f\u064a\u0646 \u0646\u0641\u0633\u0647 \u0645\u0631\u062a\u064a\u0646 \u2014\n\u0645\u0631\u0629 \u0639\u0644\u0649 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0648\u0645\u0631\u0629 \u0639\u0644\u0649 \u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0627\u0644\u062a\u064a \u062a\u063a\u0637\u0651\u064a\u0647\u0627 \u0623\u0635\u0644\u064b\u0627.\n" } } }, "is_dues": { "type": "boolean", "description": "This payment IS the consolidation \u2014 one payable covering every open bill the\naccount had when the customer chose to settle them together. The bills it covers\nare the rows whose `settled_by_payment_id` is this payment's `id`. Late-payment\ninterest is never charged on this row itself: it is charged on each covered bill,\non that bill's own clock.\n", "x-i18n": { "tr": { "description": "Bu \u00f6deme, toplu bor\u00e7 \u00f6demesinin kendisidir \u2014 m\u00fc\u015fteri hepsini birlikte kapatmay\u0131\nse\u00e7ti\u011finde hesab\u0131n a\u00e7\u0131k olan b\u00fct\u00fcn faturalar\u0131n\u0131 tek bir \u00f6denecek tutarda\ntoplar. Kapsad\u0131\u011f\u0131 faturalar, `settled_by_payment_id` de\u011feri bu \u00f6demenin `id`\nde\u011feri olan sat\u0131rlard\u0131r. Temerr\u00fct faizi bu sat\u0131r\u0131n kendisine hi\u00e7bir zaman\ni\u015fletilmez; her kapsanan faturaya, o faturan\u0131n kendi s\u00fcresi \u00fczerinden i\u015fletilir.\n" }, "ar": { "description": "\u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u0647\u064a \u0627\u0644\u062a\u062c\u0645\u064a\u0639 \u0646\u0641\u0633\u0647 \u2014 \u0645\u0628\u0644\u063a \u0648\u0627\u062d\u062f \u0645\u0633\u062a\u062d\u0642 \u064a\u063a\u0637\u0651\u064a \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0641\u062a\u0648\u062d\u0629 \u0643\u0627\u0646\u062a \u0639\u0644\u0649\n\u0627\u0644\u062d\u0633\u0627\u0628 \u062d\u064a\u0646 \u0627\u062e\u062a\u0627\u0631 \u0627\u0644\u0639\u0645\u064a\u0644 \u062a\u0633\u062f\u064a\u062f\u0647\u0627 \u0645\u0639\u064b\u0627. \u0648\u0627\u0644\u0641\u0648\u0627\u062a\u064a\u0631 \u0627\u0644\u062a\u064a \u062a\u063a\u0637\u0651\u064a\u0647\u0627 \u0647\u064a \u0627\u0644\u0633\u0637\u0648\u0631 \u0627\u0644\u062a\u064a\n\u064a\u0633\u0627\u0648\u064a \u0641\u064a\u0647\u0627 `settled_by_payment_id` \u0642\u064a\u0645\u0629 `id` \u0644\u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629. \u0648\u0644\u0627 \u062a\u064f\u062d\u062a\u0633\u0628 \u0641\u0627\u0626\u062f\u0629\n\u0627\u0644\u062a\u0623\u062e\u064a\u0631 \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0633\u0637\u0631 \u0625\u0637\u0644\u0627\u0642\u064b\u0627\u060c \u0628\u0644 \u0639\u0644\u0649 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0634\u0645\u0648\u0644\u0629 \u0648\u0641\u0642 \u0645\u062f\u0651\u062a\u0647\u0627 \u0647\u064a.\n" } } }, "covered_interest": { "type": "object", "nullable": true, "description": "WHAT SETTLING THIS DUES PAYMENT WILL CHARGE IN LATE-PAYMENT INTEREST, published\nbefore it is charged. `null` on every payment that is not a dues payment, and on a\ndues payment once it is settled or cancelled \u2014 by then the figures have been charged\nas interest payments of their own and appear in the list like any other payment.\n\nA dues payment carries no interest of its own \u2014 see `is_dues` \u2014 but paying it raises\none further payment per covered bill, each on that bill's own clock. Without this\nfield a client saw the dues payment, saw every absorbed bill still at `status: new`,\nand had no way to learn that settling it would produce more charges; the interest\npayments simply appeared afterwards.\n", "x-i18n": { "tr": { "description": "BU TOPLU BOR\u00c7 \u00d6DEMES\u0130 KAPATILDI\u011eINDA \u0130\u015eLET\u0130LECEK TEMERR\u00dcT FA\u0130Z\u0130, hen\u00fcz tahsil\nedilmeden \u00f6nce yay\u0131mlan\u0131r. Toplu bor\u00e7 \u00f6demesi olmayan her \u00f6demede ve toplu bor\u00e7\n\u00f6demesi kapat\u0131ld\u0131\u011f\u0131nda ya da iptal edildi\u011finde `null` olur \u2014 o noktada tutarlar\nkendi faiz \u00f6demeleri olarak tahsil edilmi\u015f ve listede yerini alm\u0131\u015ft\u0131r.\n\nToplu bor\u00e7 \u00f6demesinin kendi faizi yoktur \u2014 bkz. `is_dues` \u2014 ancak kapat\u0131ld\u0131\u011f\u0131nda\nkapsad\u0131\u011f\u0131 her fatura i\u00e7in, o faturan\u0131n kendi s\u00fcresi \u00fczerinden ayr\u0131 bir \u00f6deme\nolu\u015fturulur. Bu alan olmadan istemci yaln\u0131zca toplu bor\u00e7 \u00f6demesini ve h\u00e2l\u00e2\n`status: new` g\u00f6r\u00fcnen faturalar\u0131 g\u00f6r\u00fcyor, kapatman\u0131n yeni tutarlar do\u011furaca\u011f\u0131n\u0131\nhi\u00e7bir yerden \u00f6\u011frenemiyordu; faiz \u00f6demeleri sonradan ortaya \u00e7\u0131k\u0131yordu.\n" }, "ar": { "description": "\u0645\u0627 \u0633\u062a\u064f\u062d\u0645\u0651\u0644\u0647 \u062a\u0633\u0648\u064a\u0629 \u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0647\u0630\u0647 \u0645\u0646 \u0641\u0627\u0626\u062f\u0629 \u062a\u0623\u062e\u064a\u0631\u060c \u0645\u0646\u0634\u0648\u0631\u064b\u0627 \u0642\u0628\u0644 \u062a\u062d\u0635\u064a\u0644\u0647. \u0648\u064a\u0643\u0648\u0646\n`null` \u0641\u064a \u0643\u0644 \u062f\u0641\u0639\u0629 \u0644\u064a\u0633\u062a \u062f\u0641\u0639\u0629 \u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0645\u062c\u0645\u0651\u0639\u0629\u060c \u0648\u0643\u0630\u0644\u0643 \u0641\u064a \u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0628\u0639\u062f \u062a\u0633\u0648\u064a\u062a\u0647\u0627 \u0623\u0648\n\u0625\u0644\u063a\u0627\u0626\u0647\u0627 \u2014 \u0641\u0639\u0646\u062f\u0626\u0630\u064d \u062a\u0643\u0648\u0646 \u0627\u0644\u0645\u0628\u0627\u0644\u063a \u0642\u062f \u062d\u064f\u0635\u0650\u0651\u0644\u062a \u0643\u062f\u0641\u0639\u0627\u062a \u0641\u0627\u0626\u062f\u0629 \u0645\u0633\u062a\u0642\u0644\u0629 \u0648\u0638\u0647\u0631\u062a \u0641\u064a \u0627\u0644\u0642\u0627\u0626\u0645\u0629.\n\n\u0644\u0627 \u062a\u062d\u0645\u0644 \u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0641\u0627\u0626\u062f\u0629 \u062e\u0627\u0635\u0629 \u0628\u0647\u0627 \u2014 \u0627\u0646\u0638\u0631 `is_dues` \u2014 \u0644\u0643\u0646 \u062a\u0633\u062f\u064a\u062f\u0647\u0627 \u064a\u0646\u0634\u0626 \u062f\u0641\u0639\u0629\n\u0625\u0636\u0627\u0641\u064a\u0629 \u0639\u0646 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0634\u0645\u0648\u0644\u0629\u060c \u0648\u0641\u0642 \u0645\u062f\u0651\u0629 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0647\u064a. \u0648\u0628\u062f\u0648\u0646 \u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644 \u0643\u0627\u0646 \u0627\u0644\u0639\u0645\u064a\u0644\n\u064a\u0631\u0649 \u062f\u0641\u0639\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0648\u064a\u0631\u0649 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0636\u0645\u0648\u0645\u0629 \u0628\u0642\u064a\u0645\u0629 `status: new` \u062f\u0648\u0646 \u0623\u064a \u0633\u0628\u064a\u0644 \u0644\u0645\u0639\u0631\u0641\u0629\n\u0623\u0646 \u0627\u0644\u062a\u0633\u0648\u064a\u0629 \u0633\u062a\u064f\u0646\u0634\u0626 \u0645\u0628\u0627\u0644\u063a \u0623\u062e\u0631\u0649\u061b \u0641\u0643\u0627\u0646\u062a \u062f\u0641\u0639\u0627\u062a \u0627\u0644\u0641\u0627\u0626\u062f\u0629 \u062a\u0638\u0647\u0631 \u0628\u0639\u062f \u0630\u0644\u0643 \u0641\u062c\u0623\u0629.\n" } }, "required": [ "lines", "total", "total_usd" ], "properties": { "lines": { "type": "array", "description": "One entry per covered bill the interest meter answers on, oldest first \u2014 a 0.00\naccrual is listed too. Entries that will NOT be charged are listed as well \u2014 read\n`payable`.\n", "x-i18n": { "tr": { "description": "Faiz sayac\u0131n\u0131n yan\u0131t verdi\u011fi her kapsanan fatura i\u00e7in bir sat\u0131r; en eski \u00f6nce\n\u2014 0,00 tutarl\u0131 bir sat\u0131r da listelenir. Tahsil ED\u0130LMEYECEK sat\u0131rlar da\nlistelenir \u2014 `payable` alan\u0131n\u0131 okuyun.\n" }, "ar": { "description": "\u0633\u0637\u0631 \u0648\u0627\u062d\u062f \u0639\u0646 \u0643\u0644 \u0641\u0627\u062a\u0648\u0631\u0629 \u0645\u0634\u0645\u0648\u0644\u0629 \u064a\u062c\u064a\u0628 \u0639\u0646\u0647\u0627 \u0639\u062f\u0651\u0627\u062f \u0627\u0644\u0641\u0627\u0626\u062f\u0629\u060c \u0645\u0646 \u0627\u0644\u0623\u0642\u062f\u0645 \u0625\u0644\u0649 \u0627\u0644\u0623\u062d\u062f\u062b \u2014\n\u0648\u064a\u064f\u062f\u0631\u064e\u062c \u0627\u0644\u0633\u0637\u0631 \u062d\u062a\u0649 \u0644\u0648 \u0643\u0627\u0646 \u0645\u0628\u0644\u063a\u0647 0.00. \u0648\u0627\u0644\u0633\u0637\u0648\u0631 \u0627\u0644\u062a\u064a \u0644\u0646 \u062a\u064f\u062d\u0635\u064e\u0651\u0644 \u0645\u062f\u0631\u062c\u0629 \u0623\u064a\u0636\u064b\u0627 \u2014 \u0627\u0642\u0631\u0623 `payable`.\n" } }, "items": { "type": "object", "required": [ "payment_id", "due_at", "days", "amount", "amount_usd", "accrued", "accrued_usd", "payable", "waived", "below_floor" ], "properties": { "payment_id": { "type": "integer", "description": "The covered bill this interest is charged on (`GET /payments/{id}`).", "x-i18n": { "tr": { "description": "Bu faizin i\u015fletildi\u011fi kapsanan fatura (`GET /payments/{id}`)." }, "ar": { "description": "\u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0627\u0644\u0645\u0634\u0645\u0648\u0644\u0629 \u0627\u0644\u062a\u064a \u062a\u064f\u062d\u062a\u0633\u0628 \u0639\u0644\u064a\u0647\u0627 \u0647\u0630\u0647 \u0627\u0644\u0641\u0627\u0626\u062f\u0629 (`GET /payments/{id}`)." } } }, "due_at": { "type": "string", "format": "date-time", "description": "When that bill fell due \u2014 the anchor its own meter runs from, which is why\ntwo bills on one dues payment owe different amounts.\n", "x-i18n": { "tr": { "description": "O faturan\u0131n vadesi \u2014 kendi sayac\u0131n\u0131n ba\u015flad\u0131\u011f\u0131 an; ayn\u0131 toplu bor\u00e7\n\u00f6demesindeki iki faturan\u0131n farkl\u0131 tutarlar bor\u00e7lanmas\u0131n\u0131n sebebi budur.\n" }, "ar": { "description": "\u0645\u0648\u0639\u062f \u0627\u0633\u062a\u062d\u0642\u0627\u0642 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u2014 \u0646\u0642\u0637\u0629 \u0628\u062f\u0621 \u0639\u062f\u0651\u0627\u062f\u0647\u0627 \u0627\u0644\u062e\u0627\u0635\u060c \u0648\u0647\u0648 \u0633\u0628\u0628 \u0627\u062e\u062a\u0644\u0627\u0641\n\u0627\u0644\u0645\u0628\u0627\u0644\u063a \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0629 \u0639\u0644\u0649 \u0641\u0627\u062a\u0648\u0631\u062a\u064a\u0646 \u0636\u0645\u0646 \u062f\u0641\u0639\u0629 \u0645\u0633\u062a\u062d\u0642\u0627\u062a \u0648\u0627\u062d\u062f\u0629.\n" } } }, "days": { "type": "number", "format": "float", "description": "Credited days late, fractional \u2014 after any suspended window and any\nprovider outage have been taken off.\n", "x-i18n": { "tr": { "description": "Gecikmenin say\u0131lan g\u00fcn say\u0131s\u0131 (kesirli) \u2014 ask\u0131ya al\u0131nm\u0131\u015f s\u00fcre ve\nsa\u011flay\u0131c\u0131 kaynakl\u0131 kesinti d\u00fc\u015f\u00fcld\u00fckten sonra.\n" }, "ar": { "description": "\u0623\u064a\u0627\u0645 \u0627\u0644\u062a\u0623\u062e\u064a\u0631 \u0627\u0644\u0645\u062d\u062a\u0633\u0628\u0629\u060c \u0628\u0643\u0633\u0648\u0631\u0647\u0627 \u2014 \u0628\u0639\u062f \u062e\u0635\u0645 \u0623\u064a \u0641\u062a\u0631\u0629 \u062a\u0639\u0644\u064a\u0642 \u0648\u0623\u064a \u0627\u0646\u0642\u0637\u0627\u0639 \u0645\u0646\n\u062c\u0647\u0629 \u0627\u0644\u0645\u0632\u0648\u0651\u062f.\n" } } }, "amount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "What settling will CHARGE for that bill, in that bill's own currency: the\naccrued interest with 20% KDV carved out of it (net + KDV is exactly this\nfigure), snapped down one kuru\u015f when the accrual cannot hold an exact\nsplit. It is `accrued` or one kuru\u015f less, never more, and it is what the\nminted interest payment carries and what `total` sums.\n", "x-i18n": { "tr": { "description": "\u00d6deme ger\u00e7ekle\u015fti\u011finde o fatura i\u00e7in TAHS\u0130L ED\u0130LECEK tutar, faturan\u0131n\nkendi para biriminde: i\u015fleyen faizin i\u00e7inden %20 KDV ayr\u0131l\u0131r (matrah +\nKDV tam olarak bu tutard\u0131r); faiz tam b\u00f6l\u00fcnemiyorsa bir kuru\u015f a\u015fa\u011f\u0131\nyuvarlan\u0131r. `accrued` tutar\u0131na e\u015fittir ya da ondan bir kuru\u015f azd\u0131r,\nasla fazla de\u011fildir; olu\u015fturulan faiz \u00f6demesi bu tutar\u0131 ta\u015f\u0131r ve\n`total` bunlar\u0131 toplar.\n" }, "ar": { "description": "\u0645\u0627 \u0633\u064a\u064f\u062d\u0635\u064e\u0651\u0644 \u0639\u0646 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0639\u0646\u062f \u0627\u0644\u062a\u0633\u0648\u064a\u0629\u060c \u0628\u0639\u0645\u0644\u0629 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0646\u0641\u0633\u0647\u0627: \u0627\u0644\u0641\u0627\u0626\u062f\u0629\n\u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0629 \u0648\u0642\u062f \u0627\u0642\u062a\u064f\u0637\u0639\u062a \u0645\u0646\u0647\u0627 \u0636\u0631\u064a\u0628\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0645\u0636\u0627\u0641\u0629 \u0628\u0646\u0633\u0628\u0629 20% (\u0627\u0644\u0635\u0627\u0641\u064a \u0645\u0639\n\u0627\u0644\u0636\u0631\u064a\u0628\u0629 \u064a\u0633\u0627\u0648\u064a \u0647\u0630\u0627 \u0627\u0644\u0645\u0628\u0644\u063a \u062a\u0645\u0627\u0645\u064b\u0627)\u060c \u0645\u0639 \u062a\u0642\u0631\u064a\u0628\u0647 \u0642\u0631\u0634\u064b\u0627 \u0648\u0627\u062d\u062f\u064b\u0627 \u0625\u0644\u0649 \u0627\u0644\u0623\u0633\u0641\u0644 \u0625\u0630\u0627\n\u062a\u0639\u0630\u0651\u0631 \u062a\u0642\u0633\u064a\u0645\u0647 \u062a\u0642\u0633\u064a\u0645\u064b\u0627 \u062f\u0642\u064a\u0642\u064b\u0627. \u064a\u0633\u0627\u0648\u064a `accrued` \u0623\u0648 \u064a\u0642\u0644\u0651 \u0639\u0646\u0647 \u0628\u0642\u0631\u0634 \u0648\u0627\u062d\u062f \u0648\u0644\u0627\n\u064a\u0632\u064a\u062f \u0639\u0644\u064a\u0647 \u0623\u0628\u062f\u064b\u0627\u060c \u0648\u0647\u0648 \u0645\u0627 \u062a\u062d\u0645\u0644\u0647 \u062f\u0641\u0639\u0629 \u0627\u0644\u0641\u0627\u0626\u062f\u0629 \u0627\u0644\u0645\u064f\u0646\u0634\u0623\u0629 \u0648\u0645\u0627 \u064a\u062c\u0645\u0639\u0647 `total`.\n" } } }, "amount_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "The charge in USD: `accrued_usd` carved and snapped the same way. The USD\nfigure is taken back through the rate already frozen on that bill \u2014 never a\nfresh conversion.\n", "x-i18n": { "tr": { "description": "Tahsil edilecek tutar\u0131n USD kar\u015f\u0131l\u0131\u011f\u0131: `accrued_usd` ayn\u0131 \u015fekilde\nayr\u0131l\u0131p yuvarlan\u0131r. USD tutar\u0131 faturada zaten donmu\u015f olan kur \u00fczerinden\nhesaplan\u0131r, g\u00fcncel kurla de\u011fil.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0645\u064f\u062d\u0635\u064e\u0651\u0644 \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631: `accrued_usd` \u0628\u0639\u062f \u0627\u0644\u0627\u0642\u062a\u0637\u0627\u0639 \u0648\u0627\u0644\u062a\u0642\u0631\u064a\u0628 \u0628\u0627\u0644\u0637\u0631\u064a\u0642\u0629\n\u0646\u0641\u0633\u0647\u0627\u060c \u0645\u062d\u0633\u0648\u0628\u064b\u0627 \u0628\u0633\u0639\u0631 \u0627\u0644\u0635\u0631\u0641 \u0627\u0644\u0645\u062c\u0645\u064e\u0651\u062f \u0639\u0644\u0649 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0644\u0627 \u0628\u0633\u0639\u0631 \u062c\u062f\u064a\u062f.\n" } } }, "accrued": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "The interest that ACCRUED on that bill under the contract, in that bill's\nown currency \u2014 the legal figure before KDV is carved out of it. `amount`\nis what is charged for it.\n", "x-i18n": { "tr": { "description": "S\u00f6zle\u015fmeye g\u00f6re o faturaya \u0130\u015eLEYEN faiz, faturan\u0131n kendi para\nbiriminde \u2014 KDV ayr\u0131lmadan \u00f6nceki yasal tutar. Bunun i\u00e7in tahsil\nedilen tutar `amount` alan\u0131ndad\u0131r.\n" }, "ar": { "description": "\u0627\u0644\u0641\u0627\u0626\u062f\u0629 \u0627\u0644\u062a\u064a \u0627\u0633\u062a\u062d\u0642\u062a \u0639\u0644\u0649 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0628\u0645\u0648\u062c\u0628 \u0627\u0644\u0639\u0642\u062f\u060c \u0628\u0639\u0645\u0644\u0629 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0646\u0641\u0633\u0647\u0627 \u2014\n\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0642\u0627\u0646\u0648\u0646\u064a \u0642\u0628\u0644 \u0627\u0642\u062a\u0637\u0627\u0639 \u0636\u0631\u064a\u0628\u0629 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0645\u0636\u0627\u0641\u0629 \u0645\u0646\u0647. \u0623\u0645\u0627 \u0645\u0627 \u064a\u064f\u062d\u0635\u064e\u0651\u0644 \u0639\u0646\u0647\n\u0641\u0647\u0648 `amount`.\n" } } }, "accrued_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "The accrued interest in USD, back through the rate already frozen on that\nbill \u2014 never a fresh conversion. This is what the de-minimis floor is\ntested against.\n", "x-i18n": { "tr": { "description": "\u0130\u015fleyen faizin USD kar\u015f\u0131l\u0131\u011f\u0131; faturada zaten donmu\u015f olan kur \u00fczerinden\nhesaplan\u0131r, g\u00fcncel kurla de\u011fil. Asgari tahsil e\u015fi\u011fi bu tutara bakar.\n" }, "ar": { "description": "\u0627\u0644\u0641\u0627\u0626\u062f\u0629 \u0627\u0644\u0645\u0633\u062a\u062d\u0642\u0629 \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631\u060c \u0645\u062d\u0633\u0648\u0628\u0629 \u0628\u0633\u0639\u0631 \u0627\u0644\u0635\u0631\u0641 \u0627\u0644\u0645\u062c\u0645\u064e\u0651\u062f \u0639\u0644\u0649 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0644\u0627\n\u0628\u0633\u0639\u0631 \u062c\u062f\u064a\u062f. \u0648\u0647\u0630\u0627 \u0647\u0648 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0630\u064a \u064a\u064f\u0642\u0627\u0633 \u0639\u0644\u064a\u0647 \u0627\u0644\u062d\u062f \u0627\u0644\u0623\u062f\u0646\u0649 \u0644\u0644\u062a\u062d\u0635\u064a\u0644.\n" } } }, "payable": { "type": "boolean", "description": "Whether this line will actually be charged. `false` for a waived accrual\nand for one below the minimum charge; both are still listed, because a\nreal figure about a real debt is never dropped in silence.\n", "x-i18n": { "tr": { "description": "Bu sat\u0131r\u0131n ger\u00e7ekten tahsil edilip edilmeyece\u011fi. Faizi silinmi\u015f ya da\nasgari tutar\u0131n alt\u0131nda kalan sat\u0131rlarda `false` olur; yine de\nlistelenirler, \u00e7\u00fcnk\u00fc ger\u00e7ek bir borca ait ger\u00e7ek bir tutar sessizce\nat\u0131lmaz.\n" }, "ar": { "description": "\u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646 \u0647\u0630\u0627 \u0627\u0644\u0633\u0637\u0631 \u0633\u064a\u064f\u062d\u0635\u064e\u0651\u0644 \u0641\u0639\u0644\u064b\u0627. \u064a\u0643\u0648\u0646 `false` \u0644\u0644\u0641\u0627\u0626\u062f\u0629 \u0627\u0644\u0645\u064f\u0633\u0642\u0637\u0629\n\u0648\u0644\u0644\u0645\u0628\u0644\u063a \u062f\u0648\u0646 \u0627\u0644\u062d\u062f \u0627\u0644\u0623\u062f\u0646\u0649\u061b \u0648\u0645\u0639 \u0630\u0644\u0643 \u064a\u064f\u062f\u0631\u062c \u0627\u0644\u0633\u0637\u0631\u0627\u0646\u060c \u0644\u0623\u0646 \u0645\u0628\u0644\u063a\u064b\u0627 \u062d\u0642\u064a\u0642\u064a\u064b\u0627 \u0639\u0646\n\u062f\u064a\u0646 \u062d\u0642\u064a\u0642\u064a \u0644\u0627 \u064a\u064f\u062d\u0630\u0641 \u0628\u0635\u0645\u062a.\n" } } }, "waived": { "type": "boolean", "description": "Staff have forgiven the interest on that bill.", "x-i18n": { "tr": { "description": "Yetkili personel o faturan\u0131n faizini silmi\u015ftir." }, "ar": { "description": "\u0623\u0633\u0642\u0637 \u0627\u0644\u0645\u0648\u0638\u0641\u0648\u0646 \u0627\u0644\u0641\u0627\u0626\u062f\u0629 \u0639\u0646 \u062a\u0644\u0643 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629." } } }, "below_floor": { "type": "boolean", "description": "Something accrued but stays under the minimum charge, so nothing is\ncollected \u2014 not carried forward and not accumulated.\n", "x-i18n": { "tr": { "description": "Bir tutar i\u015flemi\u015f ama asgari tahsil e\u015fi\u011finin alt\u0131nda kald\u0131\u011f\u0131 i\u00e7in\ntahsil edilmez \u2014 ne devreder ne birikir.\n" }, "ar": { "description": "\u062a\u0631\u0627\u0643\u0645 \u0645\u0628\u0644\u063a \u0644\u0643\u0646\u0647 \u062f\u0648\u0646 \u0627\u0644\u062d\u062f \u0627\u0644\u0623\u062f\u0646\u0649 \u0644\u0644\u062a\u062d\u0635\u064a\u0644\u060c \u0641\u0644\u0627 \u064a\u064f\u062d\u0635\u064e\u0651\u0644 \u0634\u064a\u0621 \u2014 \u0648\u0644\u0627 \u064a\u064f\u0631\u062d\u064e\u0651\u0644\n\u0648\u0644\u0627 \u064a\u062a\u0631\u0627\u0643\u0645.\n" } } } } } }, "total": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "The sum of the PAYABLE lines, in this payment's `currency`. `null` in the one\ncase the covered bills do not all share it, where there is no single figure to\nstate \u2014 read `total_usd` instead.\n", "x-i18n": { "tr": { "description": "TAHS\u0130L ED\u0130LECEK sat\u0131rlar\u0131n toplam\u0131, bu \u00f6demenin `currency` biriminde.\nKapsanan faturalar\u0131n tamam\u0131 ayn\u0131 para birimini ta\u015f\u0131mad\u0131\u011f\u0131 tek durumda `null`\nolur; b\u00f6yle bir durumda tek bir tutar yaz\u0131lamaz \u2014 `total_usd` alan\u0131n\u0131 okuyun.\n" }, "ar": { "description": "\u0645\u062c\u0645\u0648\u0639 \u0627\u0644\u0633\u0637\u0648\u0631 \u0627\u0644\u0642\u0627\u0628\u0644\u0629 \u0644\u0644\u062a\u062d\u0635\u064a\u0644 \u0628\u0639\u0645\u0644\u0629 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 `currency`. \u0648\u064a\u0643\u0648\u0646 `null` \u0641\u064a\n\u0627\u0644\u062d\u0627\u0644\u0629 \u0627\u0644\u0648\u062d\u064a\u062f\u0629 \u0627\u0644\u062a\u064a \u0644\u0627 \u062a\u062a\u0634\u0627\u0631\u0643 \u0641\u064a\u0647\u0627 \u0627\u0644\u0641\u0648\u0627\u062a\u064a\u0631 \u0627\u0644\u0645\u0634\u0645\u0648\u0644\u0629 \u0627\u0644\u0639\u0645\u0644\u0629 \u0646\u0641\u0633\u0647\u0627\u060c \u0625\u0630 \u0644\u0627\n\u064a\u0648\u062c\u062f \u0645\u0628\u0644\u063a \u0648\u0627\u062d\u062f \u064a\u064f\u0630\u0643\u0631 \u2014 \u0627\u0642\u0631\u0623 `total_usd` \u0639\u0646\u062f\u0626\u0630.\n" } } }, "total_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "The same sum in USD, each line back through its own bill's frozen rate. Always\npresent.\n", "x-i18n": { "tr": { "description": "Ayn\u0131 toplam\u0131n USD kar\u015f\u0131l\u0131\u011f\u0131; her sat\u0131r kendi faturas\u0131n\u0131n donmu\u015f kuruyla\n\u00e7evrilir. Her zaman bulunur.\n" }, "ar": { "description": "\u0627\u0644\u0645\u062c\u0645\u0648\u0639 \u0646\u0641\u0633\u0647 \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631\u060c \u0648\u0643\u0644 \u0633\u0637\u0631 \u0645\u062d\u0633\u0648\u0628 \u0628\u0633\u0639\u0631 \u0627\u0644\u0635\u0631\u0641 \u0627\u0644\u0645\u062c\u0645\u064e\u0651\u062f \u0639\u0644\u0649 \u0641\u0627\u062a\u0648\u0631\u062a\u0647. \u0648\u0647\u0648\n\u0645\u0648\u062c\u0648\u062f \u062f\u0627\u0626\u0645\u064b\u0627.\n" } } } } }, "subscription_ids": { "type": "array", "items": { "type": "integer" }, "description": "The subscriptions this payment covers (see `GET /subscriptions/{id}`).", "x-i18n": { "tr": { "description": "Bu \u00f6demenin kapsad\u0131\u011f\u0131 abonelikler (bkz. `GET /subscriptions/{id}`)." }, "ar": { "description": "\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u062a\u064a \u062a\u063a\u0637\u0651\u064a\u0647\u0627 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 (\u0627\u0646\u0638\u0631 `GET /subscriptions/{id}`)." } } }, "failure_reason": { "type": "string", "nullable": true }, "failure_count": { "type": "integer", "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "paid_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When this payment settled. `null` while it is unpaid, and `null` on rows\nthat predate the column \u2014 never substituted with `created_at`, which would\npublish a guess as a timestamp.\n", "x-i18n": { "tr": { "description": "Bu \u00f6demenin ne zaman tahsil edildi\u011fi. \u00d6deme hen\u00fcz yap\u0131lmam\u0131\u015fken `null` olur;\ns\u00fctundan \u00f6nce olu\u015fturulmu\u015f sat\u0131rlarda da `null` olur \u2014 yerine asla\n`created_at` konmaz, \u00e7\u00fcnk\u00fc bu, bir tahmini zaman damgas\u0131 olarak\nyay\u0131mlamak olurdu.\n" }, "ar": { "description": "\u0648\u0642\u062a \u062a\u0633\u0648\u064a\u0629 \u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629. \u062a\u0643\u0648\u0646 `null` \u0645\u0627 \u062f\u0627\u0645\u062a \u063a\u064a\u0631 \u0645\u062f\u0641\u0648\u0639\u0629\u060c \u0648`null` \u0623\u064a\u0636\u064b\u0627 \u0641\u064a\n\u0627\u0644\u0633\u062c\u0644\u0627\u062a \u0627\u0644\u0633\u0627\u0628\u0642\u0629 \u0644\u0648\u062c\u0648\u062f \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u0648\u062f \u2014 \u0648\u0644\u0627 \u064a\u064f\u0633\u062a\u0628\u062f\u064e\u0644 \u0628\u0647\u0627 `created_at` \u0623\u0628\u062f\u064b\u0627\u060c\n\u0641\u0630\u0644\u0643 \u0646\u0634\u0631\u064c \u0644\u062a\u062e\u0645\u064a\u0646 \u0639\u0644\u0649 \u0623\u0646\u0647 \u0637\u0627\u0628\u0639 \u0632\u0645\u0646\u064a.\n" } } } } } ], "description": "`payed` when the order cost nothing at all, and `new` when a card still has to settle\nit. Granted credit is a discount on the NET and may cover at most a set share of it,\nso an order with a price on it normally leaves something for a card: read\n`needs_card` rather than assuming this is settled. The payment's own figures are the\nROW as it stands \u2014 an unpaid order still carries its whole amount, because the credit\nis applied when it is paid; `credit_applied` and `payable` are what will happen then.\n", "x-i18n": { "tr": { "description": "Sipari\u015fin hi\u00e7bir bedeli yoksa `payed`, kartla \u00f6denmesi gerekiyorsa `new` olur.\nHediye kredi net tutar \u00fczerinden uygulanan bir iskontodur ve bu tutar\u0131n en \u00e7ok\nbelirli bir oran\u0131n\u0131 kar\u015f\u0131layabilir; bu y\u00fczden fiyat\u0131 olan bir sipari\u015fte karta\nkalan bir tutar genellikle bulunur. Sipari\u015fin kapand\u0131\u011f\u0131n\u0131 varsaymak yerine\n`needs_card` alan\u0131n\u0131 okuyun. \u00d6demenin kendi tutarlar\u0131 sat\u0131r\u0131n o anki h\u00e2lidir:\n\u00f6denmemi\u015f bir sipari\u015f tutar\u0131n\u0131n tamam\u0131n\u0131 ta\u015f\u0131r, \u00e7\u00fcnk\u00fc kredi \u00f6deme s\u0131ras\u0131nda\nuygulan\u0131r. O anda ne olaca\u011f\u0131n\u0131 `credit_applied` ile `payable` g\u00f6sterir.\n" }, "ar": { "description": "\u064a\u0643\u0648\u0646 `payed` \u0625\u0646 \u0644\u0645 \u064a\u0643\u0646 \u0644\u0644\u0637\u0644\u0628 \u0623\u064a \u062a\u0643\u0644\u0641\u0629\u060c \u0648`new` \u0625\u0646 \u0643\u0627\u0646 \u0644\u0627 \u0628\u062f \u0623\u0646 \u062a\u064f\u0633\u0648\u0651\u064a\u0647 \u0628\u0637\u0627\u0642\u0629.\n\u0641\u0627\u0644\u0631\u0635\u064a\u062f \u0627\u0644\u0645\u0645\u0646\u0648\u062d \u062e\u0635\u0645 \u064a\u064f\u0637\u0631\u062d \u0645\u0646 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a \u0648\u0644\u0627 \u064a\u063a\u0637\u064a \u0645\u0646\u0647 \u0625\u0644\u0627 \u062d\u0635\u0629 \u0645\u062d\u062f\u0651\u062f\u0629 \u0639\u0644\u0649\n\u0627\u0644\u0623\u0643\u062b\u0631\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u0628\u0642\u0649 \u0639\u0627\u062f\u0629\u064b \u0641\u064a \u0627\u0644\u0637\u0644\u0628 \u0627\u0644\u0630\u064a \u0644\u0647 \u0633\u0639\u0631 \u0645\u0628\u0644\u063a \u064a\u064f\u0637\u0644\u0628 \u0645\u0646 \u0627\u0644\u0628\u0637\u0627\u0642\u0629: \u0627\u0642\u0631\u0623\n`needs_card` \u0628\u062f\u0644 \u0627\u0641\u062a\u0631\u0627\u0636 \u0623\u0646 \u0627\u0644\u0637\u0644\u0628 \u0642\u062f \u0633\u064f\u0648\u0650\u0651\u064a. \u0648\u0623\u0631\u0642\u0627\u0645 \u0627\u0644\u062f\u0641\u0639\u0629 \u0646\u0641\u0633\u0647\u0627 \u0647\u064a \u062d\u0627\u0644 \u0627\u0644\u0633\u062c\u0644\n\u0627\u0644\u0622\u0646: \u0627\u0644\u0637\u0644\u0628 \u063a\u064a\u0631 \u0627\u0644\u0645\u062f\u0641\u0648\u0639 \u064a\u062d\u0645\u0644 \u0645\u0628\u0644\u063a\u0647 \u0643\u0627\u0645\u0644\u064b\u0627\u060c \u0644\u0623\u0646 \u0627\u0644\u0631\u0635\u064a\u062f \u064a\u064f\u0637\u0628\u064e\u0651\u0642 \u0639\u0646\u062f \u0627\u0644\u062f\u0641\u0639\u061b \u0648\n`credit_applied` \u0648`payable` \u0647\u0645\u0627 \u0645\u0627 \u0633\u064a\u062d\u062f\u062b \u0639\u0646\u062f\u0626\u0630\u064d.\n" } } }, "subscriptions": { "type": "array", "items": { "type": "object", "required": [ "id", "name", "description", "item_type", "status", "is_locked", "is_superseded", "is_administrative", "is_refundable", "period_ends_at", "is_scaling", "resize_history", "instance_id", "volume_id", "public_ip_address_id", "network_id", "payment_plan_id", "credit_card_id", "next_id", "price", "effective_price", "started_at", "ended_at", "created_at" ], "properties": { "id": { "type": "integer", "example": 4821 }, "name": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "item_type": { "type": "string", "description": "Which of the six product types this subscription bought, or `none` when the\nrow links no product at all. Every value `Subscription::getItemTypeAttribute()`\ncan return is listed here: `ipAddress` has been reachable since 2026-08-09 and\n`service`/`network` since 2026-08-19, and the list endpoint applies no\nproduct-type filter, so a strictly-generated client must accept all seven.\n", "x-i18n": { "tr": { "description": "Bu aboneli\u011fin alt\u0131 \u00fcr\u00fcn t\u00fcr\u00fcnden hangisini sat\u0131n ald\u0131\u011f\u0131; sat\u0131r hi\u00e7bir \u00fcr\u00fcne\nba\u011fl\u0131 de\u011filse `none`. `Subscription::getItemTypeAttribute()` metodunun\nd\u00f6nd\u00fcrebilece\u011fi her de\u011fer burada listelenmi\u015ftir: `ipAddress` 2026-08-09,\n`service`/`network` ise 2026-08-19 tarihinden beri eri\u015filebilir ve liste u\u00e7\nnoktas\u0131 hi\u00e7bir \u00fcr\u00fcn t\u00fcr\u00fc filtresi uygulamaz; bu y\u00fczden kat\u0131 bi\u00e7imde \u00fcretilmi\u015f\nbir istemci yedi de\u011ferin tamam\u0131n\u0131 kabul etmelidir.\n" }, "ar": { "description": "\u0623\u064a\u064c\u0651 \u0645\u0646 \u0623\u0646\u0648\u0627\u0639 \u0627\u0644\u0645\u0646\u062a\u062c\u0627\u062a \u0627\u0644\u0633\u062a\u0629 \u0627\u0634\u062a\u0631\u0627\u0647 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u060c \u0623\u0648 `none` \u0639\u0646\u062f\u0645\u0627 \u0644\u0627 \u064a\u0631\u062a\u0628\u0637\n\u0627\u0644\u0635\u0641 \u0628\u0623\u064a \u0645\u0646\u062a\u062c \u0625\u0637\u0644\u0627\u0642\u064b\u0627. \u0648\u0643\u0644 \u0642\u064a\u0645\u0629 \u064a\u0645\u0643\u0646 \u0623\u0646 \u064a\u0639\u064a\u062f\u0647\u0627\n`Subscription::getItemTypeAttribute()` \u0645\u0630\u0643\u0648\u0631\u0629 \u0647\u0646\u0627: \u0641\u0640`ipAddress` \u0645\u062a\u0627\u062d \u0645\u0646\u0630\n2026-08-09 \u0648`service`/`network` \u0645\u0646\u0630 2026-08-19\u060c \u0648\u0646\u0642\u0637\u0629 \u0627\u0644\u0646\u0647\u0627\u064a\u0629 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u0642\u0627\u0626\u0645\u0629\n\u0644\u0627 \u062a\u0637\u0628\u0651\u0642 \u0623\u064a \u0645\u0631\u0634\u0651\u062d \u0639\u0644\u0649 \u0646\u0648\u0639 \u0627\u0644\u0645\u0646\u062a\u062c\u060c \u0648\u0644\u0630\u0644\u0643 \u0639\u0644\u0649 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0648\u0644\u064e\u0651\u062f \u0628\u0635\u0631\u0627\u0645\u0629 \u0623\u0646 \u064a\u0642\u0628\u0644\n\u0627\u0644\u0623\u0646\u0648\u0627\u0639 \u0627\u0644\u0633\u0628\u0639\u0629 \u062c\u0645\u064a\u0639\u0647\u0627.\n" } }, "enum": [ "virtualMachine", "volume", "domainName", "ipAddress", "service", "network", "none" ] }, "status": { "type": "string", "description": "The base lifecycle status, decoded from a bitmask that also carries\n`is_superseded`/`is_administrative` as separate flags (published as their\nown boolean fields below, not folded into this value).\n\n`failed` is reserved: `Subscription::failed()` currently writes `deployed`,\nnot `failed`, and that write is itself rolled back by the transaction it\nruns in, so no subscription reaches this value today. A failed deployment\nis observable only as a `pending` subscription that never settles \u2014 a\npoller must not assume `pending` means \"still in progress\" past a\nreasonable timeout.\n", "x-i18n": { "tr": { "description": "Temel ya\u015fam d\u00f6ng\u00fcs\u00fc durumu; `is_superseded`/`is_administrative` bayraklar\u0131n\u0131 da\nayr\u0131 ayr\u0131 ta\u015f\u0131yan bir bit maskesinden \u00e7\u00f6z\u00fcl\u00fcr (bu bayraklar a\u015fa\u011f\u0131da kendi boole\nalanlar\u0131 olarak yay\u0131mlan\u0131r, bu de\u011ferin i\u00e7ine katlanmaz).\n\n`failed` ayr\u0131lm\u0131\u015f bir de\u011ferdir: `Subscription::failed()` \u015fu anda `failed` de\u011fil\n`deployed` yazar ve bu yazma da i\u00e7inde \u00e7al\u0131\u015ft\u0131\u011f\u0131 i\u015flem taraf\u0131ndan geri al\u0131n\u0131r;\ndolay\u0131s\u0131yla bug\u00fcn hi\u00e7bir abonelik bu de\u011fere ula\u015fmaz. Ba\u015far\u0131s\u0131z bir kurulum\nyaln\u0131zca hi\u00e7 tamamlanmayan `pending` bir abonelik olarak g\u00f6zlenebilir \u2014 yoklama\nyapan bir istemci, makul bir zaman a\u015f\u0131m\u0131ndan sonra `pending` de\u011ferini \u201ch\u00e2l\u00e2\ns\u00fcr\u00fcyor\u201d diye okumamal\u0131d\u0131r.\n" }, "ar": { "description": "\u062d\u0627\u0644\u0629 \u062f\u0648\u0631\u0629 \u0627\u0644\u062d\u064a\u0627\u0629 \u0627\u0644\u0623\u0633\u0627\u0633\u064a\u0629\u060c \u0648\u062a\u064f\u0641\u0643\u0651 \u0645\u0646 \u0642\u0646\u0627\u0639 \u0628\u062a\u0651\u064a \u064a\u062d\u0645\u0644 \u0623\u064a\u0636\u064b\u0627 `is_superseded`\n\u0648`is_administrative` \u0643\u0631\u0627\u064a\u062a\u064a\u0646 \u0645\u0646\u0641\u0635\u0644\u062a\u064a\u0646 (\u062a\u064f\u0646\u0634\u0631\u0627\u0646 \u0623\u062f\u0646\u0627\u0647 \u0643\u062d\u0642\u0644\u064a\u0646 \u0645\u0646\u0637\u0642\u064a\u064a\u0646 \u0645\u0633\u062a\u0642\u0644\u064a\u0646\u060c\n\u0648\u0644\u0627 \u062a\u064f\u062f\u0645\u062c\u0627\u0646 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0642\u064a\u0645\u0629).\n\n\u0648\u0627\u0644\u0642\u064a\u0645\u0629 `failed` \u0645\u062d\u062c\u0648\u0632\u0629: \u0625\u0630 \u064a\u0643\u062a\u0628 `Subscription::failed()` \u062d\u0627\u0644\u064a\u064b\u0627 `deployed` \u0644\u0627\n`failed`\u060c \u0648\u062a\u0644\u0643 \u0627\u0644\u0643\u062a\u0627\u0628\u0629 \u0646\u0641\u0633\u0647\u0627 \u062a\u062a\u0631\u0627\u062c\u0639 \u0645\u0639 \u0627\u0644\u0645\u0639\u0627\u0645\u0644\u0629 \u0627\u0644\u062a\u064a \u062a\u062c\u0631\u064a \u062f\u0627\u062e\u0644\u0647\u0627\u060c \u0648\u0644\u0630\u0644\u0643 \u0644\u0627\n\u064a\u0628\u0644\u063a \u0623\u064a \u0627\u0634\u062a\u0631\u0627\u0643 \u0647\u0630\u0647 \u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u064a\u0648\u0645. \u0648\u0644\u0627 \u064a\u0638\u0647\u0631 \u0627\u0644\u0625\u062e\u0641\u0627\u0642 \u0641\u064a \u0627\u0644\u0646\u0634\u0631 \u0625\u0644\u0627 \u0639\u0644\u0649 \u0647\u064a\u0626\u0629 \u0627\u0634\u062a\u0631\u0627\u0643\n`pending` \u0644\u0627 \u064a\u0633\u062a\u0642\u0631 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0648\u0639\u0644\u0649 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u064a\u0633\u062a\u0639\u0644\u0645 \u062f\u0648\u0631\u064a\u064b\u0627 \u0623\u0644\u0651\u0627 \u064a\u0641\u062a\u0631\u0636 \u0623\u0646\n`pending` \u062a\u0639\u0646\u064a \u00ab\u0644\u0627 \u064a\u0632\u0627\u0644 \u0642\u064a\u062f \u0627\u0644\u062a\u0646\u0641\u064a\u0630\u00bb \u0628\u0639\u062f \u0645\u0647\u0644\u0629 \u0645\u0639\u0642\u0648\u0644\u0629.\n" } }, "enum": [ "new", "pending", "failed", "deployed", "locked", "terminated", "scaling", "unknown" ] }, "is_locked": { "type": "boolean", "description": "Every mutation is refused while this holds \u2014 an unpaid or suspended subscription.", "x-i18n": { "tr": { "description": "Bu ge\u00e7erliyken her de\u011fi\u015fiklik reddedilir \u2014 \u00f6denmemi\u015f ya da ask\u0131ya al\u0131nm\u0131\u015f bir abonelik." }, "ar": { "description": "\u062a\u064f\u0631\u0641\u0636 \u0643\u0644 \u0639\u0645\u0644\u064a\u0629 \u062a\u0639\u062f\u064a\u0644 \u0645\u0627 \u062f\u0627\u0645 \u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644 \u0635\u062d\u064a\u062d\u064b\u0627 \u2014 \u0627\u0634\u062a\u0631\u0627\u0643 \u063a\u064a\u0631 \u0645\u062f\u0641\u0648\u0639 \u0623\u0648 \u0645\u0648\u0642\u0648\u0641." } } }, "is_superseded": { "type": "boolean", "description": "Replaced by a later subscription (a scale, typically). See `next_id`.", "x-i18n": { "tr": { "description": "Yerini daha sonraki bir abonelik alm\u0131\u015ft\u0131r (genellikle bir \u00f6l\u00e7eklendirme). Bkz. `next_id`." }, "ar": { "description": "\u062d\u0644\u0651 \u0645\u062d\u0644\u0651\u0647 \u0627\u0634\u062a\u0631\u0627\u0643 \u0644\u0627\u062d\u0642 (\u0639\u0645\u0644\u064a\u0629 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645 \u0639\u0627\u062f\u0629\u064b). \u0627\u0646\u0638\u0631 `next_id`." } } }, "is_administrative": { "type": "boolean", "description": "Comped or provider-created rather than sold; contributes nothing to billing.", "x-i18n": { "tr": { "description": "Sat\u0131lm\u0131\u015f de\u011fil; bedelsiz verilmi\u015f ya da sa\u011flay\u0131c\u0131 taraf\u0131ndan olu\u015fturulmu\u015f. Faturalamaya hi\u00e7bir katk\u0131s\u0131 yoktur." }, "ar": { "description": "\u0645\u062c\u0627\u0646\u064a \u0623\u0648 \u0623\u0646\u0634\u0623\u0647 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0628\u062f\u0644 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0645\u0628\u064a\u0639\u064b\u0627\u061b \u0644\u0627 \u064a\u0633\u0627\u0647\u0645 \u0641\u064a \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u0625\u0637\u0644\u0627\u0642\u064b\u0627." } } }, "is_refundable": { "type": "boolean", "description": "Whether the refund flow would currently accept this subscription \u2014 the\nsame derived answer the panel shows, not a raw flag: a subscription whose\nattached service work has already been scheduled or delivered is NOT\nrefundable however new it is. Refund doors themselves are out of scope for\nthis phase; this field is informational.\nA resized subscription answers `false`: what a full refund of a resized\ncontract should pay back is an open question, and cancelling is what the\ncustomer can actually do. Also `false` while an invoice-cancellation refund\nrequest is open on the line.\n", "x-i18n": { "tr": { "description": "\u0130ade ak\u0131\u015f\u0131n\u0131n bu aboneli\u011fi \u015fu anda kabul edip etmeyece\u011fi \u2014 paneldeki ile ayn\u0131\nt\u00fcretilmi\u015f yan\u0131t, ham bir bayrak de\u011fil: ba\u011fl\u0131 hizmet \u00e7al\u0131\u015fmas\u0131 planlanm\u0131\u015f veya\nteslim edilmi\u015f bir abonelik, ne kadar yeni olursa olsun iade edilemez. \u0130ade u\u00e7\nnoktalar\u0131n\u0131n kendisi bu a\u015faman\u0131n kapsam\u0131 d\u0131\u015f\u0131ndad\u0131r; bu alan yaln\u0131zca bilgi\nama\u00e7l\u0131d\u0131r. Yeniden boyutland\u0131r\u0131lm\u0131\u015f bir abonelik `false` yan\u0131t\u0131n\u0131 verir:\nyeniden boyutland\u0131r\u0131lm\u0131\u015f bir s\u00f6zle\u015fmenin tam iadesinin ne \u00f6demesi gerekti\u011fi a\u00e7\u0131k\nbir sorudur ve m\u00fc\u015fterinin ger\u00e7ekten yapabilece\u011fi \u015fey iptaldir.\n" }, "ar": { "description": "\u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646 \u0645\u0633\u0627\u0631 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0633\u064a\u0642\u0628\u0644 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u062d\u0627\u0644\u064a\u064b\u0627 \u2014 \u0648\u0647\u0648 \u0627\u0644\u062c\u0648\u0627\u0628 \u0627\u0644\u0645\u0634\u062a\u0642 \u0646\u0641\u0633\u0647\n\u0627\u0644\u0630\u064a \u062a\u0639\u0631\u0636\u0647 \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0644\u0627 \u0631\u0627\u064a\u0629 \u062e\u0627\u0645\u064b\u0627: \u0641\u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u062c\u064f\u062f\u0648\u0650\u0644 \u0639\u0645\u0644 \u062e\u062f\u0645\u062a\u0647 \u0623\u0648 \u0633\u064f\u0644\u0650\u0651\u0645 \u0644\u0627\n\u064a\u0642\u0628\u0644 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0645\u0647\u0645\u0627 \u0643\u0627\u0646 \u062d\u062f\u064a\u062b\u064b\u0627. \u0623\u0645\u0627 \u0623\u0628\u0648\u0627\u0628 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0646\u0641\u0633\u0647\u0627 \u0641\u062e\u0627\u0631\u062c \u0646\u0637\u0627\u0642 \u0647\u0630\u0647\n\u0627\u0644\u0645\u0631\u062d\u0644\u0629\u061b \u0648\u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644 \u0644\u0644\u0639\u0644\u0645 \u0641\u0642\u0637. \u0648\u064a\u062c\u064a\u0628 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u062c\u0631\u0649 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645\u0647 \u0628\u0640`false`:\n\u0641\u0645\u0627 \u064a\u0646\u0628\u063a\u064a \u0623\u0646 \u064a\u0639\u064a\u062f\u0647 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0643\u0627\u0645\u0644 \u0644\u0639\u0642\u062f \u062c\u0631\u0649 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645\u0647 \u0633\u0624\u0627\u0644 \u0645\u0641\u062a\u0648\u062d\u060c \u0648\u0627\u0644\u0625\u0644\u063a\u0627\u0621 \u0647\u0648\n\u0645\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0627\u0644\u0639\u0645\u064a\u0644 \u0641\u0639\u0644\u0647 \u0641\u0639\u0644\u064b\u0627.\n" } } }, "refund_needs_invoice_cancellation": { "type": "boolean", "description": "True when the refund window is open but an e-Ar\u015fiv/e-Fatura invoice has already been\nissued for the purchase: the invoice must be cancelled before the money can go back,\nso a refund goes through an invoice-cancellation request in the panel rather than\nstraight to the card.\n", "x-i18n": { "tr": { "description": "\u0130ade s\u00fcresi a\u00e7\u0131k oldu\u011fu h\u00e2lde sat\u0131n alma i\u00e7in e-Ar\u015fiv/e-Fatura faturas\u0131 zaten\nkesilmi\u015fse do\u011frudur: para iade edilmeden \u00f6nce faturan\u0131n iptal edilmesi gerekir; bu\ny\u00fczden iade do\u011frudan karta de\u011fil, paneldeki fatura iptali talebi \u00fczerinden yap\u0131l\u0131r.\n" }, "ar": { "description": "\u064a\u0643\u0648\u0646 \u0635\u062d\u064a\u062d\u064b\u0627 \u062d\u064a\u0646 \u062a\u0643\u0648\u0646 \u0645\u0647\u0644\u0629 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0645\u0641\u062a\u0648\u062d\u0629 \u0644\u0643\u0646 \u0641\u0627\u062a\u0648\u0631\u0629 e-Ar\u015fiv/e-Fatura \u0642\u062f \u0635\u062f\u0631\u062a\n\u0628\u0627\u0644\u0641\u0639\u0644 \u0644\u0639\u0645\u0644\u064a\u0629 \u0627\u0644\u0634\u0631\u0627\u0621: \u064a\u062c\u0628 \u0625\u0644\u063a\u0627\u0621 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0642\u0628\u0644 \u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u0645\u0627\u0644\u060c \u0644\u0630\u0627 \u064a\u0645\u0631 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0639\u0628\u0631\n\u0637\u0644\u0628 \u0625\u0644\u063a\u0627\u0621 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0628\u062f\u0644\u064b\u0627 \u0645\u0646 \u0627\u0644\u0630\u0647\u0627\u0628 \u0645\u0628\u0627\u0634\u0631\u0629 \u0625\u0644\u0649 \u0627\u0644\u0628\u0637\u0627\u0642\u0629.\n" } } }, "period_ends_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When the paid period ends and this subscription renews. A resize never moves\nit \u2014 an upscale charges the difference and a downscale refunds it, and the\ndate stays where it was. `null` on a row that has never carried the override.\n", "x-i18n": { "tr": { "description": "\u00d6denmi\u015f d\u00f6nemin bitti\u011fi ve bu aboneli\u011fin yenilendi\u011fi tarih. Yeniden\nboyutland\u0131rma bu tarihi hi\u00e7bir zaman de\u011fi\u015ftirmez \u2014 y\u00fckseltme fark\u0131 tahsil\neder, k\u00fc\u00e7\u00fcltme fark\u0131 iade eder ve tarih oldu\u011fu yerde kal\u0131r. Bu ge\u00e7ersiz\nk\u0131lmay\u0131 hi\u00e7 ta\u015f\u0131mam\u0131\u015f bir sat\u0131rda `null` olur.\n" }, "ar": { "description": "\u0645\u0648\u0639\u062f \u0627\u0646\u062a\u0647\u0627\u0621 \u0627\u0644\u0641\u062a\u0631\u0629 \u0627\u0644\u0645\u062f\u0641\u0648\u0639\u0629 \u0648\u062a\u062c\u062f\u064a\u062f \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643. \u0648\u0644\u0627 \u064a\u062d\u0631\u0651\u0643\u0647 \u062a\u063a\u064a\u064a\u0631 \u0627\u0644\u062d\u062c\u0645 \u0623\u0628\u062f\u064b\u0627\n\u2014 \u0641\u0627\u0644\u062a\u0631\u0642\u064a\u0629 \u062a\u062e\u0635\u0645 \u0627\u0644\u0641\u0631\u0642 \u0648\u0627\u0644\u062a\u062e\u0641\u064a\u0636 \u064a\u0631\u062f\u0651\u0647\u060c \u0648\u064a\u0628\u0642\u0649 \u0627\u0644\u062a\u0627\u0631\u064a\u062e \u0641\u064a \u0645\u0643\u0627\u0646\u0647. \u0648\u064a\u0643\u0648\u0646 `null` \u0641\u064a\n\u0633\u062c\u0644 \u0644\u0645 \u064a\u062d\u0645\u0644 \u0647\u0630\u0627 \u0627\u0644\u062a\u062c\u0627\u0648\u0632 \u0642\u0637.\n" } } }, "is_scaling": { "type": "boolean", "description": "A resize is being applied to this subscription right now. It is a temporary\nlock, not a state of the contract: the machine is being rebuilt at its new\nsize and mutations are refused until it clears.\n", "x-i18n": { "tr": { "description": "Bu abonelikte \u015fu anda bir yeniden boyutland\u0131rma uygulan\u0131yor. Bu, s\u00f6zle\u015fmenin\nbir durumu de\u011fil ge\u00e7ici bir kilittir: makine yeni boyutunda yeniden kuruluyor\nve kilit kalkana kadar de\u011fi\u015fiklikler reddedilir.\n" }, "ar": { "description": "\u064a\u062c\u0631\u064a \u0627\u0644\u0622\u0646 \u062a\u0637\u0628\u064a\u0642 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645 \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643. \u0648\u0647\u0648 \u0642\u0641\u0644 \u0645\u0624\u0642\u062a \u0644\u0627 \u062d\u0627\u0644\u0629 \u0645\u0646 \u062d\u0627\u0644\u0627\u062a\n\u0627\u0644\u0639\u0642\u062f: \u0625\u0630 \u064a\u064f\u0639\u0627\u062f \u0628\u0646\u0627\u0621 \u0627\u0644\u062c\u0647\u0627\u0632 \u0628\u062d\u062c\u0645\u0647 \u0627\u0644\u062c\u062f\u064a\u062f \u0648\u062a\u064f\u0631\u0641\u0636 \u0627\u0644\u062a\u0639\u062f\u064a\u0644\u0627\u062a \u062d\u062a\u0649 \u064a\u0646\u0642\u0636\u064a \u0627\u0644\u0642\u0641\u0644.\n" } } }, "resize_history": { "type": "array", "nullable": true, "description": "Every step of this subscription's resize chain, newest first \u2014 what each step\ncharged and what it refunded, and where the refund went. Sent by\n`GET /subscriptions/{id}` only; `null` in the list, because building it walks\nthe whole chain and queries per member. Every figure inside is a `Money`, every\ncurrency an ISO code, and both statuses are the same closed string sets\n`GET /payments` and `GET /refunds` publish \u2014 so a refund seen here and the same\nrefund seen at `GET /refunds` agree field for field.\n", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string", "nullable": true }, "item_type": { "type": "string" }, "product_id": { "type": "integer", "nullable": true }, "event": { "type": "string" }, "from_name": { "type": "string", "nullable": true }, "effective_price": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ] }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "ended_at": { "type": "string", "format": "date-time", "nullable": true }, "period_ends_at": { "type": "string", "format": "date-time", "nullable": true }, "charge": { "type": "object", "nullable": true, "properties": { "payment_id": { "type": "integer" }, "currency": { "type": "string", "minLength": 3, "maxLength": 3 }, "total": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true }, "status": { "type": "string", "enum": [ "new", "payed", "failed", "canceled", "expired", "refunded", "partially_refunded", "unknown" ] }, "is_superseded": { "type": "boolean" }, "is_administrative": { "type": "boolean" }, "paid_at": { "type": "string", "format": "date-time", "nullable": true } } }, "refunds": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "payment_id": { "type": "integer" }, "currency": { "type": "string", "minLength": 3, "maxLength": 3 }, "amount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true }, "amount_usd": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true }, "destination": { "type": "string", "nullable": true }, "status": { "type": "string", "enum": [ "new", "done", "failed", "pending", "unknown" ] }, "expires_at": { "type": "string", "format": "date-time", "nullable": true } } } } } }, "x-i18n": { "tr": { "description": "Bu aboneli\u011fin yeniden boyutland\u0131rma zincirindeki her ad\u0131m, en yenisi \u00f6nce \u2014\nher ad\u0131m\u0131n ne tahsil etti\u011fi, ne iade etti\u011fi ve iadenin nereye gitti\u011fi.\nYaln\u0131zca `GET /subscriptions/{id}` g\u00f6nderir; listede `null` olur, \u00e7\u00fcnk\u00fc bunu\nkurmak t\u00fcm zinciri dola\u015f\u0131r ve her \u00fcye i\u00e7in sorgu yapar. \u0130\u00e7indeki her tutar bir\n`Money`, her para birimi bir ISO kodudur ve iki durum alan\u0131 da `GET /payments`\nile `GET /refunds` u\u00e7 noktalar\u0131n\u0131n yay\u0131mlad\u0131\u011f\u0131 kapal\u0131 de\u011fer k\u00fcmelerinin\nayn\u0131s\u0131d\u0131r \u2014 b\u00f6ylece burada g\u00f6r\u00fclen bir iade ile `GET /refunds` alt\u0131nda g\u00f6r\u00fclen\nayn\u0131 iade alan alan uyu\u015fur.\n" }, "ar": { "description": "\u0643\u0644 \u062e\u0637\u0648\u0629 \u0641\u064a \u0633\u0644\u0633\u0644\u0629 \u062a\u063a\u064a\u064a\u0631 \u062d\u062c\u0645 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u060c \u0645\u0646 \u0627\u0644\u0623\u062d\u062f\u062b \u0625\u0644\u0649 \u0627\u0644\u0623\u0642\u062f\u0645 \u2014 \u0645\u0627 \u062e\u0635\u0645\u062a\u0647 \u0643\u0644\n\u062e\u0637\u0648\u0629 \u0648\u0645\u0627 \u0631\u062f\u0651\u062a\u0647 \u0648\u0625\u0644\u0649 \u0623\u064a\u0646 \u0630\u0647\u0628 \u0627\u0644\u0631\u062f. \u0644\u0627 \u064a\u0631\u0633\u0644\u0647\u0627 \u0625\u0644\u0627 `GET /subscriptions/{id}`\u060c\n\u0648\u062a\u0643\u0648\u0646 `null` \u0641\u064a \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0644\u0623\u0646 \u0628\u0646\u0627\u0621\u0647\u0627 \u064a\u0645\u0634\u064a \u0639\u0644\u0649 \u0627\u0644\u0633\u0644\u0633\u0644\u0629 \u0643\u0627\u0645\u0644\u0629 \u0648\u064a\u0633\u062a\u0639\u0644\u0645 \u0644\u0643\u0644 \u0639\u0636\u0648\n\u0641\u064a\u0647\u0627. \u0648\u0643\u0644 \u0645\u0628\u0644\u063a \u062f\u0627\u062e\u0644\u0647\u0627 \u0645\u0646 \u0646\u0648\u0639 `Money`\u060c \u0648\u0643\u0644 \u0639\u0645\u0644\u0629 \u0631\u0645\u0632 ISO\u060c \u0648\u062d\u0642\u0644\u0627 \u0627\u0644\u062d\u0627\u0644\u0629 \u0647\u0645\u0627\n\u0627\u0644\u0645\u062c\u0645\u0648\u0639\u062a\u0627\u0646 \u0627\u0644\u0645\u063a\u0644\u0642\u062a\u0627\u0646 \u0646\u0641\u0633\u0627\u0647\u0645\u0627 \u0627\u0644\u0644\u062a\u0627\u0646 \u064a\u0646\u0634\u0631\u0647\u0645\u0627 `GET /payments` \u0648`GET /refunds` \u2014\n\u0641\u064a\u062a\u0637\u0627\u0628\u0642 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0627\u0644\u0645\u0631\u0626\u064a \u0647\u0646\u0627 \u0645\u0639 \u0627\u0644\u0627\u0633\u062a\u0631\u062f\u0627\u062f \u0646\u0641\u0633\u0647 \u0641\u064a `GET /refunds` \u062d\u0642\u0644\u064b\u0627 \u0628\u062d\u0642\u0644.\n" } } }, "instance_id": { "type": "integer", "nullable": true, "description": "The id of the linked instance (see `GET /instances/{id}`), for a `virtualMachine` subscription.", "x-i18n": { "tr": { "description": "Bir `virtualMachine` aboneli\u011finde, ba\u011fl\u0131 sanal makinan\u0131n kimli\u011fi (bkz. `GET /instances/{id}`)." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0627\u0644\u0645\u0631\u062a\u0628\u0637 (\u0627\u0646\u0638\u0631 `GET /instances/{id}`) \u0641\u064a \u0627\u0634\u062a\u0631\u0627\u0643 \u0645\u0646 \u0646\u0648\u0639 `virtualMachine`." } }, "example": 17 }, "volume_id": { "type": "integer", "nullable": true, "description": "The id of the linked volume (see `GET /volumes/{id}`), for a `volume` subscription.", "x-i18n": { "tr": { "description": "Bir `volume` aboneli\u011finde, ba\u011fl\u0131 diskin kimli\u011fi (bkz. `GET /volumes/{id}`)." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0642\u0631\u0635 \u0627\u0644\u0645\u0631\u062a\u0628\u0637 (\u0627\u0646\u0638\u0631 `GET /volumes/{id}`) \u0641\u064a \u0627\u0634\u062a\u0631\u0627\u0643 \u0645\u0646 \u0646\u0648\u0639 `volume`." } } }, "public_ip_address_id": { "type": "integer", "nullable": true, "description": "The id of the linked public address (see `GET /public-ip-addresses/{id}`), for an\n`ipAddress` subscription. The same pointer `instance_id`/`volume_id` are for their\nproduct types: the row records both the product bought and the resource it became.\n", "x-i18n": { "tr": { "description": "Bir `ipAddress` aboneli\u011finde, ba\u011fl\u0131 kamusal adresin kimli\u011fi\n(bkz. `GET /public-ip-addresses/{id}`). `instance_id`/`volume_id` alanlar\u0131 kendi\n\u00fcr\u00fcn t\u00fcrleri i\u00e7in ne ise bu da odur: sat\u0131r, hem sat\u0131n al\u0131nan \u00fcr\u00fcn\u00fc hem de o\n\u00fcr\u00fcn\u00fcn d\u00f6n\u00fc\u015ft\u00fc\u011f\u00fc kayna\u011f\u0131 kaydeder.\n" }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0639\u0646\u0648\u0627\u0646 \u0627\u0644\u0639\u0627\u0645 \u0627\u0644\u0645\u0631\u062a\u0628\u0637 (\u0627\u0646\u0638\u0631 `GET /public-ip-addresses/{id}`) \u0641\u064a \u0627\u0634\u062a\u0631\u0627\u0643\n\u0645\u0646 \u0646\u0648\u0639 `ipAddress`. \u0648\u0647\u0648 \u0627\u0644\u0645\u0624\u0634\u0651\u0631 \u0630\u0627\u062a\u0647 \u0627\u0644\u0630\u064a \u064a\u0645\u062b\u0651\u0644\u0647 `instance_id`/`volume_id`\n\u0644\u0646\u0648\u0639\u064e\u064a \u0627\u0644\u0645\u0646\u062a\u062c \u0627\u0644\u062e\u0627\u0635\u064e\u0651\u064a\u0646 \u0628\u0647\u0645\u0627: \u0641\u0627\u0644\u0635\u0641 \u064a\u0633\u062c\u0651\u0644 \u0627\u0644\u0645\u0646\u062a\u062c \u0627\u0644\u0645\u0634\u062a\u0631\u0649 \u0648\u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0630\u064a \u0635\u0627\u0631 \u0625\u0644\u064a\u0647.\n" } }, "example": 4 }, "network_id": { "type": "integer", "nullable": true, "description": "The id of the network this subscription BOUGHT, for a `network` subscription \u2014\nnot the network another product deploys into, which is not published. Null until\nthe provider reports the network created, and nulled again if it is later removed.\n", "x-i18n": { "tr": { "description": "Bir `network` aboneli\u011finde, bu aboneli\u011fin SATIN ALDI\u011eI a\u011f\u0131n kimli\u011fi \u2014 ba\u015fka bir\n\u00fcr\u00fcn\u00fcn i\u00e7ine kuruldu\u011fu a\u011f de\u011fil; o a\u011f yay\u0131mlanmaz. Sa\u011flay\u0131c\u0131 a\u011f\u0131n olu\u015fturuldu\u011funu\nbildirene kadar null olur ve a\u011f sonradan kald\u0131r\u0131l\u0131rsa yeniden null yap\u0131l\u0131r.\n" }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0634\u0628\u0643\u0629 \u0627\u0644\u062a\u064a \u0627\u0634\u062a\u0631\u0627\u0647\u0627 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0646\u0641\u0633\u0647\u060c \u0641\u064a \u0627\u0634\u062a\u0631\u0627\u0643 \u0645\u0646 \u0646\u0648\u0639 `network` \u2014 \u0644\u0627\n\u0627\u0644\u0634\u0628\u0643\u0629 \u0627\u0644\u062a\u064a \u064a\u064f\u0646\u0634\u0631 \u062f\u0627\u062e\u0644\u0647\u0627 \u0645\u0646\u062a\u062c \u0622\u062e\u0631\u060c \u0641\u062a\u0644\u0643 \u0644\u0627 \u062a\u064f\u0646\u0634\u0631 \u0647\u0646\u0627. \u062a\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 null \u0625\u0644\u0649 \u0623\u0646\n\u064a\u064f\u0628\u0644\u0651\u063a \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0628\u0625\u0646\u0634\u0627\u0621 \u0627\u0644\u0634\u0628\u0643\u0629\u060c \u0648\u062a\u0639\u0648\u062f null \u0625\u0646 \u0623\u064f\u0632\u064a\u0644\u062a \u0644\u0627\u062d\u0642\u064b\u0627.\n" } } }, "payment_plan_id": { "type": "integer", "nullable": true }, "credit_card_id": { "type": "integer", "nullable": true }, "next_id": { "type": "integer", "nullable": true, "description": "The id of the subscription that superseded this one, or `null`. Stands in\nfor the panel's `history` field, which is omitted here \u2014 it is an N+1 walk\nof the whole ancestor chain. A client that wants the chain follows this\npointer (and `is_superseded`) itself.\n", "x-i18n": { "tr": { "description": "Bu aboneli\u011fin yerine ge\u00e7en aboneli\u011fin kimli\u011fi ya da `null`. Panelin burada\nyay\u0131mlanmayan `history` alan\u0131n\u0131n yerini tutar \u2014 o alan, b\u00fct\u00fcn ata zincirini\ndola\u015fan bir N+1 sorgusudur. Zinciri isteyen bir istemci, bu i\u015faret\u00e7iyi (ve\n`is_superseded` alan\u0131n\u0131) kendisi izler.\n" }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643 \u0627\u0644\u0630\u064a \u062d\u0644\u0651 \u0645\u062d\u0644\u0651 \u0647\u0630\u0627 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u060c \u0623\u0648 `null`. \u064a\u0642\u0648\u0645 \u0645\u0642\u0627\u0645 \u062d\u0642\u0644 `history`\n\u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0648\u0647\u0648 \u062d\u0642\u0644 \u0645\u064f\u063a\u0641\u064e\u0644 \u0647\u0646\u0627 \u2014 \u0625\u0630 \u064a\u0645\u062b\u0651\u0644 \u0645\u0631\u0648\u0631\u064b\u0627 \u0645\u0646 \u0646\u0648\u0639 N+1 \u0639\u0644\u0649 \u0633\u0644\u0633\u0644\u0629 \u0627\u0644\u0623\u0633\u0644\u0627\u0641\n\u0643\u0627\u0645\u0644\u0629. \u0648\u0639\u0644\u0649 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u064a\u0631\u064a\u062f \u0627\u0644\u0633\u0644\u0633\u0644\u0629 \u0623\u0646 \u064a\u062a\u062a\u0628\u0651\u0639 \u0647\u0630\u0627 \u0627\u0644\u0645\u0624\u0634\u0651\u0631\n(\u0648`is_superseded`) \u0628\u0646\u0641\u0633\u0647.\n" } } }, "price": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "USD, unconditionally \u2014 the linked payment plan's list price, before any coupon.", "x-i18n": { "tr": { "description": "Ko\u015fulsuz olarak USD \u2014 ba\u011fl\u0131 \u00f6deme plan\u0131n\u0131n liste fiyat\u0131, herhangi bir kupon uygulanmadan \u00f6nce." }, "ar": { "description": "\u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a \u062f\u0627\u0626\u0645\u064b\u0627 \u2014 \u0633\u0639\u0631 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0644\u062e\u0637\u0629 \u0627\u0644\u062f\u0641\u0639 \u0627\u0644\u0645\u0631\u062a\u0628\u0637\u0629\u060c \u0642\u0628\u0644 \u0623\u064a \u0642\u0633\u064a\u0645\u0629." } } }, "effective_price": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "USD, unconditionally \u2014 the price after the best currently-valid coupon, if any.", "x-i18n": { "tr": { "description": "Ko\u015fulsuz olarak USD \u2014 varsa ge\u00e7erli en iyi kupon uyguland\u0131ktan sonraki fiyat." }, "ar": { "description": "\u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a \u062f\u0627\u0626\u0645\u064b\u0627 \u2014 \u0627\u0644\u0633\u0639\u0631 \u0628\u0639\u062f \u0623\u0641\u0636\u0644 \u0642\u0633\u064a\u0645\u0629 \u0633\u0627\u0631\u064a\u0629 \u062d\u0627\u0644\u064a\u064b\u0627\u060c \u0625\u0646 \u0648\u064f\u062c\u062f\u062a." } } }, "started_at": { "type": "string", "format": "date-time" }, "ended_at": { "type": "string", "format": "date-time" }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "description": "One per unit ordered. Freshly created subscriptions read `new` and settle\nasynchronously through `pending` to `deployed` or `failed`; poll\n`GET /subscriptions/{id}` to follow them.\n", "x-i18n": { "tr": { "description": "Sipari\u015f edilen her birim i\u00e7in bir tane. Yeni olu\u015fturulan abonelikler `new`\ndurumundad\u0131r ve `pending` \u00fczerinden e\u015fzamans\u0131z olarak `deployed` ya da `failed`\ndurumuna ge\u00e7er; izlemek i\u00e7in `GET /subscriptions/{id}` u\u00e7 noktas\u0131n\u0131 yoklay\u0131n.\n" }, "ar": { "description": "\u0648\u0627\u062d\u062f \u0644\u0643\u0644 \u0648\u062d\u062f\u0629 \u0645\u0637\u0644\u0648\u0628\u0629. \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0627\u0644\u0645\u0646\u0634\u0623\u0629 \u062d\u062f\u064a\u062b\u064b\u0627 \u062a\u0643\u0648\u0646 `new` \u0648\u062a\u0633\u062a\u0642\u0631 \u0628\u0634\u0643\u0644 \u063a\u064a\u0631\n\u0645\u062a\u0632\u0627\u0645\u0646 \u0639\u0628\u0631 `pending` \u0625\u0644\u0649 `deployed` \u0623\u0648 `failed`\u061b \u0627\u0633\u062a\u0639\u0644\u0645 \u0639\u0646\n`GET /subscriptions/{id}` \u0644\u0645\u062a\u0627\u0628\u0639\u062a\u0647\u0627.\n" } } }, "paid_from_balance": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "`payments.from_balance` \u2014 the amount ALREADY taken from the account balance, in USD.\nIt is `0.00` on every order this endpoint places: placing an order takes nothing, and\nthe credit is applied when the order is paid. Read `credit_applied` for what the\ncredit will cover.\n", "x-i18n": { "tr": { "description": "`payments.from_balance` \u2014 hesap bakiyesinden ALINMI\u015e olan tutar, USD cinsinden. Bu\nu\u00e7 noktan\u0131n olu\u015fturdu\u011fu her sipari\u015fte `0.00`'d\u0131r: sipari\u015f verilirken bakiyeden\nhi\u00e7bir tutar al\u0131nmaz, kredi \u00f6deme yap\u0131ld\u0131\u011f\u0131nda uygulan\u0131r. Kredinin kar\u015f\u0131layaca\u011f\u0131\ntutar i\u00e7in `credit_applied` alan\u0131n\u0131 okuyun.\n" }, "ar": { "description": "`payments.from_balance` \u2014 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0645\u0623\u062e\u0648\u0630 \u0641\u0639\u0644\u064b\u0627 \u0645\u0646 \u0631\u0635\u064a\u062f \u0627\u0644\u062d\u0633\u0627\u0628\u060c \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a.\n\u0648\u0647\u0648 `0.00` \u0641\u064a \u0643\u0644 \u0637\u0644\u0628 \u064a\u064f\u0646\u0634\u0626\u0647 \u0647\u0630\u0627 \u0627\u0644\u0645\u0633\u0627\u0631: \u0641\u0625\u0646\u0634\u0627\u0621 \u0627\u0644\u0637\u0644\u0628 \u0644\u0627 \u064a\u0623\u062e\u0630 \u0634\u064a\u0626\u064b\u0627\u060c \u0648\u064a\u064f\u0637\u0628\u064e\u0651\u0642\n\u0627\u0644\u0631\u0635\u064a\u062f \u0639\u0646\u062f \u062f\u0641\u0639 \u0627\u0644\u0637\u0644\u0628. \u0627\u0642\u0631\u0623 `credit_applied` \u0644\u0645\u0639\u0631\u0641\u0629 \u0645\u0627 \u0633\u064a\u063a\u0637\u0651\u064a\u0647 \u0627\u0644\u0631\u0635\u064a\u062f.\n" } } }, "balance_after": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "`users.balance` after the withdrawal, in USD. That column is USD\nunconditionally, unlike the payment's own totals, which carry the payment's\ncurrency.\n", "x-i18n": { "tr": { "description": "\u00c7ekim sonras\u0131 `users.balance` de\u011feri, USD cinsinden. Bu s\u00fctun ko\u015fulsuz olarak\nUSD ta\u015f\u0131r; \u00f6demenin kendi toplamlar\u0131 ise \u00f6demenin para birimini ta\u015f\u0131r.\n" }, "ar": { "description": "\u0642\u064a\u0645\u0629 `users.balance` \u0628\u0639\u062f \u0627\u0644\u0633\u062d\u0628\u060c \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a. \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u0648\u062f \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631\n\u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a \u062f\u0627\u0626\u0645\u064b\u0627\u060c \u0628\u062e\u0644\u0627\u0641 \u0625\u062c\u0645\u0627\u0644\u064a\u0627\u062a \u0627\u0644\u062f\u0641\u0639\u0629 \u0646\u0641\u0633\u0647\u0627 \u0627\u0644\u062a\u064a \u062a\u062d\u0645\u0644 \u0639\u0645\u0644\u0629 \u0627\u0644\u062f\u0641\u0639\u0629.\n" } } }, "needs_card": { "type": "boolean", "description": "Whether a person still has to pay for this order with a card. Granted credit is a\ndiscount on the net and may cover at most a set share of it, so this is `true` for\nalmost every priced order; it is `false` only when the order's net was 0.00 and the\nwhole of it settled from credit. The subscriptions are created either way \u2014 an API\norder is never refused for want of a balance.\n", "x-i18n": { "tr": { "description": "Bu sipari\u015f i\u00e7in h\u00e2l\u00e2 kartla \u00f6deme yap\u0131lmas\u0131 gerekip gerekmedi\u011fi. Hediye kredi net\ntutar \u00fczerinden uygulanan bir iskontodur ve bu tutar\u0131n en \u00e7ok belirli bir oran\u0131n\u0131\nkar\u015f\u0131layabilir; bu y\u00fczden fiyat\u0131 olan hemen her sipari\u015fte `true` olur. Yaln\u0131zca\nsipari\u015fin net tutar\u0131 0,00 oldu\u011funda ve tamam\u0131 krediden kar\u015f\u0131land\u0131\u011f\u0131nda `false`\nolur. Abonelikler her iki durumda da olu\u015fturulur \u2014 bir API sipari\u015fi bakiye\nyetersizli\u011fi y\u00fcz\u00fcnden asla reddedilmez.\n" }, "ar": { "description": "\u0645\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646 \u0644\u0627 \u064a\u0632\u0627\u0644 \u064a\u062a\u0639\u064a\u064e\u0651\u0646 \u0639\u0644\u0649 \u0634\u062e\u0635 \u062f\u0641\u0639 \u0642\u064a\u0645\u0629 \u0647\u0630\u0627 \u0627\u0644\u0637\u0644\u0628 \u0628\u0628\u0637\u0627\u0642\u0629. \u0641\u0627\u0644\u0631\u0635\u064a\u062f \u0627\u0644\u0645\u0645\u0646\u0648\u062d \u062e\u0635\u0645\n\u064a\u064f\u0637\u0631\u062d \u0645\u0646 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a \u0648\u0644\u0627 \u064a\u063a\u0637\u064a \u0645\u0646\u0647 \u0625\u0644\u0627 \u062d\u0635\u0629 \u0645\u062d\u062f\u0651\u062f\u0629 \u0639\u0644\u0649 \u0627\u0644\u0623\u0643\u062b\u0631\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u0643\u0648\u0646 \u0642\u064a\u0645\u062a\u0647\n`true` \u0641\u064a \u0643\u0644 \u0637\u0644\u0628 \u0644\u0647 \u0633\u0639\u0631 \u062a\u0642\u0631\u064a\u0628\u064b\u0627\u061b \u0648\u0644\u0627 \u062a\u0643\u0648\u0646 `false` \u0625\u0644\u0627 \u0625\u0630\u0627 \u0643\u0627\u0646 \u0635\u0627\u0641\u064a \u0627\u0644\u0637\u0644\u0628 0.00\n\u0648\u0633\u064f\u0648\u0650\u0651\u064a \u0628\u0627\u0644\u0643\u0627\u0645\u0644 \u0645\u0646 \u0627\u0644\u0631\u0635\u064a\u062f. \u0648\u062a\u064f\u0646\u0634\u0623 \u0627\u0644\u0627\u0634\u062a\u0631\u0627\u0643\u0627\u062a \u0641\u064a \u0627\u0644\u062d\u0627\u0644\u062a\u064a\u0646 \u2014 \u0641\u0637\u0644\u0628 \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u0629 \u0644\u0627\n\u064a\u064f\u0631\u0641\u0636 \u0623\u0628\u062f\u064b\u0627 \u0644\u0639\u062f\u0645 \u0643\u0641\u0627\u064a\u0629 \u0627\u0644\u0631\u0635\u064a\u062f.\n" } } }, "payable": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "What the card will be asked for, in the PAYMENT's own currency (TRY for a T\u00fcrkiye\nbilling country) \u2014 the taxable base plus the VAT on that base, never the net. It is a\nPROJECTION while the order is unpaid: the credit has not been taken yet, so the\npayment's own `amount` is still the whole figure and this is what will be charged\nonce the credit is applied at payment. `0.00` once there is nothing left to pay.\n", "x-i18n": { "tr": { "description": "Karttan tahsil edilecek tutar, \u00d6DEMEN\u0130N kendi para biriminde (fatura \u00fclkesi\nT\u00fcrkiye ise TRY) \u2014 matrah ve bu matrah\u0131n KDV'si; asla net tutar de\u011fil. Sipari\u015f\n\u00f6denene kadar bu bir \u00d6NG\u00d6R\u00dcD\u00dcR: kredi hen\u00fcz al\u0131nmad\u0131\u011f\u0131 i\u00e7in \u00f6demenin kendi\n`amount` alan\u0131 h\u00e2l\u00e2 tutar\u0131n tamam\u0131n\u0131 g\u00f6sterir, bu alan ise \u00f6deme s\u0131ras\u0131nda kredi\nuyguland\u0131ktan sonra tahsil edilecek tutar\u0131 g\u00f6sterir. \u00d6denecek bir \u015fey\nkalmad\u0131\u011f\u0131nda `0.00` olur.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0630\u064a \u0633\u064a\u064f\u0637\u0644\u0628 \u0645\u0646 \u0627\u0644\u0628\u0637\u0627\u0642\u0629\u060c \u0628\u0639\u0645\u0644\u0629 \u0627\u0644\u062f\u0641\u0639\u0629 \u0646\u0641\u0633\u0647\u0627 (TRY \u0625\u0646 \u0643\u0627\u0646 \u0628\u0644\u062f \u0627\u0644\u0641\u0648\u062a\u0631\u0629 \u062a\u0631\u0643\u064a\u0627)\n\u2014 \u0623\u064a \u0627\u0644\u0648\u0639\u0627\u0621 \u0627\u0644\u0636\u0631\u064a\u0628\u064a \u0645\u0636\u0627\u0641\u064b\u0627 \u0625\u0644\u064a\u0647 \u0636\u0631\u064a\u0628\u062a\u0647\u060c \u0644\u0627 \u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0635\u0627\u0641\u064a \u0623\u0628\u062f\u064b\u0627. \u0648\u0647\u0648 \u062a\u0642\u062f\u064a\u0631 \u0645\u0627 \u062f\u0627\u0645\n\u0627\u0644\u0637\u0644\u0628 \u063a\u064a\u0631 \u0645\u062f\u0641\u0648\u0639: \u0641\u0627\u0644\u0631\u0635\u064a\u062f \u0644\u0645 \u064a\u064f\u0624\u062e\u0630 \u0628\u0639\u062f\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u0628\u0642\u0649 \u062d\u0642\u0644 `amount` \u0641\u064a \u0627\u0644\u062f\u0641\u0639\u0629 \u0646\u0641\u0633\u0647\n\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0643\u0627\u0645\u0644\u060c \u0648\u0647\u0630\u0627 \u0647\u0648 \u0645\u0627 \u0633\u064a\u064f\u062d\u0635\u064e\u0651\u0644 \u0628\u0639\u062f \u062a\u0637\u0628\u064a\u0642 \u0627\u0644\u0631\u0635\u064a\u062f \u0639\u0646\u062f \u0627\u0644\u062f\u0641\u0639. \u0648\u064a\u0643\u0648\u0646 `0.00` \u0645\u062a\u0649 \u0644\u0645\n\u064a\u0628\u0642\u064e \u0634\u064a\u0621 \u0644\u0644\u062f\u0641\u0639.\n" } } }, "credit_applied": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "description": "What the caller's granted credit will take off this order as an iskonto, in the\nPAYMENT's own currency \u2014 capped at a set share of the order's net, so it never covers\nall of it. A PROJECTION, like `payable`: it is taken when the order is paid, and\n`paid_from_balance` is what has actually moved. `0.00` when the account holds no\ncredit, and on a settled order.\n", "x-i18n": { "tr": { "description": "\u00c7a\u011f\u0131ran\u0131n hediye kredisinin bu sipari\u015ften iskonto olarak d\u00fc\u015fece\u011fi tutar, \u00d6DEMEN\u0130N\nkendi para biriminde \u2014 sipari\u015fin net tutar\u0131n\u0131n belirli bir oran\u0131yla s\u0131n\u0131rl\u0131d\u0131r,\ndolay\u0131s\u0131yla tamam\u0131n\u0131 hi\u00e7bir zaman kar\u015f\u0131lamaz. `payable` gibi bir \u00d6NG\u00d6R\u00dcD\u00dcR: tutar\nsipari\u015f \u00f6dendi\u011finde al\u0131n\u0131r, ger\u00e7ekte hareket eden tutar ise\n`paid_from_balance`'t\u0131r. Hesapta kredi yoksa ve kapanm\u0131\u015f sipari\u015flerde `0.00` olur.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0627\u0644\u0630\u064a \u0633\u064a\u062e\u0635\u0645\u0647 \u0631\u0635\u064a\u062f \u0627\u0644\u0645\u064f\u0633\u062a\u062f\u0639\u064a \u0627\u0644\u0645\u0645\u0646\u0648\u062d \u0645\u0646 \u0647\u0630\u0627 \u0627\u0644\u0637\u0644\u0628\u060c \u0628\u0639\u0645\u0644\u0629 \u0627\u0644\u062f\u0641\u0639\u0629 \u0646\u0641\u0633\u0647\u0627 \u2014\n\u0648\u0645\u062d\u062f\u0648\u062f \u0628\u062d\u0635\u0629 \u0645\u0642\u0631\u064e\u0651\u0631\u0629 \u0645\u0646 \u0635\u0627\u0641\u064a \u0627\u0644\u0637\u0644\u0628\u060c \u0641\u0644\u0627 \u064a\u063a\u0637\u0651\u064a\u0647 \u0643\u0627\u0645\u0644\u064b\u0627 \u0623\u0628\u062f\u064b\u0627. \u0648\u0647\u0648 \u062a\u0642\u062f\u064a\u0631 \u0645\u062b\u0644\n`payable`: \u064a\u064f\u0624\u062e\u0630 \u0639\u0646\u062f \u062f\u0641\u0639 \u0627\u0644\u0637\u0644\u0628\u060c \u0623\u0645\u0627 \u0645\u0627 \u062a\u062d\u0631\u064e\u0651\u0643 \u0641\u0639\u0644\u064b\u0627 \u0641\u0647\u0648 `paid_from_balance`.\n\u0648\u064a\u0643\u0648\u0646 `0.00` \u0625\u0646 \u0644\u0645 \u064a\u0643\u0646 \u0641\u064a \u0627\u0644\u062d\u0633\u0627\u0628 \u0631\u0635\u064a\u062f\u060c \u0648\u0643\u0630\u0644\u0643 \u0641\u064a \u0627\u0644\u0637\u0644\u0628 \u0627\u0644\u0645\u064f\u0633\u0648\u064e\u0651\u0649.\n" } } }, "payment_url": { "type": "string", "format": "uri", "nullable": true, "description": "The customer's own payment page for THIS payment, where a person finishes the order\nwith a card. It is not the shop cart, which cannot see an API order at all. `null`\nonce there is nothing to pay.\n", "x-i18n": { "tr": { "description": "BU \u00f6demeye ait, m\u00fc\u015fterinin kendi \u00f6deme sayfas\u0131; sipari\u015fi kartla tamamlamak i\u00e7in\nkullan\u0131l\u0131r. Ma\u011faza sepeti de\u011fildir \u2014 sepet bir API sipari\u015fini hi\u00e7 g\u00f6remez.\n\u00d6denecek bir \u015fey kalmad\u0131\u011f\u0131nda `null` olur.\n" }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0627\u0644\u062f\u0641\u0639 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u0639\u0645\u064a\u0644 \u0644\u0647\u0630\u0647 \u0627\u0644\u062f\u0641\u0639\u0629 \u062a\u062d\u062f\u064a\u062f\u064b\u0627\u060c \u062d\u064a\u062b \u064a\u064f\u062a\u0645\u0651 \u0634\u062e\u0635\u064c \u0627\u0644\u0637\u0644\u0628 \u0628\u0628\u0637\u0627\u0642\u0629. \u0648\u0647\u064a\n\u0644\u064a\u0633\u062a \u0633\u0644\u0629 \u0627\u0644\u0645\u062a\u062c\u0631\u060c \u0627\u0644\u062a\u064a \u0644\u0627 \u062a\u0631\u0649 \u0637\u0644\u0628 \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u0629 \u0625\u0637\u0644\u0627\u0642\u064b\u0627. \u0648\u062a\u0643\u0648\u0646 `null` \u0645\u062a\u0649 \u0644\u0645 \u064a\u0628\u0642\u064e\n\u0634\u064a\u0621 \u0644\u0644\u062f\u0641\u0639.\n" } } } } }, "Ticket": { "type": "object", "required": [ "id", "title", "category", "status", "subscription_id", "reply_count", "created_at", "updated_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the ticket.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Destek talebi var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u062a\u0630\u0643\u0631\u0629." } }, "example": 42 }, "title": { "type": "string", "description": "The subject line.", "x-i18n": { "tr": { "description": "Konu sat\u0131r\u0131." }, "ar": { "description": "\u0633\u0637\u0631 \u0627\u0644\u0645\u0648\u0636\u0648\u0639." } }, "example": "Mail bounces since this morning" }, "category": { "type": "string", "enum": [ "general", "cloud", "billing", "dns", "account", "partnership" ], "description": "What the ticket is about.", "x-i18n": { "tr": { "description": "Talebin konusu." }, "ar": { "description": "\u0645\u0648\u0636\u0648\u0639 \u0627\u0644\u062a\u0630\u0643\u0631\u0629." } }, "example": "general" }, "status": { "type": "string", "enum": [ "new", "open", "pending", "solved", "closed", "merged", "spam", "unknown" ], "description": "Where the thread stands. A `solved` or later ticket takes no more replies; open a new\none instead.\n", "x-i18n": { "tr": { "description": "Talebin durumu. `solved` veya sonras\u0131ndaki bir talep art\u0131k yan\u0131t almaz; bunun\nyerine yeni bir talep a\u00e7\u0131n.\n" }, "ar": { "description": "\u062d\u0627\u0644\u0629 \u0627\u0644\u062a\u0630\u0643\u0631\u0629. \u0644\u0627 \u062a\u0642\u0628\u0644 \u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0627\u0644\u062a\u064a \u0628\u0644\u063a\u062a `solved` \u0623\u0648 \u0645\u0627 \u0628\u0639\u062f\u0647\u0627 \u0631\u062f\u0648\u062f\u064b\u0627 \u0623\u062e\u0631\u0649\u061b \u0627\u0641\u062a\u062d \u062a\u0630\u0643\u0631\u0629\n\u062c\u062f\u064a\u062f\u0629 \u0628\u062f\u0644\u064b\u0627 \u0645\u0646 \u0630\u0644\u0643.\n" } }, "example": "open" }, "subscription_id": { "type": "integer", "nullable": true, "description": "The purchased one-time service this ticket is the work order for, or null on an ordinary\nticket. Such a ticket cannot be closed over the API while the service can still be\nrefunded, because closing it ends that right.\n", "x-i18n": { "tr": { "description": "Bu talebin i\u015f emri oldu\u011fu, sat\u0131n al\u0131nm\u0131\u015f tek seferlik hizmet; s\u0131radan bir talepte\nnull. B\u00f6yle bir talep, hizmet h\u00e2l\u00e2 iade edilebilirken API \u00fczerinden kapat\u0131lamaz,\n\u00e7\u00fcnk\u00fc kapatmak bu hakk\u0131 sona erdirir.\n" }, "ar": { "description": "\u0627\u0644\u062e\u062f\u0645\u0629 \u0627\u0644\u0645\u0634\u062a\u0631\u0627\u0629 \u0644\u0645\u0631\u0629 \u0648\u0627\u062d\u062f\u0629 \u0627\u0644\u062a\u064a \u062a\u0643\u0648\u0646 \u0647\u0630\u0647 \u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0623\u0645\u0631 \u0639\u0645\u0644\u0647\u0627\u060c \u0623\u0648 null \u0641\u064a \u0627\u0644\u062a\u0630\u0643\u0631\u0629\n\u0627\u0644\u0639\u0627\u062f\u064a\u0629. \u0648\u0644\u0627 \u064a\u0645\u0643\u0646 \u0625\u063a\u0644\u0627\u0642 \u0645\u062b\u0644 \u0647\u0630\u0647 \u0627\u0644\u062a\u0630\u0643\u0631\u0629 \u0639\u0628\u0631 API \u0645\u0627 \u062f\u0627\u0645 \u0628\u0627\u0644\u0625\u0645\u0643\u0627\u0646 \u0627\u0633\u062a\u0631\u062f\u0627\u062f \u062b\u0645\u0646 \u0627\u0644\u062e\u062f\u0645\u0629\u060c\n\u0644\u0623\u0646 \u0625\u063a\u0644\u0627\u0642\u0647\u0627 \u064a\u064f\u0646\u0647\u064a \u0647\u0630\u0627 \u0627\u0644\u062d\u0642.\n" } }, "example": null }, "reply_count": { "type": "integer", "description": "How many replies the thread has.", "x-i18n": { "tr": { "description": "Talepteki yan\u0131t say\u0131s\u0131." }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u0631\u062f\u0648\u062f \u0641\u064a \u0627\u0644\u062a\u0630\u0643\u0631\u0629." } }, "example": 3 }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "updated_at": { "type": "string", "format": "date-time", "nullable": true }, "body": { "type": "string", "description": "The opening message. Sent on a single ticket's read and after a write, never in the list.", "x-i18n": { "tr": { "description": "\u0130lk mesaj. Tek bir talebin okunmas\u0131nda ve bir yazmadan sonra g\u00f6nderilir, listede hi\u00e7bir zaman." }, "ar": { "description": "\u0627\u0644\u0631\u0633\u0627\u0644\u0629 \u0627\u0644\u0623\u0648\u0644\u0649. \u062a\u064f\u0631\u0633\u0644 \u0639\u0646\u062f \u0642\u0631\u0627\u0621\u0629 \u062a\u0630\u0643\u0631\u0629 \u0648\u0627\u062d\u062f\u0629 \u0648\u0628\u0639\u062f \u0623\u064a \u0643\u062a\u0627\u0628\u0629\u060c \u0648\u0644\u0627 \u062a\u064f\u0631\u0633\u0644 \u0641\u064a \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0623\u0628\u062f\u064b\u0627." } }, "example": "Every mail to our domain has bounced since 08:00." }, "attachment_count": { "type": "integer", "description": "How many files came with the opening message. Sent where `body` is.", "x-i18n": { "tr": { "description": "\u0130lk mesajla birlikte gelen dosya say\u0131s\u0131. `body` ile ayn\u0131 yerlerde g\u00f6nderilir." }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u0645\u0644\u0641\u0627\u062a \u0627\u0644\u0645\u0631\u0641\u0642\u0629 \u0628\u0627\u0644\u0631\u0633\u0627\u0644\u0629 \u0627\u0644\u0623\u0648\u0644\u0649. \u064a\u064f\u0631\u0633\u0644 \u062d\u064a\u062b \u064a\u064f\u0631\u0633\u0644 `body`." } }, "example": 0 }, "replies": { "type": "array", "description": "Every reply, oldest first. Sent where `body` is.", "x-i18n": { "tr": { "description": "Her yan\u0131t, en eskiden yeniye. `body` ile ayn\u0131 yerlerde g\u00f6nderilir." }, "ar": { "description": "\u0643\u0644 \u0627\u0644\u0631\u062f\u0648\u062f\u060c \u0645\u0646 \u0627\u0644\u0623\u0642\u062f\u0645 \u0625\u0644\u0649 \u0627\u0644\u0623\u062d\u062f\u062b. \u064a\u064f\u0631\u0633\u0644 \u062d\u064a\u062b \u064a\u064f\u0631\u0633\u0644 `body`." } }, "items": { "$ref": "#/components/schemas/TicketComment" } } } }, "TicketComment": { "type": "object", "required": [ "id", "author_name", "from_staff", "is_system", "body", "attachment_count", "created_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier of the reply.", "x-i18n": { "tr": { "description": "Yan\u0131t\u0131n kal\u0131c\u0131 kimli\u011fi." }, "ar": { "description": "\u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u062b\u0627\u0628\u062a \u0644\u0644\u0631\u062f." } }, "example": 311 }, "author_name": { "type": "string", "nullable": true, "description": "The display name of whoever wrote the reply. Null when that login no longer exists.", "x-i18n": { "tr": { "description": "Yan\u0131t\u0131 yazan\u0131n g\u00f6r\u00fcnen ad\u0131. O oturum art\u0131k yoksa null." }, "ar": { "description": "\u0627\u0644\u0627\u0633\u0645 \u0627\u0644\u0645\u0639\u0631\u0648\u0636 \u0644\u0643\u0627\u062a\u0628 \u0627\u0644\u0631\u062f. \u062a\u0643\u0648\u0646 null \u0625\u0630\u0627 \u0644\u0645 \u064a\u0639\u062f \u0630\u0644\u0643 \u0627\u0644\u062d\u0633\u0627\u0628 \u0645\u0648\u062c\u0648\u062f\u064b\u0627." } }, "example": "Ay\u015fe Y\u0131lmaz" }, "from_staff": { "type": "boolean", "description": "Whether a member of our staff wrote the reply.", "x-i18n": { "tr": { "description": "Yan\u0131t\u0131 ekibimizden birinin yaz\u0131p yazmad\u0131\u011f\u0131." }, "ar": { "description": "\u0647\u0644 \u0643\u062a\u0628 \u0627\u0644\u0631\u062f \u0623\u062d\u062f \u0623\u0641\u0631\u0627\u062f \u0641\u0631\u064a\u0642\u0646\u0627." } }, "example": true }, "is_system": { "type": "boolean", "description": "True when the panel wrote the line to record a step of a purchased service's work\n(booked, delivered), rather than a person replying.\n", "x-i18n": { "tr": { "description": "Sat\u0131r, bir ki\u015finin yan\u0131t\u0131 de\u011fil de panelin sat\u0131n al\u0131nm\u0131\u015f bir hizmetin i\u015f\nad\u0131m\u0131n\u0131 (planland\u0131, teslim edildi) kaydetmek i\u00e7in yazd\u0131\u011f\u0131 bir sat\u0131rsa true.\n" }, "ar": { "description": "\u062a\u0643\u0648\u0646 true \u062d\u064a\u0646 \u062a\u0643\u062a\u0628 \u0627\u0644\u0644\u0648\u062d\u0629 \u0627\u0644\u0633\u0637\u0631 \u0644\u062a\u0633\u062c\u064a\u0644 \u062e\u0637\u0648\u0629 \u0645\u0646 \u0639\u0645\u0644 \u062e\u062f\u0645\u0629 \u0645\u0634\u062a\u0631\u0627\u0629 (\u062d\u064f\u062c\u0632\u062a\u060c \u0633\u064f\u0644\u0651\u0645\u062a)\u060c\n\u0644\u0627 \u062d\u064a\u0646 \u064a\u0631\u062f\u0651 \u0634\u062e\u0635.\n" } }, "example": false }, "body": { "type": "string", "description": "The reply's text, as written.", "x-i18n": { "tr": { "description": "Yan\u0131t\u0131n yaz\u0131ld\u0131\u011f\u0131 h\u00e2liyle metni." }, "ar": { "description": "\u0646\u0635 \u0627\u0644\u0631\u062f \u0643\u0645\u0627 \u0643\u064f\u062a\u0628." } }, "example": "The mail server is reachable again; please retry." }, "attachment_count": { "type": "integer", "description": "How many files came with the reply. The files themselves are served in the panel only.", "x-i18n": { "tr": { "description": "Yan\u0131tla birlikte gelen dosya say\u0131s\u0131. Dosyalar\u0131n kendisi yaln\u0131zca panelde sunulur." }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u0645\u0644\u0641\u0627\u062a \u0627\u0644\u0645\u0631\u0641\u0642\u0629 \u0628\u0627\u0644\u0631\u062f. \u0623\u0645\u0627 \u0627\u0644\u0645\u0644\u0641\u0627\u062a \u0646\u0641\u0633\u0647\u0627 \u0641\u0644\u0627 \u062a\u064f\u0642\u062f\u064e\u0651\u0645 \u0625\u0644\u0627 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629." } }, "example": 0 }, "created_at": { "type": "string", "format": "date-time", "nullable": true } } }, "Usage": { "type": "object", "required": [ "available", "message", "from", "to", "day_count", "last_record_date", "scope", "totals", "unmetered", "instances", "volumes" ], "properties": { "available": { "type": "boolean", "description": "False when the cloud's usage records could not be read just now. Every figure is then\nzero and `message` says why; try again in a few minutes.\n", "x-i18n": { "tr": { "description": "Bulutun kullan\u0131m kay\u0131tlar\u0131 \u015fu an okunamad\u0131ysa false. Bu durumda her de\u011fer s\u0131f\u0131rd\u0131r ve\n`message` nedenini s\u00f6yler; birka\u00e7 dakika sonra yeniden deneyin.\n" }, "ar": { "description": "\u062a\u0643\u0648\u0646 false \u0625\u0630\u0627 \u062a\u0639\u0630\u0651\u0631\u062a \u0642\u0631\u0627\u0621\u0629 \u0633\u062c\u0644\u0627\u062a \u0627\u0633\u062a\u062e\u062f\u0627\u0645 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0627\u0644\u0622\u0646. \u0648\u0639\u0646\u062f\u0626\u0630 \u062a\u0643\u0648\u0646 \u0643\u0644 \u0627\u0644\u0623\u0631\u0642\u0627\u0645 \u0635\u0641\u0631\u064b\u0627\n\u0648\u064a\u0630\u0643\u0631 `message` \u0627\u0644\u0633\u0628\u0628\u061b \u0623\u0639\u062f \u0627\u0644\u0645\u062d\u0627\u0648\u0644\u0629 \u0628\u0639\u062f \u0628\u0636\u0639 \u062f\u0642\u0627\u0626\u0642.\n" } }, "example": true }, "message": { "type": "string", "nullable": true, "description": "Why the records could not be read, in the caller's language. Null when they were.", "x-i18n": { "tr": { "description": "Kay\u0131tlar\u0131n neden okunamad\u0131\u011f\u0131, \u00e7a\u011f\u0131ran\u0131n dilinde. Okunabildiyse null." }, "ar": { "description": "\u0633\u0628\u0628 \u062a\u0639\u0630\u0651\u0631 \u0642\u0631\u0627\u0621\u0629 \u0627\u0644\u0633\u062c\u0644\u0627\u062a\u060c \u0628\u0644\u063a\u0629 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a. \u062a\u0643\u0648\u0646 null \u0625\u0630\u0627 \u0642\u064f\u0631\u0626\u062a." } }, "example": null }, "from": { "type": "string", "format": "date", "nullable": true, "description": "The first day of the window (GMT).", "x-i18n": { "tr": { "description": "Aral\u0131\u011f\u0131n ilk g\u00fcn\u00fc (GMT)." }, "ar": { "description": "\u0627\u0644\u064a\u0648\u0645 \u0627\u0644\u0623\u0648\u0644 \u0645\u0646 \u0627\u0644\u0641\u062a\u0631\u0629 (\u0628\u062a\u0648\u0642\u064a\u062a \u063a\u0631\u064a\u0646\u062a\u0634)." } }, "example": "2026-08-30" }, "to": { "type": "string", "format": "date", "nullable": true, "description": "The last day of the window (GMT) \u2014 yesterday at the latest, because today is not counted yet.", "x-i18n": { "tr": { "description": "Aral\u0131\u011f\u0131n son g\u00fcn\u00fc (GMT) \u2014 en ge\u00e7 d\u00fcn, \u00e7\u00fcnk\u00fc bug\u00fcn hen\u00fcz say\u0131lmaz." }, "ar": { "description": "\u0627\u0644\u064a\u0648\u0645 \u0627\u0644\u0623\u062e\u064a\u0631 \u0645\u0646 \u0627\u0644\u0641\u062a\u0631\u0629 (\u0628\u062a\u0648\u0642\u064a\u062a \u063a\u0631\u064a\u0646\u062a\u0634) \u2014 \u0627\u0644\u0623\u0645\u0633 \u0639\u0644\u0649 \u0627\u0644\u0623\u0643\u062b\u0631\u060c \u0644\u0623\u0646 \u0627\u0644\u064a\u0648\u0645 \u0644\u0645 \u064a\u064f\u062d\u062a\u0633\u0628 \u0628\u0639\u062f." } }, "example": "2026-09-28" }, "day_count": { "type": "integer", "description": "How many days the window covers.", "x-i18n": { "tr": { "description": "Aral\u0131\u011f\u0131n kapsad\u0131\u011f\u0131 g\u00fcn say\u0131s\u0131." }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u0623\u064a\u0627\u0645 \u0627\u0644\u062a\u064a \u062a\u063a\u0637\u064a\u0647\u0627 \u0627\u0644\u0641\u062a\u0631\u0629." } }, "example": 30 }, "last_record_date": { "type": "string", "nullable": true, "description": "The newest day any record was found for, or null when none was.", "x-i18n": { "tr": { "description": "Kay\u0131t bulunan en yeni g\u00fcn; hi\u00e7 kay\u0131t yoksa null." }, "ar": { "description": "\u0623\u062d\u062f\u062b \u064a\u0648\u0645 \u0648\u064f\u062c\u062f \u0644\u0647 \u0633\u062c\u0644\u0651\u060c \u0623\u0648 null \u0625\u0646 \u0644\u0645 \u064a\u0648\u062c\u062f \u0623\u064a \u0633\u062c\u0644\u0651." } }, "example": "2026-09-28" }, "scope": { "type": "object", "required": [ "type", "id" ], "description": "What the figures cover \u2014 the whole account, one machine or one disk. A machine or a disk\ncarries only what the cloud meters per machine or per disk; `unmetered` names the rest.\n", "x-i18n": { "tr": { "description": "De\u011ferlerin neyi kapsad\u0131\u011f\u0131 \u2014 hesab\u0131n tamam\u0131, tek bir makine ya da tek bir disk. Bir\nmakine ya da disk yaln\u0131zca bulutun makine ya da disk ba\u015f\u0131na \u00f6l\u00e7t\u00fcklerini ta\u015f\u0131r; geri\nkalanlar\u0131 `unmetered` ad\u0131yla sayar.\n" }, "ar": { "description": "\u0645\u0627 \u062a\u063a\u0637\u064a\u0647 \u0627\u0644\u0623\u0631\u0642\u0627\u0645 \u2014 \u0627\u0644\u062d\u0633\u0627\u0628 \u0643\u0644\u0647 \u0623\u0648 \u062c\u0647\u0627\u0632 \u0648\u0627\u062d\u062f \u0623\u0648 \u0642\u0631\u0635 \u0648\u0627\u062d\u062f. \u0648\u0644\u0627 \u064a\u062d\u0645\u0644 \u0627\u0644\u062c\u0647\u0627\u0632 \u0623\u0648 \u0627\u0644\u0642\u0631\u0635 \u0625\u0644\u0627 \u0645\u0627\n\u062a\u0642\u064a\u0633\u0647 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0644\u0643\u0644 \u062c\u0647\u0627\u0632 \u0623\u0648 \u0644\u0643\u0644 \u0642\u0631\u0635\u061b \u0648\u064a\u0630\u0643\u0631 `unmetered` \u0627\u0644\u0628\u0627\u0642\u064a \u0628\u0623\u0633\u0645\u0627\u0626\u0647.\n" } }, "properties": { "type": { "type": "string", "enum": [ "account", "instance", "volume" ] }, "id": { "type": "integer", "nullable": true } } }, "totals": { "type": "object", "description": "The window's totals. Hours and GB sent/received are sums; the storage figures are the\naverage GB held per day. Quantities only \u2014 the bill is on `/payments`.\n", "x-i18n": { "tr": { "description": "Aral\u0131\u011f\u0131n toplamlar\u0131. Saatler ve g\u00f6nderilen/al\u0131nan GB toplamd\u0131r; depolama de\u011ferleri\ng\u00fcnl\u00fck ortalama GB'd\u0131r. Yaln\u0131zca miktarlar \u2014 fatura `/payments` alt\u0131ndad\u0131r.\n" }, "ar": { "description": "\u0625\u062c\u0645\u0627\u0644\u064a\u0627\u062a \u0627\u0644\u0641\u062a\u0631\u0629. \u0627\u0644\u0633\u0627\u0639\u0627\u062a \u0648\u0627\u0644\u063a\u064a\u063a\u0627\u0628\u0627\u064a\u062a \u0627\u0644\u0645\u064f\u0631\u0633\u0644\u0629/\u0627\u0644\u0645\u064f\u0633\u062a\u0642\u0628\u0644\u0629 \u0645\u062c\u0627\u0645\u064a\u0639\u061b \u0648\u0623\u0631\u0642\u0627\u0645 \u0627\u0644\u062a\u062e\u0632\u064a\u0646 \u0647\u064a \u0645\u062a\u0648\u0633\u0637\n\u0627\u0644\u063a\u064a\u063a\u0627\u0628\u0627\u064a\u062a \u0627\u0644\u0645\u062d\u0641\u0648\u0638\u0629 \u064a\u0648\u0645\u064a\u064b\u0627. \u0643\u0645\u064a\u0627\u062a \u0641\u0642\u0637 \u2014 \u0627\u0644\u0641\u0627\u062a\u0648\u0631\u0629 \u0641\u064a `/payments`.\n" } }, "required": [ "running_vm_hours", "allocated_vm_hours", "storage_gb_average", "snapshot_gb_average", "template_iso_gb_average", "ip_hours", "network_sent_gb", "network_received_gb" ], "properties": { "running_vm_hours": { "type": "number" }, "allocated_vm_hours": { "type": "number" }, "storage_gb_average": { "type": "number" }, "snapshot_gb_average": { "type": "number" }, "template_iso_gb_average": { "type": "number" }, "ip_hours": { "type": "number" }, "network_sent_gb": { "type": "number" }, "network_received_gb": { "type": "number" } } }, "unmetered": { "type": "array", "description": "The `totals` and `daily` keys this scope does NOT measure. Empty for the whole account.\nIP address hours and network traffic are metered per address and per network, snapshots\nper snapshot and templates/ISOs per image, so one machine lists `snapshot_gb_average`,\n`snapshot_gb`, `template_iso_gb_average`, `template_iso_gb`, `ip_hours`,\n`network_sent_gb` and `network_received_gb`; one disk lists those and both machine-hour\nkeys. A key listed here still carries a number, and that number is not a measurement \u2014\nnever read it as \"used nothing\". For traffic, read the whole account.\n", "x-i18n": { "tr": { "description": "Bu kapsam\u0131n \u00d6L\u00c7MED\u0130\u011e\u0130 `totals` ve `daily` anahtarlar\u0131. Hesab\u0131n tamam\u0131 i\u00e7in bo\u015ftur.\nIP adresi saatleri ve a\u011f trafi\u011fi adres ve a\u011f ba\u015f\u0131na, anl\u0131k g\u00f6r\u00fcnt\u00fcler anl\u0131k g\u00f6r\u00fcnt\u00fc\nba\u015f\u0131na, \u015fablonlar ve ISO'lar g\u00f6r\u00fcnt\u00fc ba\u015f\u0131na \u00f6l\u00e7\u00fcl\u00fcr; bu y\u00fczden tek bir makine\n`snapshot_gb_average`, `snapshot_gb`, `template_iso_gb_average`, `template_iso_gb`,\n`ip_hours`, `network_sent_gb` ve `network_received_gb` anahtarlar\u0131n\u0131, tek bir disk\nbunlarla birlikte iki makine saati anahtar\u0131n\u0131 da sayar. Burada ad\u0131 ge\u00e7en bir anahtar\nyine de bir say\u0131 ta\u015f\u0131r ve o say\u0131 bir \u00f6l\u00e7\u00fcm de\u011fildir \u2014 asla \"hi\u00e7 kullan\u0131lmad\u0131\" diye\nokumay\u0131n. Trafik i\u00e7in hesab\u0131n tamam\u0131n\u0131 okuyun.\n" }, "ar": { "description": "\u0645\u0641\u0627\u062a\u064a\u062d `totals` \u0648`daily` \u0627\u0644\u062a\u064a \u0644\u0627 \u064a\u0642\u064a\u0633\u0647\u0627 \u0647\u0630\u0627 \u0627\u0644\u0646\u0637\u0627\u0642. \u0648\u062a\u0643\u0648\u0646 \u0641\u0627\u0631\u063a\u0629 \u0644\u0644\u062d\u0633\u0627\u0628 \u0643\u0644\u0647. \u062a\u064f\u0642\u0627\u0633\n\u0633\u0627\u0639\u0627\u062a \u0639\u0646\u0627\u0648\u064a\u0646 IP \u0648\u062d\u0631\u0643\u0629 \u0627\u0644\u0634\u0628\u0643\u0629 \u0644\u0643\u0644 \u0639\u0646\u0648\u0627\u0646 \u0648\u0644\u0643\u0644 \u0634\u0628\u0643\u0629\u060c \u0648\u0627\u0644\u0644\u0642\u0637\u0627\u062a \u0644\u0643\u0644 \u0644\u0642\u0637\u0629\u060c \u0648\u0627\u0644\u0642\u0648\u0627\u0644\u0628 \u0648\u0645\u0644\u0641\u0627\u062a\nISO \u0644\u0643\u0644 \u0635\u0648\u0631\u0629\u061b \u0648\u0644\u0630\u0644\u0643 \u064a\u0630\u0643\u0631 \u0627\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0648\u0627\u062d\u062f `snapshot_gb_average` \u0648`snapshot_gb`\n\u0648`template_iso_gb_average` \u0648`template_iso_gb` \u0648`ip_hours` \u0648`network_sent_gb`\n\u0648`network_received_gb`\u060c \u0648\u064a\u0630\u0643\u0631 \u0627\u0644\u0642\u0631\u0635 \u0627\u0644\u0648\u0627\u062d\u062f \u0647\u0630\u0647 \u0627\u0644\u0645\u0641\u0627\u062a\u064a\u062d \u0648\u0645\u0639\u0647\u0627 \u0645\u0641\u062a\u0627\u062d\u064a \u0633\u0627\u0639\u0627\u062a \u0627\u0644\u0623\u062c\u0647\u0632\u0629.\n\u0648\u064a\u0628\u0642\u0649 \u0644\u0644\u0645\u0641\u062a\u0627\u062d \u0627\u0644\u0645\u0630\u0643\u0648\u0631 \u0647\u0646\u0627 \u0631\u0642\u0645\u060c \u0644\u0643\u0646\u0647 \u0644\u064a\u0633 \u0642\u064a\u0627\u0633\u064b\u0627 \u2014 \u0641\u0644\u0627 \u062a\u0642\u0631\u0623\u0647 \u0623\u0628\u062f\u064b\u0627 \u0639\u0644\u0649 \u0623\u0646\u0647 \"\u0644\u0645 \u064a\u064f\u0633\u062a\u062e\u062f\u0645\n\u0634\u064a\u0621\". \u0648\u0644\u0645\u0639\u0631\u0641\u0629 \u0627\u0644\u062d\u0631\u0643\u0629 \u0627\u0642\u0631\u0623 \u0627\u0644\u062d\u0633\u0627\u0628 \u0643\u0644\u0647.\n" } }, "items": { "type": "string" } }, "instances": { "type": "array", "description": "One row per machine the records name, heaviest first. `id` is null for a machine that\nis no longer yours to address (deleted since); its last known name is kept.\n", "x-i18n": { "tr": { "description": "Kay\u0131tlarda ge\u00e7en her makine i\u00e7in bir sat\u0131r, en \u00e7ok kullanan ba\u015fta. O zamandan beri\nsilinmi\u015f, art\u0131k sizin adresleyemeyece\u011finiz bir makinede `id` null olur; bilinen son ad\u0131\nkorunur.\n" }, "ar": { "description": "\u0633\u0637\u0631 \u0644\u0643\u0644 \u062c\u0647\u0627\u0632 \u062a\u0630\u0643\u0631\u0647 \u0627\u0644\u0633\u062c\u0644\u0627\u062a\u060c \u0627\u0644\u0623\u062b\u0642\u0644 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u064b\u0627 \u0623\u0648\u0644\u064b\u0627. \u064a\u0643\u0648\u0646 `id` null \u0644\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0630\u064a \u0644\u0645 \u064a\u0639\u062f\n\u0628\u0625\u0645\u0643\u0627\u0646\u0643 \u0645\u062e\u0627\u0637\u0628\u062a\u0647 (\u062d\u064f\u0630\u0641 \u0645\u0646\u0630 \u0630\u0644\u0643 \u0627\u0644\u062d\u064a\u0646)\u061b \u0648\u064a\u064f\u062d\u062a\u0641\u0638 \u0628\u0627\u0633\u0645\u0647 \u0627\u0644\u0623\u062e\u064a\u0631 \u0627\u0644\u0645\u0639\u0631\u0648\u0641.\n" } }, "items": { "type": "object", "required": [ "id", "name", "running_hours", "allocated_hours" ], "properties": { "id": { "type": "integer", "nullable": true }, "name": { "type": "string" }, "running_hours": { "type": "number" }, "allocated_hours": { "type": "number" } } } }, "volumes": { "type": "array", "description": "One row per disk the records name, heaviest first. `id` is null as for machines.", "x-i18n": { "tr": { "description": "Kay\u0131tlarda ge\u00e7en her disk i\u00e7in bir sat\u0131r, en \u00e7ok kullanan ba\u015fta. `id`, makinelerde oldu\u011fu gibi null olabilir." }, "ar": { "description": "\u0633\u0637\u0631 \u0644\u0643\u0644 \u0642\u0631\u0635 \u062a\u0630\u0643\u0631\u0647 \u0627\u0644\u0633\u062c\u0644\u0627\u062a\u060c \u0627\u0644\u0623\u062b\u0642\u0644 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u064b\u0627 \u0623\u0648\u0644\u064b\u0627. \u0648\u0642\u062f \u064a\u0643\u0648\u0646 `id` null \u0643\u0645\u0627 \u0641\u064a \u0627\u0644\u0623\u062c\u0647\u0632\u0629." } }, "items": { "type": "object", "required": [ "id", "name", "size_gb", "hours" ], "properties": { "id": { "type": "integer", "nullable": true }, "name": { "type": "string" }, "size_gb": { "type": "number" }, "hours": { "type": "number" } } } }, "daily": { "type": "array", "description": "One row per GMT day of the window, with the same eight figures per day.", "x-i18n": { "tr": { "description": "Aral\u0131\u011f\u0131n her GMT g\u00fcn\u00fc i\u00e7in, g\u00fcn ba\u015f\u0131na ayn\u0131 sekiz de\u011feri ta\u015f\u0131yan bir sat\u0131r." }, "ar": { "description": "\u0633\u0637\u0631 \u0644\u0643\u0644 \u064a\u0648\u0645 \u0645\u0646 \u0623\u064a\u0627\u0645 \u0627\u0644\u0641\u062a\u0631\u0629 \u0628\u062a\u0648\u0642\u064a\u062a \u063a\u0631\u064a\u0646\u062a\u0634\u060c \u064a\u062d\u0645\u0644 \u0627\u0644\u0623\u0631\u0642\u0627\u0645 \u0627\u0644\u062b\u0645\u0627\u0646\u064a\u0629 \u0646\u0641\u0633\u0647\u0627 \u0644\u0643\u0644 \u064a\u0648\u0645." } }, "items": { "type": "object", "required": [ "date", "running_vm_hours", "allocated_vm_hours", "storage_gb", "snapshot_gb", "template_iso_gb", "ip_hours", "network_sent_gb", "network_received_gb" ], "properties": { "date": { "type": "string", "format": "date" }, "running_vm_hours": { "type": "number" }, "allocated_vm_hours": { "type": "number" }, "storage_gb": { "type": "number" }, "snapshot_gb": { "type": "number" }, "template_iso_gb": { "type": "number" }, "ip_hours": { "type": "number" }, "network_sent_gb": { "type": "number" }, "network_received_gb": { "type": "number" } } } } } }, "UserRef": { "type": "object", "description": "A minimal reference to a user, projected to `id`, `name` and `email` and nothing\nelse. Never a serialised `User`: that model's `$hidden` list does not cover\n`identity_number`, `passport_number`, `birthdate`, the telegram ids or `balance`,\nso every staff payload builds its user references field by field instead.\n", "x-i18n": { "tr": { "description": "Bir kullan\u0131c\u0131ya yap\u0131lan en k\u00fc\u00e7\u00fck referans; yaln\u0131zca `id`, `name` ve `email`\nalanlar\u0131na indirgenmi\u015ftir, ba\u015fka hi\u00e7bir \u015feye de\u011fil. Hi\u00e7bir zaman serile\u015ftirilmi\u015f\nbir `User` de\u011fildir: o modelin `$hidden` listesi `identity_number`,\n`passport_number`, `birthdate`, telegram kimlikleri ya da `balance` alanlar\u0131n\u0131\nkapsamaz; bu y\u00fczden personel taraf\u0131ndaki her yan\u0131t, kullan\u0131c\u0131 referanslar\u0131n\u0131 alan\nalan kendisi kurar.\n" }, "ar": { "description": "\u0625\u0634\u0627\u0631\u0629 \u0645\u062e\u062a\u0635\u0631\u0629 \u0625\u0644\u0649 \u0645\u0633\u062a\u062e\u062f\u0645\u060c \u0645\u0642\u0635\u0648\u0631\u0629 \u0639\u0644\u0649 `id` \u0648`name` \u0648`email` \u0644\u0627 \u063a\u064a\u0631. \u0648\u0647\u064a \u0644\u064a\u0633\u062a\n`User` \u0645\u064f\u0633\u0644\u0633\u064e\u0644\u064b\u0627 \u0623\u0628\u062f\u064b\u0627: \u0641\u0642\u0627\u0626\u0645\u0629 `$hidden` \u0641\u064a \u0630\u0644\u0643 \u0627\u0644\u0646\u0645\u0648\u0630\u062c \u0644\u0627 \u062a\u063a\u0637\u0651\u064a\n`identity_number` \u0648\u0644\u0627 `passport_number` \u0648\u0644\u0627 `birthdate` \u0648\u0644\u0627 \u0645\u0639\u0631\u0651\u0641\u0627\u062a telegram \u0648\u0644\u0627\n`balance`\u060c \u0648\u0644\u0630\u0644\u0643 \u062a\u0628\u0646\u064a \u0643\u0644 \u062d\u0645\u0648\u0644\u0629 \u0639\u0644\u0649 \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0645\u0648\u0638\u0641\u064a\u0646 \u0625\u0634\u0627\u0631\u0627\u062a\u0647\u0627 \u0625\u0644\u0649 \u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645\u064a\u0646 \u062d\u0642\u0644\u064b\u0627\n\u062d\u0642\u0644\u064b\u0627.\n" } }, "required": [ "id", "name", "email" ], "properties": { "id": { "type": "integer", "example": 412 }, "name": { "type": "string", "example": "Ada Lovelace" }, "email": { "type": "string", "format": "email", "example": "ada@example.com" } } }, "AuditLog": { "type": "object", "description": "One row of the append-only audit trail.\n\nThe field set is exactly the column list the panel's own CSV export chose, plus\nthe actor/subject ids. Four stored columns are deliberately **not** published:\n\n* `changes` and `context` \u2014 redaction is a write-time, best-effort concern, so the\n stored payload is only as safe as what the writer happened to redact, and it\n carries whatever attribute names a model mutated. The panel's CSV export omits\n both for the same reason.\n* `hash` and `previous_hash` \u2014 the hash covers `changes` and `context`, so a hash\n published without its payload cannot be verified by a client. The chain is sealed\n and verified out of band by the `c2:verify-audit-chain` command.\n\nAdding a field to this schema later is additive; removing one is a v2.\n", "x-i18n": { "tr": { "description": "Yaln\u0131zca ekleme yap\u0131lan denetim izinin tek bir sat\u0131r\u0131.\n\nAlan k\u00fcmesi, panelin kendi CSV d\u0131\u015fa aktar\u0131m\u0131n\u0131n se\u00e7ti\u011fi s\u00fctun listesinin\nayn\u0131s\u0131d\u0131r; buna eylemi yapan\u0131n ve veri sahibinin kimlikleri eklenir. Saklanan\nd\u00f6rt s\u00fctun bilin\u00e7li olarak **yay\u0131mlanmaz**:\n\n* `changes` ve `context` \u2014 maskeleme, yazma an\u0131nda elden geldi\u011fince yap\u0131lan bir\n i\u015ftir; bu y\u00fczden saklanan i\u00e7erik ancak yazan\u0131n maskeleyebildi\u011fi kadar\n g\u00fcvenlidir ve bir modelin de\u011fi\u015ftirdi\u011fi b\u00fct\u00fcn \u00f6znitelik adlar\u0131n\u0131 ta\u015f\u0131r.\n Panelin CSV d\u0131\u015fa aktar\u0131m\u0131 da ayn\u0131 nedenle ikisini birden d\u0131\u015far\u0131da b\u0131rak\u0131r.\n* `hash` ve `previous_hash` \u2014 \u00f6zet `changes` ve `context` alanlar\u0131n\u0131 da kapsar;\n dolay\u0131s\u0131yla i\u00e7eri\u011fi olmadan yay\u0131mlanan bir \u00f6zeti istemci do\u011frulayamaz. Zincir\n `c2:verify-audit-chain` komutuyla ayr\u0131 bir kanalda m\u00fch\u00fcrlenir ve do\u011frulan\u0131r.\n\nBu \u015femaya sonradan alan eklemek eklemeli bir de\u011fi\u015fikliktir; alan kald\u0131rmak ise\nv2 demektir.\n" }, "ar": { "description": "\u0635\u0641\u064c\u0651 \u0648\u0627\u062d\u062f \u0645\u0646 \u0633\u062c\u0644\u0651 \u0627\u0644\u062a\u062f\u0642\u064a\u0642 \u0627\u0644\u0630\u064a \u0644\u0627 \u064a\u0642\u0628\u0644 \u0625\u0644\u0627 \u0627\u0644\u0625\u0636\u0627\u0641\u0629.\n\n\u0645\u062c\u0645\u0648\u0639\u0629 \u0627\u0644\u062d\u0642\u0648\u0644 \u0647\u064a \u0628\u0627\u0644\u0636\u0628\u0637 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0623\u0639\u0645\u062f\u0629 \u0627\u0644\u062a\u064a \u0627\u062e\u062a\u0627\u0631\u0647\u0627 \u062a\u0635\u062f\u064a\u0631 CSV \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629\u060c\n\u0645\u0636\u0627\u0641\u064b\u0627 \u0625\u0644\u064a\u0647\u0627 \u0645\u0639\u0631\u0651\u0641\u0627 \u0627\u0644\u0641\u0627\u0639\u0644 \u0648\u0635\u0627\u062d\u0628 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a. \u0648\u0623\u0631\u0628\u0639\u0629 \u0623\u0639\u0645\u062f\u0629 \u0645\u062e\u0632\u064e\u0651\u0646\u0629 **\u0644\u0627** \u062a\u064f\u0646\u0634\u064e\u0631\n\u0639\u0646 \u0642\u0635\u062f:\n\n* `changes` \u0648`context` \u2014 \u0641\u0627\u0644\u062a\u0646\u0642\u064a\u062d \u0634\u0623\u0646\u064c \u064a\u062c\u0631\u064a \u0648\u0642\u062a \u0627\u0644\u0643\u062a\u0627\u0628\u0629 \u0648\u0628\u0623\u0641\u0636\u0644 \u062c\u0647\u062f \u0645\u0645\u0643\u0646\u060c \u0641\u0644\u0627\n \u062a\u0643\u0648\u0646 \u0627\u0644\u062d\u0645\u0648\u0644\u0629 \u0627\u0644\u0645\u062e\u0632\u064e\u0651\u0646\u0629 \u0622\u0645\u0646\u0629 \u0625\u0644\u0627 \u0628\u0642\u062f\u0631 \u0645\u0627 \u0646\u0642\u0651\u062d\u0647 \u0627\u0644\u0643\u0627\u062a\u0628 \u0641\u0639\u0644\u064b\u0627\u060c \u0648\u0647\u064a \u062a\u062d\u0645\u0644 \u0623\u0633\u0645\u0627\u0621\n \u0623\u064a \u062e\u0635\u0627\u0626\u0635 \u0639\u062f\u0651\u0644\u0647\u0627 \u0627\u0644\u0646\u0645\u0648\u0630\u062c. \u0648\u064a\u062d\u0630\u0641 \u062a\u0635\u062f\u064a\u0631 CSV \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0643\u0644\u064a\u0647\u0645\u0627 \u0644\u0644\u0633\u0628\u0628 \u0646\u0641\u0633\u0647.\n* `hash` \u0648`previous_hash` \u2014 \u0625\u0630 \u062a\u063a\u0637\u064a \u0627\u0644\u0628\u0635\u0645\u0629 `changes` \u0648`context`\u060c \u0641\u0627\u0644\u0628\u0635\u0645\u0629\n \u0627\u0644\u0645\u0646\u0634\u0648\u0631\u0629 \u062f\u0648\u0646 \u062d\u0645\u0648\u0644\u062a\u0647\u0627 \u0644\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u062a\u062d\u0642\u0642 \u0645\u0646\u0647\u0627. \u0648\u0627\u0644\u0633\u0644\u0633\u0644\u0629 \u062a\u064f\u062e\u062a\u064e\u0645\n \u0648\u064a\u064f\u062a\u062d\u0642\u064e\u0651\u0642 \u0645\u0646\u0647\u0627 \u062e\u0627\u0631\u062c \u0647\u0630\u0647 \u0627\u0644\u0642\u0646\u0627\u0629 \u0628\u0623\u0645\u0631 `c2:verify-audit-chain`.\n\n\u0625\u0636\u0627\u0641\u0629 \u062d\u0642\u0644 \u0625\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0645\u062e\u0637\u0637 \u0644\u0627\u062d\u0642\u064b\u0627 \u062a\u063a\u064a\u064a\u0631\u064c \u0625\u0636\u0627\u0641\u064a\u061b \u0623\u0645\u0627 \u062d\u0630\u0641 \u062d\u0642\u0644 \u0641\u064a\u0639\u0646\u064a \u0625\u0635\u062f\u0627\u0631\u064b\u0627 \u062b\u0627\u0646\u064a\u064b\u0627\n(v2).\n" } }, "required": [ "id", "occurred_at", "actor", "actor_role", "subject", "event", "domain", "auditable_type", "auditable_id" ], "properties": { "id": { "type": "integer", "example": 90211 }, "occurred_at": { "type": "string", "format": "date-time", "description": "When the recorded action happened. The trail is ordered by this field, newest first, with the id breaking ties.", "x-i18n": { "tr": { "description": "Kaydedilen eylemin ger\u00e7ekle\u015fti\u011fi an. \u0130z bu alana g\u00f6re, en yeniden ba\u015flayarak s\u0131ralan\u0131r; e\u015fitli\u011fi id bozar." }, "ar": { "description": "\u0648\u0642\u062a \u0648\u0642\u0648\u0639 \u0627\u0644\u0625\u062c\u0631\u0627\u0621 \u0627\u0644\u0645\u0633\u062c\u064e\u0651\u0644. \u0648\u064a\u064f\u0631\u062a\u064e\u0651\u0628 \u0627\u0644\u0633\u062c\u0644\u0651 \u0628\u0647\u0630\u0627 \u0627\u0644\u062d\u0642\u0644 \u0645\u0646 \u0627\u0644\u0623\u062d\u062f\u062b \u0625\u0644\u0649 \u0627\u0644\u0623\u0642\u062f\u0645\u060c \u0648\u064a\u0641\u0635\u0644 \u0627\u0644\u0645\u0639\u0631\u0651\u0641 \u0628\u064a\u0646 \u0627\u0644\u0645\u062a\u0633\u0627\u0648\u064a\u064a\u0646." } } }, "actor": { "allOf": [ { "$ref": "#/components/schemas/UserRef" } ], "nullable": true, "description": "Who acted, or `null` \u2014 either a system action (scheduler, `c2:*` command,\nconsole) or an actor whose account has since been deleted, since `actor_id` is\n`nullOnDelete`. A row with a null actor still describes a real event.\n", "x-i18n": { "tr": { "description": "Eylemi kimin yapt\u0131\u011f\u0131 ya da `null` \u2014 bu ya bir sistem eylemidir\n(zamanlay\u0131c\u0131, `c2:*` komutu, konsol) ya da hesab\u0131 sonradan silinmi\u015f bir\nakt\u00f6rd\u00fcr; \u00e7\u00fcnk\u00fc `actor_id` alan\u0131 `nullOnDelete` tan\u0131ml\u0131d\u0131r. Akt\u00f6r\u00fc null\nolan bir sat\u0131r yine de ger\u00e7ek bir olay\u0131 anlat\u0131r.\n" }, "ar": { "description": "\u0645\u0646 \u0642\u0627\u0645 \u0628\u0627\u0644\u0625\u062c\u0631\u0627\u0621\u060c \u0623\u0648 `null` \u2014 \u0625\u0645\u0651\u0627 \u0625\u062c\u0631\u0627\u0621 \u0646\u0638\u0627\u0645 (\u0627\u0644\u0645\u062c\u062f\u0648\u0644\u060c \u0623\u0645\u0631 `c2:*`\u060c\n\u0627\u0644\u0637\u0631\u0641\u064a\u0629) \u0648\u0625\u0645\u0651\u0627 \u0641\u0627\u0639\u0644 \u062d\u064f\u0630\u0641 \u062d\u0633\u0627\u0628\u0647 \u0644\u0627\u062d\u0642\u064b\u0627\u060c \u0644\u0623\u0646 `actor_id` \u0645\u0639\u0631\u064e\u0651\u0641 \u0628\u0640\n`nullOnDelete`. \u0648\u0627\u0644\u0635\u0641 \u0627\u0644\u0630\u064a \u0641\u0627\u0639\u0644\u0647 null \u064a\u0635\u0641 \u0645\u0639 \u0630\u0644\u0643 \u062d\u062f\u062b\u064b\u0627 \u062d\u0642\u064a\u0642\u064a\u064b\u0627.\n" } } }, "actor_role": { "type": "string", "description": "The highest role the actor held at the time, or `system` when there was no\nactor. Closed set: these are the four roles the audit writer ranks, plus\n`system`. A user holding only a custom, operator-created role is recorded as\n`system` \u2014 the writer has no rank for it.\n", "x-i18n": { "tr": { "description": "Akt\u00f6r\u00fcn o anda ta\u015f\u0131d\u0131\u011f\u0131 en y\u00fcksek rol ya da akt\u00f6r yoksa `system`. Kapal\u0131\nbir k\u00fcmedir: denetim yaz\u0131c\u0131s\u0131n\u0131n s\u0131ralad\u0131\u011f\u0131 d\u00f6rt rol ve `system`. Yaln\u0131zca\noperat\u00f6r\u00fcn olu\u015fturdu\u011fu \u00f6zel bir rol\u00fc ta\u015f\u0131yan kullan\u0131c\u0131 `system` olarak\nkaydedilir \u2014 yaz\u0131c\u0131n\u0131n o rol i\u00e7in bir s\u0131ras\u0131 yoktur.\n" }, "ar": { "description": "\u0623\u0639\u0644\u0649 \u062f\u0648\u0631 \u0643\u0627\u0646 \u064a\u062d\u0645\u0644\u0647 \u0627\u0644\u0641\u0627\u0639\u0644 \u062d\u064a\u0646\u0647\u0627\u060c \u0623\u0648 `system` \u0625\u0646 \u0644\u0645 \u064a\u0643\u0646 \u0647\u0646\u0627\u0643 \u0641\u0627\u0639\u0644. \u0648\u0647\u064a\n\u0645\u062c\u0645\u0648\u0639\u0629 \u0645\u063a\u0644\u0642\u0629: \u0627\u0644\u0623\u062f\u0648\u0627\u0631 \u0627\u0644\u0623\u0631\u0628\u0639\u0629 \u0627\u0644\u062a\u064a \u064a\u0631\u062a\u0651\u0628\u0647\u0627 \u0643\u0627\u062a\u0628 \u0627\u0644\u062a\u062f\u0642\u064a\u0642\u060c \u0625\u0636\u0627\u0641\u0629\u064b \u0625\u0644\u0649\n`system`. \u0648\u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645 \u0627\u0644\u0630\u064a \u0644\u0627 \u064a\u062d\u0645\u0644 \u0625\u0644\u0627 \u062f\u0648\u0631\u064b\u0627 \u0645\u062e\u0635\u0635\u064b\u0627 \u0623\u0646\u0634\u0623\u0647 \u0627\u0644\u0645\u0634\u063a\u0651\u0644 \u064a\u064f\u0633\u062c\u064e\u0651\u0644\n\u0628\u0648\u0635\u0641\u0647 `system` \u2014 \u0625\u0630 \u0644\u0627 \u0631\u062a\u0628\u0629 \u0644\u0647\u0630\u0627 \u0627\u0644\u062f\u0648\u0631 \u0644\u062f\u0649 \u0627\u0644\u0643\u0627\u062a\u0628.\n" } }, "enum": [ "user", "support", "admin", "super-admin", "system" ] }, "subject": { "allOf": [ { "$ref": "#/components/schemas/UserRef" } ], "nullable": true, "description": "The data subject the row is about \u2014 the person whose data was read or changed \u2014 or `null`.", "x-i18n": { "tr": { "description": "Sat\u0131r\u0131n konusu olan veri sahibi \u2014 verisi okunan ya da de\u011fi\u015ftirilen ki\u015fi \u2014 ya da `null`." }, "ar": { "description": "\u0635\u0627\u062d\u0628 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0644\u0630\u064a \u064a\u062a\u0639\u0644\u0642 \u0628\u0647 \u0627\u0644\u0635\u0641 \u2014 \u0623\u064a \u0627\u0644\u0634\u062e\u0635 \u0627\u0644\u0630\u064a \u0642\u064f\u0631\u0626\u062a \u0628\u064a\u0627\u0646\u0627\u062a\u0647 \u0623\u0648 \u0639\u064f\u062f\u0651\u0644\u062a \u2014 \u0623\u0648 `null`." } } }, "event": { "type": "string", "description": "Dotted event name; its prefix picks the `domain`.", "x-i18n": { "tr": { "description": "Noktal\u0131 olay ad\u0131; \u00f6n eki `domain` alan\u0131n\u0131 belirler." }, "ar": { "description": "\u0627\u0633\u0645 \u0627\u0644\u062d\u062f\u062b \u0628\u0635\u064a\u063a\u0629 \u0645\u0646\u0642\u0651\u0637\u0629\u061b \u0648\u0628\u0627\u062f\u0626\u062a\u0647 \u0647\u064a \u0627\u0644\u062a\u064a \u062a\u062d\u062f\u062f `domain`." } }, "example": "account.pii_read" }, "domain": { "type": "string", "description": "The subject area. The first five values are 1:1 with the support-assignment\ncapability columns, which is what makes the trail filterable for a support\nagent; `auth`, `shop`, `privacy`, `partner` and `system` have no support\nequivalent and are never visible to one.\n\nThis list is the backing values of `App\\Enums\\AuditDomain`, in order, and a\ntest asserts it stays that way \u2014 the runtime filter derives its own rule from\nthat enum, so a value missing here is spec drift and nothing else.\n", "x-i18n": { "tr": { "description": "Konu alan\u0131. \u0130lk be\u015f de\u011fer, destek atamas\u0131 yetki s\u00fctunlar\u0131yla birebir \u00f6rt\u00fc\u015f\u00fcr;\ndenetim izinin bir destek temsilcisi i\u00e7in s\u00fcz\u00fclebilir olmas\u0131n\u0131 sa\u011flayan da budur.\n`auth`, `shop`, `privacy`, `partner` ve `system` de\u011ferlerinin destek kar\u015f\u0131l\u0131\u011f\u0131\nyoktur ve bir temsilciye asla g\u00f6r\u00fcnmezler.\n\nBu liste, `App\\Enums\\AuditDomain` numaraland\u0131rmas\u0131n\u0131n dayanak de\u011ferleridir, ayn\u0131\ns\u0131rayla; bir test de b\u00f6yle kalmas\u0131n\u0131 g\u00fcvence alt\u0131na al\u0131r \u2014 \u00e7al\u0131\u015fma zaman\u0131ndaki\ns\u00fczge\u00e7 kendi kural\u0131n\u0131 o numaraland\u0131rmadan t\u00fcretir, dolay\u0131s\u0131yla burada eksik bir\nde\u011fer yaln\u0131zca s\u00f6zle\u015fme kaymas\u0131d\u0131r.\n" }, "ar": { "description": "\u0645\u062c\u0627\u0644 \u0627\u0644\u0645\u0648\u0636\u0648\u0639. \u0627\u0644\u0642\u064a\u0645 \u0627\u0644\u062e\u0645\u0633 \u0627\u0644\u0623\u0648\u0644\u0649 \u062a\u0642\u0627\u0628\u0644 \u0648\u0627\u062d\u062f\u0629\u064b \u0628\u0648\u0627\u062d\u062f\u0629 \u0623\u0639\u0645\u062f\u0629 \u0635\u0644\u0627\u062d\u064a\u0627\u062a \u0625\u0633\u0646\u0627\u062f\n\u0627\u0644\u062f\u0639\u0645\u060c \u0648\u0647\u0630\u0627 \u0645\u0627 \u064a\u062c\u0639\u0644 \u0627\u0644\u0633\u062c\u0644\u0651 \u0642\u0627\u0628\u0644\u064b\u0627 \u0644\u0644\u062a\u0631\u0634\u064a\u062d \u0644\u062f\u0649 \u0645\u0648\u0638\u0641 \u0627\u0644\u062f\u0639\u0645\u061b \u0623\u0645\u0627 `auth`\n\u0648`shop` \u0648`privacy` \u0648`partner` \u0648`system` \u0641\u0644\u0627 \u0646\u0638\u064a\u0631 \u0644\u0647\u0627 \u0641\u064a \u0627\u0644\u062f\u0639\u0645 \u0648\u0644\u0627 \u062a\u0638\u0647\u0631 \u0644\u0647\n\u0623\u0628\u062f\u064b\u0627.\n\n\u0647\u0630\u0647 \u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u0647\u064a \u0627\u0644\u0642\u064a\u0645 \u0627\u0644\u062f\u0627\u0639\u0645\u0629 \u0644\u0640 `App\\Enums\\AuditDomain` \u0628\u0627\u0644\u062a\u0631\u062a\u064a\u0628 \u0646\u0641\u0633\u0647\u060c\n\u0648\u064a\u0624\u0643\u0651\u062f \u0627\u062e\u062a\u0628\u0627\u0631\u064c \u0628\u0642\u0627\u0621\u0647\u0627 \u0643\u0630\u0644\u0643 \u2014 \u0625\u0630 \u064a\u0634\u062a\u0642 \u0645\u0631\u0634\u0650\u0651\u062d \u0648\u0642\u062a \u0627\u0644\u062a\u0634\u063a\u064a\u0644 \u0642\u0627\u0639\u062f\u062a\u0647 \u0645\u0646 \u0630\u0644\u0643\n\u0627\u0644\u062a\u0639\u062f\u0627\u062f\u060c \u0641\u0627\u0644\u0642\u064a\u0645\u0629 \u0627\u0644\u0646\u0627\u0642\u0635\u0629 \u0647\u0646\u0627 \u0627\u0646\u062d\u0631\u0627\u0641\u064c \u0641\u064a \u0627\u0644\u062a\u0648\u0635\u064a\u0641 \u0644\u0627 \u0623\u0643\u062b\u0631.\n" } }, "enum": [ "cloud", "billing", "dns", "tickets", "account", "auth", "shop", "privacy", "partner", "system" ] }, "auditable_type": { "type": "string", "nullable": true, "description": "The model class the row is attached to, or `null`.", "x-i18n": { "tr": { "description": "Sat\u0131r\u0131n ba\u011fl\u0131 oldu\u011fu model s\u0131n\u0131f\u0131 ya da `null`." }, "ar": { "description": "\u0635\u0646\u0641 \u0627\u0644\u0646\u0645\u0648\u0630\u062c \u0627\u0644\u0630\u064a \u064a\u0631\u062a\u0628\u0637 \u0628\u0647 \u0627\u0644\u0635\u0641\u060c \u0623\u0648 `null`." } }, "example": "App\\Models\\Subscription" }, "auditable_id": { "type": "integer", "nullable": true } } }, "CustomerCounts": { "type": "object", "description": "Row counts for one customer's resources, read straight from the local database.\n\nDeliberately counts rather than listings, and deliberately database-backed: the\npanel's equivalent dashboard is built the same way so that showing an operator\n\"how much does this customer have\" never depends on CloudStack, PowerDNS or the\npayment gateway being reachable. Fetch the per-domain collections for detail.\n", "x-i18n": { "tr": { "description": "Tek bir m\u00fc\u015fterinin kaynaklar\u0131na ait sat\u0131r say\u0131lar\u0131; do\u011frudan yerel veritaban\u0131ndan\nokunur.\n\nBilin\u00e7li olarak listeler yerine say\u0131lar verir ve bilin\u00e7li olarak veritaban\u0131ndan\nyan\u0131tlan\u0131r: panelin e\u015fde\u011fer g\u00f6sterge paneli de ayn\u0131 bi\u00e7imde kurulmu\u015ftur; b\u00f6ylece bir\noperat\u00f6re \u201cbu m\u00fc\u015fterinin nesi var\u201d bilgisini g\u00f6stermek hi\u00e7bir zaman CloudStack'e,\nPowerDNS'e ya da \u00f6deme sa\u011flay\u0131c\u0131s\u0131na eri\u015filebilmesine ba\u011fl\u0131 olmaz. Ayr\u0131nt\u0131 i\u00e7in alan\nbazl\u0131 koleksiyonlar\u0131 \u00e7ekin.\n" }, "ar": { "description": "\u0623\u0639\u062f\u0627\u062f \u0627\u0644\u0635\u0641\u0648\u0641 \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0645\u0648\u0627\u0631\u062f \u0639\u0645\u064a\u0644 \u0648\u0627\u062d\u062f\u060c \u062a\u064f\u0642\u0631\u0623 \u0645\u0628\u0627\u0634\u0631\u0629\u064b \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0644\u0645\u062d\u0644\u064a\u0629.\n\n\u062a\u0639\u0637\u064a \u0623\u0639\u062f\u0627\u062f\u064b\u0627 \u0644\u0627 \u0642\u0648\u0627\u0626\u0645 \u0639\u0646 \u0642\u0635\u062f\u060c \u0648\u062a\u0639\u062a\u0645\u062f \u0639\u0644\u0649 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0639\u0646 \u0642\u0635\u062f: \u0641\u0644\u0648\u062d\u0629\n\u0627\u0644\u0645\u0639\u0644\u0648\u0645\u0627\u062a \u0627\u0644\u0645\u0642\u0627\u0628\u0644\u0629 \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u0645\u0628\u0646\u064a\u0651\u0629 \u0628\u0627\u0644\u0637\u0631\u064a\u0642\u0629 \u0646\u0641\u0633\u0647\u0627\u060c \u062d\u062a\u0649 \u0644\u0627 \u064a\u062a\u0648\u0642\u0641 \u0625\u0638\u0647\u0627\u0631 \u00ab\u0643\u0645\n\u064a\u0645\u0644\u0643 \u0647\u0630\u0627 \u0627\u0644\u0639\u0645\u064a\u0644\u00bb \u0644\u0644\u0645\u0634\u063a\u0651\u0644 \u0639\u0644\u0649 \u0625\u0645\u0643\u0627\u0646 \u0627\u0644\u0648\u0635\u0648\u0644 \u0625\u0644\u0649 CloudStack \u0623\u0648 PowerDNS \u0623\u0648 \u0628\u0648\u0627\u0628\u0629\n\u0627\u0644\u062f\u0641\u0639. \u0627\u0637\u0644\u0628 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643\u0644 \u0645\u062c\u0627\u0644 \u0644\u0644\u062a\u0641\u0627\u0635\u064a\u0644.\n" } }, "required": [ "instances", "volumes", "dns_zones", "subscriptions", "invoices", "tickets" ], "properties": { "instances": { "type": "integer", "minimum": 0 }, "volumes": { "type": "integer", "minimum": 0 }, "dns_zones": { "type": "integer", "minimum": 0 }, "subscriptions": { "type": "integer", "minimum": 0 }, "invoices": { "type": "integer", "minimum": 0 }, "tickets": { "type": "integer", "minimum": 0 } } }, "AdminCustomer": { "type": "object", "description": "One customer, as the admin surface publishes them.\n\nBuilt field by field, never by serialising a `User`: that model's `$hidden` list\ncovers the password, the CloudStack ids and the preferences blob, but **not**\n`identity_number`, `passport_number`, `birthdate`, the telegram ids or `balance`.\n\nThe panel's own admin customer page does ship `identity_number` and\n`passport_number`. This API deliberately does not. \"The API must never grant more\nthan the panel\" is a ceiling, not a floor, and no API consumer has a use for a\nnational identity number.\n\nDeliberately absent: `password`, `identity_number`, `passport_number`, `birthdate`,\n`telegram_user_id`, `telegram_chat_id`, `balance`, `cloudstack_userid`,\n`cloudstack_accountid`, `preferences`, `locked_out`, `max_vms`, `max_vols`.\n\nAdding a field to this schema later is additive; removing one is a v2.\n", "x-i18n": { "tr": { "description": "Y\u00f6netici aray\u00fcz\u00fcn\u00fcn yay\u0131mlad\u0131\u011f\u0131 h\u00e2liyle tek bir m\u00fc\u015fteri.\n\nBir `User` nesnesi serile\u015ftirilerek de\u011fil, alan alan kurulur: o modelin `$hidden`\nlistesi parolay\u0131, CloudStack kimliklerini ve tercihler y\u0131\u011f\u0131n\u0131n\u0131 kapsar, ama\n`identity_number`, `passport_number`, `birthdate`, telegram kimliklerini ya da\n`balance` alan\u0131n\u0131 **kapsamaz**.\n\nPanelin kendi y\u00f6netici m\u00fc\u015fteri sayfas\u0131 `identity_number` ve `passport_number`\nalanlar\u0131n\u0131 g\u00f6nderir. Bu API bilin\u00e7li olarak g\u00f6ndermez. \u201cAPI asla panelden fazlas\u0131n\u0131\nvermemeli\u201d bir tavand\u0131r, taban de\u011fil; \u00fcstelik hi\u00e7bir API t\u00fcketicisinin ulusal kimlik\nnumaras\u0131na ihtiyac\u0131 yoktur.\n\nBilin\u00e7li olarak yoktur: `password`, `identity_number`, `passport_number`, `birthdate`,\n`telegram_user_id`, `telegram_chat_id`, `balance`, `cloudstack_userid`,\n`cloudstack_accountid`, `preferences`, `locked_out`, `max_vms`, `max_vols`.\n\nBu \u015femaya sonradan alan eklemek eklemeli bir de\u011fi\u015fikliktir; alan kald\u0131rmak ise v2\ndemektir.\n" }, "ar": { "description": "\u0639\u0645\u064a\u0644 \u0648\u0627\u062d\u062f \u0643\u0645\u0627 \u062a\u0646\u0634\u0631\u0647 \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0645\u062f\u064a\u0631.\n\n\u064a\u064f\u0628\u0646\u0649 \u062d\u0642\u0644\u064b\u0627 \u062d\u0642\u0644\u064b\u0627\u060c \u0644\u0627 \u0628\u062a\u0633\u0644\u0633\u0644 \u0643\u0627\u0626\u0646 `User` \u0623\u0628\u062f\u064b\u0627: \u0641\u0642\u0627\u0626\u0645\u0629 `$hidden` \u0641\u064a \u0630\u0644\u0643 \u0627\u0644\u0646\u0645\u0648\u0630\u062c\n\u062a\u063a\u0637\u064a \u0643\u0644\u0645\u0629 \u0627\u0644\u0645\u0631\u0648\u0631 \u0648\u0645\u0639\u0631\u0651\u0641\u0627\u062a CloudStack \u0648\u0643\u062a\u0644\u0629 \u0627\u0644\u062a\u0641\u0636\u064a\u0644\u0627\u062a\u060c \u0644\u0643\u0646\u0647\u0627 **\u0644\u0627** \u062a\u063a\u0637\u064a\n`identity_number` \u0648\u0644\u0627 `passport_number` \u0648\u0644\u0627 `birthdate` \u0648\u0644\u0627 \u0645\u0639\u0631\u0651\u0641\u0627\u062a telegram\n\u0648\u0644\u0627 `balance`.\n\n\u0623\u0645\u0627 \u0635\u0641\u062d\u0629 \u0627\u0644\u0639\u0645\u064a\u0644 \u0641\u064a \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0645\u062f\u064a\u0631 \u0628\u0627\u0644\u0644\u0648\u062d\u0629 \u0641\u062a\u064f\u0631\u0633\u0644 `identity_number`\n\u0648`passport_number` \u0641\u0639\u0644\u064b\u0627. \u0648\u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0644\u0627 \u062a\u0641\u0639\u0644 \u0630\u0644\u0643 \u0639\u0646 \u0642\u0635\u062f. \u0641\u0642\u0627\u0639\u062f\u0629 \u00ab\u064a\u062c\u0628\n\u0623\u0644\u0627 \u062a\u0645\u0646\u062d \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0623\u0643\u062b\u0631 \u0645\u0645\u0627 \u062a\u0645\u0646\u062d\u0647 \u0627\u0644\u0644\u0648\u062d\u0629\u00bb \u0633\u0642\u0641\u064c \u0644\u0627 \u0623\u0631\u0636\u064a\u0629\u060c \u0648\u0644\u0627 \u062d\u0627\u062c\u0629 \u0644\u0623\u064a\n\u0645\u0633\u062a\u0647\u0644\u0643 \u0644\u0644\u0648\u0627\u062c\u0647\u0629 \u0628\u0631\u0642\u0645 \u0647\u0648\u064a\u0629 \u0648\u0637\u0646\u064a\u0629.\n\n\u063a\u0627\u0626\u0628\u0629 \u0639\u0646 \u0642\u0635\u062f: `password` \u0648`identity_number` \u0648`passport_number` \u0648`birthdate`\n\u0648`telegram_user_id` \u0648`telegram_chat_id` \u0648`balance` \u0648`cloudstack_userid`\n\u0648`cloudstack_accountid` \u0648`preferences` \u0648`locked_out` \u0648`max_vms` \u0648`max_vols`.\n\n\u0625\u0636\u0627\u0641\u0629 \u062d\u0642\u0644 \u0625\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0645\u062e\u0637\u0637 \u0644\u0627\u062d\u0642\u064b\u0627 \u062a\u063a\u064a\u064a\u0631\u064c \u0625\u0636\u0627\u0641\u064a\u061b \u0623\u0645\u0627 \u062d\u0630\u0641 \u062d\u0642\u0644 \u0641\u064a\u0639\u0646\u064a \u0625\u0635\u062f\u0627\u0631\u064b\u0627 \u062b\u0627\u0646\u064a\u064b\u0627\n(v2).\n" } }, "required": [ "id", "name", "email", "type", "language", "phone", "email_verified_at", "created_at", "updated_at" ], "properties": { "id": { "type": "integer", "description": "Stable identifier. Never changes for the life of the account.", "x-i18n": { "tr": { "description": "Kal\u0131c\u0131 kimlik. Hesap var oldu\u011fu s\u00fcrece de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u062b\u0627\u0628\u062a. \u0644\u0627 \u064a\u062a\u063a\u064a\u0651\u0631 \u0637\u0648\u0627\u0644 \u0639\u0645\u0631 \u0627\u0644\u062d\u0633\u0627\u0628." } }, "example": 412 }, "name": { "type": "string", "example": "Ada Lovelace" }, "email": { "type": "string", "format": "email", "example": "ada@example.test" }, "type": { "type": "string", "description": "The account's own type column, which the application keeps in step with the\nSpatie role of the same name. A listing of this collection only ever contains\n`user` rows.\n", "x-i18n": { "tr": { "description": "Hesab\u0131n kendi t\u00fcr s\u00fctunu; uygulama bu s\u00fctunu ayn\u0131 ad\u0131 ta\u015f\u0131yan Spatie\nrol\u00fcyle uyumlu tutar. Bu koleksiyonun listelemesi yaln\u0131zca `user` sat\u0131rlar\u0131\ni\u00e7erir.\n" }, "ar": { "description": "\u0639\u0645\u0648\u062f \u0627\u0644\u0646\u0648\u0639 \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u062d\u0633\u0627\u0628\u060c \u0648\u0627\u0644\u0630\u064a \u064a\u0628\u0642\u064a\u0647 \u0627\u0644\u062a\u0637\u0628\u064a\u0642 \u0645\u062a\u0648\u0627\u0641\u0642\u064b\u0627 \u0645\u0639 \u062f\u0648\u0631 Spatie \u0627\u0644\u0630\u064a\n\u064a\u062d\u0645\u0644 \u0627\u0644\u0627\u0633\u0645 \u0646\u0641\u0633\u0647. \u0648\u0644\u0627 \u064a\u062d\u062a\u0648\u064a \u0633\u0631\u062f \u0647\u0630\u0647 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0629 \u0625\u0644\u0627 \u0639\u0644\u0649 \u0635\u0641\u0648\u0641 `user`.\n" } }, "enum": [ "user", "admin", "support" ] }, "language": { "type": "string", "nullable": true, "description": "The customer's stored locale tag, used for their notifications.", "x-i18n": { "tr": { "description": "M\u00fc\u015fterinin kay\u0131tl\u0131 dil etiketi; bildirimlerinde kullan\u0131l\u0131r." }, "ar": { "description": "\u0648\u0633\u0645 \u0627\u0644\u0644\u063a\u0629 \u0627\u0644\u0645\u062e\u0632\u064e\u0651\u0646 \u0644\u0644\u0639\u0645\u064a\u0644\u060c \u0648\u064a\u064f\u0633\u062a\u062e\u062f\u0645 \u0641\u064a \u0625\u0634\u0639\u0627\u0631\u0627\u062a\u0647." } }, "example": "en-US" }, "phone": { "type": "string", "nullable": true, "description": "Published here and **not** on the support equivalent. An admin already reaches\nevery field on this record through the panel; a support agent's reach is scoped\nby assignment, and the customer dashboard they get is reachable with no domain\ncapability at all.\n", "x-i18n": { "tr": { "description": "Burada yay\u0131mlan\u0131r, destek kar\u015f\u0131l\u0131\u011f\u0131nda ise **yay\u0131mlanmaz**. Bir y\u00f6netici bu\nkayd\u0131n her alan\u0131na zaten panel \u00fczerinden eri\u015fir; bir destek temsilcisinin\neri\u015fimi ise atamayla s\u0131n\u0131rl\u0131d\u0131r ve ona verilen m\u00fc\u015fteri g\u00f6sterge paneline\nhi\u00e7bir alan yetkisi olmadan ula\u015f\u0131labilir.\n" }, "ar": { "description": "\u064a\u064f\u0646\u0634\u064e\u0631 \u0647\u0646\u0627 \u0648**\u0644\u0627** \u064a\u064f\u0646\u0634\u064e\u0631 \u0641\u064a \u0627\u0644\u0646\u0638\u064a\u0631 \u0627\u0644\u062e\u0627\u0635 \u0628\u0627\u0644\u062f\u0639\u0645. \u0641\u0627\u0644\u0645\u062f\u064a\u0631 \u064a\u0635\u0644 \u0623\u0635\u0644\u064b\u0627 \u0625\u0644\u0649 \u0643\u0644\n\u062d\u0642\u0644 \u0641\u064a \u0647\u0630\u0627 \u0627\u0644\u0633\u062c\u0644\u0651 \u0639\u0628\u0631 \u0627\u0644\u0644\u0648\u062d\u0629\u061b \u0623\u0645\u0627 \u0645\u0648\u0638\u0641 \u0627\u0644\u062f\u0639\u0645 \u0641\u0648\u0635\u0648\u0644\u0647 \u0645\u062d\u062f\u0648\u062f \u0628\u0627\u0644\u0625\u0633\u0646\u0627\u062f\u060c \u0648\u0644\u0648\u062d\u0629\n\u0645\u0639\u0644\u0648\u0645\u0627\u062a \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u062a\u064a \u064a\u062d\u0635\u0644 \u0639\u0644\u064a\u0647\u0627 \u0645\u062a\u0627\u062d\u0629 \u0644\u0647 \u062f\u0648\u0646 \u0623\u064a \u0635\u0644\u0627\u062d\u064a\u0629 \u0645\u062c\u0627\u0644 \u0639\u0644\u0649 \u0627\u0644\u0625\u0637\u0644\u0627\u0642.\n" } }, "example": "+905551234567" }, "email_verified_at": { "type": "string", "format": "date-time", "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "updated_at": { "type": "string", "format": "date-time", "nullable": true } } }, "AdminCustomerDetail": { "description": "One customer with their resource counts \u2014 the single-record representation.\n\nA separate schema rather than an optional `counts` field on `AdminCustomer`: an\noptional field in a frozen contract is a field every generated client has to\nnull-check forever, even on the path where it is always present.\n", "x-i18n": { "tr": { "description": "Kaynak say\u0131lar\u0131yla birlikte tek bir m\u00fc\u015fteri \u2014 tek kay\u0131tl\u0131k g\u00f6sterim.\n\n`AdminCustomer` \u00fczerinde iste\u011fe ba\u011fl\u0131 bir `counts` alan\u0131 yerine ayr\u0131 bir \u015fema\nkullan\u0131l\u0131r: dondurulmu\u015f bir s\u00f6zle\u015fmede iste\u011fe ba\u011fl\u0131 bir alan, her zaman dolu\noldu\u011fu yolda bile \u00fcretilen her istemcinin sonsuza dek null denetimi yapmak\nzorunda kald\u0131\u011f\u0131 bir aland\u0131r.\n" }, "ar": { "description": "\u0639\u0645\u064a\u0644 \u0648\u0627\u062d\u062f \u0645\u0639 \u0623\u0639\u062f\u0627\u062f \u0645\u0648\u0627\u0631\u062f\u0647 \u2014 \u062a\u0645\u062b\u064a\u0644 \u0627\u0644\u0633\u062c\u0644\u0651 \u0627\u0644\u0645\u0641\u0631\u062f.\n\n\u0627\u0633\u062a\u064f\u062e\u062f\u0645 \u0645\u062e\u0637\u0637 \u0645\u0646\u0641\u0635\u0644 \u0628\u062f\u0644\u064b\u0627 \u0645\u0646 \u062d\u0642\u0644 `counts` \u0627\u062e\u062a\u064a\u0627\u0631\u064a \u0639\u0644\u0649 `AdminCustomer`: \u0641\u0627\u0644\u062d\u0642\u0644\n\u0627\u0644\u0627\u062e\u062a\u064a\u0627\u0631\u064a \u0641\u064a \u0639\u0642\u062f \u0645\u062c\u0645\u064e\u0651\u062f \u062d\u0642\u0644\u064c \u064a\u0636\u0637\u0631 \u0643\u0644 \u0639\u0645\u064a\u0644 \u0645\u064f\u0648\u0644\u064e\u0651\u062f \u0625\u0644\u0649 \u0641\u062d\u0635 \u062e\u0644\u0648\u0651\u0647 \u0645\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 \u0625\u0644\u0649\n\u0627\u0644\u0623\u0628\u062f\u060c \u062d\u062a\u0649 \u0641\u064a \u0627\u0644\u0645\u0633\u0627\u0631 \u0627\u0644\u0630\u064a \u064a\u0643\u0648\u0646 \u0641\u064a\u0647 \u0645\u0648\u062c\u0648\u062f\u064b\u0627 \u062f\u0627\u0626\u0645\u064b\u0627.\n" } }, "allOf": [ { "$ref": "#/components/schemas/AdminCustomer" }, { "type": "object", "required": [ "counts" ], "properties": { "counts": { "$ref": "#/components/schemas/CustomerCounts" } } } ] }, "SupportCapabilities": { "type": "object", "description": "The per-domain capability levels one support agent holds over one customer.\n\nFive domains, each 1:1 with a column on the assignment row, and three ordered\nlevels \u2014 `none` < `view` < `manage`. A `GET` on the support surface requires at\nleast `view`; a mutation requires `manage`. There is one deliberate exception on\nthe panel that must never be relaxed if it is ever ported here: minting a VM console\nsession is gated at `manage`, not `view`, because a console is effective full\ncontrol of the machine.\n\nA `super-admin` short-circuits the assignment lookup entirely and reads `manage` on\nevery domain, matching the panel.\n", "x-i18n": { "tr": { "description": "Bir destek temsilcisinin tek bir m\u00fc\u015fteri \u00fczerinde alan alan ta\u015f\u0131d\u0131\u011f\u0131 yetki d\u00fczeyleri.\n\nBe\u015f alan vard\u0131r; her biri atama sat\u0131r\u0131ndaki bir s\u00fctunla birebir e\u015fle\u015fir ve s\u0131ral\u0131\n\u00fc\u00e7 d\u00fczey bulunur \u2014 `none` < `view` < `manage`. Destek taraf\u0131ndaki bir `GET` en az\n`view` ister; bir de\u011fi\u015fiklik `manage` ister. Panelde, buraya ta\u015f\u0131nmas\u0131 h\u00e2linde asla\ngev\u015fetilmemesi gereken bilin\u00e7li bir istisna vard\u0131r: sanal makina konsolu oturumu\na\u00e7mak `view` ile de\u011fil `manage` ile denetlenir, \u00e7\u00fcnk\u00fc konsol, sanal makinan\u0131n fiilen tam\ndenetimi demektir.\n\nBir `super-admin` atama sorgusunu tamamen atlar ve her alanda `manage` okur; panelde\noldu\u011fu gibi.\n" }, "ar": { "description": "\u0645\u0633\u062a\u0648\u064a\u0627\u062a \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 \u0627\u0644\u062a\u064a \u064a\u0645\u0644\u0643\u0647\u0627 \u0645\u0648\u0638\u0641 \u062f\u0639\u0645 \u0648\u0627\u062d\u062f \u0639\u0644\u0649 \u0639\u0645\u064a\u0644 \u0648\u0627\u062d\u062f\u060c \u0645\u062c\u0627\u0644\u064b\u0627 \u0645\u062c\u0627\u0644\u064b\u0627.\n\n\u062e\u0645\u0633\u0629 \u0645\u062c\u0627\u0644\u0627\u062a\u060c \u0643\u0644 \u0645\u0646\u0647\u0627 \u064a\u0642\u0627\u0628\u0644 \u0639\u0645\u0648\u062f\u064b\u0627 \u0648\u0627\u062d\u062f\u064b\u0627 \u0641\u064a \u0635\u0641 \u0627\u0644\u0625\u0633\u0646\u0627\u062f\u060c \u0648\u062b\u0644\u0627\u062b\u0629 \u0645\u0633\u062a\u0648\u064a\u0627\u062a \u0645\u0631\u062a\u064e\u0651\u0628\u0629 \u2014\n`none` < `view` < `manage`. \u0648\u064a\u062a\u0637\u0644\u0628 \u0637\u0644\u0628 `GET` \u0639\u0644\u0649 \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u062f\u0639\u0645 \u0645\u0633\u062a\u0648\u0649 `view` \u0639\u0644\u0649\n\u0627\u0644\u0623\u0642\u0644\u061b \u0648\u064a\u062a\u0637\u0644\u0628 \u0623\u064a \u062a\u0639\u062f\u064a\u0644 \u0645\u0633\u062a\u0648\u0649 `manage`. \u0648\u062b\u0645\u0629 \u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u0645\u0642\u0635\u0648\u062f \u0648\u0627\u062d\u062f \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629 \u064a\u062c\u0628 \u0623\u0644\u0651\u0627\n\u064a\u064f\u062e\u0641\u064e\u0651\u0641 \u0623\u0628\u062f\u064b\u0627 \u0625\u0646 \u0646\u064f\u0642\u0644 \u0625\u0644\u0649 \u0647\u0646\u0627: \u0641\u0625\u0646\u0634\u0627\u0621 \u062c\u0644\u0633\u0629 \u0643\u0648\u0646\u0633\u0648\u0644 \u0644\u0644\u062c\u0647\u0627\u0632 \u0627\u0644\u0627\u0641\u062a\u0631\u0627\u0636\u064a \u0645\u062d\u0643\u0648\u0645\n\u0628\u0640`manage` \u0644\u0627 \u0628\u0640`view`\u060c \u0644\u0623\u0646 \u0627\u0644\u0643\u0648\u0646\u0633\u0648\u0644 \u062a\u062d\u0643\u0651\u0645 \u0643\u0627\u0645\u0644 \u0641\u0639\u0644\u064a \u0641\u064a \u0627\u0644\u062c\u0647\u0627\u0632.\n\n\u0648\u064a\u062a\u062e\u0637\u0649 `super-admin` \u0627\u0644\u0628\u062d\u062b \u0641\u064a \u0627\u0644\u0625\u0633\u0646\u0627\u062f \u0643\u0644\u064a\u064b\u0627 \u0641\u064a\u0642\u0631\u0623 `manage` \u0641\u064a \u0643\u0644 \u0645\u062c\u0627\u0644\u060c \u0645\u0637\u0627\u0628\u0642\u0629\u064b\n\u0644\u0644\u0648\u062d\u0629.\n" } }, "required": [ "cloud", "billing", "dns", "tickets", "account" ], "properties": { "cloud": { "type": "string", "enum": [ "none", "view", "manage" ] }, "billing": { "type": "string", "enum": [ "none", "view", "manage" ] }, "dns": { "type": "string", "enum": [ "none", "view", "manage" ] }, "tickets": { "type": "string", "enum": [ "none", "view", "manage" ] }, "account": { "type": "string", "enum": [ "none", "view", "manage" ] } } }, "SupportCustomer": { "type": "object", "description": "One assigned customer, as the support surface publishes them, with the capability\nmap the requesting agent holds over them.\n\nThis is `AdminCustomer`'s field set **minus `phone`**, plus `capabilities`. Dropping\nthe phone number is a deliberate, documented deviation from both the admin surface\nand the panel: the customer dashboard is reachable on `support.assigned` alone, so\nan agent whose assignment reads `none` on all five domains can open it, and the\npanel does hand them a phone number for it. An API being stricter than the panel is\nallowed; the reverse is not.\n\nEverything `AdminCustomer` withholds is withheld here too: `identity_number`,\n`passport_number`, `birthdate`, `balance`, the telegram ids, the CloudStack ids.\n\nAdding a field to this schema later is additive; removing one is a v2.\n", "x-i18n": { "tr": { "description": "Destek aray\u00fcz\u00fcn\u00fcn yay\u0131mlad\u0131\u011f\u0131 h\u00e2liyle atanm\u0131\u015f tek bir m\u00fc\u015fteri; yan\u0131nda, \u00e7a\u011f\u0131ran\ntemsilcinin o m\u00fc\u015fteri \u00fczerinde ta\u015f\u0131d\u0131\u011f\u0131 yetki haritas\u0131yla.\n\nBu, `AdminCustomer`'\u0131n alan k\u00fcmesinin **`phone` alan\u0131 \u00e7\u0131kar\u0131lm\u0131\u015f** h\u00e2lidir, art\u0131\n`capabilities`. Telefon numaras\u0131n\u0131n d\u00fc\u015f\u00fcr\u00fclmesi, hem y\u00f6netim taraf\u0131ndan hem de\npanelden bilin\u00e7li ve belgelenmi\u015f bir sapmad\u0131r: m\u00fc\u015fteri panosuna yaln\u0131zca\n`support.assigned` ile ula\u015f\u0131labildi\u011fi i\u00e7in, atamas\u0131 be\u015f alan\u0131n hepsinde `none` okuyan\nbir temsilci de panoyu a\u00e7abilir ve panel bu i\u015f i\u00e7in ona bir telefon numaras\u0131 verir.\nBir API'nin panelden daha kat\u0131 olmas\u0131 kabul edilebilir; tersi de\u011fil.\n\n`AdminCustomer`'\u0131n esirgedi\u011fi her \u015fey burada da esirgenir: `identity_number`,\n`passport_number`, `birthdate`, `balance`, telegram kimlikleri, CloudStack kimlikleri.\n\nBu \u015femaya sonradan alan eklemek yaln\u0131zca ekleme olur; alan \u00e7\u0131karmak ise v2 demektir.\n" }, "ar": { "description": "\u0639\u0645\u064a\u0644 \u0645\u064f\u0633\u0646\u064e\u062f \u0648\u0627\u062d\u062f \u0643\u0645\u0627 \u062a\u0646\u0634\u0631\u0647 \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u062f\u0639\u0645\u060c \u0645\u0639 \u062e\u0631\u064a\u0637\u0629 \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0627\u062a \u0627\u0644\u062a\u064a \u064a\u0645\u0644\u0643\u0647\u0627 \u0627\u0644\u0645\u0648\u0638\u0641\n\u0645\u0642\u062f\u0650\u0651\u0645 \u0627\u0644\u0637\u0644\u0628 \u0639\u0644\u064a\u0647.\n\n\u0647\u0630\u0647 \u0647\u064a \u0645\u062c\u0645\u0648\u0639\u0629 \u062d\u0642\u0648\u0644 `AdminCustomer` **\u0646\u0627\u0642\u0635\u064e `phone`**\u060c \u0645\u0636\u0627\u0641\u064b\u0627 \u0625\u0644\u064a\u0647\u0627 `capabilities`.\n\u0648\u0625\u0633\u0642\u0627\u0637 \u0631\u0642\u0645 \u0627\u0644\u0647\u0627\u062a\u0641 \u0627\u0646\u062d\u0631\u0627\u0641 \u0645\u0642\u0635\u0648\u062f \u0648\u0645\u0648\u062b\u064e\u0651\u0642 \u0639\u0646 \u0648\u0627\u062c\u0647\u0629 \u0627\u0644\u0625\u062f\u0627\u0631\u0629 \u0648\u0639\u0646 \u0627\u0644\u0644\u0648\u062d\u0629 \u0645\u0639\u064b\u0627: \u0641\u0644\u0648\u062d\u0629\n\u0627\u0644\u0639\u0645\u064a\u0644 \u064a\u0645\u0643\u0646 \u0628\u0644\u0648\u063a\u0647\u0627 \u0628\u0640`support.assigned` \u0648\u062d\u062f\u0647\u060c \u0648\u0645\u0646 \u062b\u0645\u0651 \u064a\u0633\u062a\u0637\u064a\u0639 \u0641\u062a\u062d\u0647\u0627 \u0645\u0648\u0638\u0641 \u064a\u0642\u0631\u0623\n\u0625\u0633\u0646\u0627\u062f\u0647 `none` \u0641\u064a \u0627\u0644\u0645\u062c\u0627\u0644\u0627\u062a \u0627\u0644\u062e\u0645\u0633\u0629 \u0643\u0644\u0647\u0627\u060c \u0648\u0627\u0644\u0644\u0648\u062d\u0629 \u062a\u0633\u0644\u0651\u0645\u0647 \u0631\u0642\u0645 \u0647\u0627\u062a\u0641 \u0639\u0646\u062f\u0647\u0627. \u0648\u064a\u062c\u0648\u0632 \u0623\u0646\n\u062a\u0643\u0648\u0646 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0623\u0634\u062f\u0651 \u0645\u0646 \u0627\u0644\u0644\u0648\u062d\u0629\u061b \u0623\u0645\u0627 \u0627\u0644\u0639\u0643\u0633 \u0641\u0644\u0627.\n\n\u0648\u0643\u0644 \u0645\u0627 \u062a\u062d\u062c\u0628\u0647 `AdminCustomer` \u0645\u062d\u062c\u0648\u0628 \u0647\u0646\u0627 \u0623\u064a\u0636\u064b\u0627: `identity_number` \u0648`passport_number`\n\u0648`birthdate` \u0648`balance` \u0648\u0645\u0639\u0631\u0651\u0641\u0627\u062a telegram \u0648\u0645\u0639\u0631\u0651\u0641\u0627\u062a CloudStack.\n\n\u0648\u0625\u0636\u0627\u0641\u0629 \u062d\u0642\u0644 \u0625\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u0645\u062e\u0637\u0637 \u0644\u0627\u062d\u0642\u064b\u0627 \u0625\u0636\u0627\u0641\u0629 \u063a\u064a\u0631 \u0643\u0627\u0633\u0631\u0629\u061b \u0623\u0645\u0627 \u062d\u0630\u0641 \u062d\u0642\u0644 \u0641\u064a\u0639\u0646\u064a \u0625\u0635\u062f\u0627\u0631\u064b\u0627 \u062b\u0627\u0646\u064a\u064b\u0627.\n" } }, "required": [ "id", "name", "email", "type", "language", "email_verified_at", "created_at", "updated_at", "capabilities" ], "properties": { "id": { "type": "integer", "example": 412 }, "name": { "type": "string", "example": "Ada Lovelace" }, "email": { "type": "string", "format": "email", "example": "ada@example.test" }, "type": { "type": "string", "enum": [ "user", "admin", "support" ] }, "language": { "type": "string", "nullable": true, "example": "en-US" }, "email_verified_at": { "type": "string", "format": "date-time", "nullable": true }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "updated_at": { "type": "string", "format": "date-time", "nullable": true }, "capabilities": { "$ref": "#/components/schemas/SupportCapabilities" } } }, "SupportCustomerDetail": { "description": "One assigned customer with their resource counts \u2014 the single-record\nrepresentation, mirroring `AdminCustomerDetail`.\n\nA separate schema rather than an optional `counts` field on `SupportCustomer`: an\noptional field in a frozen contract is a field every generated client has to\nnull-check forever.\n\nThe counts are unconditional and are **not** filtered by the agent's capability\nmap. That matches the panel's cross-domain customer dashboard, whose whole purpose\nis to tell an agent where a customer's problem might be before they have a domain\nto look in. The per-domain collections beside this path are the ones that require a\ncapability.\n", "x-i18n": { "tr": { "description": "Kaynak say\u0131lar\u0131yla birlikte, atanm\u0131\u015f tek bir m\u00fc\u015fteri \u2014 `AdminCustomerDetail` ile\nayn\u0131 bi\u00e7imde kurulmu\u015f, tek kay\u0131tl\u0131k g\u00f6sterim.\n\n`SupportCustomer` \u00fczerinde iste\u011fe ba\u011fl\u0131 bir `counts` alan\u0131 yerine ayr\u0131 bir \u015fema:\ndondurulmu\u015f bir s\u00f6zle\u015fmede iste\u011fe ba\u011fl\u0131 bir alan, \u00fcretilen her istemcinin sonsuza\nkadar null denetimi yapmak zorunda kald\u0131\u011f\u0131 bir aland\u0131r.\n\nSay\u0131lar ko\u015fulsuzdur ve temsilcinin yetki haritas\u0131na g\u00f6re **s\u00fcz\u00fclmez**. Bu, panelin\nalanlar aras\u0131 m\u00fc\u015fteri panosuyla \u00f6rt\u00fc\u015f\u00fcr; o panonun b\u00fct\u00fcn amac\u0131, temsilciye\nbakaca\u011f\u0131 alan\u0131 se\u00e7meden \u00f6nce m\u00fc\u015fterinin sorununun nerede olabilece\u011fini s\u00f6ylemektir.\nBu yolun yan\u0131ndaki alan alan koleksiyonlar ise yetki isteyenlerdir.\n" }, "ar": { "description": "\u0639\u0645\u064a\u0644 \u0645\u064f\u0633\u0646\u064e\u062f \u0648\u0627\u062d\u062f \u0645\u0639 \u0623\u0639\u062f\u0627\u062f \u0645\u0648\u0627\u0631\u062f\u0647 \u2014 \u062a\u0645\u062b\u064a\u0644 \u0627\u0644\u0633\u062c\u0644 \u0627\u0644\u0645\u0641\u0631\u062f\u060c \u0639\u0644\u0649 \u063a\u0631\u0627\u0631\n`AdminCustomerDetail`.\n\n\u0627\u062e\u062a\u064a\u0631 \u0645\u062e\u0637\u0637 \u0645\u0646\u0641\u0635\u0644 \u0628\u062f\u0644 \u062d\u0642\u0644 `counts` \u0627\u062e\u062a\u064a\u0627\u0631\u064a \u0639\u0644\u0649 `SupportCustomer`: \u0641\u0627\u0644\u062d\u0642\u0644 \u0627\u0644\u0627\u062e\u062a\u064a\u0627\u0631\u064a\n\u0641\u064a \u0639\u0642\u062f \u0645\u062c\u0645\u064e\u0651\u062f \u062d\u0642\u0644 \u064a\u0636\u0637\u0631 \u0643\u0644 \u0639\u0645\u064a\u0644 \u0645\u0648\u0644\u064e\u0651\u062f \u0625\u0644\u0649 \u0627\u0644\u062a\u062d\u0642\u0642 \u0645\u0646 \u062e\u0644\u0648\u0651\u0647 \u0645\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 \u0625\u0644\u0649 \u0627\u0644\u0623\u0628\u062f.\n\n\u0648\u0627\u0644\u0623\u0639\u062f\u0627\u062f \u063a\u064a\u0631 \u0645\u0634\u0631\u0648\u0637\u0629 \u0648**\u0644\u0627** \u062a\u064f\u0631\u0634\u064e\u0651\u062d \u0648\u0641\u0642 \u062e\u0631\u064a\u0637\u0629 \u0635\u0644\u0627\u062d\u064a\u0627\u062a \u0627\u0644\u0645\u0648\u0638\u0641. \u0648\u0647\u0630\u0627 \u064a\u0637\u0627\u0628\u0642 \u0644\u0648\u062d\u0629\n\u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0639\u0627\u0628\u0631\u0629 \u0644\u0644\u0645\u062c\u0627\u0644\u0627\u062a \u0641\u064a \u0627\u0644\u0644\u0648\u062d\u0629\u060c \u0625\u0630 \u0625\u0646 \u063a\u0631\u0636\u0647\u0627 \u0643\u0644\u0647 \u0623\u0646 \u062a\u062f\u0644\u0651 \u0627\u0644\u0645\u0648\u0638\u0641 \u0639\u0644\u0649 \u0645\u0648\u0636\u0639 \u0645\u0634\u0643\u0644\u0629\n\u0627\u0644\u0639\u0645\u064a\u0644 \u0642\u0628\u0644 \u0623\u0646 \u064a\u0643\u0648\u0646 \u0644\u062f\u064a\u0647 \u0645\u062c\u0627\u0644 \u064a\u0628\u062d\u062b \u0641\u064a\u0647. \u0623\u0645\u0627 \u0627\u0644\u0645\u062c\u0645\u0648\u0639\u0627\u062a \u0627\u0644\u062e\u0627\u0635\u0629 \u0628\u0643\u0644 \u0645\u062c\u0627\u0644 \u0628\u062c\u0648\u0627\u0631 \u0647\u0630\u0627\n\u0627\u0644\u0645\u0633\u0627\u0631 \u0641\u0647\u064a \u0627\u0644\u062a\u064a \u062a\u0634\u062a\u0631\u0637 \u0635\u0644\u0627\u062d\u064a\u0629.\n" } }, "allOf": [ { "$ref": "#/components/schemas/SupportCustomer" }, { "type": "object", "required": [ "counts" ], "properties": { "counts": { "$ref": "#/components/schemas/CustomerCounts" } } } ] }, "SupportAssignment": { "type": "object", "description": "One row of the support-assignment matrix: which agent may act on which customer,\nand at what level in each of the five domains.\n\nThis is the control plane for every gate on the `Support` surface, which is why it\nis published read-only and nothing more. An `admin:write` grant over this table\nwould be a grant of `manage` over any customer to any agent, and no policy stands\nbehind it \u2014 see the `Admin` tag description.\n\n`support` and `customer` are `null` when the referenced account has been deleted;\nthe row is still worth reading, since it records that the access existed.\n\nTimestamps are not published: the listing comes from the admin assignment service,\nwhose projection is deliberately capped at `{id, name, email}` per side and does not\ncarry them. Adding them later is additive.\n", "x-i18n": { "tr": { "description": "Destek atama matrisinin bir sat\u0131r\u0131: hangi temsilcinin hangi m\u00fc\u015fteri \u00fczerinde i\u015flem\nyapabilece\u011fini ve be\u015f alan\u0131n her birinde bunu hangi d\u00fczeyde yapabilece\u011fini s\u00f6yler.\n\n`Support` taraf\u0131ndaki her denetimin kontrol d\u00fczlemi budur; bu y\u00fczden yaln\u0131zca salt\nokunur olarak yay\u0131mlan\u0131r, fazlas\u0131 de\u011fil. Bu tablo \u00fczerinde verilecek bir\n`admin:write` yetkisi, herhangi bir temsilciye herhangi bir m\u00fc\u015fteri \u00fczerinde `manage`\nvermek anlam\u0131na gelirdi ve arkas\u0131nda duran bir politika yoktur \u2014 bkz. `Admin`\netiketinin a\u00e7\u0131klamas\u0131.\n\nAd\u0131 ge\u00e7en hesap silinmi\u015fse `support` ve `customer` alanlar\u0131 `null` olur; eri\u015fimin\nvar oldu\u011funu kaydetti\u011fi i\u00e7in sat\u0131r yine de okumaya de\u011fer.\n\nZaman damgalar\u0131 yay\u0131mlanmaz: liste, y\u00f6netim taraf\u0131ndaki atama servisinden gelir ve\nbu servisin izd\u00fc\u015f\u00fcm\u00fc her iki taraf i\u00e7in de bilin\u00e7li olarak `{id, name, email}` ile\ns\u0131n\u0131rl\u0131d\u0131r, zaman damgalar\u0131n\u0131 ta\u015f\u0131maz. Sonradan eklenmeleri yaln\u0131zca ekleme olur.\n" }, "ar": { "description": "\u0635\u0641 \u0648\u0627\u062d\u062f \u0645\u0646 \u0645\u0635\u0641\u0648\u0641\u0629 \u0625\u0633\u0646\u0627\u062f \u0627\u0644\u062f\u0639\u0645: \u0623\u064a \u0645\u0648\u0638\u0641 \u064a\u062c\u0648\u0632 \u0644\u0647 \u0627\u0644\u062a\u0635\u0631\u0641 \u0628\u0634\u0623\u0646 \u0623\u064a \u0639\u0645\u064a\u0644\u060c \u0648\u0628\u0623\u064a \u0645\u0633\u062a\u0648\u0649\n\u0641\u064a \u0643\u0644 \u0645\u062c\u0627\u0644 \u0645\u0646 \u0627\u0644\u0645\u062c\u0627\u0644\u0627\u062a \u0627\u0644\u062e\u0645\u0633\u0629.\n\n\u0647\u0630\u0627 \u0647\u0648 \u0645\u0633\u062a\u0648\u0649 \u0627\u0644\u062a\u062d\u0643\u0645 \u0644\u0643\u0644 \u0628\u0648\u0627\u0628\u0629 \u0639\u0644\u0649 \u0648\u0627\u062c\u0647\u0629 `Support`\u060c \u0648\u0644\u0630\u0644\u0643 \u064a\u064f\u0646\u0634\u0631 \u0644\u0644\u0642\u0631\u0627\u0621\u0629 \u0641\u0642\u0637 \u0644\u0627\n\u0623\u0643\u062b\u0631. \u0641\u0645\u0646\u062d `admin:write` \u0639\u0644\u0649 \u0647\u0630\u0627 \u0627\u0644\u062c\u062f\u0648\u0644 \u064a\u0639\u0646\u064a \u0645\u0646\u062d `manage` \u0639\u0644\u0649 \u0623\u064a \u0639\u0645\u064a\u0644 \u0644\u0623\u064a \u0645\u0648\u0638\u0641\u060c\n\u0648\u0644\u0627 \u062a\u0642\u0641 \u062e\u0644\u0641\u0647 \u0623\u064a \u0633\u064a\u0627\u0633\u0629 \u2014 \u0627\u0646\u0638\u0631 \u0648\u0635\u0641 \u0627\u0644\u0648\u0633\u0645 `Admin`.\n\n\u064a\u0643\u0648\u0646 \u0627\u0644\u062d\u0642\u0644\u0627\u0646 `support` \u0648`customer` \u0628\u0642\u064a\u0645\u0629 `null` \u0639\u0646\u062f \u062d\u0630\u0641 \u0627\u0644\u062d\u0633\u0627\u0628 \u0627\u0644\u0645\u0634\u0627\u0631 \u0625\u0644\u064a\u0647\u061b \u0648\u064a\u0638\u0644\n\u0627\u0644\u0635\u0641 \u062c\u062f\u064a\u0631\u064b\u0627 \u0628\u0627\u0644\u0642\u0631\u0627\u0621\u0629\u060c \u0644\u0623\u0646\u0647 \u064a\u0633\u062c\u0651\u0644 \u0623\u0646 \u0630\u0644\u0643 \u0627\u0644\u0648\u0635\u0648\u0644 \u0643\u0627\u0646 \u0642\u0627\u0626\u0645\u064b\u0627.\n\n\u0627\u0644\u0637\u0648\u0627\u0628\u0639 \u0627\u0644\u0632\u0645\u0646\u064a\u0629 \u063a\u064a\u0631 \u0645\u0646\u0634\u0648\u0631\u0629: \u0641\u0627\u0644\u0642\u0627\u0626\u0645\u0629 \u062a\u0623\u062a\u064a \u0645\u0646 \u062e\u062f\u0645\u0629 \u0627\u0644\u0625\u0633\u0646\u0627\u062f \u0627\u0644\u0625\u062f\u0627\u0631\u064a\u0629\u060c \u0648\u0625\u0633\u0642\u0627\u0637\u0647\u0627\n\u0645\u0642\u0635\u0648\u0631 \u0639\u0645\u062f\u064b\u0627 \u0639\u0644\u0649 `{id, name, email}` \u0644\u0643\u0644 \u0637\u0631\u0641 \u0648\u0644\u0627 \u064a\u062d\u0645\u0644\u0647\u0627. \u0648\u0625\u0636\u0627\u0641\u062a\u0647\u0627 \u0644\u0627\u062d\u0642\u064b\u0627 \u0625\u0636\u0627\u0641\u0629\n\u063a\u064a\u0631 \u0643\u0627\u0633\u0631\u0629.\n" } }, "required": [ "id", "support", "customer", "capabilities" ], "properties": { "id": { "type": "integer", "example": 17 }, "support": { "allOf": [ { "$ref": "#/components/schemas/UserRef" } ], "nullable": true, "description": "The agent the assignment grants access to.", "x-i18n": { "tr": { "description": "Ataman\u0131n eri\u015fim verdi\u011fi temsilci." }, "ar": { "description": "\u0627\u0644\u0645\u0648\u0638\u0641 \u0627\u0644\u0630\u064a \u064a\u0645\u0646\u062d\u0647 \u0627\u0644\u0625\u0633\u0646\u0627\u062f \u0635\u0644\u0627\u062d\u064a\u0629 \u0627\u0644\u0648\u0635\u0648\u0644." } } }, "customer": { "allOf": [ { "$ref": "#/components/schemas/UserRef" } ], "nullable": true, "description": "The customer whose data the assignment covers.", "x-i18n": { "tr": { "description": "Ataman\u0131n kapsad\u0131\u011f\u0131 verilerin sahibi olan m\u00fc\u015fteri." }, "ar": { "description": "\u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0630\u064a \u062a\u0634\u0645\u0644 \u0628\u064a\u0627\u0646\u0627\u062a\u0647 \u0647\u0630\u0627 \u0627\u0644\u0625\u0633\u0646\u0627\u062f." } } }, "capabilities": { "$ref": "#/components/schemas/SupportCapabilities" } } }, "AiPrompts": { "type": "object", "description": "Both assistants' system prompts: the fixed built-in contract, which no surface can\nedit, and the operator's own guidance, which is appended below it.\n", "x-i18n": { "tr": { "description": "Her iki asistan\u0131n sistem istemleri: hi\u00e7bir aray\u00fcz\u00fcn d\u00fczenleyemedi\u011fi sabit\nyerle\u015fik s\u00f6zle\u015fme ve onun alt\u0131na eklenen, operat\u00f6r\u00fcn kendi y\u00f6nergesi.\n" }, "ar": { "description": "\u0645\u0648\u062c\u0651\u0647\u0627\u062a \u0627\u0644\u0646\u0638\u0627\u0645 \u0644\u0643\u0644\u0627 \u0627\u0644\u0645\u0633\u0627\u0639\u062f\u064e\u064a\u0646: \u0627\u0644\u0639\u0642\u062f \u0627\u0644\u0645\u062f\u0645\u062c \u0627\u0644\u062b\u0627\u0628\u062a \u0627\u0644\u0630\u064a \u0644\u0627 \u062a\u0633\u062a\u0637\u064a\u0639 \u0623\u064a \u0648\u0627\u062c\u0647\u0629\n\u062a\u0639\u062f\u064a\u0644\u0647\u060c \u0648\u062a\u0648\u062c\u064a\u0647 \u0627\u0644\u0645\u0634\u063a\u0651\u0644 \u0646\u0641\u0633\u0647 \u0627\u0644\u0630\u064a \u064a\u064f\u0636\u0627\u0641 \u062a\u062d\u062a\u0647.\n" } }, "required": [ "max_guidance", "surfaces" ], "properties": { "max_guidance": { "type": "integer", "description": "The character limit each `guidance` is held to, enforced identically by this API,\nthe admin settings form and the MCP tool. The text is sent to the model on every\nturn of every conversation, so the limit is a bill as much as a policy.\n", "x-i18n": { "tr": { "description": "Her `guidance` metninin uymas\u0131 gereken karakter s\u0131n\u0131r\u0131; bu API, y\u00f6netim\nayarlar\u0131 formu ve MCP arac\u0131 taraf\u0131ndan birebir ayn\u0131 bi\u00e7imde uygulan\u0131r.\nMetin, her sohbetin her turunda modele g\u00f6nderilir; bu y\u00fczden s\u0131n\u0131r bir\npolitika oldu\u011fu kadar bir maliyet kalemidir.\n" }, "ar": { "description": "\u0627\u0644\u062d\u062f\u0651 \u0627\u0644\u0623\u0642\u0635\u0649 \u0644\u0639\u062f\u062f \u0627\u0644\u0645\u062d\u0627\u0631\u0641 \u0627\u0644\u0630\u064a \u064a\u0644\u062a\u0632\u0645 \u0628\u0647 \u0643\u0644 `guidance`\u060c \u0648\u062a\u0641\u0631\u0636\u0647 \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629\n\u0627\u0644\u0628\u0631\u0645\u062c\u064a\u0629 \u0648\u0646\u0645\u0648\u0630\u062c \u0625\u0639\u062f\u0627\u062f\u0627\u062a \u0627\u0644\u0645\u062f\u064a\u0631 \u0648\u0623\u062f\u0627\u0629 MCP \u0628\u0627\u0644\u0637\u0631\u064a\u0642\u0629 \u0646\u0641\u0633\u0647\u0627. \u0648\u064a\u064f\u0631\u0633\u064e\u0644 \u0627\u0644\u0646\u0635 \u0625\u0644\u0649\n\u0627\u0644\u0646\u0645\u0648\u0630\u062c \u0641\u064a \u0643\u0644 \u062f\u0648\u0631 \u0645\u0646 \u0643\u0644 \u0645\u062d\u0627\u062f\u062b\u0629\u060c \u0641\u0627\u0644\u062d\u062f\u0651 \u0641\u0627\u062a\u0648\u0631\u0629\u064c \u0628\u0642\u062f\u0631 \u0645\u0627 \u0647\u0648 \u0633\u064a\u0627\u0633\u0629.\n" } }, "example": 2000 }, "surfaces": { "type": "array", "description": "One entry per assistant. There are two, and they never share text.", "x-i18n": { "tr": { "description": "Her asistan i\u00e7in bir girdi. \u0130ki tane vard\u0131r ve hi\u00e7bir zaman ayn\u0131 metni payla\u015fmazlar." }, "ar": { "description": "\u0645\u062f\u062e\u0644\u0629 \u0648\u0627\u062d\u062f\u0629 \u0644\u0643\u0644 \u0645\u0633\u0627\u0639\u062f. \u0648\u0647\u0645\u0627 \u0627\u062b\u0646\u0627\u0646\u060c \u0648\u0644\u0627 \u064a\u062a\u0634\u0627\u0631\u0643\u0627\u0646 \u0627\u0644\u0646\u0635 \u0623\u0628\u062f\u064b\u0627." } }, "items": { "type": "object", "required": [ "surface", "title", "core", "guidance" ], "properties": { "surface": { "type": "string", "enum": [ "assistant", "public" ], "description": "`assistant` is the panel assistant a signed-in customer operates their cloud\nwith; `public` is the anonymous chat bubble on the marketing site.\n", "x-i18n": { "tr": { "description": "`assistant`, oturum a\u00e7m\u0131\u015f bir m\u00fc\u015fterinin bulutunu y\u00f6netti\u011fi panel\nasistan\u0131d\u0131r; `public` ise tan\u0131t\u0131m sitesindeki anonim sohbet\nbalonudur.\n" }, "ar": { "description": "`assistant` \u0647\u0648 \u0645\u0633\u0627\u0639\u062f \u0627\u0644\u0644\u0648\u062d\u0629 \u0627\u0644\u0630\u064a \u064a\u062f\u064a\u0631 \u0628\u0647 \u0627\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0633\u062c\u064e\u0651\u0644 \u062f\u062e\u0648\u0644\u0647\n\u0633\u062d\u0627\u0628\u062a\u0647\u061b \u0648`public` \u0647\u0648 \u0641\u0642\u0627\u0639\u0629 \u0627\u0644\u062f\u0631\u062f\u0634\u0629 \u0627\u0644\u0645\u062c\u0647\u0648\u0644\u0629 \u0639\u0644\u0649 \u0627\u0644\u0645\u0648\u0642\u0639 \u0627\u0644\u062a\u0639\u0631\u064a\u0641\u064a.\n" } } }, "title": { "type": "string", "description": "A human-readable name for the surface.", "x-i18n": { "tr": { "description": "Aray\u00fcz\u00fcn insan taraf\u0131ndan okunabilir ad\u0131." }, "ar": { "description": "\u0627\u0633\u0645 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u0628\u0635\u064a\u063a\u0629 \u0645\u0642\u0631\u0648\u0621\u0629 \u0644\u0644\u0628\u0634\u0631." } }, "example": "Panel assistant" }, "core": { "type": "string", "description": "The built-in prompt, READ-ONLY on every surface \u2014 it lives in the\napplication's source, not in the database. It carries the rules that make\nthe assistant safe to run, and the operator's guidance is appended below it\nand explicitly subordinate to it.\n", "x-i18n": { "tr": { "description": "Yerle\u015fik istem; her aray\u00fczde SALT OKUNURDUR \u2014 veritaban\u0131nda de\u011fil,\nuygulaman\u0131n kaynak kodunda durur. Asistan\u0131 g\u00fcvenle \u00e7al\u0131\u015ft\u0131ran\nkurallar\u0131 ta\u015f\u0131r; operat\u00f6r\u00fcn y\u00f6nergesi bunun alt\u0131na eklenir ve\na\u00e7\u0131k\u00e7a buna tabidir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0648\u062c\u0651\u0647 \u0627\u0644\u0645\u062f\u0645\u062c\u060c \u0648\u0647\u0648 \u0644\u0644\u0642\u0631\u0627\u0621\u0629 \u0641\u0642\u0637 \u0641\u064a \u0643\u0644 \u0648\u0627\u062c\u0647\u0629 \u2014 \u0625\u0630 \u064a\u0639\u064a\u0634 \u0641\u064a \u0634\u064a\u0641\u0631\u0629\n\u0627\u0644\u062a\u0637\u0628\u064a\u0642 \u0644\u0627 \u0641\u064a \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a. \u0648\u0647\u0648 \u064a\u062d\u0645\u0644 \u0627\u0644\u0642\u0648\u0627\u0639\u062f \u0627\u0644\u062a\u064a \u062a\u062c\u0639\u0644 \u062a\u0634\u063a\u064a\u0644\n\u0627\u0644\u0645\u0633\u0627\u0639\u062f \u0622\u0645\u0646\u064b\u0627\u060c \u0648\u064a\u064f\u0636\u0627\u0641 \u062a\u0648\u062c\u064a\u0647 \u0627\u0644\u0645\u0634\u063a\u0651\u0644 \u062a\u062d\u062a\u0647 \u0648\u064a\u0643\u0648\u0646 \u062a\u0627\u0628\u0639\u064b\u0627 \u0644\u0647 \u0635\u0631\u0627\u062d\u0629\u064b.\n" } } }, "guidance": { "type": "string", "nullable": true, "description": "The operator's own text, or null when none is set. Null on every surface\nmeans the assistants send exactly the prompt that shipped.\n", "x-i18n": { "tr": { "description": "Operat\u00f6r\u00fcn kendi metni ya da hi\u00e7biri tan\u0131mlanmad\u0131\u011f\u0131nda null. Her\naray\u00fczde null olmas\u0131, asistanlar\u0131n tam olarak \u00fcr\u00fcnle gelen istemi\ng\u00f6nderdi\u011fi anlam\u0131na gelir.\n" }, "ar": { "description": "\u0646\u0635 \u0627\u0644\u0645\u0634\u063a\u0651\u0644 \u0646\u0641\u0633\u0647\u060c \u0623\u0648 null \u0639\u0646\u062f \u0639\u062f\u0645 \u0636\u0628\u0637 \u0623\u064a \u0646\u0635. \u0648\u0643\u0648\u0646 \u0627\u0644\u0642\u064a\u0645\u0629 null \u0641\u064a \u0643\u0644\n\u0648\u0627\u062c\u0647\u0629 \u064a\u0639\u0646\u064a \u0623\u0646 \u0627\u0644\u0645\u0633\u0627\u0639\u062f\u064e\u064a\u0646 \u064a\u0631\u0633\u0644\u0627\u0646 \u0627\u0644\u0645\u0648\u062c\u0651\u0647 \u0627\u0644\u0630\u064a \u0634\u064f\u062d\u0646 \u0645\u0639 \u0627\u0644\u0645\u0646\u062a\u062c \u062a\u0645\u0627\u0645\u064b\u0627.\n" } } } } } } } }, "StagedAction": { "type": "object", "description": "One entry of the approval queue: an action a token asked for and a person decides on the\npanel. The frozen payload is not published; `preview` is the sentence the approver reads.\n", "required": [ "id", "action", "status", "subject_id", "preview", "requested_by", "requested_via_token", "requested_at", "expires_at", "decided_by", "decided_at", "decision_note", "result", "approval_url" ], "properties": { "id": { "type": "integer", "example": 12 }, "action": { "type": "string", "example": "publish_news" }, "status": { "type": "string", "enum": [ "pending", "approved", "rejected", "expired", "failed" ], "description": "`pending` until a person decides or it lapses (24 hours); then `approved`, `rejected`,\n`expired` or `failed`. A decided entry is never revived: ask again.\n", "x-i18n": { "tr": { "description": "Bir ki\u015fi karar verene ya da s\u00fcresi dolana (24 saat) kadar `pending`; ard\u0131ndan\n`approved`, `rejected`, `expired` veya `failed`. Karara ba\u011flanm\u0131\u015f bir kay\u0131t hi\u00e7bir\nzaman yeniden canlanmaz: yeniden isteyin.\n" }, "ar": { "description": "`pending` \u0625\u0644\u0649 \u0623\u0646 \u064a\u0642\u0631\u0651\u0631 \u0634\u062e\u0635 \u0623\u0648 \u062a\u0646\u0642\u0636\u064a \u0627\u0644\u0645\u0647\u0644\u0629 (24 \u0633\u0627\u0639\u0629)\u061b \u062b\u0645 `approved` \u0623\u0648 `rejected` \u0623\u0648\n`expired` \u0623\u0648 `failed`. \u0648\u0644\u0627 \u064a\u064f\u0639\u0627\u062f \u0625\u062d\u064a\u0627\u0621 \u0633\u062c\u0644 \u062d\u064f\u0633\u0645 \u0623\u0628\u062f\u064b\u0627: \u0627\u0637\u0644\u0628 \u0645\u0646 \u062c\u062f\u064a\u062f.\n" } } }, "subject_id": { "type": "integer", "nullable": true, "description": "The row the action addresses; its kind follows from `action` (for `publish_news`, a news id).", "x-i18n": { "tr": { "description": "Eylemin hedefledi\u011fi kay\u0131t; t\u00fcr\u00fc `action` alan\u0131ndan anla\u015f\u0131l\u0131r (`publish_news` i\u00e7in bir duyuru id'si)." }, "ar": { "description": "\u0627\u0644\u0633\u062c\u0644 \u0627\u0644\u0630\u064a \u064a\u0633\u062a\u0647\u062f\u0641\u0647 \u0627\u0644\u0625\u062c\u0631\u0627\u0621\u061b \u0648\u064a\u064f\u0639\u0631\u0641 \u0646\u0648\u0639\u0647 \u0645\u0646 `action` (\u0641\u0641\u064a `publish_news` \u0647\u0648 \u0645\u0639\u0631\u0651\u0641 \u062e\u0628\u0631)." } } }, "preview": { "type": "string", "description": "What will happen if a person approves, in the sentence the approver reads.", "x-i18n": { "tr": { "description": "Bir ki\u015fi onaylarsa ne olaca\u011f\u0131; onaylayan\u0131n okudu\u011fu c\u00fcmleyle." }, "ar": { "description": "\u0645\u0627 \u0627\u0644\u0630\u064a \u0633\u064a\u062d\u062f\u062b \u0625\u0646 \u0648\u0627\u0641\u0642 \u0634\u062e\u0635\u060c \u0628\u0627\u0644\u062c\u0645\u0644\u0629 \u0627\u0644\u062a\u064a \u064a\u0642\u0631\u0624\u0647\u0627 \u0645\u0646 \u064a\u0648\u0627\u0641\u0642." } } }, "requested_by": { "allOf": [ { "$ref": "#/components/schemas/UserRef" } ], "nullable": true }, "requested_via_token": { "type": "integer", "nullable": true, "description": "The id of the personal access token that asked, so a client can pick out its own requests. Never the token itself.", "x-i18n": { "tr": { "description": "\u0130ste\u011fi yapan ki\u015fisel eri\u015fim anahtar\u0131n\u0131n id'si; b\u00f6ylece bir istemci kendi isteklerini ay\u0131rt edebilir. Anahtar\u0131n kendisi asla verilmez." }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0631\u0645\u0632 \u0627\u0644\u0648\u0635\u0648\u0644 \u0627\u0644\u0634\u062e\u0635\u064a \u0627\u0644\u0630\u064a \u0637\u0644\u0628\u060c \u0644\u064a\u062a\u0645\u0643\u0651\u0646 \u0627\u0644\u0639\u0645\u064a\u0644 \u0645\u0646 \u062a\u0645\u064a\u064a\u0632 \u0637\u0644\u0628\u0627\u062a\u0647. \u0648\u0644\u0627 \u064a\u064f\u0639\u0637\u0649 \u0627\u0644\u0631\u0645\u0632 \u0646\u0641\u0633\u0647 \u0623\u0628\u062f\u064b\u0627." } } }, "requested_at": { "type": "string", "format": "date-time", "nullable": true }, "expires_at": { "type": "string", "format": "date-time", "nullable": true }, "decided_by": { "allOf": [ { "$ref": "#/components/schemas/UserRef" } ], "nullable": true }, "decided_at": { "type": "string", "format": "date-time", "nullable": true }, "decision_note": { "type": "string", "nullable": true }, "result": { "description": "What the approved action reported, or `{error}` when it failed; `null` while pending.", "x-i18n": { "tr": { "description": "Onaylanan eylemin bildirdi\u011fi sonu\u00e7 ya da ba\u015far\u0131s\u0131z oldu\u011funda `{error}`; beklemedeyken `null`." }, "ar": { "description": "\u0645\u0627 \u0623\u0641\u0627\u062f \u0628\u0647 \u0627\u0644\u0625\u062c\u0631\u0627\u0621 \u0627\u0644\u0645\u0648\u0627\u0641\u0642 \u0639\u0644\u064a\u0647\u060c \u0623\u0648 `{error}` \u0639\u0646\u062f \u0641\u0634\u0644\u0647\u061b \u0648`null` \u0645\u0627 \u062f\u0627\u0645 \u0645\u0639\u0644\u0651\u0642\u064b\u0627." } } }, "approval_url": { "type": "string", "description": "The panel page where an administrator, signed in, decides this entry. A token cannot use it.", "x-i18n": { "tr": { "description": "Oturum a\u00e7m\u0131\u015f bir y\u00f6neticinin bu kay\u0131t hakk\u0131nda karar verdi\u011fi panel sayfas\u0131. Bir anahtar onu kullanamaz." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0627\u0644\u0644\u0648\u062d\u0629 \u0627\u0644\u062a\u064a \u064a\u0642\u0631\u0651\u0631 \u0641\u064a\u0647\u0627 \u0645\u062f\u064a\u0631 \u0645\u0633\u062c\u064e\u0651\u0644 \u0627\u0644\u062f\u062e\u0648\u0644 \u0647\u0630\u0627 \u0627\u0644\u0633\u062c\u0644. \u0648\u0644\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0627\u0644\u0631\u0645\u0632 \u0627\u0633\u062a\u062e\u062f\u0627\u0645\u0647\u0627." } } } } }, "News": { "type": "object", "description": "One news item of the panel. A draft is `is_published: false`; nothing on this API\npublishes one except an administrator approving a staged publication.\n", "required": [ "id", "title", "body", "language", "audience", "is_published", "publish_date", "scheduled_for", "announced_at", "created_at", "updated_at" ], "properties": { "id": { "type": "integer", "example": 31 }, "title": { "type": "string", "maxLength": 255, "example": "Planned maintenance on Sunday" }, "body": { "type": "string", "maxLength": 2048 }, "language": { "type": "string", "enum": [ "tr-TR", "en-US", "ar-SA" ], "description": "Who is told \u2014 only readers of this language receive it when it is published.", "x-i18n": { "tr": { "description": "Kime bildirilece\u011fi: yay\u0131mland\u0131\u011f\u0131nda yaln\u0131zca bu dili kullanan okurlara ula\u015f\u0131r." }, "ar": { "description": "\u0645\u0646 \u064a\u064f\u0628\u0644\u064e\u0651\u063a: \u0639\u0646\u062f \u0627\u0644\u0646\u0634\u0631 \u0644\u0627 \u064a\u0635\u0644 \u0625\u0644\u0627 \u0625\u0644\u0649 \u0642\u0631\u0651\u0627\u0621 \u0647\u0630\u0647 \u0627\u0644\u0644\u063a\u0629." } } }, "audience": { "type": "string", "enum": [ "everyone", "customers" ], "description": "`everyone`, or `customers` \u2014 accounts holding an active subscription when it is sent.", "x-i18n": { "tr": { "description": "`everyone` ya da `customers` \u2014 g\u00f6nderildi\u011fi anda etkin bir aboneli\u011fi olan hesaplar." }, "ar": { "description": "`everyone`\u060c \u0623\u0648 `customers` \u2014 \u0623\u064a \u0627\u0644\u062d\u0633\u0627\u0628\u0627\u062a \u0627\u0644\u062a\u064a \u062a\u0645\u0644\u0643 \u0627\u0634\u062a\u0631\u0627\u0643\u064b\u0627 \u0641\u0639\u0651\u0627\u0644\u064b\u0627 \u0644\u062d\u0638\u0629 \u0627\u0644\u0625\u0631\u0633\u0627\u0644." } } }, "is_published": { "type": "boolean", "description": "Whether it is visible. A draft is `false`; nothing on this API sets it `true` except an administrator approving a staged publication.", "x-i18n": { "tr": { "description": "G\u00f6r\u00fcn\u00fcr olup olmad\u0131\u011f\u0131. Taslak `false` de\u011ferindedir; bu API'de onu `true` yapan tek \u015fey, bir y\u00f6neticinin kuyru\u011fa al\u0131nm\u0131\u015f bir yay\u0131mlamay\u0131 onaylamas\u0131d\u0131r." }, "ar": { "description": "\u0647\u0644 \u0647\u0648 \u0638\u0627\u0647\u0631. \u0627\u0644\u0645\u0633\u0648\u062f\u0629 \u0642\u064a\u0645\u062a\u0647\u0627 `false`\u061b \u0648\u0644\u0627 \u0634\u064a\u0621 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u064a\u062c\u0639\u0644\u0647\u0627 `true` \u0633\u0648\u0649 \u0645\u0648\u0627\u0641\u0642\u0629 \u0645\u062f\u064a\u0631 \u0639\u0644\u0649 \u0646\u0634\u0631 \u0645\u064f\u062f\u0631\u064e\u062c \u0641\u064a \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631." } } }, "publish_date": { "type": "string", "format": "date-time", "nullable": true, "description": "When the item was published, or `null` on a draft.", "x-i18n": { "tr": { "description": "Duyurunun yay\u0131mland\u0131\u011f\u0131 an; taslakta `null`." }, "ar": { "description": "\u0648\u0642\u062a \u0646\u0634\u0631 \u0627\u0644\u062e\u0628\u0631\u060c \u0623\u0648 `null` \u0625\u0646 \u0643\u0627\u0646 \u0645\u0633\u0648\u062f\u0629." } } }, "scheduled_for": { "type": "string", "format": "date-time", "nullable": true }, "announced_at": { "type": "string", "format": "date-time", "nullable": true, "description": "When it was sent to its audience, or `null` if it never was. A news item is sent at most once.", "x-i18n": { "tr": { "description": "Kitlesine ne zaman g\u00f6nderildi\u011fi ya da hi\u00e7 g\u00f6nderilmediyse `null`. Bir duyuru en fazla bir kez g\u00f6nderilir." }, "ar": { "description": "\u0645\u062a\u0649 \u0623\u064f\u0631\u0633\u0644 \u0625\u0644\u0649 \u062c\u0645\u0647\u0648\u0631\u0647\u060c \u0623\u0648 `null` \u0625\u0646 \u0644\u0645 \u064a\u064f\u0631\u0633\u0644 \u0642\u0637. \u0648\u0644\u0627 \u064a\u064f\u0631\u0633\u0644 \u0627\u0644\u062e\u0628\u0631 \u0623\u0643\u062b\u0631 \u0645\u0646 \u0645\u0631\u0629." } } }, "created_at": { "type": "string", "format": "date-time", "nullable": true }, "updated_at": { "type": "string", "format": "date-time", "nullable": true } } }, "StagedActionReceipt": { "type": "object", "description": "The answer to a request that was STAGED rather than carried out: nothing has happened yet.\nPoll `GET /admin/staged-actions/{staged_action_id}` (the `Location` header) for the outcome.\n", "required": [ "staged", "staged_action_id", "status", "preview", "expires_at", "approval_url", "note" ], "properties": { "staged": { "type": "boolean", "example": true }, "staged_action_id": { "type": "integer", "example": 12 }, "status": { "type": "string", "example": "pending" }, "preview": { "type": "string", "example": "Publish news item" }, "expires_at": { "type": "string", "format": "date-time", "nullable": true }, "approval_url": { "type": "string" }, "note": { "type": "string" } } }, "WorkQueue": { "type": "object", "description": "One operator queue \u2014 how many items wait on a person, and since when. Counts only; nobody is named.", "required": [ "queue", "count", "urgent", "oldest", "overdue", "suspended", "accounts", "amount", "currency", "href" ], "properties": { "queue": { "type": "string", "example": "privacy", "description": "The queue's key, stable across releases.", "x-i18n": { "tr": { "description": "Kuyru\u011fun anahtar\u0131; s\u00fcr\u00fcmden s\u00fcr\u00fcme de\u011fi\u015fmez." }, "ar": { "description": "\u0645\u0641\u062a\u0627\u062d \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631\u060c \u0648\u0647\u0648 \u062b\u0627\u0628\u062a \u0639\u0628\u0631 \u0627\u0644\u0625\u0635\u062f\u0627\u0631\u0627\u062a." } } }, "count": { "type": "integer" }, "urgent": { "type": "boolean" }, "oldest": { "type": "string", "nullable": true, "description": "When the longest-waiting item arrived, or `null` when nothing waits.", "x-i18n": { "tr": { "description": "En uzun s\u00fcredir bekleyen \u00f6\u011fenin geldi\u011fi zaman ya da hi\u00e7bir \u015fey beklemiyorsa `null`." }, "ar": { "description": "\u0645\u062a\u0649 \u0648\u0635\u0644 \u0627\u0644\u0639\u0646\u0635\u0631 \u0627\u0644\u0623\u0637\u0648\u0644 \u0627\u0646\u062a\u0638\u0627\u0631\u064b\u0627\u060c \u0623\u0648 `null` \u0625\u0646 \u0644\u0645 \u064a\u0643\u0646 \u0647\u0646\u0627\u0643 \u0645\u0627 \u064a\u0646\u062a\u0638\u0631." } } }, "overdue": { "type": "integer", "nullable": true }, "suspended": { "type": "integer", "nullable": true }, "accounts": { "type": "integer", "nullable": true }, "amount": { "allOf": [ { "type": "object", "description": "An amount in the currency's minor unit. Never a floating-point number \u2014 129900 TRY\nmeans 1,299.00 TRY.\n", "x-i18n": { "tr": { "description": "Tutar, para biriminin alt biriminde verilir. Asla kayan noktal\u0131 bir say\u0131 de\u011fildir \u2014\n129900 TRY, 1.299,00 TRY demektir.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0628\u0644\u063a \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629. \u0644\u064a\u0633 \u0631\u0642\u0645\u064b\u0627 \u0639\u0634\u0631\u064a\u064b\u0627 \u0639\u0627\u0626\u0645\u064b\u0627 \u0623\u0628\u062f\u064b\u0627 \u2014 \u0641\u0627\u0644\u0642\u064a\u0645\u0629 129900 TRY\n\u062a\u0639\u0646\u064a 1,299.00 TRY.\n" } }, "required": [ "amount", "currency" ], "properties": { "amount": { "type": "integer", "format": "int64", "example": 129900 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3, "example": "TRY" } } } ], "nullable": true, "description": "What the queue's items are worth, in the currency's MINOR unit like every other\namount in this API \u2014 1250 USD means 12.50 USD. Only the `referrals` queue carries\none (the unpaid rewards, in USD); `null` for every other queue.\n", "x-i18n": { "tr": { "description": "Kuyruktaki \u00f6\u011felerin tutar\u0131; bu API'deki di\u011fer her tutar gibi para biriminin ALT\nbiriminde verilir \u2014 1250 USD, 12,50 USD demektir. Yaln\u0131zca `referrals` kuyru\u011fu bir\ntutar ta\u015f\u0131r (\u00f6denmemi\u015f tavsiye \u00f6d\u00fclleri, USD cinsinden); di\u011fer her kuyrukta `null`.\n" }, "ar": { "description": "\u0642\u064a\u0645\u0629 \u0639\u0646\u0627\u0635\u0631 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631\u060c \u0628\u0627\u0644\u0648\u062d\u062f\u0629 \u0627\u0644\u0641\u0631\u0639\u064a\u0629 \u0644\u0644\u0639\u0645\u0644\u0629 \u0645\u062b\u0644 \u0643\u0644 \u0645\u0628\u0644\u063a \u0622\u062e\u0631 \u0641\u064a \u0647\u0630\u0647 \u0627\u0644\u0648\u0627\u062c\u0647\u0629 \u2014\n\u0641\u0627\u0644\u0642\u064a\u0645\u0629 1250 USD \u062a\u0639\u0646\u064a 12.50 USD. \u0644\u0627 \u062a\u062d\u0645\u0644 \u0645\u0628\u0644\u063a\u064b\u0627 \u0625\u0644\u0627 \u0642\u0627\u0626\u0645\u0629 `referrals` (\u0645\u0643\u0627\u0641\u0622\u062a \u0627\u0644\u0625\u062d\u0627\u0644\u0629\n\u063a\u064a\u0631 \u0627\u0644\u0645\u062f\u0641\u0648\u0639\u0629\u060c \u0628\u0627\u0644\u062f\u0648\u0644\u0627\u0631 \u0627\u0644\u0623\u0645\u0631\u064a\u0643\u064a)\u061b \u0648`null` \u0644\u0643\u0644 \u0642\u0627\u0626\u0645\u0629 \u0623\u062e\u0631\u0649.\n" } } }, "currency": { "type": "string", "nullable": true, "description": "The currency of `amount`, repeated beside it; `null` where `amount` is.", "x-i18n": { "tr": { "description": "`amount` tutar\u0131n\u0131n para birimi, yan\u0131nda yinelenir; `amount` `null` ise bu da `null` olur." }, "ar": { "description": "\u0639\u0645\u0644\u0629 `amount`\u060c \u0645\u0643\u0631\u0651\u0631\u0629 \u0628\u062c\u0627\u0646\u0628\u0647\u061b \u0648\u062a\u0643\u0648\u0646 `null` \u062d\u064a\u062b \u064a\u0643\u0648\u0646 `amount` \u0643\u0630\u0644\u0643." } } }, "href": { "type": "string", "description": "The panel page that works this queue.", "x-i18n": { "tr": { "description": "Bu kuyru\u011fun i\u015flendi\u011fi panel sayfas\u0131." }, "ar": { "description": "\u0635\u0641\u062d\u0629 \u0627\u0644\u0644\u0648\u062d\u0629 \u0627\u0644\u062a\u064a \u062a\u064f\u0639\u0627\u0644\u064e\u062c \u0641\u064a\u0647\u0627 \u0647\u0630\u0647 \u0627\u0644\u0642\u0627\u0626\u0645\u0629." } } } } }, "SystemHealth": { "type": "object", "description": "The installation's health, the same report the admin MCP server's get_system_health returns.", "required": [ "version", "failed_jobs", "queue", "schedule", "migrations", "configuration", "checked_at" ], "properties": { "version": { "type": "object", "required": [ "app" ], "properties": { "app": { "type": "string" } } }, "failed_jobs": { "type": "object", "required": [ "total", "recent" ], "description": "Job name and exception class only; never the payload or the message.", "x-i18n": { "tr": { "description": "Yaln\u0131zca i\u015f ad\u0131 ve istisna s\u0131n\u0131f\u0131; y\u00fck ya da ileti asla." }, "ar": { "description": "\u0627\u0633\u0645 \u0627\u0644\u0645\u0647\u0645\u0629 \u0648\u0635\u0646\u0641 \u0627\u0644\u0627\u0633\u062a\u062b\u0646\u0627\u0621 \u0641\u0642\u0637\u061b \u0648\u0644\u0627 \u062a\u064f\u0639\u0637\u0649 \u0627\u0644\u062d\u0645\u0648\u0644\u0629 \u0623\u0648 \u0627\u0644\u0631\u0633\u0627\u0644\u0629 \u0623\u0628\u062f\u064b\u0627." } }, "properties": { "total": { "type": "integer" }, "recent": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "nullable": true }, "uuid": { "type": "string", "nullable": true }, "queue": { "type": "string", "nullable": true }, "job": { "type": "string", "nullable": true }, "exception": { "type": "string", "nullable": true }, "failed_at": { "type": "string", "nullable": true } } } } } }, "queue": { "type": "object", "required": [ "available", "connection" ], "description": "`available: false` with a `reason` when the queue store cannot be reached, rather than failing the whole read.", "x-i18n": { "tr": { "description": "Kuyruk deposuna ula\u015f\u0131lamad\u0131\u011f\u0131nda, okuman\u0131n tamam\u0131n\u0131 ba\u015far\u0131s\u0131z k\u0131lmak yerine bir `reason` ile `available: false`." }, "ar": { "description": "`available: false` \u0645\u0639 `reason` \u0639\u0646\u062f \u062a\u0639\u0630\u0651\u0631 \u0627\u0644\u0648\u0635\u0648\u0644 \u0625\u0644\u0649 \u0645\u062e\u0632\u0646 \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0627\u0646\u062a\u0638\u0627\u0631\u060c \u0628\u062f\u0644 \u0625\u0641\u0634\u0627\u0644 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0643\u0644\u0647\u0627." } }, "properties": { "available": { "type": "boolean" }, "connection": { "type": "string" }, "depth": [], "horizon": { "type": "string" }, "reason": { "type": "string" } } }, "schedule": { "type": "object", "required": [ "commands", "failure_window_days", "note" ], "description": "Failures are recorded, successes are not \u2014 a command with no failure in the window either succeeded or was not due.", "x-i18n": { "tr": { "description": "Ba\u015far\u0131s\u0131zl\u0131klar kaydedilir, ba\u015far\u0131lar kaydedilmez: pencerede ba\u015far\u0131s\u0131zl\u0131\u011f\u0131 olmayan bir komut ya ba\u015far\u0131l\u0131 olmu\u015ftur ya da \u00e7al\u0131\u015fma zaman\u0131 gelmemi\u015ftir." }, "ar": { "description": "\u062a\u064f\u0633\u062c\u064e\u0651\u0644 \u0627\u0644\u0625\u062e\u0641\u0627\u0642\u0627\u062a \u0644\u0627 \u0627\u0644\u0646\u062c\u0627\u062d\u0627\u062a: \u0641\u0627\u0644\u0623\u0645\u0631 \u0627\u0644\u0630\u064a \u0644\u0627 \u0625\u062e\u0641\u0627\u0642 \u0644\u0647 \u0641\u064a \u0627\u0644\u0646\u0627\u0641\u0630\u0629 \u0625\u0645\u0651\u0627 \u0646\u062c\u062d \u0648\u0625\u0645\u0651\u0627 \u0644\u0645 \u064a\u062d\u0646 \u0645\u0648\u0639\u062f\u0647." } }, "properties": { "commands": { "type": "array", "items": { "type": "object", "properties": { "command": { "type": "string" }, "expression": { "type": "string" }, "next_due_at": { "type": "string" }, "without_overlapping": { "type": "boolean" }, "last_failed_at": { "type": "string", "nullable": true }, "last_failure_reason": { "type": "string", "nullable": true }, "failures_in_window": { "type": "integer" } } } }, "other_failures": [], "failure_window_days": { "type": "integer" }, "note": { "type": "string" } } }, "migrations": { "type": "object", "required": [ "pending", "names" ], "properties": { "pending": { "type": "integer", "nullable": true }, "names": { "type": "array", "items": { "type": "string" } } } }, "configuration": { "type": "object", "description": "Configuration keys that changed recently; never their values.", "x-i18n": { "tr": { "description": "Son zamanlarda de\u011fi\u015fen yap\u0131land\u0131rma anahtarlar\u0131; de\u011ferleri asla." }, "ar": { "description": "\u0645\u0641\u0627\u062a\u064a\u062d \u0627\u0644\u0625\u0639\u062f\u0627\u062f \u0627\u0644\u062a\u064a \u062a\u063a\u064a\u0651\u0631\u062a \u0645\u0624\u062e\u0631\u064b\u0627\u061b \u0648\u0644\u0627 \u062a\u064f\u0639\u0637\u0649 \u0642\u064a\u0645\u0647\u0627 \u0623\u0628\u062f\u064b\u0627." } }, "properties": { "last_snapshot_at": { "type": "string", "nullable": true }, "recent_changes": { "type": "array", "items": { "type": "object", "properties": { "audit_log_id": { "type": "integer" }, "occurred_at": { "type": "string" }, "keys": { "type": "array", "items": { "type": "string" } }, "host": { "type": "string", "nullable": true } } } } } }, "checked_at": { "type": "string" } } }, "PaginationMeta": { "type": "object", "required": [ "current_page", "per_page", "total", "last_page" ], "properties": { "current_page": { "type": "integer", "example": 1 }, "per_page": { "type": "integer", "example": 25 }, "total": { "type": "integer", "example": 42 }, "last_page": { "type": "integer", "example": 2 } } }, "PaginationLinks": { "type": "object", "required": [ "first", "last", "prev", "next" ], "properties": { "first": { "type": "string", "nullable": true }, "last": { "type": "string", "nullable": true }, "prev": { "type": "string", "nullable": true }, "next": { "type": "string", "nullable": true } } } }, "parameters": { "CustomerId": { "name": "user", "in": "path", "required": true, "description": "The target customer's user id. The parameter is named `user` rather than\n`customer` on purpose: the capability gate, the assignment gate and the\naccess-log middleware all read it by that literal name, and the last of those\nfails *open* \u2014 it would stop writing the access-log row \u2014 if it were renamed.\n", "x-i18n": { "tr": { "description": "Hedef m\u00fc\u015fterinin kullan\u0131c\u0131 id'si. Parametrenin ad\u0131 bilerek `customer` de\u011fil\n`user`: yetki kap\u0131s\u0131, atama kap\u0131s\u0131 ve eri\u015fim g\u00fcnl\u00fc\u011f\u00fc ara katman\u0131 onu bu adla\nokur ve sonuncusu, ad de\u011fi\u015fseydi *a\u00e7\u0131k* kal\u0131r \u2014 eri\u015fim g\u00fcnl\u00fc\u011f\u00fc sat\u0131r\u0131n\u0131\nyazmay\u0131 b\u0131rak\u0131rd\u0131.\n" }, "ar": { "description": "\u0645\u0639\u0631\u0651\u0641 \u0627\u0644\u0645\u0633\u062a\u062e\u062f\u0645 \u0644\u0644\u0639\u0645\u064a\u0644 \u0627\u0644\u0645\u0633\u062a\u0647\u062f\u0641. \u0633\u064f\u0645\u0651\u064a \u0627\u0644\u0645\u0639\u0627\u0645\u0644 `user` \u0644\u0627 `customer` \u0639\u0645\u062f\u064b\u0627:\n\u0628\u0648\u0627\u0628\u0629 \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 \u0648\u0628\u0648\u0627\u0628\u0629 \u0627\u0644\u0625\u0633\u0646\u0627\u062f \u0648\u0648\u0633\u064a\u0637 \u0633\u062c\u0644 \u0627\u0644\u0648\u0635\u0648\u0644 \u062a\u0642\u0631\u0623\u0647 \u062c\u0645\u064a\u0639\u0647\u0627 \u0628\u0647\u0630\u0627 \u0627\u0644\u0627\u0633\u0645\n\u0627\u0644\u062d\u0631\u0641\u064a\u060c \u0648\u0627\u0644\u0623\u062e\u064a\u0631 \u0645\u0646\u0647\u0627 \u064a\u0641\u0634\u0644 *\u0645\u0641\u062a\u0648\u062d\u064b\u0627* \u2014 \u0623\u064a \u064a\u062a\u0648\u0642\u0641 \u0639\u0646 \u0643\u062a\u0627\u0628\u0629 \u0633\u0637\u0631 \u0633\u062c\u0644 \u0627\u0644\u0648\u0635\u0648\u0644 \u2014\n\u0644\u0648 \u0623\u064f\u0639\u064a\u062f\u062a \u062a\u0633\u0645\u064a\u062a\u0647.\n" } }, "schema": { "type": "integer", "minimum": 1 } }, "Page": { "name": "page", "in": "query", "required": false, "description": "1-based page number.", "x-i18n": { "tr": { "description": "1'den ba\u015flayan sayfa numaras\u0131." }, "ar": { "description": "\u0631\u0642\u0645 \u0627\u0644\u0635\u0641\u062d\u0629\u060c \u0627\u0628\u062a\u062f\u0627\u0621\u064b \u0645\u0646 1." } }, "schema": { "type": "integer", "minimum": 1, "default": 1 } }, "PerPage": { "name": "per_page", "in": "query", "required": false, "description": "Items per page. Values above 100 are clamped to 100.", "x-i18n": { "tr": { "description": "Sayfa ba\u015f\u0131na \u00f6\u011fe say\u0131s\u0131. 100'\u00fcn \u00fcst\u00fcndeki de\u011ferler 100'e indirilir." }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u0639\u0646\u0627\u0635\u0631 \u0641\u064a \u0627\u0644\u0635\u0641\u062d\u0629. \u0627\u0644\u0642\u064a\u0645 \u0627\u0644\u0623\u0639\u0644\u0649 \u0645\u0646 100 \u062a\u064f\u062e\u0641\u064e\u0651\u0636 \u0625\u0644\u0649 100." } }, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } }, "IdempotencyKey": { "name": "Idempotency-Key", "in": "header", "required": true, "description": "A caller-chosen key that makes this request safe to retry. The key is claimed\nbefore the order runs: a retry that arrives while the first request is still\nin flight gets `409` rather than a second charge, and a repeat of a request\nthat already finished replays the original response with an\n`Idempotent-Replay: true` header instead of ordering again. Keys are scoped to\nthe caller and honoured for 24 hours. Reusing one with a different body is a\n`409`.\n", "x-i18n": { "tr": { "description": "\u00c7a\u011f\u0131ran\u0131n se\u00e7ti\u011fi ve bu iste\u011fin g\u00fcvenle yinelenmesini sa\u011flayan bir anahtar.\nAnahtar sipari\u015f \u00e7al\u0131\u015fmadan \u00f6nce al\u0131n\u0131r: ilk istek h\u00e2l\u00e2 s\u00fcrerken gelen bir\nyineleme ikinci bir tahsilat yerine `409` al\u0131r; tamamlanm\u0131\u015f bir iste\u011fin\ntekrar\u0131 ise yeniden sipari\u015f vermek yerine ilk yan\u0131t\u0131 `Idempotent-Replay: true`\nba\u015fl\u0131\u011f\u0131yla yeniden oynat\u0131r. Anahtarlar \u00e7a\u011f\u0131rana \u00f6zeldir ve 24 saat ge\u00e7erlidir.\nAyn\u0131 anahtar\u0131 farkl\u0131 bir g\u00f6vdeyle yeniden kullanmak `409` d\u00f6ner.\n" }, "ar": { "description": "\u0645\u0641\u062a\u0627\u062d \u064a\u062e\u062a\u0627\u0631\u0647 \u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0648\u064a\u062c\u0639\u0644 \u062a\u0643\u0631\u0627\u0631 \u0647\u0630\u0627 \u0627\u0644\u0637\u0644\u0628 \u0622\u0645\u0646\u064b\u0627. \u064a\u064f\u062d\u062c\u0632 \u0627\u0644\u0645\u0641\u062a\u0627\u062d \u0642\u0628\u0644 \u062a\u0646\u0641\u064a\u0630\n\u0627\u0644\u0637\u0644\u0628: \u0641\u0627\u0644\u062a\u0643\u0631\u0627\u0631 \u0627\u0644\u0630\u064a \u064a\u0635\u0644 \u0648\u0627\u0644\u0637\u0644\u0628 \u0627\u0644\u0623\u0648\u0644 \u0645\u0627 \u0632\u0627\u0644 \u0642\u064a\u062f \u0627\u0644\u062a\u0646\u0641\u064a\u0630 \u064a\u062c\u064a\u0628 \u0628\u0640 `409` \u0628\u062f\u0644\n\u062a\u062d\u0635\u064a\u0644 \u062b\u0627\u0646\u064d\u060c \u0648\u062a\u0643\u0631\u0627\u0631 \u0637\u0644\u0628 \u0627\u0643\u062a\u0645\u0644 \u0628\u0627\u0644\u0641\u0639\u0644 \u064a\u0639\u064a\u062f \u0627\u0644\u0627\u0633\u062a\u062c\u0627\u0628\u0629 \u0627\u0644\u0623\u0635\u0644\u064a\u0629 \u0645\u0639 \u0627\u0644\u062a\u0631\u0648\u064a\u0633\u0629\n`Idempotent-Replay: true` \u0628\u062f\u0644 \u0627\u0644\u0637\u0644\u0628 \u0645\u0646 \u062c\u062f\u064a\u062f. \u0627\u0644\u0645\u0641\u0627\u062a\u064a\u062d \u062e\u0627\u0635\u0629 \u0628\u0627\u0644\u0645\u0633\u062a\u062f\u0639\u064a \u0648\u062a\u064f\u062d\u062a\u0631\u0645\n\u0644\u0645\u062f\u0629 24 \u0633\u0627\u0639\u0629. \u0648\u0625\u0639\u0627\u062f\u0629 \u0627\u0633\u062a\u062e\u062f\u0627\u0645 \u0645\u0641\u062a\u0627\u062d \u0645\u0639 \u062c\u0633\u0645 \u0645\u062e\u062a\u0644\u0641 \u062a\u062c\u064a\u0628 \u0628\u0640 `409`.\n" } }, "schema": { "type": "string", "example": "5c5f0f4e-4c6f-4d0e-9a1e-1f1b1c1d1e1f" } }, "Refresh": { "name": "refresh", "in": "query", "required": false, "description": "Reconcile against the upstream provider before responding, instead of reading\nthe local database. Subject to a much tighter rate limit; do not use it for\npolling.\n", "x-i18n": { "tr": { "description": "Yerel veritaban\u0131n\u0131 okumak yerine yan\u0131t vermeden \u00f6nce sa\u011flay\u0131c\u0131yla e\u015fitle.\n\u00c7ok daha dar bir istek s\u0131n\u0131r\u0131na tabidir; d\u00fczenli yoklama i\u00e7in kullanmay\u0131n.\n" }, "ar": { "description": "\u0627\u0644\u0645\u0637\u0627\u0628\u0642\u0629 \u0645\u0639 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0642\u0628\u0644 \u0627\u0644\u0625\u062c\u0627\u0628\u0629 \u0628\u062f\u0644 \u0627\u0644\u0642\u0631\u0627\u0621\u0629 \u0645\u0646 \u0642\u0627\u0639\u062f\u0629 \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u0627\u0644\u0645\u062d\u0644\u064a\u0629.\n\u064a\u062e\u0636\u0639 \u0644\u062d\u062f\u0651 \u0645\u0639\u062f\u0651\u0644 \u0623\u0636\u064a\u0642 \u0628\u0643\u062b\u064a\u0631\u061b \u0644\u0627 \u062a\u0633\u062a\u062e\u062f\u0645\u0647 \u0644\u0644\u0627\u0633\u062a\u0637\u0644\u0627\u0639 \u0627\u0644\u062f\u0648\u0631\u064a.\n" } }, "schema": { "type": "boolean", "default": false } } }, "responses": { "Unauthorized": { "description": "No token was presented, or it is invalid or expired.", "x-i18n": { "tr": { "description": "Hi\u00e7bir anahtar sunulmad\u0131 ya da sunulan anahtar ge\u00e7ersiz veya s\u00fcresi dolmu\u015f." }, "ar": { "description": "\u0644\u0645 \u064a\u064f\u0642\u062f\u064e\u0651\u0645 \u0623\u064a \u0631\u0645\u0632 \u0645\u0645\u064a\u0632\u060c \u0623\u0648 \u0623\u0646 \u0627\u0644\u0631\u0645\u0632 \u0627\u0644\u0645\u0645\u064a\u0632 \u063a\u064a\u0631 \u0635\u0627\u0644\u062d \u0623\u0648 \u0645\u0646\u062a\u0647\u064a \u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "Forbidden": { "description": "Authenticated, but not permitted \u2014 the token lacks the required ability, a policy\ndenied the action, the email address is unverified, or a support capability is\ninsufficient.\n", "x-i18n": { "tr": { "description": "Kimlik do\u011fruland\u0131, ancak i\u015fleme izin verilmiyor \u2014 anahtarda gereken izin\nyok, bir politika i\u015flemi reddetti, e-posta adresi do\u011frulanmam\u0131\u015f ya da destek\nyetkisi yetersiz.\n" }, "ar": { "description": "\u062a\u0645 \u0627\u0644\u062a\u062d\u0642\u0642 \u0645\u0646 \u0627\u0644\u0647\u0648\u064a\u0629\u060c \u0644\u0643\u0646 \u0627\u0644\u0639\u0645\u0644\u064a\u0629 \u063a\u064a\u0631 \u0645\u0633\u0645\u0648\u062d \u0628\u0647\u0627 \u2014 \u0625\u0645\u0651\u0627 \u0623\u0646 \u0627\u0644\u0631\u0645\u0632 \u0627\u0644\u0645\u0645\u064a\u0632 \u064a\u0641\u062a\u0642\u0631 \u0625\u0644\u0649\n\u0627\u0644\u0635\u0644\u0627\u062d\u064a\u0629 \u0627\u0644\u0645\u0637\u0644\u0648\u0628\u0629\u060c \u0623\u0648 \u0623\u0646 \u0633\u064a\u0627\u0633\u0629\u064b \u0631\u0641\u0636\u062a \u0627\u0644\u0625\u062c\u0631\u0627\u0621\u060c \u0623\u0648 \u0623\u0646 \u0627\u0644\u0628\u0631\u064a\u062f \u0627\u0644\u0625\u0644\u0643\u062a\u0631\u0648\u0646\u064a \u063a\u064a\u0631\n\u0645\u0648\u062b\u064e\u0651\u0642\u060c \u0623\u0648 \u0623\u0646 \u0635\u0644\u0627\u062d\u064a\u0629 \u0627\u0644\u062f\u0639\u0645 \u063a\u064a\u0631 \u0643\u0627\u0641\u064a\u0629.\n" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "NotFound": { "description": "No such resource, or it belongs to another customer. The two cases are deliberately\nindistinguishable.\n", "x-i18n": { "tr": { "description": "B\u00f6yle bir kaynak yok ya da ba\u015fka bir m\u00fc\u015fteriye ait. \u0130ki durum bilin\u00e7li olarak\nbirbirinden ay\u0131rt edilemez.\n" }, "ar": { "description": "\u0644\u0627 \u0648\u062c\u0648\u062f \u0644\u0647\u0630\u0627 \u0627\u0644\u0645\u0648\u0631\u062f\u060c \u0623\u0648 \u0623\u0646\u0647 \u064a\u062e\u0635\u0651 \u0639\u0645\u064a\u0644\u064b\u0627 \u0622\u062e\u0631. \u0627\u0644\u062d\u0627\u0644\u062a\u0627\u0646 \u063a\u064a\u0631 \u0642\u0627\u0628\u0644\u062a\u064a\u0646 \u0644\u0644\u062a\u0645\u064a\u064a\u0632\n\u0639\u0645\u062f\u064b\u0627.\n" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "Conflict": { "description": "The addressed resource has drifted from the upstream provider in a way this\nrequest cannot resolve. Refresh and retry.\n", "x-i18n": { "tr": { "description": "Adreslenen kaynak, sa\u011flay\u0131c\u0131daki kar\u015f\u0131l\u0131\u011f\u0131ndan bu iste\u011fin \u00e7\u00f6zemeyece\u011fi bir\nbi\u00e7imde ayr\u0131\u015fm\u0131\u015f. Yenileyin ve yeniden deneyin.\n" }, "ar": { "description": "\u062a\u0628\u0627\u0639\u062f \u0627\u0644\u0645\u0648\u0631\u062f \u0627\u0644\u0645\u0642\u0635\u0648\u062f \u0639\u0646 \u062d\u0627\u0644\u062a\u0647 \u0644\u062f\u0649 \u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0628\u0635\u0648\u0631\u0629 \u0644\u0627 \u064a\u0633\u062a\u0637\u064a\u0639 \u0647\u0630\u0627 \u0627\u0644\u0637\u0644\u0628\n\u0645\u0639\u0627\u0644\u062c\u062a\u0647\u0627. \u062d\u062f\u0650\u0651\u062b \u0627\u0644\u0628\u064a\u0627\u0646\u0627\u062a \u062b\u0645 \u0623\u0639\u062f \u0627\u0644\u0645\u062d\u0627\u0648\u0644\u0629.\n" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "ValidationFailed": { "description": "The request body or query string failed validation.", "x-i18n": { "tr": { "description": "\u0130stek g\u00f6vdesi ya da sorgu dizesi do\u011frulamadan ge\u00e7emedi." }, "ar": { "description": "\u0644\u0645 \u064a\u062c\u062a\u0632 \u062c\u0633\u0645 \u0627\u0644\u0637\u0644\u0628 \u0623\u0648 \u0633\u0644\u0633\u0644\u0629 \u0627\u0644\u0627\u0633\u062a\u0639\u0644\u0627\u0645 \u0627\u0644\u062a\u062d\u0642\u0642 \u0645\u0646 \u0627\u0644\u0635\u062d\u0629." } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "RateLimited": { "description": "Too many requests. Retry after the interval given in `Retry-After`.", "x-i18n": { "tr": { "description": "\u00c7ok fazla istek g\u00f6nderildi. `Retry-After` ba\u015fl\u0131\u011f\u0131nda verilen s\u00fcre kadar bekleyip yeniden deneyin." }, "ar": { "description": "\u0637\u0644\u0628\u0627\u062a \u0643\u062b\u064a\u0631\u0629 \u062c\u062f\u064b\u0627. \u0623\u0639\u062f \u0627\u0644\u0645\u062d\u0627\u0648\u0644\u0629 \u0628\u0639\u062f \u0627\u0644\u0645\u062f\u0629 \u0627\u0644\u0645\u0630\u0643\u0648\u0631\u0629 \u0641\u064a `Retry-After`." } }, "headers": { "Retry-After": { "description": "Seconds to wait before retrying.", "x-i18n": { "tr": { "description": "Yeniden denemeden \u00f6nce beklenecek saniye say\u0131s\u0131." }, "ar": { "description": "\u0639\u062f\u062f \u0627\u0644\u062b\u0648\u0627\u0646\u064a \u0627\u0644\u062a\u064a \u064a\u062c\u0628 \u0627\u0646\u062a\u0638\u0627\u0631\u0647\u0627 \u0642\u0628\u0644 \u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u0645\u062d\u0627\u0648\u0644\u0629." } }, "schema": { "type": "integer" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "UpstreamFailure": { "description": "The cloud's underlying IaaS control plane failed to carry out the request. The\ndetail is a fixed, non-specific string in production \u2014 the provider's own error\ntext routinely names internal hosts, pods and hypervisors. Treat this as\nretryable rather than as a client error.\n", "x-i18n": { "tr": { "description": "Bulutun temelindeki IaaS denetim d\u00fczlemi iste\u011fi yerine getiremedi. \u00dcretim\nortam\u0131nda ayr\u0131nt\u0131 alan\u0131 sabit ve belirsiz bir metindir \u2014 sa\u011flay\u0131c\u0131n\u0131n kendi\nhata metni s\u0131kl\u0131kla i\u00e7 sunucular\u0131, pod'lar\u0131 ve hiperviz\u00f6rleri ad\u0131yla anar.\nBunu bir istemci hatas\u0131 olarak de\u011fil, yeniden denenebilir bir durum olarak\nde\u011ferlendirin.\n" }, "ar": { "description": "\u0623\u062e\u0641\u0642 \u0645\u0633\u062a\u0648\u0649 \u0627\u0644\u062a\u062d\u0643\u0651\u0645 \u0641\u064a \u0627\u0644\u0628\u0646\u064a\u0629 \u0627\u0644\u062a\u062d\u062a\u064a\u0629 \u0627\u0644\u0630\u064a \u062a\u0642\u0648\u0645 \u0639\u0644\u064a\u0647 \u0627\u0644\u0633\u062d\u0627\u0628\u0629 \u0641\u064a \u062a\u0646\u0641\u064a\u0630 \u0627\u0644\u0637\u0644\u0628.\n\u0641\u064a \u0628\u064a\u0626\u0629 \u0627\u0644\u0625\u0646\u062a\u0627\u062c \u064a\u0643\u0648\u0646 \u062d\u0642\u0644 \u0627\u0644\u062a\u0641\u0635\u064a\u0644 \u0646\u0635\u064b\u0627 \u062b\u0627\u0628\u062a\u064b\u0627 \u0648\u063a\u064a\u0631 \u0645\u062d\u062f\u064e\u0651\u062f \u2014 \u0625\u0630 \u0625\u0646 \u0646\u0635\u0648\u0635 \u0623\u062e\u0637\u0627\u0621\n\u0627\u0644\u0645\u0632\u0648\u0651\u062f \u0646\u0641\u0633\u0647\u0627 \u0643\u062b\u064a\u0631\u064b\u0627 \u0645\u0627 \u062a\u0630\u0643\u0631 \u0645\u0636\u064a\u0641\u0627\u062a \u062f\u0627\u062e\u0644\u064a\u0629 \u0648\u0648\u062d\u062f\u0627\u062a pod\n\u0648\u0645\u0634\u0631\u0641\u0627\u062a \u0623\u0646\u0638\u0645\u0629 \u0627\u0641\u062a\u0631\u0627\u0636\u064a\u0629. \u0639\u0627\u0645\u0650\u0644 \u0647\u0630\u0647 \u0627\u0644\u062d\u0627\u0644\u0629 \u0639\u0644\u0649 \u0623\u0646\u0647\u0627 \u0642\u0627\u0628\u0644\u0629 \u0644\u0625\u0639\u0627\u062f\u0629 \u0627\u0644\u0645\u062d\u0627\u0648\u0644\u0629 \u0644\u0627\n\u0639\u0644\u0649 \u0623\u0646\u0647\u0627 \u062e\u0637\u0623 \u0645\u0646 \u0627\u0644\u0639\u0645\u064a\u0644.\n" } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }