Spaceship MCP Connector — referenční příručka nástrojů

Aktualizováno 6. 11. 2026

Doba čtení 115 min

Spaceship MCP Connector propojuje vašeho AI asistenta (například Claude) s vaším účtem Spaceship. Díky tomu může asistent kontrolovat dostupnost a ceny domén, předávat vám odkazy na nákup domén na platební stránce Spaceship, spravovat kontakty domén a nameservery, číst nebo upravovat DNS záznamy a vaším jménem nakupovat a prodávat domény na tržišti Spaceship — stačí se zeptat běžným jazykem a asistent zavolá správné nástroje.

Asistent nikdy neúčtuje nic z vašeho účtu. Nákup domény vždy probíhá přes domain_purchase_link: otevřete odkaz, pak si vše sami zkontrolujete a zaplatíte na platební stránce Spaceship.

Začínáme

Potřebujete účet Spaceship. Spaceship MCP Connector je k dispozici na adrese https://connector-mcp.spaceship.com/mcp.

Claude (web a desktop) — otevřete Settings, zvolte Connectors, najděte Spaceship v adresáři konektorů a přidejte jej. Claude od Anthropic je v současnosti klient, u kterého jsme ověřili, že Spaceship MCP Connector funguje.
Další MCP klienti — přidejte vzdálený MCP server a namiřte jej na https://connector-mcp.spaceship.com/mcp. Další klienti mohou fungovat, ale zatím jsme je neověřili.

Když se připojíte, budete vyzváni k přihlášení do Spaceship a udělení přístupu asistenta k vašemu účtu. To, které nástroje může asistent používat, závisí na přístupu, který schválíte — pokud nástroj není dostupný, protože přístup nebyl udělen, podívejte se na Přístup, který udělujete, pak se znovu připojte a schvalte přístup, který potřebuje.

Podmínky a soukromí

Smlouvy a zásady, které se vztahují na Spaceship MCP Connector a na vše, co si jeho prostřednictvím koupíte:

Přehled nástrojů

Nástroj: contacts_save
Co dělá: Uloží kontaktní údaje a získá ID kontaktu
Přístup: Zápis
Nástroj: contacts_get
Co dělá: Načte uložený kontakt podle jeho ID
Přístup: Čtení
Nástroj: contacts_list
Co dělá: Vypíše všechny uložené kontakty, abyste našli a znovu použili jeden z nich
Přístup: Čtení
Nástroj: domains_list
Co dělá: Vypíše vaše domény nebo vyhledá jednu doménu
Přístup: Čtení
Nástroj: domains_check_availability
Co dělá: Kontroluje, zda jsou domény dostupné k registraci, a jejich cenu
Přístup: Čtení
Nástroj: domain_purchase_link
Co dělá: Získá platební odkazy pro nákup domén na platební stránce Spaceship — samotným voláním se nic neúčtuje
Přístup: Zápis
Nástroj: domain_set_contacts
Co dělá: Přiřazuje kontakty k doméně, kterou vlastníte
Přístup: Citlivý zápis
Nástroj: domain_set_nameservers
Co dělá: Přepíná doménu na základní nebo vlastní nameservery
Přístup: Citlivý zápis
Nástroj: dns_records_get
Co dělá: Čte DNS záznamy pro doménu
Přístup: Čtení
Nástroj: dns_records_save
Co dělá: Přidává DNS záznamy nebo aktualizuje jejich TTL
Přístup: Zápis
Nástroj: dns_records_delete
Co dělá: Maže DNS záznamy
Přístup: Citlivý zápis
Nástroj: async_operation_get
Co dělá: Kontroluje stav dlouhotrvající operace
Přístup: Čtení
Nástroj: marketplace_listings_list
Co dělá: Vypíše domény, které jste nabídli k prodeji, s filtry
Přístup: Čtení
Nástroj: marketplace_listing_get
Co dělá: Přečte jednu nabídku v plném rozsahu, včetně jejích odkazů Add to Cart
Přístup: Čtení
Nástroj: marketplace_listing_create
Co dělá: Nabídne doménu k prodeji na tržišti Spaceship
Přístup: Citlivý zápis
Nástroj: marketplace_listing_update
Co dělá: Změní ceny nabídky, popis, nastavení stránky nebo Lease-to-Own
Přístup: Citlivý zápis
Nástroj: marketplace_listing_delete
Co dělá: Stáhne doménu z prodeje — nelze vrátit zpět
Přístup: Citlivý zápis
Nástroj: marketplace_listing_verify
Co dělá: Spustí kontrolu vlastnictví pro jednu nabídku čekající na ověření
Přístup: Zápis
Nástroj: marketplace_listings_bulk_verify
Co dělá: Spustí kontroly vlastnictví pro každou nabídku čekající na ověření
Přístup: Zápis
Nástroj: marketplace_seller_settings_get
Co dělá: Načte stránku portfolia, Quality Offer, maskované výplatní metody a záznamy ověření
Přístup: Čtení
Nástroj: marketplace_seller_settings_update
Co dělá: Změní stránku portfolia a/nebo nastavení Quality Offer pro celý účet
Přístup: Citlivý zápis
Nástroj: marketplace_insights_get
Co dělá: Údaje o portfoliu, vyjednávání, prodejích, návštěvnosti a příjmech plus top domény
Přístup: Čtení
Nástroj: marketplace_sales_list
Co dělá: Vypíše domény, které prodejce prodal, včetně ceny a výplaty
Přístup: Čtení
Nástroj: marketplace_checkout_links_list
Co dělá: Vypíše checkout odkazy prodejce se stavem, cenou a rozdělením poplatků
Přístup: Čtení
Nástroj: marketplace_checkout_link_create
Co dělá: Vytvoří sdílitelný 7denní checkout odkaz „koupit nyní“ pro uvedenou doménu
Přístup: Citlivý zápis
Nástroj: marketplace_checkout_link_deactivate
Co dělá: Po potvrzení trvale deaktivuje aktivní checkout odkaz
Přístup: Citlivý zápis
Nástroj: marketplace_negotiations_list
Co dělá: Vypíše vaše jednání jako prodávajícího nebo kupujícího, filtrovaná podle stavu nebo domény
Přístup: Čtení
Nástroj: marketplace_negotiation_get
Co dělá: Přečte jedno jednání s jeho nabídkami a nejnovějšími zprávami
Přístup: Čtení
Nástroj: marketplace_negotiation_message_send
Co dělá: Odešle textovou zprávu druhé straně jednání
Přístup: Citlivý zápis
Nástroj: marketplace_offer_make
Co dělá: Vytvoří nabídku jako kupující na doménu nabízenou k prodeji
Přístup: Citlivý zápis
Nástroj: marketplace_offer_counter
Co dělá: Odpoví na nabídku druhé strany částkou nebo podmínkami Lease-to-Own
Přístup: Citlivý zápis
Nástroj: marketplace_offer_accept
Co dělá: Přijme nejnovější nabídku druhé strany — závazná dohoda
Přístup: Citlivý zápis
Nástroj: marketplace_offer_decline
Co dělá: Odmítne jako prodávající nejnovější nabídku kupujícího
Přístup: Citlivý zápis
Nástroj: marketplace_offer_withdraw
Co dělá: Stáhne jako prodávající vaši vlastní čekající protinabídku
Přístup: Citlivý zápis
Nástroj: marketplace_negotiation_suspend
Co dělá: Zruší (pozastaví) jako prodávající celé vyjednávání u vaší nabídky po potvrzení
Přístup: Citlivý zápis
Nástroj: marketplace_negotiation_restore
Co dělá: Obnoví jako prodávající pozastavené vyjednávání
Přístup: Zápis
Nástroj: marketplace_safepay_deals_list
Co dělá: Vypíše vaše obchody SafePay jako prodávající, kupující nebo obojí, filtrované podle stavu nebo domény
Přístup: Čtení
Nástroj: marketplace_safepay_deal_get
Co dělá: Načte jeden obchod SafePay: podmínky, kdo co platí, váš další krok a váš odkaz
Přístup: Čtení
Nástroj: marketplace_safepay_deal_create
Co dělá: Otevře dohodu SafePay pro doménu jako prodávající nebo kupující
Přístup: Citlivý zápis
Nástroj: marketplace_safepay_deal_confirm
Co dělá: Potvrdí podmínky dohody SafePay, kterou otevřela druhá strana, po kroku potvrzení
Přístup: Citlivý zápis
Nástroj: marketplace_leases_list
Co dělá: Vypíše smlouvy lease-to-own, které si pronajímáte nebo pronajímáte dál
Přístup: Čtení
Nástroj: marketplace_lease_get
Co dělá: Načte jednu smlouvu lease-to-own: stav, zaplaceno, zbývá a další platbu
Přístup: Čtení
Nástroj: marketplace_lease_cancel
Co dělá: Zruší smlouvu o pronájmu s následným odkupem jako kupující po kroku potvrzení
Přístup: Citlivý zápis
Nástroj: marketplace_listings_search
Co dělá: Vyhledává domény, které ostatní lidé nabízejí k prodeji, podle jednoho povinného klíčového slova, zúžené podle TLD, ceny, délky a možnosti
Přístup: Čtení
Nástroj: marketplace_purchase_link
Co dělá: Získá odkaz k platbě na Spaceship za doménu z marketplace, dohodu nebo obchod SafePay — samotné volání nic neúčtuje
Přístup: Zápis
Nástroj: marketplace_listings_import
Co dělá: Uvede až 5000 domén k prodeji v jedné operaci, která běží po volání
Přístup: Citlivý zápis
Nástroj: marketplace_listings_bulk_update
Co dělá: Změní ceny, nastavení stránky nebo lease-to-own u mnoha nabídek v jedné operaci
Přístup: Citlivý zápis
Nástroj: marketplace_negotiations_bulk_cancel
Co dělá: Po potvrzení zruší mnoho jednání u vašich nabídek v jedné operaci
Přístup: Citlivý zápis
Nástroj: marketplace_listings_export
Co dělá: Exportuje všechny nabídky do souboru CSV, připraveného po volání
Přístup: Čtení
Nástroj: marketplace_sales_export
Co dělá: Exportuje domény prodané mezi dvěma daty do souboru CSV, připraveného po volání
Přístup: Čtení

Přístup:Čtení pouze načítá informace. Zápis mění data způsobem, který můžete snadno vrátit zpět. Citlivý zápis má účinek, který nelze jednoduše vzít zpět (utrácí peníze, nelze vrátit, okamžitě mění fungování vaší domény, zasahuje jinou osobu nebo nastavuje cenu, za kterou mohou ostatní nakoupit); váš asistent by vás měl požádat o potvrzení každého volání.

Žádný z těchto nástrojů neúčtuje vašemu účtu poplatky. Pro nákup domény vrací domain_purchase_link odkazy, které sami otevřete a zaplatíte, a domains_list následně potvrdí výsledek.

Přístup, který udělujete

Když se přihlásíte, Spaceship zobrazí obrazovku souhlasu, která se ptá, jaký přístup má asistent dostat. Přístup pro čtení je vždy zahrnut; přístup pro zápis je samostatná volba. Přístup, se kterým souhlasíte, určuje, které nástroje může asistent používat:

Povolujete: Čtení
Asistent může používat: Nástroje označené výše jako Čtení: contacts_get, contacts_list, domains_list, domains_check_availability, dns_records_get, async_operation_get, marketplace_listings_list, marketplace_listing_get, marketplace_listings_search, marketplace_seller_settings_get, marketplace_insights_get, marketplace_sales_list, marketplace_checkout_links_list, marketplace_negotiations_list, marketplace_negotiation_get, marketplace_safepay_deals_list, marketplace_safepay_deal_get, marketplace_leases_list, marketplace_lease_get, marketplace_listings_export a marketplace_sales_export.
Povolujete: Čtení a zápis
Asistent může používat: Každý nástroj v tabulce výše.

Přístup pro zápis sám o sobě funguje jako čtení i zápis.
Nástroj, který jste nepovolili, se asistentovi nezobrazuje a volání na něj je zodpovězeno, jako by nástroj neexistoval: chyba JSON-RPC -32602 se zprávou Tool <name> not found. Odpověď nikdy neříká proč.
Pouze s přístupem pro čtení je asistent informován, že připojení může pouze číst data účtu, a že vás má požádat o opětovné připojení a povolení operací zápisu, když požádáte o něco, co nemůže udělat. Pokud vámi udělený přístup nenechá k dispozici žádný nástroj, je místo toho informován, že připojení nemá přístup k datům účtu, a že vás má požádat o opětovné připojení a povolení přístupu. Ani jeden text se neposílá, když je povolen přístup pro zápis.
Připojení, které bylo schváleno předtím, než tato volba existovala, nebo které požádalo pouze o základní přístup Spaceship, si zachovává přístup ke každému nástroji. Změna vaší volby se projeví, až se asistent příště přihlásí nebo obnoví svůj token.
Připojení bez použitelného přístupu Spaceship nevidí žádné nástroje.

Kontakty: odkazované pomocí ID

Každý nástroj, který potřebuje kontakt, přijímá pro každou roli řetězec contactId string, nikdy ne vložené kontaktní údaje. Těmito nástroji jsou domain_purchase_link, domain_set_contacts a marketplace_purchase_link.

Nejprve uložte kontakt pomocí contacts_save, které vrátí jeho ID, a pak toto ID předejte tam, kde je kontakt přijímán. Neexistuje žádné automatické inline uložení; role nemůže přijmout celý objekt kontaktu. Můžete také znovu použít ID z výsledku contacts_list nebo domains_list.

Hodnota contactId je řetězec o 27–32 alfanumerických znacích. Stačí ji předat zpět tam, kde je kontakt přijímán.

Běžné pracovní postupy

Několik nástrojů je navrženo tak, aby se používaly společně: výstup jednoho se stává vstupem dalšího.

Kupujte domény přes platební odkaz

domains_check_availability — zkontrolujte požadovaný název nebo názvy. Pokračujte pouze tehdy, když je resultavailable. Každý dostupný název obsahuje cenu registrace v USD price (stejně pro standardní i prémiové), nebo priceUnavailableReason, když ji nelze určit, plus minRegisterPeriodInYears a maxRegisterPeriodInYears — období, která TLD povoluje. Všimněte si, že price pokrývá price.pricedYears let, což je nejkratší období povolené TLD a není vždy 1.
domain_purchase_link — jakmile souhlasíte, předejte domény jako items a kontakty, které se na ně mají použít, jako contacts — ID kontaktů z contacts_list, nebo nejprve uložte nové údaje pomocí contacts_save — se sdílenými hodnotami years a autoRenew na nejvyšší úrovni a s přepisy pro jednotlivé domény tam, kde se liší. Toto volání nic neúčtuje. Vrací jeden odkaz pro každou skupinu až 10 domén s odhadovanou cenou pro každou z nich; každý odkaz otevřete a zaplatíte na platební stránce Spaceship, kde zvolíte platební metodu (prostředky na účtu jsou předvybrány, pokud je máte). Ochranu soukromí WHOIS tímto způsobem nastavit nelze.
domains_list — po zaplacení jej zavolejte pro danou doménu, abyste potvrdili, že je zaregistrována. Nepovažujte odkaz za důkaz nákupu a asistent by předtím neměl z konverzace tvrdit, že byla doména zaregistrována.

Nežádejte o druhý odkaz pro nákup, který už možná proběhl. Pokud jste už za doménu možná zaplatili — použili jste dřívější odkaz nebo ji koupili jiným způsobem — nejprve zavolejte domains_list a o nový odkaz žádejte jen pro domény, které skutečně nejsou zaregistrované. Odkazy nevyprší a lze je znovu použít, proto je nesdílejte s nikým dalším.

Aktualizujte kontakty u domény, kterou vlastníte

domain_set_contacts — přiřaďte kontakty k doméně pomocí contactId (v případě potřeby je nejprve uložte pomocí contacts_save). To se dokončí okamžitě a vrátí verificationStatus: verification znamená, že držitel registrace musí potvrdit svou e-mailovou adresu, než se změna plně projeví (je mu odeslán e-mail), success znamená, že je již potvrzena, a null znamená, že pro tuto doménu není potvrzení vyžadováno.

Změňte nameservery domény

domains_list — najděte doménu a zobrazte její aktuální nameservers ({ provider, hosts }).
domain_set_nameservers — přepněte ji na výchozí nameservery Spaceship pomocí provider: "basic" (bez hosts), nebo ji namiřte na vlastní pomocí provider: "custom" a seznamu 2–12 hodnot hosts. Vrací výsledné { provider, hosts } a následné domains_list změnu odráží. Opětovné použití stavu, ve kterém už doména je, není chyba: nic se nezapíše a odpověď nese poznámku „Již nastaveno; nic se nezměnilo.“.

Spravujte DNS záznamy

domains_list — najděte doménu, kterou chcete spravovat (nebo předejte její název přímo, pokud jej znáte).
dns_records_get — načtěte aktuální záznamy pro doménu.
dns_records_save nebo dns_records_delete — přidejte, aktualizujte nebo odeberte záznamy. Záznamy vrácené nástrojem dns_records_get mají stejný tvar, jaký přijímají nástroje pro uložení a odstranění (odstranění pouze vynechává ttl), takže asistent může číst, upravit a znovu zapsat. Porovnávání nerozlišuje velikost písmen kromě TXT záznamů, které velikost písmen rozlišují.

Zkontrolujte své portfolio

domains_list — procházejte všechny své domény po stránkách s řazením nebo načtěte jednu doménu podle názvu. Každá doména obsahuje datum vypršení platnosti, nastavení automatického obnovení, stav, nameservery, ochranu soukromí a přiřazená ID kontaktů.
contacts_list — procházejte po stránkách všechny kontakty uložené ve vašem účtu, abyste našli a znovu použili existující kontakt (podle jeho ID kontaktu) místo vytváření duplicitního.
contacts_get — vyhledejte údaje za jakýmkoli ID kontaktu, které vidíte u domény nebo ve výsledku contacts_list.

Prodávejte domény na marketplace

marketplace_listing_create — nabídněte doménu k prodeji s cenou Buy Now, minimální nabídkou nebo obojím. Nový listing je ve stavu verifying, zatímco se ověřuje jeho vlastnictví. Doména registrovaná u Spaceship jde obvykle do prodeje během přibližně minuty; u domény registrované jinde zveřejněte DNS záznamy zobrazené nástrojem marketplace_seller_settings_get a poté spusťte kontrolu pomocí marketplace_listing_verify (nebo marketplace_listings_bulk_verify pro všechny).
marketplace_listings_list / marketplace_listing_get — zkontrolujte své listingy; jeden změňte pomocí marketplace_listing_update nebo více najednou pomocí marketplace_listings_bulk_update.
marketplace_negotiations_list / marketplace_negotiation_get — sledujte nabídky kupujících a poté odpovězte pomocí marketplace_offer_counter, marketplace_offer_accept (vždy nejprve potvrzené s vámi) nebo marketplace_offer_decline a komunikujte s kupujícím pomocí marketplace_negotiation_message_send.
marketplace_sales_list a marketplace_insights_get — podívejte se, co se prodalo a jak si portfolio vede.
marketplace_listings_export / marketplace_sales_export — stáhněte si své listingy nebo to, co se prodalo mezi dvěma daty, jako CSV soubor.

Kupte doménu na marketplace

marketplace_listings_search — najděte domény, které jiní prodejci nabízejí, podle jednoho klíčového slova, zúžené podle koncovky, ceny, délky a možnosti nákupu.
marketplace_offer_make — vytvořte nabídku; prodejce je upozorněn a otevře se vyjednávání. Poté jej sledujte pomocí marketplace_negotiation_get.
marketplace_safepay_deal_create — nebo otevřete pro doménu SafePay deal; druhá strana potvrdí podmínky a kupující zaplatí přes odkaz na deal. Voláním se nic neúčtuje.
marketplace_purchase_link — zaplaťte za ni: doménu Buy Now, dohodu, které jste dosáhli, nebo SafePay deal čekající na vaši platbu. Pro doménu nebo dohodu předejte jeden ze svých uložených kontaktů (contacts_list) jako contactId; stane se kontaktem domény. Volání vrátí odkaz, který otevřete a zaplatíte na Spaceship; voláním se nic neúčtuje.

Referenční příručka nástrojů

Každý nástroj vrací svůj výsledek jako strukturovaný JSON. Hromadné operace marketplace běží po volání a vracejí odkaz na operaci pro dotazování pomocí async_operation_get; každý jiný nástroj se dokončí okamžitě.

Kontakty

Kontakty jsou osoby nebo organizace připojené k registraci domény (držitel registrace, admin, tech, billing). Na kontakt se všude odkazuje pomocí jeho ID kontaktu — neprůhledného řetězce.

`contacts_save` — Uložit kontakt

Přístup: Zápis.

Uloží kontaktní údaje a vrátí vygenerované ID kontaktu. Validace některých polí (například stateProvince a postalCode) závisí na zvolené zemi.

Pokud volání selže s infrastructure.serviceUnavailable, kontakt mohl být přesto uložen: před dalším ukládáním jej vyhledejte pomocí contacts_list (viz Opakování zápisů).

Parametr: firstName
Povinné: Ano
Typ a omezení: Řetězec, 1–64 znaků. Může obsahovat spojovníky a apostrofy.
Parametr: lastName
Povinné: Ano
Typ a omezení: Řetězec, 1–64 znaků. Může obsahovat spojovníky a apostrofy.
Parametr: email
Povinné: Ano
Typ a omezení: Platná e-mailová adresa, max. 254 znaků.
Parametr: address1
Povinné: Ano
Typ a omezení: Řádek adresy 1. Řetězec, 1–128 znaků.
Parametr: city
Povinné: Ano
Typ a omezení: Řetězec, 1–64 znaků.
Parametr: country
Povinné: Ano
Typ a omezení: Dvou písmenný kód země (ISO 3166-1 alpha-2), např. US.
Parametr: phone
Povinné: Ano
Typ a omezení: Mezinárodní formát +CountryCode.Number, např. +1.2025551234. Max. 32 znaků.
Parametr: organization
Povinné: Ne
Typ a omezení: Název organizace/společnosti. 1–128 znaků.
Parametr: address2
Povinné: Ne
Typ a omezení: Řádek adresy 2. 1–128 znaků.
Parametr: stateProvince
Povinné: Ne
Typ a omezení: Název státu/provincie, 1–64 znaků. Může být povinný v závislosti na zemi.
Parametr: postalCode
Povinné: Ne
Typ a omezení: 1–16 znaků. Může být povinné v závislosti na zemi.
Parametr: phoneExt
Povinné: Ne
Typ a omezení: Telefonní linka, 1–16 znaků.
Parametr: fax
Povinné: Ne
Typ a omezení: Faxové číslo, stejný formát +CountryCode.Number, max. 32 znaků.
Parametr: faxExt
Povinné: Ne
Typ a omezení: Faxová linka, 1–16 znaků.
Parametr: taxNumber
Povinné: Ne
Typ a omezení: Daňové číslo, 1–32 znaků.

Vrací

{ "contactId": "..." }

contactId (27–32 alfanumerických znaků) je to, co předáváte do domain_purchase_link, domain_set_contacts a contacts_get.

`contacts_get` — Získat kontakt

Přístup: Čtení.

Načte podrobnosti uloženého kontaktu podle jeho ID kontaktu. ID kontaktů pocházejí z contacts_save, contacts_list nebo z pole contacts ve výsledcích domains_list.

Parametr: contactId
Povinné: Ano
Typ a omezení: ID kontaktu, 27–32 alfanumerických znaků.

Vrací — { contact } s:

Pole: firstName, lastName, email, address1, city, country, phone, postalCode
Typ: Řetězec
Pole: organization, address2, stateProvince, phoneExt, fax, faxExt, taxNumber
Typ: Řetězec nebo null

`contacts_list` — Seznam kontaktů

Přístup: Čtení.

Vypíše všechny kontakty uložené pod vaším účtem, takže můžete najít a znovu použít existující kontakt (podle jeho ID kontaktu) místo vytváření duplikátu nebo procházení svých domén. Seznam je stránkovaný a řaditelný, konzistentní s domains_list.

Parametr: take
Povinné: Ne
Typ a omezení: Položek na stránku, 1–100. Výchozí hodnota 10.
Parametr: skip
Povinné: Ne
Typ a omezení: Položky k přeskočení, 0 nebo více. Výchozí hodnota 0.
Parametr: orderBy
Povinné: Ne
Typ a omezení: Až 8 klíčů řazení: name, email, organization; pro sestupné řazení přidejte předponu - (např. -name).

Vrací — { items, total } kde total je počet jedinečných kontaktů v účtu (deduplikovaných podle ID kontaktu, nikoli podle velikosti stránky) a každá položka obsahuje dostatek informací k rozlišení kontaktů bez následného volání. Pokud má účet duplicitní záznamy pro stejné ID kontaktu, jsou sloučeny do jednoho, takže total počítá odlišné kontakty, nikoli nezpracované řádky na straně serveru:

Pole: contactId
Typ: Řetězec (27–32 alfanumerických znaků). Předává se do contacts_get, domain_purchase_link nebo domain_set_contacts.
Pole: name
Typ: Řetězec — jméno kontaktu.
Pole: email
Typ: Řetězec nebo null, pokud kontakt nemá evidovaný e-mail.
Pole: organization
Typ: Řetězec nebo null, pokud kontakt nemá evidovanou organizaci.

{
"items": [
{ "contactId": "1anq5bsl9haBy21rOV9aeDWrARBsV", "name": "Ada Lovelace", "email": "ada@example.com", "organization": "Analytical Engines" }
],
"total": 1
}

Domény

Vstupy názvů domén (domain/domainName) přijímají Unicode (IDN) nebo ASCII (A-label) — v obou případech nástroj před použitím automaticky normalizuje název na punycode. domains_check_availability navíc vyžaduje TLD, které Spaceship podporuje pro registraci: doména, jejíž TLD není podporováno, je nahlášena jako nedostupná místo toho, aby byla zkontrolována. Ostatní nástroje pro domény (domains_list, domain_set_contacts, domain_set_nameservers) a nástroje DNS pouze normalizují název a nikdy jej neodmítnou kvůli podpoře TLD.

`domains_list` — Seznam domén

Přístup: Čtení.

Načte stránkovaný seznam vašich domén. Místo toho předejte domain pro načtení jedné domény podle názvu (stránkování a řazení se pak ignorují a výsledek obsahuje note, která to uvádí, pokud byly zadány). Doména, která není ve vašem účtu, ať už není registrovaná nebo je registrovaná někým jiným, není chyba: výsledkem je { "items": [], "total": 0, "note": "This domain is not in this account." }, v obou případech stejné.

Parametr: domain
Povinné: Ne
Typ a omezení: Plně kvalifikovaný název domény pro načtení jedné domény. Přijímá Unicode (IDN) nebo ASCII (A-label) — automaticky se normalizuje na punycode.
Parametr: take
Povinné: Ne
Typ a omezení: Položek na stránku, 1–100. Výchozí hodnota 10.
Parametr: skip
Povinné: Ne
Typ a omezení: Položky k přeskočení, 0 nebo více. Výchozí hodnota 0.
Parametr: orderBy
Povinné: Ne
Typ a omezení: Až 4 klíče řazení, každý z name, -name, unicodeName, -unicodeName, registrationDate, -registrationDate, expirationDate, -expirationDate; úvodní - znamená sestupně. První klíč řadí jako první a každý další klíč rozhoduje při shodě. Každé pole se může objevit jen jednou, v jednom směru. Jakákoli jiná hodnota nebo opakované pole je odmítnuto s application.request.badRequest.

Vrací — { items, total } kde každá položka popisuje doménu:

Pole: name / unicodeName
Význam: Název domény ve formátu ASCII a Unicode.
Pole: isPremium
Význam: Zda je doména prémiový název.
Pole: autoRenew
Význam: Zda je povoleno automatické obnovení.
Pole: registrationDate / expirationDate
Význam: Časová razítka registrace a vypršení platnosti.
Pole: lifecycleStatus
Význam: creating, registered, grace1, grace2 nebo redemption.
Pole: verificationStatus
Význam: verification, success, failed nebo null, pokud se nepoužije.
Pole: eppStatuses
Význam: Kódy stavu registru (např. zámky převodu).
Pole: suspensions
Význam: Aktivní pozastavení, každé s reasonCode.
Pole: privacyProtection
Význam: { level: "public" | "high", contactForm: boolean }.
Pole: nameservers
Význam: { provider: "basic" | "custom", hosts: [...] }.
Pole: contacts
Význam: ID kontaktů: registrant, plus admin/tech/billing (může být null) a attributes (seznam ID kontaktů rozšířených atributů nebo null). Lze číst přes contacts_get.

Spaceship MCP Connector vyplňuje všechna výše uvedená pole — včetně contacts, eppStatuses, suspensions, verificationStatus, nameservers, skutečného autoRenew a odlišného unicodeName, pokud jej doména má — jak pro seznam s více položkami, tak pro načtení jedné domény.

`domains_check_availability` — Zkontrolovat dostupnost domény

Přístup: Čtení.

Kontroluje, zda je možné zaregistrovat jeden nebo více názvů domén. Názvy se kontrolují ve skupinách po maximálně 5, několik skupin najednou; skupina s jedním názvem používá endpoint pro jednu doménu a větší skupina hromadný endpoint. Doména, jejíž TLD není podporováno pro registraci, se ke kontrole dostupnosti vůbec neodesílá — je okamžitě vrácena jako tldNotSupported.

Parametr: domains
Povinné: Ano
Typ a omezení: 1–20 plně kvalifikovaných názvů domén. Každý přijímá Unicode (IDN) nebo ASCII (A-label) — automaticky se normalizuje na punycode.

Vrací — { results }, jedna položka pro každý požadovaný název:

Pole: domain
Význam: Kontrolovaný název.
Pole: result
Význam: available, taken, invalidDomainName, tldNotSupported, unexpectedError nebo checkTimedOut.
Pole: premiumPricing
Význam: Pro prémiové názvy: seznam { operation, price, currency }, kde operation je register, transfer, renew nebo restore. U běžných názvů je prázdný.
Pole: price
Význam: Pro dostupné názvy (standardní i prémiové): cena v USD za registraci domény na nejkratší období, které TLD umožňuje — { amount, currency: "USD", pricedYears?, pricePerYear?, icannFee?, isPremium }. amount je celková splatná částka za celé toto období; pricedYears uvádí, kolik let pokrývá. Není uváděna žádná cena před slevou ani „původní“ cena. icannFee je poplatek ICANN (USD) již zahrnutý v amount, vrácený samostatně, aby bylo možné vysvětlit rozpis; objevuje se pouze tehdy, když TLD tento poplatek má.
Pole: pricePerYear
Význam: Uvnitř price: amount děleno pricedYears, takže je pro porovnání vždy k dispozici roční údaj. Když je pricedYears 1, jde o skutečnou cenu za jeden rok; při vyšší hodnotě jde o průměr za rok v rámci období, nikoli o období, které by bylo možné koupit.
Pole: minRegisterPeriodInYears / maxRegisterPeriodInYears
Význam: Pro dostupné názvy: nejkratší a nejdelší registrační období, které dané TLD skutečně povoluje, jako dvě prostá čísla. Říkají zákazníkovi, na jaká období může doménu koupit. Obojí je vynecháno, pokud nebylo možné povolené období určit.
Pole: priceUnavailableReason
Význam: Přítomno místo price, když nebylo možné určit cenu dostupného názvu. Samotná kontrola je přesto úspěšná.

Cenu mají pouze dostupné názvy; výsledky taken/invalid neobsahují ani price, ani priceUnavailableReason.

taken říká pouze to, že je název registrován, ne kým: doména už může být ve vašem vlastním účtu. Než zákazníkovi řeknete, že ji vlastní někdo jiný, zkontrolujte ji v domains_list.

checkTimedOut znamená, že kontrola tohoto názvu nebyla dokončena včas, takže o něm není nic známo — nenítaken ani available. Neobsahuje žádné price. Názvy se kontrolují ve skupinách a tímto způsobem se vrátí pouze názvy ze skupiny, u které vypršel čas; ostatní výsledky jsou platné. Zkontrolujte později znovu jen názvy checkTimedOut. Volání selže s chybou pouze tehdy, když vyprší čas u každé skupiny nebo když skupina selže z jakéhokoli jiného důvodu.

Většina TLD umožňuje jeden rok, ale některé ne..ai má například minimálně dva roky. U takových TLD je price.amount celková částka za minimální období — nikoli cena za jeden rok, kterou by bylo možné použít — a price.pricedYears to uvádí:

{
"domain": "example.ai",
"result": "available",
"premiumPricing": [],
"price": { "amount": 159.96, "currency": "USD", "pricedYears": 2, "pricePerYear": 79.98, "isPremium": false },
"minRegisterPeriodInYears": 2,
"maxRegisterPeriodInYears": 10
}

pricePerYear je zde přítomno — 159.96 děleno dvěma roky, které pokrývá, dává 79.98. Jde o celkovou částku dělenou obdobím, nikoli o cenu, kterou by bylo možné zaplatit za jeden rok (jednoletou registraci .ai nelze koupit). Vždy zobrazujte amount společně s pricedYears („159.96 $ za 2 roky“), nikdy ne samotné amount. U běžného TLD je pricedYears1 a pricePerYear se rovná amount.

`domain_purchase_link` — Získat odkazy pro nákup domény

Přístup: Zápis.

Připraví jeden nebo více platebních odkazů Spaceship, abyste mohli koupit domény na vlastní platební stránce Spaceship v prohlížeči místo v chatu. Tímto voláním se nic neregistruje ani neúčtuje — na stránce vše zkontrolujete a zaplatíte, což je potvrzovací krok. Je to jediný způsob, jak koupit doménu od asistenta. Vyžaduje přístup domains:billing. Pokud jste už za doménu možná zaplatili, nejprve zkontrolujte domains_list a žádejte o odkaz jen pro domény, které skutečně nejsou registrované, jinak riskujete dvojí platbu.

Nastavení zadaná na nejvyšší úrovni (years, autoRenew, contacts) platí pro každou položku. Položka, která nastaví vlastní years, autoRenew nebo contacts, je přepíše pouze pro tuto doménu a cokoli vynechá, se zdědí (contacts položky nahrazují contacts na nejvyšší úrovni jako celek). contacts na nejvyšší úrovni jsou povinné: kontakty se přenášejí s odkazem a po jeho otevření jsou už předvyplněné jako kontakty domény. Každá doména může být uvedena jen jednou a neexistují žádné vstupy pro platbu, měnu ani WHOIS privacy — WHOIS privacy zůstává na platební stránce ve výchozím nastavení platformy.

Parametr: items
Povinné: Ano
Typ a omezení: Pole 1–20 položek, každá uvedená jednou.
Parametr: items[].domain
Povinné: Ano
Typ a omezení: Plně kvalifikovaný název domény ke koupi, např. example.com. Přijímá Unicode (IDN) nebo ASCII (A-label) — automaticky se normalizuje na punycode.
Parametr: items[].years
Povinné: Ne
Typ a omezení: Celé číslo 1–10; přepisuje years na nejvyšší úrovni pro tuto doménu.
Parametr: items[].autoRenew
Povinné: Ne
Typ a omezení: Boolean; přepisuje autoRenew na nejvyšší úrovni pro tuto doménu.
Parametr: items[].contacts
Povinné: Ne
Typ a omezení: Kontakty pouze pro tuto doménu jako řetězce contactId (registrant, admin, tech, billing, volitelné attributes); nahrazují contacts na nejvyšší úrovni jako celek.
Parametr: years
Povinné: Ne
Typ a omezení: Celé číslo 1–10, použije se na každou položku, která nemá nastavenou vlastní hodnotu. Musí spadat do období, které TLD povoluje (minRegisterPeriodInYears/maxRegisterPeriodInYears z domains_check_availability); hodnoty mimo rozsah jsou odmítnuty s chybou uvádějící povolený rozsah, nikoli upraveny. Když to nenastaví ani toto, ani položka, použije se nejkratší období TLD.
Parametr: autoRenew
Povinné: Ne
Typ a omezení: Boolean, použije se na každou položku, která nemá nastavenou vlastní hodnotu. Výchozí hodnota je true.
Parametr: contacts
Povinné: Ano
Typ a omezení: Kontakty jako řetězce contactId, použijí se na každou položku, která nemá nastavené vlastní: registrant (povinné), admin, tech a billing (každé má výchozí hodnotu registrant) a volitelné attributes (seznam až 5 ID kontaktů rozšířených atributů, vyžadovaný jen pro některé TLD). ID vezměte z contacts_list, nebo nejprve uložte údaje pomocí contacts_save.

Odkazy na jedno volání. Jeden odkaz může obsahovat nejvýše 10 domén, takže delší seznam vrátí několik odkazů v pořadí požadavku — například 15 domén vytvoří dva odkazy po 10 a 5. links[].domains uvádí, které domény každý odkaz pokrývá.

Cena. Pole price u každé domény je odhad; konečná cena se zobrazí na platební stránce. Když odhad není k dispozici, má doména místo toho pole priceUnavailableReason. Chybějící odhad nikdy nebrání vydání odkazu.

Platba. Způsob platby se vybírá na stránce. Prostředky na účtu jsou předvybrány, pokud je účet má.

Odkazy lze použít opakovaně. Odkaz nevyprší a lze jej otevřít více než jednou, proto jej s nikým dalším nesdílejte.

Vrací

{
"status": "links_ready",
"links": [
{
"url": "https://example.spaceship.com/pay/abc123",
"domains": [
{
"domain": "example.com",
"years": 1,
"autoRenew": true,
"price": { "amount": 9.08, "currency": "USD", "pricedYears": 1, "pricePerYear": 9.08, "icannFee": 0.2, "isPremium": false }
},
{
"domain": "example.ai",
"years": 2,
"autoRenew": false,
"priceUnavailableReason": "Price is currently unavailable for this domain."
}
]
}
],
"failed": [],
"note": "Nothing has been charged. ..."
}

status: links_ready
Význam: Každá doména je pokryta odkazem.
status: partial
Význam: Některé domény jsou pokryty; ostatní jsou uvedeny v failed, každá s reason (například není dostupná, nepodporovaná koncovka, nepovolené období, problém s kontakty nebo odkaz, který se nepodařilo vytvořit).
status: no_links
Význam: Nebyl vydán žádný odkaz a nic nebylo účtováno; failed uvádí proč u každé domény. Když je každá doména nedostupná (již registrovaná nebo zabraná) nebo má koncovku, kterou zde nelze registrovat, je to normální výsledek a není označen jako chyba: řekněte zákazníkovi, že není co koupit. Když odkaz nebylo možné připravit nebo vytvořit z jakéhokoli jiného důvodu nebo kvůli kombinaci důvodů, je výsledek označen jako chyba (isError), se stejným tělem.

Poté, co zákazník řekne, že zaplatil, zavolejte domains_list pro danou doménu a potvrďte, že je registrovaná — nepovažujte samotný odkaz za důkaz nákupu.

`domain_set_contacts` — Nastavit kontakty domény

Přístup: Citlivý zápis — změna vlastníka může zablokovat převody na 60 dní.

Změní kontakty přiřazené k doméně, kterou vlastníte. Dokončí se okamžitě (žádná operace ke zjišťování stavu).

Parametr: domainName
Povinné: Ano
Typ a omezení: Plně kvalifikovaný název domény. Přijímá Unicode (IDN) nebo ASCII (A-label) — automaticky se normalizuje na punycode.
Parametr: registrant
Povinné: Ano
Typ a omezení: contactId řetězec (27–32 alfanumerických znaků), z contacts_save.
Parametr: admin
Povinné: Ne
Typ a omezení: contactId řetězec (27–32 alfanumerických znaků) nebo null.
Parametr: tech
Povinné: Ne
Typ a omezení: contactId řetězec (27–32 alfanumerických znaků) nebo null.
Parametr: billing
Povinné: Ne
Typ a omezení: contactId řetězec (27–32 alfanumerických znaků) nebo null.
Parametr: attributes
Povinné: Ne
Typ a omezení: Pole ID kontaktů rozšířených atributů (až 5); vyžadováno jen pro některé TLD, jinak vynechte nebo použijte null.

Vrací

{ "verificationStatus": "verification" }

Vrácená hodnota verificationStatus odráží ověření e-mailu podle ICANN RAA: verification — držitel musí potvrdit svou e-mailovou adresu (je odeslán potvrzovací e-mail); success — již potvrzeno; null — ověření RAA se na tuto doménu nevztahuje.

`domain_set_nameservers` — Nastavit nameservery domény

Přístup: Citlivý zápis — přesune veškerý provoz domény.

Změní nameservery domény na úrovni registrátora. Dokončí se okamžitě (žádná operace ke zjišťování stavu). Změna se poté projeví v domains_list.

Parametr: domainName
Povinné: Ano
Typ a omezení: Plně kvalifikovaný název domény. Přijímá Unicode (IDN) nebo ASCII (A-label) — automaticky se normalizuje na punycode.
Parametr: provider
Povinné: Ano
Typ a omezení: basic (výchozí nameservery Spaceship) nebo custom (vaši vlastní hostitelé).
Parametr: hosts
Povinné: Podmíněně
Typ a omezení: Vyžadováno, když je providercustom: 2–12 hostname nameserverů (každý platný FQDN, 4–255 znaků). Musí být vynecháno, když je providerbasic.

Vrací

{ "provider": "custom", "hosts": ["ns1.example.com", "ns2.example.com"] }

Požadavek na nameservery, které doména již používá, není chyba. Nástroj nejprve přečte aktuální nameservery domény. Když už odpovídají požadavku (stejný provider a u vlastních nameserverů stejní hostitelé v libovolném pořadí a bez ohledu na velikost písmen), nic se nezapíše a odpovědí je aktuální stav s poznámkou:

{ "provider": "custom", "hosts": ["ns1.example.com", "ns2.example.com"], "note": "Already set; nothing changed." }

Pokud aktuální nameservery nelze včas přečíst, změna se odešle podle požadavku a opětovné použití pak může být stále odmítnuto s business.conflict ("These nameservers are already set for this domain."), což také znamená, že se nic nezměnilo.

DNS záznamy

Hodnota domainName, kterou tyto nástroje přijímají, podporuje Unicode (IDN) nebo ASCII (A-label) a automaticky se normalizuje na punycode; podpora TLD se zde nevynucuje.

`dns_records_get` — Získat DNS záznamy

Přístup: Čtení.

Načte stránkovaný seznam DNS resource záznamů pro doménu.

Parametr: domainName
Povinné: Ano
Typ a omezení: Doména, jejíž záznamy se mají načíst.
Parametr: take
Povinné: Ne
Typ a omezení: Počet položek na stránku, 1–500. Výchozí hodnota 100.
Parametr: skip
Povinné: Ne
Typ a omezení: Počet položek k přeskočení, 0 nebo více. Výchozí hodnota 0.
Parametr: orderBy
Povinné: Ne
Typ a omezení: Až 8 klíčů řazení: type, -type, name, -name.

Vrací — { items, total }. Každá položka je záznam, jak je popsán v Tvary záznamů, plus volitelné pole group označující, odkud záznam pochází (custom — vytvořeno vámi, product — spravováno produktem Spaceship, personalNs — osobní nameservery).

`dns_records_save` — Uložit DNS záznamy

Přístup: Zápis.

Přidává vlastní DNS záznamy nebo aktualizuje TTL existujících. Záznamy se porovnávají bez ohledu na velikost písmen, kromě TXT záznamů (rozlišují velikost písmen).

Pokud volání selže s infrastructure.serviceUnavailable, záznamy mohly být přesto uloženy: před dalším uložením je načtěte pomocí dns_records_get (viz Opakování zápisů).

Parametr: domainName
Povinné: Ano
Typ a omezení: Doména, jejíž záznamy se mají aktualizovat.
Parametr: records
Povinné: Ano
Typ a omezení: 1–500 záznamů — viz Tvary záznamů. Každý může obsahovat volitelné ttl.
Parametr: force
Povinné: Ne
Typ a omezení: Boolean. Přeskočí kontrolu řešení konfliktů a vynutí aktualizaci zóny.

Vrací — { "saved": <number> }, počet odeslaných záznamů. Úspěšná odpověď znamená, že byly přijaty všechny záznamy; pokud některý záznam selže, celé volání místo toho vrátí chybu. Záznam, který DNS služba odmítne, způsobí selhání volání s business.invalidArgument a detailem "The service rejected the request.", s položkou validationErrors pro každé odmítnuté pole záznamu, například { "field": "records.address", "rule": "pattern", "message": "The format of this field is not valid." }. Pole field pojmenovává pole záznamu pod records, ale neuvádí, který záznam v seznamu to je, proto před dalším uložením zkontrolujte hodnotu tohoto pole u každého záznamu podle Tvarů záznamů.

`dns_records_delete` — Smazat DNS záznamy

Přístup: Citlivý zápis — smazání nelze vrátit zpět.

Maže vlastní DNS záznamy. Smazání nelze vrátit zpět. Odeslaný záznam se smaže pouze tehdy, když se ve všech polích shoduje s uloženým záznamem; pravidla jsou uvedena pod tabulkou.

Parametr: domainName
Povinné: Ano
Typ a omezení: Doména, jejíž záznamy se mají smazat.
Parametr: records
Povinné: Ano
Typ a omezení: 1–500 záznamů ke smazání — stejné tvary jako při ukládání, ale bez ttl. Záznam, který v zóně není, je uveden v notFound, nikoli jako chyba.

Vrací — { "deleted": <number>, "notFound": [...] }. deleted je počet záznamů, které existovaly a byly odstraněny. notFound je přítomno pouze tehdy, když některé odeslané záznamy v zóně nebyly; uvádí je tak, jak byly odeslány, v pořadí, každý jednou. Tyto záznamy nebyly smazány a nejde o chybu — není co opakovat:

{
"deleted": 1,
"notFound": [
{ "type": "TXT", "name": "_old", "value": "v=old" }
]
}

Každý odeslaný záznam, který existuje, je smazán, i když jiné chybí. Nástroj nejprve čte zónu, až do 10 000 záznamů a v časovém limitu. Když je zóna větší nebo ji nelze v časovém limitu přečíst, nelze potvrdit, že nenalezený záznam skutečně chybí: přesto se odešle ke smazání a odpověď je { "deleted": <number>, "unconfirmed": [...], "note": "..." } místo notFound. deleted pak počítá jen záznamy potvrzené v zóně. Zavolejte dns_records_get a zkontrolujte záznamy v unconfirmed před dalším mazáním.

Jak se záznamy porovnávají — odeslaný záznam odpovídá uloženému, když se jeho typ a každé pole po normalizaci rovnají: názvy a hodnoty hostitelů (name, cname, aliasName, nameserver, pointer, exchange, cíle SRV a HTTPS/SVCB) se porovnávají bez ohledu na velikost písmen a ignorují jednu koncovou tečku; hodnota CAA value nerozlišuje velikost písmen a ignoruje obalující uvozovky; hodnota TXT value se porovnává přesně, znak po znaku. Hodnota MX preference je součástí shody, takže smazání mail.example.com s preferencí 10 nikdy neodstraní stejný exchange uložený s jinou preferencí. Neexistuje porovnávání podle prefixu ani zástupných znaků a pole, které je přítomné jen na jedné straně, se neshoduje.

Tvary záznamů

Každý záznam má:

type — jeden z 13 podporovaných typů níže.
name — název záznamu bez domény: použijte @ pro samotnou doménu (apex) a * pro zástupný znak.
ttl (pouze při ukládání, volitelné) — doba cache v sekundách, 60–3600.

Pole specifická pro typ:

Typ: A
Pole: address — IPv4 adresa.
Typ: AAAA
Pole: address — IPv6 adresa.
Typ: CNAME
Pole: cname — kanonický název domény (max. 253 znaků).
Typ: ALIAS
Pole: aliasName — kanonický název domény; chování podobné CNAME pro apex, kde CNAME není povoleno.
Typ: NS
Pole: nameserver — název nameserveru.
Typ: PTR
Pole: pointer — název domény pro danou IP adresu.
Typ: TXT
Pole: value — textová hodnota (porovnává se s rozlišením velikosti písmen).
Typ: MX
Pole: exchange — poštovní server; preference — priorita (0–65535, nižší je preferována).
Typ: CAA
Pole: flag — 0 nebo 128 (kritický bit); tag — issue, issuewild nebo iodef; value — identifikátor CA s volitelnými parametry.
Typ: SRV
Pole: service (např. _sip); protocol (např. _tcp); priority a weight (0–65535); port (1–65535); target — název domény serveru.
Typ: TLSA
Pole: usage, selector, matching (každé 0–255); port — * nebo _<1–65535>; protocol (např. _tcp); associationData — hash certifikátu nebo data.
Typ: HTTPS
Pole: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN nebo .; volitelné port (* nebo _<1–65535>), scheme (musí být _https, když je nastaveno port), svcParams.
Typ: SVCB
Pole: svcPriority (0–65535; 0 = AliasMode); targetName — FQDN nebo .; volitelné port, scheme (např. _tcp), svcParams.

Marketplace: nabídky

Vaše nabídky na tržišti Spaceship: domény, které jste dali k prodeji, jejich ceny, nastavení stránek a ověření vlastnictví.

`marketplace_listings_list` — Vypsat moje nabídky na Marketplace

Přístup: Čtení.

Vypíše aktuální nabídky vašeho účtu na tržišti Spaceship — nabídky, které vidíte na kartě SellerHub Domains — po jedné stránce ve stabilním pořadí. Prodané, pronajaté a neúspěšné záznamy jsou vynechány, pokud je nevyžádá status. Každá položka obsahuje doménu, její stav, ceny Buy Now a minimální nabídky, nastavení For Sale Page, Contact Owner a Quality Offer a podmínky Lease-to-Own. Pro úplnou kartu jedné nabídky, včetně stavu její For Sale Page a odkazů Add to Cart, použijte marketplace_listing_get.

Všechny filtry jsou volitelné a kombinují se pomocí AND. Filtr, který neodpovídá ničemu, není chyba: odpovědí je prázdný seznam items s total0. Délku názvu a „Lease-to-Own enabled“ nelze filtrovat.

Parametr: status
Povinné: Ne
Typ a omezení: 1–9 různých stavů: verifying, on_sale, sale_stopped, private_sale, sale_processing, waiting_for_transfer, on_lease, sold, failed (viz tabulka níže). Vráceny jsou pouze nabídky v některém z nich. Vynechte pro aktuální nabídky, jak je zobrazuje karta SellerHub Domains: verifying, on_sale, sale_stopped, private_sale, sale_processing a waiting_for_transfer po prodeji; záznamy on_lease, sold a failed jsou vráceny pouze tehdy, když jsou zde vyžádány.
Parametr: tld
Povinné: Ne
Typ a omezení: 1–20 různých koncovek bez úvodní tečky, např. ["com", "io"]. Malá písmena ASCII, číslice a pomlčky; vícedílné koncovky jako co.uk jsou povoleny.
Parametr: buyNowEnabled
Povinné: Ne
Typ a omezení: Boolean. true: pouze nabídky se zapnutým Buy Now; false: pouze nabídky s vypnutým Buy Now.
Parametr: buyNowPrice.min
Povinné: Podmíněně
Typ a omezení: Číslo, 0–10,000,000 amerických dolarů včetně. Když je nastaveno buyNowPrice, zadejte dolní mez, horní mez nebo obě. Dolní mez nesmí být vyšší než horní mez.
Parametr: buyNowPrice.max
Povinné: Podmíněně
Typ a omezení: Číslo, 0–10,000,000 amerických dolarů včetně.
Parametr: minOfferEnabled
Povinné: Ne
Typ a omezení: Boolean. true: pouze nabídky, které přijímají nabídky; false: pouze nabídky, které je nepřijímají.
Parametr: minOfferPrice.min
Povinné: Podmíněně
Typ a omezení: Číslo, 0–10,000,000 amerických dolarů včetně. Když je nastaveno minOfferPrice, zadejte dolní mez, horní mez nebo obě. Dolní mez nesmí být vyšší než horní mez.
Parametr: minOfferPrice.max
Povinné: Podmíněně
Typ a omezení: Číslo, 0–10,000,000 amerických dolarů včetně.
Parametr: limit
Povinné: Ne
Typ a omezení: Počet nabídek na stránku, 1–100. Výchozí 25.
Parametr: offset
Povinné: Ne
Typ a omezení: Počet nabídek k přeskočení před stránkou, 0 nebo více. Výchozí 0.

Vrací — { items, total, offset, limit }. total je počet nabídek, které odpovídají filtrům napříč všemi stránkami. Každá položka má stejná pole jako nabídka v marketplace_listing_get, bez forSalePageStatus, cartLinks, unavailable a note:

{
"items": [
{
"listingId": "8f3c2a1e-4b5d-4e6f-9a7b-1c2d3e4f5a6b",
"domain": "brightharbor.com",
"displayName": "BrightHarbor.com",
"status": "on_sale",
"buyNow": { "enabled": true, "price": { "amount": "25000.00", "currency": "USD" } },
"minOffer": { "enabled": true, "price": { "amount": "5000.00", "currency": "USD" } },
"description": "Short, brandable .com for a marine or travel business",
"forSalePage": true,
"contactOwner": true,
"showOnPortfolio": true,
"portfolioEligible": true,
"qualityOffer": "follow_account",
"leaseToOwn": null,
"external": false,
"ownershipVerified": true,
"addedAt": "2026-04-01T10:00:00.000Z"
}
],
"total": 1,
"offset": 0,
"limit": 25
}

status: verifying
Význam: Vlastnictví domény se ověřuje; kupující ji nevidí. Doména registrovaná u Spaceship tento stav obvykle opustí přibližně do minuty; doména registrovaná jinde zde zůstane, dokud nejsou zveřejněny její ověřovací DNS záznamy a kontrola neprojde.
status: on_sale
Význam: Na prodej kupujícím.
status: sale_stopped
Význam: Uvedeno v nabídce, ale prodej je zastaven.
status: private_sale
Význam: Prodává se v soukromém prodeji.
status: sale_processing
Význam: Objednávka kupujícího se zpracovává.
status: waiting_for_transfer
Význam: Prodáno nebo pronajato, čeká se na převod kupujícímu.
status: on_lease
Význam: Pronajato kupujícímu.
status: sold
Význam: Prodej je dokončen.
status: failed
Význam: Prodej selhal.

`marketplace_listing_get` — Získat jednu nabídku na Marketplace

Přístup: Čtení.

Načte jednu z nabídek vašeho účtu na tržišti podle domény s jejím úplným kontextem: stav, ceny Buy Now a minimální nabídky, popis, For Sale Page (zapnuto nebo vypnuto a její aktuální stav), Contact Owner, zobrazení v portfoliu, Quality Offer domény, podmínky Lease-to-Own a odkazy Add to Cart (Buy Now a Lease-to-Own), které můžete umístit na svůj vlastní web; každý odkaz je uveden pouze tehdy, když jej kupující mohou použít.

Odkazy Add to Cart se načítají samostatně v krátkém časovém limitu. Když je nelze načíst včas, cartLinks je null, unavailable uvádí cart_links a zbytek nabídky je přesto vrácen; pro odkazy čtěte znovu později. Nabídka, jejíž vlastnictví ještě není ověřeno, má stav verifying a note: doména registrovaná u Spaceship jde obvykle do prodeje přibližně do minuty a doména registrovaná jinde potřebuje ověřovací záznamy v marketplace_seller_settings_get. Doména, kterou váš účet nenabídl, odpoví business.notFound.

Parametr: domain
Povinné: Ano
Typ a omezení: Nabízená doména, např. example.com, 3–253 znaků. Unicode (IDN) nebo ASCII; automaticky normalizováno na punycode.

Vrací

{
"listingId": "8f3c2a1e-4b5d-4e6f-9a7b-1c2d3e4f5a6b",
"domain": "brightharbor.com",
"displayName": "BrightHarbor.com",
"status": "on_sale",
"buyNow": { "enabled": true, "price": { "amount": "25000.00", "currency": "USD" } },
"minOffer": { "enabled": true, "price": { "amount": "5000.00", "currency": "USD" } },
"description": "Short, brandable .com for a marine or travel business",
"forSalePage": true,
"contactOwner": true,
"showOnPortfolio": true,
"portfolioEligible": true,
"qualityOffer": "follow_account",
"leaseToOwn": {
"total": { "amount": "25000.00", "currency": "USD" },
"downPayment": { "amount": "5000.00", "currency": "USD" },
"finalPayment": null,
"installment": { "amount": "1666.66", "currency": "USD" },
"installments": 12
},
"external": false,
"ownershipVerified": true,
"addedAt": "2026-04-01T10:00:00.000Z",
"forSalePageStatus": "live",
"cartLinks": {
"buyNow": "https://www.spaceship.com/domains/cart/?buyNow=brightharbor.com",
"leaseToOwn": "https://www.spaceship.com/domains/cart/?leaseToOwn=brightharbor.com"
},
"unavailable": []
}

Pole: listingId
Význam: ID nabídky (UUID), hodnota, kterou marketplace_listings_bulk_update přijímá v listingIds.
Pole: domain / displayName
Význam: Doména ve formátu ASCII (punycode) a tak, jak se zobrazuje kupujícím.
Pole: status
Význam: Stav nabídky; viz tabulka pod marketplace_listings_list.
Pole: buyNow / minOffer
Význam: { enabled, price }; price je { amount, currency } v amerických dolarech nebo null, když není nastaveno.
Pole: description
Význam: Text zobrazený kupujícím na For Sale Page nebo null.
Pole: forSalePage / contactOwner / showOnPortfolio
Význam: Zda jsou For Sale Page, její formulář Contact Owner a doména na vaší stránce portfolia zapnuté.
Pole: portfolioEligible
Význam: Zda se nabídka může zobrazit na vaší stránce portfolia: je on_sale a nemá s kupujícím dohodnutý prodej. Stránka nezobrazuje nic, dokud portfolio není viditelné; jinak s displayModeall zobrazuje každou způsobilou nabídku a s selected pouze způsobilé nabídky se zapnutým showOnPortfolio. Přečtěte visibility a displayMode pomocí marketplace_seller_settings_get.
Pole: qualityOffer
Význam: follow_account (použije nastavení vašeho účtu), disabled, optional, mandatory nebo mandatory_for_countries.
Pole: leaseToOwn
Význam: Podmínky Lease-to-Own (total, downPayment, finalPayment, installment, installments) nebo null, když je Lease-to-Own vypnuto. downPayment a finalPayment jsou null, když žádné nejsou.
Pole: external / ownershipVerified
Význam: Zda tržiště považuje doménu za registrovanou mimo Spaceship a zda je její vlastnictví ověřeno. external je dočasné, dokud je stav verifying: každá nová nabídka začíná jako true a kontrola vlastnictví ji nastaví na false pro doménu registrovanou u Spaceship.
Pole: addedAt
Význam: Kdy byla doména zařazena do nabídky, nebo null.
Pole: forSalePageStatus
Význam: Aktuální stav For Sale Page: not_available, off, turning_off, needs_resolution, dns_records_missing, needs_dns_setup, connection_issue, connection_failed, connecting, live_ssl_pending nebo live; null, když není znám.
Pole: cartLinks
Význam: { buyNow, leaseToOwn } odkazy Add to Cart pro tuto doménu nebo null, když je nebylo možné načíst. Odkaz je null, když jej kupující nemohou použít: nabídka není on_sale, Buy Now je vypnuto (buyNow), nemá podmínky Lease-to-Own (leaseToOwn) nebo je doména přislíbena kupujícímu prostřednictvím dohodnutého prodeje nebo potvrzené dohody SafePay (oboje). Odkazy se vrátí, jakmile tato dohoda skončí bez prodeje.
Pole: unavailable
Význam: Části, které nebylo možné načíst včas: prázdné nebo ["cart_links"].
Pole: note
Význam: Přítomno pouze, když je stav verifying: že se ověřuje vlastnictví a co zveřejnit, když je doména registrována mimo Spaceship.

`marketplace_listing_create` — Zařadit doménu do prodeje

Přístup: Citlivý zápis — nabídne doménu k prodeji za ceny, za které může koupit kdokoli.

Nabídne doménu k prodeji na tržišti Spaceship pro váš účet. Zadejte cenu Buy Now, cenu minimální nabídky nebo obojí; popis, nastavení stránky (forSalePage, contactOwner, showOnPortfolio) a qualityOffer jsou volitelné a přijímají stejné hodnoty jako v marketplace_listing_update. Podmínky Lease-to-Own se zde nenastavují: nastavte je pomocí marketplace_listing_update, jakmile nabídka existuje. Pole leaseToOwn odeslané přesto je ignorováno. Nová nabídka začíná se stavem verifying, zatímco se ověřuje její vlastnictví, a kupujícím se zobrazí až po úspěšném ověření: doména registrovaná u Spaceship jde obvykle do prodeje přibližně do minuty a u domény registrované jinde note odkazuje na ověřovací záznamy v marketplace_seller_settings_get. Dokud je stav verifying, external je dočasné a může být true i pro doménu Spaceship. To je normální výsledek, nikoli chyba.

Doména je nejprve zařazena do nabídky se svými cenami a popisem; nastavení stránky a Quality Offer se pak ukládají v tomto pořadí. Pokud selže samotné zařazení domény do nabídky, volání vrátí chybu a nic nebylo zařazeno. Pokud selže pozdější skupina, doména zůstane v nabídce a odpověď uvede tuto skupinu v notSaved (nebyla změněna) nebo unconfirmed (není známo, zda byla změněna); místo opětovného vytváření načtěte nabídku pomocí marketplace_listing_get a nastavte tyto skupiny pomocí marketplace_listing_update. Doména, kterou váš účet již nabídl, není nabídnuta znovu a nic se nezmění: odpovědí je aktuální nabídka s created: false, takže opakované volání nikdy nezařadí doménu do nabídky dvakrát.

Parametr: domain
Povinné: Ano
Typ a omezení: Doména k zařazení do nabídky, např. example.com, 3–253 znaků. Unicode (IDN) nebo ASCII; automaticky normalizováno na punycode.
Parametr: buyNowPrice
Povinné: Podmíněně
Typ a omezení: Cena Buy Now v amerických dolarech jako řetězec, např. "2500" nebo "2500.00": větší než 0, nejvýše 10,000,000, až 2 desetinná místa. Zadejte ji, minOfferPrice nebo obojí.
Parametr: minOfferPrice
Povinné: Podmíněně
Typ a omezení: Nejnižší nabídka, kterou nabídka přijímá, v amerických dolarech; stejný formát jako buyNowPrice. Zadejte ji, buyNowPrice nebo obojí.
Parametr: description
Povinné: Ne
Typ a omezení: Text zobrazený kupujícím na For Sale Page, až 400 znaků, bez e-mailových adres. null jej ponechá prázdný.
Parametr: forSalePage
Povinné: Ne
Typ a omezení: Boolean. Zapíná nebo vypíná For Sale Page domény.
Parametr: contactOwner
Povinné: Ne
Typ a omezení: Boolean. Zapíná nebo vypíná formulář Contact Owner na For Sale Page.
Parametr: showOnPortfolio
Povinné: Ne
Typ a omezení: Boolean. Zobrazuje nebo skrývá doménu na vaší stránce portfolia.
Parametr: qualityOffer
Povinné: Ne
Typ a omezení: follow_account (použijte nastavení svého účtu), disabled, optional nebo mandatory.
Parametr: qualityOfferDeposit
Povinné: Podmíněně
Typ a omezení: Celé číslo, celé americké dolary, 10–50. Povinné s qualityOfferoptional nebo mandatory a jinak není povoleno; bez něj volání selže s application.request.badRequest a nic se neodešle.

Vrací — novou nabídku:

{
"created": true,
"listing": {
"domain": "northpeak.io",
"displayName": "northpeak.io",
"status": "verifying",
"buyNow": { "enabled": true, "price": { "amount": "25000.00", "currency": "USD" } },
"minOffer": { "enabled": true, "price": { "amount": "5000.00", "currency": "USD" } },
"description": null,
"forSalePage": false,
"contactOwner": false,
"showOnPortfolio": false,
"qualityOffer": "follow_account",
"leaseToOwn": null,
"external": true,
"ownershipVerified": false,
"addedAt": "2026-10-26T09:15:00.000Z"
},
"saved": ["prices"],
"notSaved": [],
"unconfirmed": [],
"note": "The ownership of this domain is being checked, and the listing is not shown to buyers until the check passes. While it is verifying, external is provisional: every new listing starts as external, also for a domain registered at Spaceship, so it does not tell where the domain is registered. A domain registered at Spaceship usually goes on sale within a minute or so; read the listing again with marketplace_listing_get. If the domain is registered elsewhere, add the DNS records listed under verification records by marketplace_seller_settings_get at the domain's DNS provider; the status changes from verifying once the check passes."
}

Pole: created
Význam: true, když toto volání zařadilo doménu do nabídky; false, když už byla v nabídce (pak následují pouze listing a note).
Pole: listing
Význam: Nabídka načtená po volání s poli z marketplace_listing_get až po addedAt. Vynecháno, když ji nebylo možné znovu načíst.
Pole: saved
Význam: Skupiny, které byly uloženy: prices (včetně popisu, který se ukládá společně s cenami), page_settings, quality_offer.
Pole: notSaved
Význam: Skupiny, které nebyly změněny.
Pole: unconfirmed
Význam: Skupiny, jejichž výsledek není znám.
Pole: note
Význam: Přítomno, když doména čeká na ověření vlastnictví, když jsou některé skupiny v notSaved nebo unconfirmed, nebo když už byla doména dříve zařazena do nabídky.

`marketplace_listing_update` — Aktualizace nabídky na Marketplace

Přístup: Citlivý zápis — nová cena se okamžitě použije pro kupující.

Změní jednu z nabídek marketplace vašeho účtu; změní se pouze pole, která zadáte, a musí být zadáno alespoň jedno. Pole spadají do skupin, které se ukládají v tomto pořadí: ceny (buyNowPrice, minOfferPrice; null některou z nich vypne a alespoň jedna musí zůstat zapnutá: změna, po které by nezůstala zapnutá ani jedna, je odmítnuta ještě před uložením čehokoli), potom popis, nastavení stránky (forSalePage, contactOwner, showOnPortfolio) a qualityOffer společně, potom leaseToOwn (nové podmínky nebo { "enabled": false }). Ceny jsou v amerických dolarech.

Odpověď uvádí skupiny v saved, notSaved (nezměněné: odmítnuté nebo nedosažené, protože byla odmítnuta dřívější skupina nebo volání vypršel čas) a unconfirmed (není známo, zda byly změněny), spolu s nabídkou načtenou po změně. Odmítnutá skupina, která není první, se hlásí tímto způsobem, nikoli jako chyba. Pokud selže první skupina, volání vrátí chybu a nic se nezmění. Když jsou skupiny v notSaved nebo unconfirmed, načtěte nabídku pomocí marketplace_listing_get před jejich opětovným odesláním a neopakujte skupiny, které byly uloženy. Doména, kterou váš účet nezařadil do nabídky, vrátí business.notFound.

Parametr: domain
Povinné: Ano
Typ a omezení: Nabízená doména, např. example.com, 3–253 znaků. Unicode (IDN) nebo ASCII; automaticky normalizováno na punycode.
Parametr: buyNowPrice
Povinné: Ne
Typ a omezení: Nová cena Buy Now v amerických dolarech jako řetězec, např. "2500" nebo "2500.00": větší než 0, maximálně 10 000 000, až 2 desetinná místa. null vypne Buy Now.
Parametr: minOfferPrice
Povinné: Ne
Typ a omezení: Nová nejnižší nabídka, kterou nabídka přijímá, v amerických dolarech; stejný formát. null zastaví přijímání nabídek.
Parametr: description
Povinné: Ne
Typ a omezení: Text zobrazený kupujícím na stránce For Sale Page, až 400 znaků, bez e-mailových adres. null jej vymaže.
Parametr: forSalePage
Povinné: Ne
Typ a omezení: Boolean. Zapíná nebo vypíná stránku For Sale Page domény.
Parametr: contactOwner
Povinné: Ne
Typ a omezení: Boolean. Zapíná nebo vypíná formulář Contact Owner na stránce For Sale Page.
Parametr: showOnPortfolio
Povinné: Ne
Typ a omezení: Boolean. Zobrazuje nebo skrývá doménu na stránce vašeho portfolia.
Parametr: qualityOffer
Povinné: Ne
Typ a omezení: follow_account (použije nastavení vašeho účtu), disabled, optional nebo mandatory.
Parametr: qualityOfferDeposit
Povinné: Podmíněně
Typ a omezení: Celé číslo, celé americké dolary, 10–50. Povinné s qualityOfferoptional nebo mandatory a jinak není povoleno; bez něj volání selže s application.request.badRequest a nic se neodešle.
Parametr: leaseToOwn.enabled
Povinné: Podmíněně
Typ a omezení: Povinné, když je zadáno leaseToOwn. false vypne Lease-to-Own; true nastaví níže uvedené podmínky.
Parametr: leaseToOwn.total
Povinné: Podmíněně
Typ a omezení: Povinné, když je leaseToOwn.enabled nastaveno na true. Celková částka, kterou kupující zaplatí během pronájmu, v amerických dolarech.
Parametr: leaseToOwn.downPayment
Povinné: Ne
Typ a omezení: Platba splatná na začátku, v amerických dolarech. Pokud není, vynechte.
Parametr: leaseToOwn.finalPayment
Povinné: Ne
Typ a omezení: Platba splatná s poslední splátkou, v amerických dolarech. Pokud není, vynechte.
Parametr: leaseToOwn.installments
Povinné: Podmíněně
Typ a omezení: Povinné, když je leaseToOwn.enabled nastaveno na true. Počet měsíčních splátek, 1–120; bez akontace alespoň 2. Výše splátky je zbytek celkové částky po odečtení akontace a závěrečné platby, rovnoměrně rozdělený a zaokrouhlený dolů na cent; tento zbytek musí být kladný a zbytek po zaokrouhlení musí být menší než 1 USD.

Vrací — stejnou strukturu jako marketplace_listing_create bez created:

{
"listing": {
"domain": "brightharbor.com",
"displayName": "BrightHarbor.com",
"status": "on_sale",
"buyNow": { "enabled": true, "price": { "amount": "30000.00", "currency": "USD" } },
"minOffer": { "enabled": true, "price": { "amount": "6000.00", "currency": "USD" } },
"description": "Short, brandable .com for a marine or travel business",
"forSalePage": true,
"contactOwner": true,
"showOnPortfolio": true,
"qualityOffer": "follow_account",
"leaseToOwn": null,
"external": false,
"ownershipVerified": true,
"addedAt": "2026-04-01T10:00:00.000Z"
},
"saved": ["prices"],
"notSaved": ["page_settings", "lease_to_own"],
"unconfirmed": [],
"note": "Only the groups listed in saved were changed. The groups in notSaved were not changed; read the listing with marketplace_listing_get before sending them again."
}

Názvy skupin v saved, notSaved a unconfirmed jsou prices, description, page_settings, quality_offer a lease_to_own. listing se vynechá, pokud jej nebylo možné znovu načíst; note je přítomno pouze tehdy, když je některá skupina v notSaved nebo unconfirmed, nebo když doména čeká na ověření vlastnictví.

`marketplace_listing_delete` — Odebrání nabídky z Marketplace

Přístup: Citlivý zápis — nelze vrátit zpět.

Stáhne jednu z domén vašeho účtu z prodeje na Spaceship marketplace. Její aktivní vyjednávání budou pozastavena a obchody SafePay, které jste pro ni otevřeli, budou deaktivovány. Tuto akci nelze vrátit zpět; opětovné zařazení domény do nabídky vytvoří novou nabídku.

Dvoufázové potvrzení. První volání nic nezmění a vrátí status: "confirmation_required" s informací o tom, co se stane (doména, počet jejích aktivních vyjednávání a dopad) a s confirmationToken; text odpovědi uvádí totéž, proto jej zobrazte uživateli. Jakmile souhlasí, zavolejte znovu se stejnou doménou, tokenem a confirmationResponse: "accept" pro odebrání nabídky, nebo "decline" pro zrušení, což vrátí status: "cancelled" a nic nezmění. Platnost tokenu po krátké době vyprší a je vázán na doménu, váš účet a počet aktivních vyjednávání, který zobrazoval: expirovaný, změněný nebo již neodpovídající token vrátí nové confirmation_required s novým tokenem, nikdy chybu a nikdy odebrání. Doména, kterou váš účet nezařadil do nabídky, vrátí business.notFound, přesně stejně jako doména zařazená do nabídky jiným účtem. Pokud potvrzené volání selže s infrastructure.serviceUnavailable, načtěte nabídku pomocí marketplace_listing_get před dalším voláním: odebraná nabídka se nenajde.

Parametr: domain
Povinné: Ano
Typ a omezení: Nabízená doména, která má být stažena z prodeje, např. example.com, 3–253 znaků.
Parametr: confirmationToken
Povinné: Ne
Typ a omezení: Řetězec, 1–4096 znaků. Token vrácený předchozím voláním marketplace_listing_delete pro tuto doménu. Při prvním volání vynechte; znovu jej odešlete beze změny spolu s confirmationResponse.
Parametr: confirmationResponse
Povinné: Podmíněně
Typ a omezení: "accept" nebo "decline". Má význam pouze spolu s platným confirmationToken. "accept" odebere nabídku; "decline" ji zruší. Při prvním volání vynechte.

Vrací — po prvním volání (nic se nezměnilo):

{
"status": "confirmation_required",
"confirmationToken": "eyJ2IjoxLCJ0IjoibWFya2V0cGxhY2UifQ.c2lnbmF0dXJl",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_listing_delete again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"confirmation": {
"domain": "brightharbor.com",
"activeNegotiations": 2,
"effect": "The domain is taken off sale. Its active negotiations are suspended and SafePay deals the seller opened for it are deactivated. This cannot be undone; listing the domain again starts a new listing."
}
}

Po potvrzeném volání:

{ "status": "removed", "domain": "brightharbor.com", "note": "The listing was removed from sale." }

status: confirmation_required
Význam: Nic se nezměnilo; potvrďte pomocí vráceného confirmationToken.
status: cancelled
Význam: Odmítnuto; nic se nezměnilo. Obsahuje také domain a note.
status: removed
Význam: Nabídka byla stažena z prodeje.

`marketplace_listing_verify` — Ověření vlastnictví domény nabídky

Přístup: Zápis.

Spustí nyní kontrolu vlastnictví pro jednu z nabídek vašeho účtu, která čeká na ověření (stav verifying). Odpověď přijde v rámci volání a uvede, zda byla kontrola spuštěna, spolu s aktuálním stavem nabídky; samotná kontrola běží na pozadí, proto nabídku načtěte později pomocí marketplace_listing_get — stav přestane být verifying, jakmile kontrola projde. DNS záznamy, které je třeba zveřejnit u poskytovatele DNS domény, jsou uvedeny v záznamech ověření v marketplace_seller_settings_get.

Nabídka, která nečeká na ověření, je běžný výsledek: odpověď vrátí její stav a checkStarted: false a žádná kontrola se nespustí. Doména, kterou váš účet nezařadil do nabídky, vrátí business.notFound. Volání lze kdykoli opakovat.

Parametr: domain
Povinné: Ano
Typ a omezení: Nabízená doména, jejíž vlastnictví se má nyní ověřit, např. example.com, 3–253 znaků.

Vrací

{
"domain": "northpeak.io",
"status": "verifying",
"checkStarted": true,
"note": "An ownership check of this domain was started. It runs in the background; read the listing with marketplace_listing_get later: the status leaves \"verifying\" once the check passes. If it does not, make sure the DNS records listed under verification records by marketplace_seller_settings_get are published at the domain's DNS provider."
}

checkStarted je false buď tehdy, když nabídka nečeká na ověření (pak status není verifying), nebo když nabídka na ověření čeká, ale kontrolu nyní nebylo možné spustit; note uvádí, co z toho platí, a ve druhém případě to zkuste znovu později.

`marketplace_listings_bulk_verify` — Ověření vlastnictví všech neověřených nabídek

Přístup: Zápis.

Spustí nyní kontrolu vlastnictví pro každou nabídku vašeho účtu, která čeká na ověření (stav verifying). Odpověď přijde v rámci volání s listingsChecked, počtem nabídek, pro které byla kontrola spuštěna; kontroly běží na pozadí, proto nabídky načtěte později pomocí marketplace_listings_list filtrovaného podle stavu verifying, abyste viděli, které prošly. Když žádná nabídka nečeká na ověření, listingsChecked je 0 a nic se nespustí; to není chyba. DNS záznamy, které je třeba zveřejnit, jsou uvedeny v záznamech ověření v marketplace_seller_settings_get. Volání lze kdykoli opakovat.

Žádné parametry.

Vrací

{
"listingsChecked": 3,
"note": "Ownership checks were started for the listings waiting for verification. They run in the background; read the listings with marketplace_listings_list (status \"verifying\") later to see which passed."
}

Marketplace: nastavení prodejce, přehledy, prodeje a odkazy na checkout

Nastavení prodejce pro celý účet, statistiky portfolia, prodané domény a odkazy na checkout „buy now“, které sdílíte s kupujícími.

`marketplace_seller_settings_get` — Získání nastavení prodejce

Přístup: Čtení.

Načte nastavení prodejce vašeho účtu v jedné odpovědi: veřejnou stránku portfolia, nastavení Quality Offer pro celý účet, vaše výplatní metody a DNS záznamy, které prokazují vlastnictví domény registrované jinde. portfolio a qualityOffer jsou null, pokud nikdy nebyly nastaveny; to je běžný výsledek, nikoli chyba.

Čtyři části se načítají souběžně v rámci jednoho časového limitu. Část, kterou se nepodařilo načíst včas, je null a je uvedena v unavailable (portfolio, quality_offer, payout_methods nebo verification), a části, které načteny byly, se přesto vrátí; unavailable se vynechá, pokud byla načtena každá část. Když se včas nepodaří načíst žádná část, volání selže s infrastructure.serviceUnavailable ("Marketplace neodpověděl včas.").

Výplatní metody jsou maskované. Každá zobrazuje pouze metodu, částečně skrytý účet a to, zda je výchozí a aktivní: adresa PayPal zachová svůj první znak a svou doménu (s***@example.com), bitcoinová adresa nebo bankovní účet (IBAN nebo číslo účtu) zachová pouze poslední čtyři znaky (****6789). Žádný jiný detail výplaty se nikdy nevrací. Výplatní metody jsou zde jen pro čtení; mění se ve vašem účtu Spaceship.

Žádné parametry.

Vrací

{
"portfolio": {
"visibility": true,
"nickname": "Greatest Domains",
"description": "Premium names",
"slug": "greatest-domains",
"displayMode": "all",
"url": "https://www.spaceship.com/domains/portfolio/greatest-domains"
},
"qualityOffer": {
"requirement": "mandatory_for_countries",
"depositAmount": 25,
"countries": ["US", "CA"],
"otherCountriesMode": "keep_disabled"
},
"payoutMethods": [
{ "method": "paypal", "account": "s***@example.com", "isDefault": true, "isActive": true },
{ "method": "wire_transfer", "account": "****6789", "isDefault": false, "isActive": true }
],
"verification": {
"options": [
{ "records": [{ "type": "TXT", "name": "@", "value": "spaceship-verification=abc123" }] }
]
}
}

Pole: portfolio
Význam: Stránka portfolia nebo null. description se vynechá, když je prázdné. displayMode je all (každá nabízená doména) nebo selected (pouze domény vybrané pro stránku). url je odkaz na veřejnou stránku.
Pole: qualityOffer
Význam: Nastavení Quality Offer pro celý účet nebo null. requirement je disabled, optional, mandatory nebo mandatory_for_countries. depositAmount je v celých amerických dolarech a vynechá se, když je požadavek disabled. countries a otherCountriesMode (keep_disabled nebo make_optional) platí pro mandatory_for_countries.
Pole: payoutMethods
Význam: Maskované výplatní metody: method (paypal, bitcoin nebo wire_transfer), account (maskovaný; vynechá se, pokud jej nelze zobrazit maskovaně), isDefault, isActive. null, pokud je nebylo možné načíst včas.
Pole: verification.options
Význam: Alternativní sady DNS záznamů; přidání záznamů jedné možnosti u DNS hostitele domény prokazuje vlastnictví domény registrované jinde. verification je null, pokud ji nebylo možné načíst včas.
Pole: unavailable
Význam: Pouze když se část nepodařilo načíst včas: části, které jsou z tohoto důvodu null.

`marketplace_seller_settings_update` — Aktualizace nastavení prodejce

Přístup: Citlivý zápis — nahrazuje nastavení Quality Offer pro celý účet jako celek.

Změní veřejnou stránku portfolia, nastavení Quality Offer pro celý účet nebo obojí. Odešlete alespoň jedno z portfolio a qualityOffer. U stránky portfolia se mění pouze pole, která odešlete; při prvním nastavení stránky jsou všechna visibility, nickname a slug povinná, jinak volání selže s business.invalidArgument a nic se neuloží. Slug se nastavuje pouze tehdy: slug (adresa) existující stránky nelze změnit a jiný slug selže s business.invalidArgument ("Slug (adresa) existující stránky portfolia nelze změnit.") a nic se neuloží, protože odkazy na stránku už byly sdíleny. U nové stránky se dostupnost slugu kontroluje před uložením čehokoli; obsazený, rezervovaný nebo neplatný slug selže s business.invalidArgument a nic se neuloží. Nastavení Quality Offer se nahrazuje jako celek, včetně seznamu zemí, a platí pro nabídky, které nemají vlastní. Výplatní metody zde změnit nelze.

Změna pouze portfolia se uloží okamžitě. Volání s qualityOffer má dva kroky. První volání načte aktuální nastavení, nic nezmění a vrátí status: "confirmation_required" s confirmationToken a confirmation obsahujícím aktuální nastavení (current, null, když není žádné aktivní), výsledné nastavení (resulting) a summary obou, které uvádí každou zemi, na kterou se záloha vztahuje před změnou i po ní, a země, které vypadnou. Druhé volání se stejnými portfolio a qualityOffer, tímto tokenem a confirmationResponse: "accept" uloží změny; "decline" nic neuloží a vrátí status: "cancelled". Token je vázán na argumenty a na uložené nastavení: pokud se nastavení mezitím změnilo, druhé volání místo uložení vrátí nové confirmation_required.

Když jsou odeslány obě skupiny, nejprve se uloží stránka portfolia. Odpověď uvede každou skupinu jako saved, notSaved nebo unconfirmed: pokud je pak nastavení Quality Offer odmítnuto, volání přesto uspěje s portfolio v saved, quality_offer v notSaved a s note; pokud není jeho výsledek znám, quality_offer je v unconfirmed a note vás vyzve, abyste před dalším pokusem načetli nastavení. Pokud volání selže s infrastructure.serviceUnavailable, změna přesto mohla být uložena: před dalším uložením ji načtěte pomocí marketplace_seller_settings_get.

Před uložením čehokoli se aktuální nastavení načtou v rámci jednoho časového limitu. Pokud je nelze načíst včas, nic se neuloží: volání uspěje s prázdným saved, každou skupinou, kterou jste odeslali, v notSaved a s note.

Parametr: portfolio
Povinné: Podmíněně
Typ a omezení: Objekt; povinný, když je qualityOffer vynecháno. Musí změnit alespoň jedno pole.
Parametr: portfolio.visibility
Povinné: Podmíněně
Typ a omezení: Boolean: zda je stránka portfolia veřejná. Povinné při prvním nastavení stránky.
Parametr: portfolio.nickname
Povinné: Podmíněně
Typ a omezení: Řetězec, 1–50 znaků: zobrazovaný název na stránce. Povinné při prvním nastavení stránky.
Parametr: portfolio.description
Povinné: Ne
Typ a omezení: Řetězec, až 400 znaků, zobrazený na stránce. Prázdný řetězec jej vymaže.
Parametr: portfolio.slug
Povinné: Podmíněně
Typ a omezení: Řetězec, 3–50 znaků: písmena, číslice a jednotlivé spojovníky, bez spojovníku na začátku nebo na konci. Před uložením se kontroluje dostupnost. Povinné při prvním nastavení stránky; slug existující stránky nelze změnit.
Parametr: portfolio.displayMode
Povinné: Ne
Typ a omezení: all (všechny uvedené domény) nebo selected (pouze domény vybrané pro stránku).
Parametr: qualityOffer
Povinné: Podmíněně
Typ a omezení: Objekt; povinný, když je portfolio vynecháno. Nahrazuje celé nastavení pro celý účet.
Parametr: qualityOffer.requirement
Povinné: Ano (v qualityOffer)
Typ a omezení: disabled, optional, mandatory nebo mandatory_for_countries (záloha pouze ze zemí v seznamu).
Parametr: qualityOffer.depositAmount
Povinné: Podmíněně
Typ a omezení: Celé číslo, 10–50, celé americké dolary. Povinné, pokud requirement není disabled, a není povoleno s disabled.
Parametr: qualityOffer.countries
Povinné: Podmíněně
Typ a omezení: 1–250 dvoupísmenných kódů zemí ISO 3166-1 alpha-2, bez opakování. Povinné s mandatory_for_countries a povolené pouze s ním.
Parametr: qualityOffer.otherCountriesMode
Povinné: Podmíněně
Typ a omezení: keep_disabled (žádná záloha pro ostatní země) nebo make_optional. Povinné s mandatory_for_countries a povolené pouze s ním.
Parametr: confirmationToken
Povinné: Ne
Typ a omezení: Řetězec, až 4096 znaků. Token z předchozího volání s qualityOffer a stejnými argumenty. Při prvním volání vynechte. Po krátké době vyprší.
Parametr: confirmationResponse
Povinné: Ne
Typ a omezení: accept nebo decline; má význam pouze s platným confirmationToken.

Vrací — při prvním volání s qualityOffer potvrzení:

{
"status": "confirmation_required",
"confirmationToken": "<opaque token>",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_seller_settings_update again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"confirmation": {
"summary": "Replace the account-wide Quality Offer setting? Now: buyers in US, CA pay a $25 Quality Offer deposit with an offer, and buyers from every other country pay no deposit. After saving: buyers in UA pay a $25 Quality Offer deposit with an offer, and buyers from every other country pay no deposit. Buyers in US, CA will no longer be asked for the deposit. The setting applies to listings that do not have their own Quality Offer setting.",
"current": { "requirement": "mandatory_for_countries", "depositAmount": 25, "countries": ["US", "CA"], "otherCountriesMode": "keep_disabled" },
"resulting": { "requirement": "mandatory_for_countries", "depositAmount": 25, "countries": ["UA"], "otherCountriesMode": "keep_disabled" }
}
}

Po uložení (nebo při změně pouze portfolia) skupiny podle výsledku plus uložené hodnoty každé uložené skupiny:

{
"saved": ["portfolio", "quality_offer"],
"notSaved": [],
"unconfirmed": [],
"portfolio": {
"visibility": true,
"nickname": "Greatest Domains",
"description": "Premium names",
"slug": "greatest-domains",
"displayMode": "all",
"url": "https://www.spaceship.com/domains/portfolio/greatest-domains"
},
"qualityOffer": { "requirement": "mandatory", "depositAmount": 50 }
}

Když byla stránka portfolia uložena, ale nastavení Quality Offer bylo zamítnuto:

{
"saved": ["portfolio"],
"notSaved": ["quality_offer"],
"unconfirmed": [],
"portfolio": { "visibility": false, "nickname": "Greatest Domains", "slug": "greatest-domains", "displayMode": "all", "url": "https://www.spaceship.com/domains/portfolio/greatest-domains" },
"note": "The portfolio page was saved. The Quality Offer setting was rejected and is unchanged."
}

Když se nepodařilo včas načíst aktuální nastavení:

{
"saved": [],
"notSaved": ["portfolio", "quality_offer"],
"unconfirmed": [],
"note": "The current seller settings could not be read in time, so nothing was saved."
}

`marketplace_insights_get` — Získat přehledy prodejce

Přístup: Čtení.

Ukazuje, jak si vede vaše portfolio prodejce, v jedné odpovědi: stav portfolia, vyjednávání a obchody SafePay podle stavu, prodeje podle zdroje a země, návštěvnost, tržby a výplaty (za celou dobu a za posledních 30 dní), plus vaše nejlepší domény seřazené podle zobrazení, návštěv nebo vyhledávání mezi nabídkami, které SellerHub Dashboard započítává do návštěvnosti: na prodej, ověřování, zpracování prodeje a čekání na převod (zastavený prodej, soukromý prodej, pronajaté, prodané a neúspěšné nabídky jsou vynechány). Údaje vypočítává tržiště Spaceship a mohou mít malé zpoždění oproti živé aktivitě. Portfolio bez aktivity vrací nulové počty a prázdný seznam top domén. Top domény se načítají vedle ostatních údajů v krátkém časovém limitu; když se je nepodaří načíst včas, topDomains je null, unavailable je ["top_domains"] a ostatní údaje jsou přesto vráceny.

Parametr: topBy
Povinné: Ne
Typ a omezení: views (zobrazení stránky), visits nebo searches, za celou dobu, od nejvyššího. Výchozí visits.
Parametr: topCount
Povinné: Ne
Typ a omezení: Celé číslo, 1–50: kolik top domén vrátit. Výchozí hodnota 10.

Vrací

{
"portfolio": {
"total": 40, "listed": 30, "onLease": 2, "pendingVerification": 1,
"withoutPrices": 4, "expiringSoon": 3, "notListed": 10, "asOf": "2026-10-26T06:00:00.000Z"
},
"negotiations": { "total": 12, "inNegotiation": 7, "agreedOrInTransfer": 2, "contactRequests": 2, "cancelledOrPaused": 1 },
"safePay": { "awaitingPayment": 1, "pendingConfirmation": 0 },
"sales": {
"total": 3,
"bySource": [{ "key": "forSalePage", "count": 2 }],
"byCountry": [{ "key": "US", "count": 3 }]
},
"traffic": { "totalViews": "5400", "totalSearches": "320", "viewsBySource": [{ "key": "search", "count": "4100" }] },
"financials": {
"revenue": { "allTime": { "amount": "15000.00", "currency": "USD" }, "last30Days": { "amount": "2500.00", "currency": "USD" } },
"payout": { "allTime": { "amount": "14250.00", "currency": "USD" }, "last30Days": { "amount": "2375.00", "currency": "USD" } },
"sold": { "allTime": 3, "last30Days": 1 }
},
"topDomains": {
"sortedBy": "views",
"total": 1,
"items": [{
"domain": "greatdomain.com", "external": false,
"views": "900", "visits": "300", "searches": "30",
"viewsToday": "12", "visitsToday": "4", "searchesToday": "1"
}]
}
}

Pole: portfolio
Význam: Počty domén podle stavu. asOf je čas, kdy byly počty naposledy vypočteny, nebo null.
Pole: negotiations
Význam: Nabídky a vyjednávání podle stavu: inNegotiation; agreedOrInTransfer, každé vyjednávání po dosažení dohody (dohoda dosažena, zaplaceno nebo se doména převádí), takže to není počet vyjednávání ve stavu agreement_reached; contactRequests; cancelledOrPaused.
Pole: safePay
Význam: Obchody SafePay čekající na platbu nebo na potvrzení.
Pole: sales
Význam: Počet prodejů podle zdroje a podle země, každý jako { key, count }.
Pole: traffic
Význam: Zobrazení a vyhledávání za celou dobu a zobrazení podle zdroje. Velká počitadla se vracejí jako řetězce.
Pole: financials
Význam: Tržby a výplata jako { amount, currency } za celou dobu a za posledních 30 dní a počet prodaných domén.
Pole: topDomains
Význam: Použité řazení (sortedBy), počet domén, které zahrnuje (total), a až topCount domén se zobrazeními, návštěvami a vyhledáváními za celou dobu i za dnešek. external je true pro doménu registrovanou jinde. null, když se top domény nepodařilo načíst včas.
Pole: unavailable
Význam: Pouze když se top domény nepodařilo načíst včas: ["top_domains"].

`marketplace_sales_list` — Vypsat prodané domény

Přístup: Čtení.

Vypíše domény, které jste prodali: doménu, kdy byla prodána, prodejní cenu, vaši výplatu po odečtení poplatku tržiště a kanál, přes který prodej proběhl. Seznam můžete omezit na časový rozsah prodeje. Rozsah bez prodejů vrátí prázdný seznam, nikoli chybu; rozsah, jehož konec není později než začátek, selže s application.request.badRequest.

Seznam je stránkován pomocí kurzoru: předejte nextCursor z jedné stránky jako cursor pro získání další. Stránka bez nextCursor je poslední.

Parametr: soldFrom
Povinné: Ne
Typ a omezení: Datum a čas ISO 8601 s časovým pásmem, například soldFrom: "2026-01-01T00:00:00Z". Pouze prodeje v tomto okamžiku nebo po něm.
Parametr: soldTo
Povinné: Ne
Typ a omezení: Datum a čas ISO 8601 s časovým pásmem. Pouze prodeje před tímto okamžikem (bez něj). Musí být později než soldFrom.
Parametr: take
Povinné: Ne
Typ a omezení: Celé číslo, 1–100: prodejů na stránku. Výchozí hodnota 50.
Parametr: cursor
Povinné: Ne
Typ a omezení: Řetězec, 1–2048 znaků: nextCursor z předchozí stránky. Pro první stránku vynechte.

Vrací

{
"items": [
{
"domain": "greatdomain.com",
"soldAt": "2026-09-30T12:00:00.000Z",
"price": { "amount": "2500.00", "currency": "USD" },
"payout": { "amount": "2375.00", "currency": "USD" },
"channel": "forSalePage"
}
],
"nextCursor": "eyJwYWdlIjoyfQ"
}

soldAt může být null, když čas prodeje není zaznamenán. Pokud v rozsahu nejsou žádné prodeje, odpověď je { "items": [] }.

`marketplace_checkout_links_list` — Vypsat checkout odkazy

Přístup: Čtení.

Vypíše vaše checkout odkazy: doménu, typ odkazu, jeho stav, URL odkazu, cenu, co kupující platí a co obdržíte vy, rozdělení poplatků a kdy odkaz přestane fungovat. Můžete filtrovat podle domény; filtr odpovídá části názvu. Filtr, který neodpovídá ničemu, vrátí prázdný seznam s total 0, nikoli chybu.

Seznam je stránkován pomocí take a skip; total je počet odkazů, které odpovídají filtru.

Parametr: domain
Povinné: Ne
Typ a omezení: Řetězec, 1–255 znaků. Pouze odkazy, jejichž název domény obsahuje tento text.
Parametr: take
Povinné: Ne
Typ a omezení: Celé číslo, 1–100: odkazů na stránku. Výchozí hodnota 50.
Parametr: skip
Povinné: Ne
Typ a omezení: Celé číslo, 0 nebo více: odkazy, které se mají před stránkou přeskočit. Výchozí hodnota 0.

Vrací

{
"items": [
{
"domain": "greatdomain.com",
"type": "buy_now",
"status": "active",
"checkoutUrl": "https://www.spaceship.com/s/buy/ab12cd34ef56gh78",
"price": { "amount": "2500.00", "currency": "USD" },
"buyerPays": { "amount": "2500.00", "currency": "USD" },
"sellerReceives": { "amount": "2375.00", "currency": "USD" },
"sellerFeeShare": 100,
"buyerFeeShare": 0,
"validTill": "2026-11-01T00:00:00.000Z",
"createdAt": "2026-10-25T10:00:00.000Z"
}
],
"total": 1
}

Pole: type
Význam: buy_now, lease_to_own nebo make_offer; unknown pro typ, který zde není uveden.
Pole: status
Význam: active, expired, deactivated nebo purchased; unknown pro stav, který zde není uveden. Ke koupi lze použít pouze active odkaz.
Pole: price / leaseToOwnTotal
Význam: Cena odkazu a u odkazu lease-to-own celková částka k zaplacení. Každá z nich je vynechána, pokud není nastavena.
Pole: buyerPays / sellerReceives
Význam: Co kupující zaplatí a co obdržíte vy po odečtení poplatku tržiště. Pokud není k dispozici, je vynecháno.
Pole: sellerFeeShare / buyerFeeShare
Význam: Procento poplatku tržiště placené vámi a kupujícím.
Pole: validTill / createdAt
Význam: Kdy odkaz přestane fungovat a kdy byl vytvořen.

`marketplace_checkout_link_create` — Vytvořit checkout odkaz

Přístup: Citlivý zápis — kdokoli, kdo má odkaz, může po dobu 7 dní koupit doménu.

Vytvoří sdílitelný checkout odkaz „koupit nyní“ pro jednu z vašich domén, která je uvedena k prodeji. Odkaz je platný 7 dní a není vázán na kupujícího: kdokoli, kdo ho má, může koupit doménu za její cenu. Asistent proto vytvoří odkaz až poté, co souhlasíte s jeho cenou a rozdělením poplatků: když o odkaz požádáte bez uvedení obojího, nejprve načte nabídku a sdělí vám podmínky, které by odkaz nesl. Bez price se použije vlastní cena nabídky pro okamžitý nákup; bez sellerFeeShare platíte celý poplatek tržiště. Doména, která není jednou z vašich nabídek, selže s business.notFound. Cena musí být alespoň 100 USD; nižší cena selže s business.invalidArgument ("The minimum checkout link price is 100 USD.") a nic se nevytvoří. Odkaz je odmítnut s business.conflict a větou uvádějící důvod, když vaše nabídka ještě není na prodej (například se stále ověřuje její vlastnictví) nebo když má doména dohodnutý obchod s kupujícím, je ve vyjednávání nebo prostřednictvím potvrzeného obchodu SafePay.

Každé volání vytvoří nový odkaz a ponechá dřívější odkazy aktivní, takže opakování volání vám dá druhý odkaz. Pokud volání selže s infrastructure.serviceUnavailable, odkaz už přesto mohl být vytvořen: před vytvořením dalšího ho vyhledejte pomocí marketplace_checkout_links_list.

Parametr: domain
Povinné: Ano
Typ a omezení: Řetězec, 4–255 znaků, Unicode nebo ASCII. Jedna z vašich nabídek, která je na prodej.
Parametr: price.amount
Povinné: Podmíněně
Typ a omezení: Povinné, když je odesláno price. Kladná desetinná částka s nejvýše dvěma desetinnými místy, například "2500.00".
Parametr: price.currency
Povinné: Podmíněně
Typ a omezení: Povinné, když je odesláno price. Třípísmenný kód měny; podporováno je pouze USD.
Parametr: sellerFeeShare
Povinné: Ne
Typ a omezení: 0, 25, 50, 75 nebo 100: procento poplatku tržiště, které platíte vy; kupující platí zbytek. Výchozí: platíte vše.

Vrací — doménu (v ASCII podobě), odkaz a kdy přestane fungovat:

{
"domain": "greatdomain.com",
"checkoutUrl": "https://www.spaceship.com/s/buy/zz99yy88xx77ww66",
"validTill": "2026-11-02T00:00:00.000Z"
}

`marketplace_checkout_link_deactivate` — Deaktivovat checkout odkaz

Přístup: Citlivý zápis — trvale deaktivuje odkaz.

Deaktivuje jeden z vašich aktivních checkout odkazů nalezený podle jeho URL. Poté přes něj už nikdo nemůže nakoupit a to nelze vrátit zpět: chcete-li znovu prodávat přes odkaz, vytvořte nový. Nástroj sám vyžaduje potvrzení. První volání nic nezmění a vrátí confirmation_required s tím, co se má stát, a krátkodobým confirmationToken; ukažte to uživateli a jakmile souhlasí, zavolejte znovu se stejnými argumenty, tokenem a confirmationResponseaccept. decline vrátí cancelled a nic nezmění. Token, který vypršel, byl vydán pro jiné argumenty nebo už neodpovídá odkazu (například se změnila jeho platnost), místo deaktivace vrátí nové confirmation_required.

Odkaz, který není mezi vašimi checkout odkazy, vrátí business.notFound, stejně jako odkaz, který neexistuje. Odkaz, který už není aktivní (vypršel, byl deaktivován nebo zakoupen), selže s business.conflict. URL, které není URL checkout odkazu, selže s business.invalidArgument. Ve velmi dlouhém seznamu nemusí být odkaz nalezen včas; volání pak vrátí statuslookup_incomplete s deactivated: false a note a nic se nezmění. Předání domain odkazu zúží hledání na odkazy této domény. Pokud volání po infrastructure.serviceUnavailable po accept selže, odkaz už může být deaktivován: před dalším pokusem ho zkontrolujte pomocí marketplace_checkout_links_list.

Parametr: checkoutUrl
Povinné: Ano
Typ a omezení: Řetězec, 1–2048 znaků: URL checkout odkazu, jak je uvedeno v marketplace_checkout_links_list.
Parametr: domain
Povinné: Ne
Typ a omezení: Řetězec, 1–255 znaků: doména odkazu, aby bylo možné odkaz rychleji najít v dlouhém seznamu.
Parametr: confirmationToken
Povinné: Podmíněně
Typ & omezení: Řetězec, až 4096 znaků. Při prvním volání vynechte; při druhém volání pošlete token z odpovědi confirmation_required beze změny. Po krátké době vyprší.
Parametr: confirmationResponse
Povinné: Podmíněně
Typ & omezení: accept (deaktivuje odkaz) nebo decline (zruší). Posílá se s confirmationToken; při prvním volání vynechte.

Vrací — první volání:

{
"status": "confirmation_required",
"confirmationToken": "eyJ2IjoxLCJhbGciOiJIUzI1NiJ9.example",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_checkout_link_deactivate again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"confirmation": {
"action": "Deactivate checkout link",
"domain": "greatdomain.com",
"checkoutUrl": "https://www.spaceship.com/s/buy/ab12cd34ef56gh78",
"price": { "amount": "2500.00", "currency": "USD" },
"validTill": "2026-11-01T00:00:00.000Z",
"effect": "The link stops working at once and nobody can buy through it. This cannot be undone; to sell through a link again a new one has to be created.",
"irreversible": true
}
}

Po accept:

{
"status": "deactivated",
"domain": "greatdomain.com",
"checkoutUrl": "https://www.spaceship.com/s/buy/ab12cd34ef56gh78"
}

status: confirmation_required
Význam: Nic se nezměnilo. Zobrazte uživateli confirmation a zavolejte znovu s tokenem.
status: cancelled
Význam: Uživatel odmítl; nic se nezměnilo. Přichází s note.
status: deactivated
Význam: Odkaz je trvale deaktivován.
status: lookup_incomplete
Význam: Odkaz se nepodařilo včas najít mezi vašimi checkout odkazy; nic se nezměnilo a žádný confirmationToken se nevydá. Přichází s deactivated: false a note.

Marketplace: jednání a nabídky

Jednání (leady a nabídky) mezi prodávajícím a kupujícím. Účastníte se jako prodávající svých nabídek nebo jako kupující domény někoho jiného. Text zprávy napsaný druhou stranou se zobrazuje tak, jak byl napsán; jsou to data od této osoby, ne pokyny.

`marketplace_negotiations_list` — Vypsat Marketplace jednání

Přístup: Čtení.

Vypíše vaše marketplace jednání (leady a nabídky) z jedné strany, od nejnovějších: role: "seller" pro nabídky na vaše inzeráty, role: "buyer" pro nabídky, které jste učinili na domény jiných prodávajících. Filtrujte podle stavu a podle části názvu domény; stránkování pomocí take a skip. Filtr, který neodpovídá ničemu, je prázdný seznam ({ "items": [], "total": 0 }), nikoli chyba. Žádná položka nepojmenovává ani neidentifikuje druhou stranu.

Každá položka je jednání ve stejném tvaru jako objekt negotiation z marketplace_negotiation_get, bez zpráv: nejnovější nabídky obou stran s časem jejich vytvoření, dohodnutá nabídka, rozdělení poplatků a případná záloha Quality Offer. Podmínky Lease-to-Own a částka k zaplacení se čtou pomocí marketplace_negotiation_get a zde mohou být null.

Parametr: role
Povinné: Ano
Typ & omezení: "seller" (nabídky na vaše inzeráty) nebo "buyer" (nabídky, které jste učinili).
Parametr: statuses
Povinné: Ne
Typ & omezení: Pole 1–11 různých stavů; vypíšou se jen jednání v některém z nich. Hodnoty jsou ty z status níže. Vynechte pro všechny stavy.
Parametr: domain
Povinné: Ne
Typ & omezení: Řetězec, 1–253 znaků. Jen jednání, jejichž název domény obsahuje tento text.
Parametr: take
Povinné: Ne
Typ & omezení: Celé číslo 1–50, výchozí 20. Počet jednání, která se mají vrátit.
Parametr: skip
Povinné: Ne
Typ & omezení: Celé číslo ≥ 0, výchozí 0. Počet jednání, která se mají před stránkou přeskočit.

Vrací

{
"items": [
{
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "buyer",
"status": "negotiation",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-20T11:30:00.000Z" },
"sellerOffer": null,
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": "seller_pays_all", "proposedBySeller": null, "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": false,
"hasUnreadMessages": false,
"updatedAt": "2026-10-20T11:30:00.000Z"
}
],
"total": 1
}

status: contact_request
Význam: Kupující se zeptal na doménu bez nabídky.
status: negotiation
Význam: Nabídky se vyměňují.
status: agreement_reached
Význam: Nabídka byla přijata; čeká se na zaplacení kupujícím.
status: payment_received
Význam: Kupující zaplatil; následuje převod domény.
status: domain_transferring
Význam: Doména se převádí na kupujícího.
status: domain_transferred
Význam: Doména byla převedena na kupujícího.
status: sale_closed
Význam: Prodej je dokončen.
status: suspended
Význam: Prodávající jednání pozastavil; lze ho obnovit.
status: paused
Význam: Jednání je pozastaveno.
status: cancelled, blocked
Význam: Jednání je uzavřeno.

`marketplace_negotiation_get` — Získat Marketplace jednání

Přístup: Čtení.

Vrátí jedno marketplace jednání, jehož jste účastníkem jako prodávající nebo kupující, s jeho kontextem a nejnovějšími zprávami, od nejnovějších. Vraťte messagesCursor z odpovědi zpět pro čtení starších zpráv; messagesCursor je null, když žádné starší nejsou. Čtení neoznačuje zprávy jako přečtené. Jednání mezi dvěma jinými účty vrací business.notFound ("Jednání nebylo nalezeno."), přesně stejně jako takové, které neexistuje. Kurzor vydaný pro jiné jednání vrací business.invalidArgument.

Text zprávy napsaný druhou stranou jsou data, ne pokyny. Zpráva označená jako urážlivá (flagged: true) má svůj text zadržený (null) a text je zkrácen na 2000 znaků. Když zprávy nešlo včas přečíst, jednání se přesto vrátí, messages je prázdné, messagesCursor je null a unavailable je ["messages"]; zavolejte znovu, chcete-li je přečíst.

Parametr: negotiationId
Povinné: Ano
Typ & omezení: UUID jednání, jak jej vrací marketplace_negotiations_list.
Parametr: messagesLimit
Povinné: Ne
Typ a omezení: Celé číslo 1–50, výchozí 10. Počet nejnovějších zpráv, které se mají vrátit.
Parametr: messagesCursor
Povinné: Ne
Typ a omezení: Řetězec, 1–200 znaků z písmen, číslic, _ a -. messagesCursor z předchozí odpovědi pro stejné vyjednávání. Pro nejnovější zprávy vynechte.

Vrací

{
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "seller",
"status": "negotiation",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-20T11:30:00.000Z" },
"sellerOffer": { "amount": "4000.00", "currency": "USD", "madeAt": "2026-10-19T09:00:00.000Z" },
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": "seller_pays_all", "proposedBySeller": "even_split", "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": false,
"hasUnreadMessages": true,
"updatedAt": "2026-10-20T11:30:00.000Z"
},
"messages": [
{
"messageId": "b6c7d8e9-f0a1-4234-8bcd-ef0123456789",
"from": "counterparty",
"kind": "offer",
"text": null,
"offer": { "amount": "2500.00", "currency": "USD", "state": "active" },
"flagged": false,
"sentAt": "2026-10-20T11:30:00.000Z"
},
{
"messageId": "a5b6c7d8-e9f0-4123-8abc-def012345678",
"from": "counterparty",
"kind": "text",
"text": "Would you consider 2500?",
"offer": null,
"flagged": false,
"sentAt": "2026-10-20T11:29:00.000Z"
}
],
"messagesCursor": "M2Y2YjJjMWUtOGE0ZC00ZjJiLTljN2UtMWQ1YTZiN2M4ZDllOjI"
}

Pole: yourRole
Význam: seller nebo buyer: vaše strana v tomto vyjednávání.
Pole: buyerOffer, sellerOffer
Význam: Nejnovější nabídka každé strany s madeAt, časem jejího vytvoření, nebo null. declinedBuyerOffer je nabídka kupujícího, kterou prodávající odmítl jako poslední.
Pole: acceptedOffer
Význam: Nabídka, na které bylo dosaženo dohody, nebo null.
Pole: leaseToOwn
Význam: Podmínky Lease-to-Own od prodávajícího: total, downPayment, finalPayment, installment a počet installments; null, pokud žádné nejsou.
Pole: feeSplit
Význam: Kdo platí poplatek tržiště podle návrhu každé strany a podle dohody: seller_pays_all, seller_pays_most (75/25), even_split, buyer_pays_most (25/75), buyer_pays_all nebo null.
Pole: amountToPay
Význam: Co kupující po dohodě zaplatí nyní, pokud je to známo: u cenové dohody dohodnutou částku plus podíl kupujícího na poplatku; u dohody Lease-to-Own první platbu, což je akontace, nebo první splátku, pokud akontace není (celý leasing je leaseToOwn.total a platební stránka přidá případný podíl kupujícího na poplatku).
Pole: deposit
Význam: U Quality Offer stav zálohy state, amount (USD) a expiresAt; jinak null.
Pole: messages[].from
Význam: you, counterparty (druhá strana, pro její zprávy a její nabídky, protinabídky, odmítnutí, stažení a přijetí), support nebo system (událost, kterou nevytvořila žádná strana).
Pole: messages[].kind
Význam: text, offer, counter_offer, offer_accepted, offer_declined, offer_withdrawn, lease_to_own_proposal, blocked_by_moderation nebo event. Pouze zprávy typu text nesou text.
Pole: messages[].offer.state
Význam: active, declined, withdrawn, accepted nebo superseded.

Nástroje, které mění vyjednávání (marketplace_offer_make, marketplace_offer_counter, marketplace_offer_accept, marketplace_offer_decline, marketplace_offer_withdraw, marketplace_negotiation_suspend a marketplace_negotiation_restore) po změně znovu vracejí vyjednávání načtené ke čtení. Pokud toto načtení selže, změna přesto platí: odpověď vynechá leaseToOwn a amountToPay a přidá note; pro jejich zobrazení načtěte vyjednávání pomocí marketplace_negotiation_get.

`marketplace_negotiation_message_send` — Odeslat zprávu vyjednávání Marketplace

Přístup: Citlivý zápis — odeslanou zprávu nelze vzít zpět.

Odešle textovou zprávu druhé straně vyjednávání, jehož jste účastníkem, jako prodávající nebo kupující; druhá strana je upozorněna. Odpověď je status: "sent" se zprávou v uložené podobě. Když ji zastaví pravidla zpráv tržiště (například kontaktní údaje nebo platba mimo Spaceship), odpověď je běžný výsledek status: "blocked_by_moderation" s note: nic nebylo doručeno a zprávu je třeba před dalším odesláním přeformulovat.

Vyjednávání, jehož nejste stranou, vrací business.notFound, stejně jako takové, které neexistuje. Neúspěšné volání se automaticky neopakuje: načtěte vyjednávání pomocí marketplace_negotiation_get a ověřte, zda zpráva dorazila, než ji odešlete znovu.

Parametr: negotiationId
Povinné: Ano
Typ a omezení: UUID vyjednávání, jak jej vrací marketplace_negotiations_list nebo marketplace_negotiation_get.
Parametr: text
Povinné: Ano
Typ a omezení: Prostý text, 1–2000 znaků po oříznutí.

Vrací

{
"status": "sent",
"message": {
"messageId": "c7d8e9f0-a1b2-4345-9cde-f01234567890",
"from": "you",
"kind": "text",
"text": "The domain is still available.",
"offer": null,
"flagged": false,
"sentAt": "2026-10-26T10:15:00.000Z"
}
}

status: sent
Význam: Zpráva byla doručena; message je uložená zpráva.
status: blocked_by_moderation
Význam: Pravidla zpráv ji zastavila a nic nebylo doručeno; note to uvádí.

`marketplace_offer_make` — Vytvořit nabídku Marketplace

Přístup: Citlivý zápis — kupující nemůže nabídku stáhnout a prodávající ji může přijmout.

Vytvoří vaši nabídku jako kupujícího na doménu nabízenou k prodeji na tržišti Spaceship a otevře vyjednávání s prodávajícím, který je upozorněn. Pokud už o této doméně vyjednáváte, nabídka se přidá do tohoto vyjednávání. Odpovědí je vyjednávání se status: "offer_sent" nebo běžný výsledek status: "deposit_required" s note, když prodávající vyžaduje vratnou zálohu Quality Offer: nabídka se k prodávajícímu dostane, jakmile je na Spaceship zaplacena záloha uvedená v negotiation.deposit.

Doména, která není nabízena k prodeji, a vaše vlastní doména vrací business.notFound ("The domain is not listed for sale."). Neúspěšné volání se automaticky neopakuje: vypište svá vyjednávání pomocí marketplace_negotiations_list a role: "buyer" a ověřte, zda byla nabídka vytvořena, než ji odešlete znovu.

Parametr: domain
Povinné: Ano
Typ a omezení: Doména nabízená k prodeji, např. example.com. Název domény v ASCII, 3–253 znaků; porovnává se bez ohledu na velikost písmen.
Parametr: amount
Povinné: Ano
Typ a omezení: Vaše nabídka v amerických dolarech jako desetinný řetězec až se 2 desetinnými místy, např. "2500". Musí být větší než 0 a nejvýše 10,000,000.

Vrací — negotiation má podobu popsanou u marketplace_negotiation_get:

{
"status": "deposit_required",
"note": "The seller requires a refundable Quality Offer deposit for this domain. The offer reaches the seller once the deposit shown in `negotiation.deposit` is paid on Spaceship.",
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "buyer",
"status": "contact_request",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-26T10:15:00.000Z" },
"sellerOffer": null,
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": null, "proposedBySeller": null, "agreed": null },
"amountToPay": null,
"deposit": { "state": "charge_pending", "amount": { "amount": "250.00", "currency": "USD" }, "expiresAt": "2026-11-02T10:15:00.000Z" },
"isSuspended": false,
"hasUnreadMessages": false,
"updatedAt": "2026-10-26T10:15:00.000Z"
}
}

status: offer_sent
Význam: Nabídka byla vytvořena a prodávající byl upozorněn.
status: deposit_required
Význam: Nabídka čeká na zaplacení zálohy Quality Offer v negotiation.deposit.

`marketplace_offer_counter` — Protinabídka Marketplace

Přístup: Citlivý zápis — druhá strana ji může přijmout jako závaznou dohodu.

Vytvoří protinabídku ve vyjednávání, jehož jste účastníkem, jako prodávající nebo kupující: buď amount v amerických dolarech, nebo pouze jako prodávající podmínky Lease-to-Own v leaseToOwn; druhá strana je upozorněna. Volitelně navrhuje, kdo platí poplatek tržiště, pomocí feeSplit. Odpovědí je aktualizované vyjednávání. Celková částka Lease-to-Own je součet akontace, splátek a konečné platby.

Předání obou amount a leaseToOwn, nebo ani jednoho, je odmítnuto ještě před odesláním čehokoli. Podmínky Lease-to-Own od kupujícího vrací business.invalidArgument ("Only the seller can propose Lease-to-Own terms."). Vyjednávání, jehož nejste stranou, vrací business.notFound. Neúspěšné volání se automaticky neopakuje: načtěte vyjednávání pomocí marketplace_negotiation_get a ověřte, zda byla protinabídka vytvořena, než ji odešlete znovu.

Parametr: negotiationId
Povinné: Ano
Typ a omezení: UUID vyjednávání, jak jej vrací marketplace_negotiations_list nebo marketplace_negotiation_get.
Parametr: amount
Povinné: Podmíněně
Typ a omezení: Povinné, pokud není zadáno leaseToOwn; nikdy ne společně s ním. Desetinný řetězec v USD až se 2 desetinnými místy, větší než 0 a nejvýše 10,000,000.
Parametr: leaseToOwn
Povinné: Podmíněně
Typ a omezení: Pouze prodávající. Povinné, pokud není zadáno amount; nikdy ne společně s ním. Objekt s níže uvedenými poli.
Parametr: leaseToOwn.installmentAmount
Povinné: Ano (v leaseToOwn)
Typ a omezení: Částka každé měsíční splátky, desetinný řetězec v USD.
Parametr: leaseToOwn.installments
Povinné: Ano (v leaseToOwn)
Typ a omezení: Celé číslo 1–120; bez downPayment alespoň 2.
Parametr: leaseToOwn.downPayment
Povinné: Ne
Typ a omezení: Akontace, placená jako první, desetinný řetězec v USD. Pokud není, vynechte.
Parametr: leaseToOwn.finalPayment
Povinné: Ne
Typ a omezení: Konečná platba, placená jako poslední, desetinný řetězec v USD. Pokud není, vynechte.
Parametr: feeSplit
Povinné: Ne
Typ a omezení: seller_pays_all, seller_pays_most (75/25), even_split, buyer_pays_most (25/75) nebo buyer_pays_all. Vynechte pro zachování aktuálního rozdělení.

Vrací — { "negotiation": { ... } }, vyjednávání ve tvaru popsaném u marketplace_negotiation_get, s vaší novou nabídkou v buyerOffer nebo sellerOffer:

`marketplace_offer_accept` — Přijmout nabídku Marketplace

Přístup: Citlivý zápis — vede k závazné dohodě, kterou nelze vzít zpět.

Přijme nejnovější nabídku druhé strany ve vyjednávání, jehož jste účastníkem: jako prodávající nejnovější nabídku kupujícího; jako kupující návrh Lease-to-Own od prodávajícího, pokud existuje, jinak nejnovější protinabídku prodávajícího. Tím se uzavírá závazná dohoda a nelze ji vzít zpět. Přijmout lze pouze nabídku, kterou druhá strana učinila po vašem posledním kroku: pokud máte jako prodávající vlastní čekající protinabídku nebo návrh Lease-to-Own, nejprve jej stáhněte pomocí marketplace_offer_withdraw. Nástroj to za vás nestáhne; přijetí odeslané v době, kdy je vaším krokem ten poslední, vrací business.conflict ("There is no offer from the other side that can be accepted now.") a nic nemění.

Dvoufázové potvrzení. První volání nic nemění a vrací status: "confirmation_required" s confirmation (větou summary, domain a offer) a confirmationToken. Zobrazte shrnutí uživateli a jakmile souhlasí, zavolejte znovu se stejným negotiationId, tokenem a confirmationResponse: "accept"; "decline" vrací status: "cancelled" a nic nemění. Token, který vypršel, patří jinému účtu nebo byl vydán pro nabídku, která se od té doby změnila, vrátí místo přijetí nové confirmation_required. Když druhá strana nemá žádnou nabídku k přijetí, odpověď je business.conflict ("There is no offer from the other side to accept."); vyjednávání, jehož nejste stranou, vrací business.notFound.

Když není výsledek znám, odpověď je infrastructure.outcomeUnknown: dohoda mohla, ale nemusela být uzavřena. Volání neopakujte: nejprve načtěte vyjednávání pomocí marketplace_negotiation_get a ověřte, zda byla dohoda uzavřena.

Parametr: negotiationId
Povinné: Ano
Typ a omezení: UUID vyjednávání, jak jej vrací marketplace_negotiations_list nebo marketplace_negotiation_get.
Parametr: confirmationToken
Povinné: Ne
Typ a omezení: Řetězec až do 4096 znaků. Token z předchozího volání marketplace_offer_accept pro toto vyjednávání. Při prvním volání vynechte. Po krátké době vyprší a je vázán na nabídku, pro kterou byl vydán.
Parametr: confirmationResponse
Povinné: Podmíněně
Typ a omezení: "accept" nebo "decline". Má význam pouze s platným confirmationToken: "accept" přijme nabídku, "decline" zruší bez jakékoli změny. Při prvním volání vynechte.

Vrací — po prvním volání (nic se nezměnilo):

{
"status": "confirmation_required",
"confirmationToken": "<opaque confirmation token>",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_offer_accept again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"confirmation": {
"summary": "Accepting the offer of 2500.00 USD from the buyer for example.com reaches a binding agreement that cannot be undone. With this offer, the seller pays the whole marketplace fee. Accepting charges nothing: the buyer then pays the agreed amount through a Spaceship payment link, which shows the fees and the final amount before payment.",
"domain": "example.com",
"offer": { "kind": "price", "price": { "amount": "2500.00", "currency": "USD" }, "feeSplit": "seller_pays_all", "leaseToOwn": null }
}
}

offer.kind je price nebo lease_to_own; pro lease_to_own je price celková částka návrhu a leaseToOwn obsahuje jeho platby (total, downPayment, finalPayment, installment, installments), které shrnutí také uvádí; jinak je leaseToOwnnull. feeSplit je rozdělení poplatku tržiště, které druhá strana navrhla s nabídkou (aktuální rozdělení vyjednávání, pokud žádné nenavrhla), jedna z hodnot feeSplit uvedených u marketplace_negotiation_get, nebo null, pokud není nic známo; v takovém případě je shrnutí vynechá. Po confirmationResponse: "accept" je odpověď { "status": "accepted", "negotiation": { ... } } s vyjednáváním ve tvaru popsaném u marketplace_negotiation_get.

status: confirmation_required
Význam: Nic nebylo přijato; potvrďte pomocí confirmationToken.
status: cancelled
Význam: confirmationResponse: "decline"; nic se nezměnilo.
status: accepted
Význam: Nabídka byla přijata a dohoda uzavřena.

`marketplace_offer_decline` — Odmítnout nabídku Marketplace

Přístup: Citlivý zápis — kupující je upozorněn a odmítnutí nelze vzít zpět.

Odmítne jako prodávající nejnovější nabídku kupujícího ve vyjednávání o vašem inzerátu; kupující je upozorněn a stále může vytvořit novou nabídku. Odpovědí je aktualizované vyjednávání. Odmítnout může pouze prodávající: kupující dostane business.invalidArgument ("Only the seller can decline an offer."), a vyjednávání, jehož nejste stranou, vrací business.notFound.

Parametr: negotiationId
Povinné: Ano
Typ a omezení: UUID vyjednávání, jak jej vrací marketplace_negotiations_list nebo marketplace_negotiation_get.

Vrací — { "negotiation": { ... } }, vyjednávání ve tvaru popsaném u marketplace_negotiation_get; odmítnutá nabídka už není v buyerOffer:

{
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "seller",
"status": "negotiation",
"buyerOffer": null,
"sellerOffer": null,
"declinedBuyerOffer": { "amount": "2500.00", "currency": "USD" },
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": null, "proposedBySeller": null, "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": false,
"hasUnreadMessages": false,
"updatedAt": "2026-10-26T10:15:00.000Z"
}
}

`marketplace_offer_withdraw` — Stáhnout protinabídku Marketplace

Přístup: Citlivý zápis — kupující je upozorněn a stažení nelze vzít zpět.

Stáhne (zruší) jako prodávající vaši vlastní čekající protinabídku nebo návrh Lease-to-Own ve vyjednávání o vašem inzerátu; kupující je upozorněn, jeho nejnovější nabídka zůstává v platnosti a vyjednávání zůstává otevřené. To je význam „zrušit moji nabídku“; zrušení celého vyjednávání je marketplace_negotiation_suspend. Odpovědí je aktualizované vyjednávání. Pokud nemáte žádnou čekající protinabídku nebo návrh, odpověď je business.conflict ("There is no pending counter-offer or Lease-to-Own proposal to withdraw.") a nic se nezmění; vrací se pouze tehdy, když vyjednávání neukazuje žádnou vaši nabídku nebo návrh, nebo když byly zkontrolovány všechny vaše zprávy v něm. Ve velmi dlouhém vyjednávání nemusí být všechny vaše zprávy zkontrolovány včas. Volání pak vrací běžný výsledek { "status": "lookup_incomplete", "withdrawn": false, "note": "The negotiation's messages could not all be checked in time for your pending counter-offer or Lease-to-Own proposal, so nothing was withdrawn and the negotiation is unchanged." }, nic se nezmění a můžete volat znovu. Stáhnout může pouze prodávající: kupující dostane business.invalidArgument ("Only the seller can withdraw a counter-offer."), a vyjednávání, jehož nejste stranou, vrací business.notFound.

Parametr: negotiationId
Povinné: Ano
Typ a omezení: UUID vyjednávání, jak jej vrací marketplace_negotiations_list nebo marketplace_negotiation_get.

Vrací — { "negotiation": { ... } }, vyjednávání ve tvaru popsaném u marketplace_negotiation_get, přičemž nejnovější nabídka kupujícího zůstává v platnosti:

`marketplace_negotiation_suspend` — Zrušit (pozastavit) vyjednávání Marketplace

Přístup: Citlivý zápis — kupující je okamžitě upozorněn, všechny otevřené nabídky se uzavřou a záloha Quality Offer nebo provize makléře se vypořádá; obnovení je nevrátí zpět.

Zruší jako prodávající celé vyjednávání o vašem inzerátu („Cancel lead“ v SellerHub): kupující je upozorněn a už nemůže vytvářet nabídky, všechny otevřené nabídky v něm se uzavřou a záloha Quality Offer nebo provize makléře v něm se vypořádá. Pouhé stažení vaší vlastní čekající protinabídky nebo návrhu Lease-to-Own je marketplace_offer_withdraw, které ponechá vyjednávání otevřené. marketplace_negotiation_restore jej znovu otevře, ale nevrátí nabídky, zálohu ani provizi makléře. Odpovědí je aktualizované vyjednávání. Udělat to může pouze prodávající: kupující dostane business.invalidArgument ("Only the seller can suspend a negotiation."), a vyjednávání, jehož nejste stranou, vrací business.notFound.

Dvoufázové potvrzení. První volání nic nemění a vrací status: "confirmation_required" s confirmation (větou summary a domain) a confirmationToken. Zobrazte shrnutí uživateli a jakmile souhlasí, zavolejte znovu se stejným negotiationId, tokenem a confirmationResponse: "accept"; "decline" vrací status: "cancelled" a nic nemění. Token, který vypršel nebo patří jinému účtu, vrátí místo zrušení nové confirmation_required.

Parametr: negotiationId
Povinné: Ano
Typ a omezení: UUID vyjednávání, jak je vráceno z marketplace_negotiations_list nebo marketplace_negotiation_get.
Parametr: confirmationToken
Povinné: Ne
Typ a omezení: Řetězec, až 4096 znaků. Token z předchozího volání marketplace_negotiation_suspend pro toto vyjednávání. Při prvním volání vynechte. Po krátké době vyprší.
Parametr: confirmationResponse
Povinné: Podmíněně
Typ a omezení: "accept" nebo "decline". Význam má pouze s platným confirmationToken: "accept" zruší vyjednávání, "decline" nic nemění. Při prvním volání vynechte.

Vrací — po prvním volání (nic se nezměnilo):

{
"status": "confirmation_required",
"confirmationToken": "<opaque confirmation token>",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_negotiation_suspend again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"confirmation": {
"summary": "Cancel the negotiation on example.com? The buyer is notified and can no longer make offers, every open offer in it closes, and a Quality Offer deposit or broker commission in it is settled. It can be restored later with marketplace_negotiation_restore, but a restore does not bring back the offers, the deposit or the broker commission.",
"domain": "example.com"
}
}

Po přijatém druhém volání — { "negotiation": { ... } }, vyjednávání ve tvaru popsaném u marketplace_negotiation_get:

{
"negotiation": {
"negotiationId": "3f6b2c1e-8a4d-4f2b-9c7e-1d5a6b7c8d9e",
"domain": "example.com",
"yourRole": "seller",
"status": "suspended",
"buyerOffer": { "amount": "2500.00", "currency": "USD", "madeAt": "2026-10-20T11:30:00.000Z" },
"sellerOffer": null,
"declinedBuyerOffer": null,
"acceptedOffer": null,
"leaseToOwn": null,
"feeSplit": { "proposedByBuyer": "seller_pays_all", "proposedBySeller": null, "agreed": null },
"amountToPay": null,
"deposit": null,
"isSuspended": true,
"hasUnreadMessages": false,
"updatedAt": "2026-10-26T10:15:00.000Z"
}
}

`marketplace_negotiation_restore` — Obnovit vyjednávání Marketplace

Přístup: Zápis.

Obnoví jako prodávající pozastavené vyjednávání u vaší nabídky; kupující je upozorněn a vyjednávání pokračuje tam, kde se zastavilo. Odpovědí je aktualizované vyjednávání. Obnovit může pouze prodávající: kupující obdrží business.invalidArgument ("Only the seller can restore a negotiation."), a vyjednávání, jehož nejste stranou, vrátí business.notFound.

Parametr: negotiationId
Povinné: Ano
Typ a omezení: UUID vyjednávání, jak je vráceno z marketplace_negotiations_list nebo marketplace_negotiation_get.

Vrací — { "negotiation": { ... } }, vyjednávání ve tvaru popsaném u marketplace_negotiation_get:

Marketplace: obchody SafePay, leasing a vyhledávání

Obchody SafePay, smlouvy lease-to-own, jejichž jste součástí, a vyhledávání v tom, co nabízejí ostatní prodejci.

`marketplace_safepay_deals_list` — Vypsat obchody SafePay

Přístup: Čtení.

Vypíše vaše obchody SafePay, od nejnovějších, jako prodávající, kupující nebo obojí, volitelně filtrované podle stavu nebo části názvu domény. Každý obchod obsahuje svůj stav, cenu, kdo co platí a vaši roli v něm. Pro další krok obchodu a váš odkaz na něj načtěte obchod pomocí marketplace_safepay_deal_get.

Bez role se obchody, kde jste prodávající, a obchody, kde jste kupující, sloučí od nejnovějších, každý označený vaší role, a total počítá obojí. V tomto režimu je dostupných pouze prvních 100 obchodů: limit plus offset nesmí překročit 100. Obě strany se čtou v rámci jednoho časového limitu: když jednu stranu nelze včas načíst, odpověď obsahuje obchody druhé strany, total počítá pouze tuto stranu a unavailable pojmenuje stranu, která nebyla načtena (["seller"] nebo ["buyer"]); unavailable se vynechá, když byly načteny všechny strany. Když nelze včas načíst žádnou požadovanou stranu, volání selže s infrastructure.serviceUnavailable ("The marketplace did not answer in time."). Filtr, který neodpovídá ničemu, vrátí prázdný seznam, nikoli chybu. Kontaktní údaje druhé strany se nikdy nevracejí.

Parametr: role
Povinné: Ne
Typ a omezení: seller nebo buyer: pouze obchody, kde jste touto stranou. Pro obojí vynechte (pak limit + offset ≤ 100).
Parametr: status
Povinné: Ne
Typ a omezení: Pole 1–10 různých stavů: active, pending_seller_confirm, pending_buyer_confirm, pending_seller_reconfirm, awaiting_payment, processing, verification, purchased, deactivated, expired.
Parametr: domain
Povinné: Ne
Typ a omezení: Řetězec, 4–253 znaků. Pouze obchody, jejichž název domény obsahuje tento text.
Parametr: limit
Povinné: Ne
Typ a omezení: Celé číslo, 1–50. Výchozí 20.
Parametr: offset
Povinné: Ne
Typ a omezení: Celé číslo, 0 nebo více. Výchozí 0.

Vrací — { items, total }, kde total je počet odpovídajících obchodů, nikoli velikost stránky:

{
"items": [
{
"dealId": "5f0c2a9e-7d41-4b8a-9c3e-2e6f1a7b9d10",
"domain": "greatdomain.com",
"role": "seller",
"status": "pending_seller_confirm",
"type": "buy_now",
"openedBy": "buyer",
"price": { "amount": "1000.00", "currency": "USD" },
"buyerPays": { "amount": "1050.00", "currency": "USD" },
"sellerReceives": { "amount": "1000.00", "currency": "USD" },
"paymentMethod": "credit_card",
"createdAt": "2026-10-26T10:00:00.000Z",
"validUntil": "2026-11-02T10:00:00.000Z",
"negotiationId": null
}
],
"total": 7
}

Pole: role
Význam: Vaše strana v obchodu: seller nebo buyer.
Pole: type
Význam: buy_now, lease_to_own nebo make_offer.
Pole: openedBy
Význam: Kdo otevřel obchod: seller, buyer nebo broker.
Pole: price, buyerPays, sellerReceives
Význam: { amount, currency } nebo null, když není nastaveno.
Pole: paymentMethod
Význam: credit_card, paypal, account_funds, btc_pay, wire_transfer, alipay nebo null, když ještě není vybrána žádná metoda.
Pole: validUntil
Význam: Kdy obchod vyprší, pokud do té doby nebude dokončen.
Pole: negotiationId
Význam: Vyjednávání marketplace, ze kterého obchod vznikl, nebo null.
Pole: unavailable
Význam: Pouze když se stranu nepodařilo včas načíst: ["seller"] nebo ["buyer"].

`marketplace_safepay_deal_get` — Získat obchod SafePay

Přístup: Čtení.

Načte jeden z vašich obchodů SafePay podle id: jeho stav, podmínky, kdo co platí, vaši roli, další krok pro vás, váš vlastní odkaz na obchod a counterpartyLink, odkaz druhé strany, který jí můžete poslat. Kontaktní údaje druhé strany (email, telefon, id účtu) se nikdy nevracejí.

Obchod, jehož nejste stranou, vrátí business.notFound (The SafePay deal was not found.), přesně stejně jako obchod, který neexistuje, takže odpověď nikdy neprozradí, zda id obchodu patří někomu jinému. Id, které není UUID, je odmítnuto s application.request.badRequest.

Parametr: dealId
Povinné: Ano
Typ a omezení: UUID obchodu, jak je vráceno z marketplace_safepay_deals_list.

Vrací — { "deal": { ... } }:

{
"deal": {
"dealId": "5f0c2a9e-7d41-4b8a-9c3e-2e6f1a7b9d10",
"domain": "greatdomain.com",
"role": "seller",
"status": "pending_seller_confirm",
"type": "buy_now",
"openedBy": "buyer",
"price": { "amount": "1000.00", "currency": "USD" },
"totalPrice": { "amount": "1050.00", "currency": "USD" },
"buyerPays": { "amount": "1050.00", "currency": "USD" },
"sellerReceives": { "amount": "1000.00", "currency": "USD" },
"feeSplit": "buyer_pays_all",
"paymentMethod": "credit_card",
"canChangePaymentMethod": false,
"needsSellerReconfirmation": false,
"leaseTerms": null,
"createdAt": "2026-10-26T10:00:00.000Z",
"updatedAt": "2026-10-26T10:05:00.000Z",
"validUntil": "2026-11-02T10:00:00.000Z",
"domainExpiresAt": "2027-10-28T10:00:00.000Z",
"domainExpiresSoon": false,
"negotiationId": null,
"link": "https://www.spaceship.com/safepay/...",
"counterpartyLink": "https://www.spaceship.com/safepay/...",
"nextStep": "You need to confirm the terms before the deal can go ahead."
}
}

Pole: role
Význam: Vaše strana v obchodu: seller nebo buyer.
Pole: status
Význam: Jeden ze stavů uvedených u marketplace_safepay_deals_list.
Pole: type / openedBy
Význam: Stejně jako v marketplace_safepay_deals_list.
Pole: price / totalPrice
Význam: Cena obchodu a celková částka včetně poplatku SafePay; { amount, currency } nebo null.
Pole: buyerPays / sellerReceives
Význam: Co každá strana zaplatí nebo obdrží po poplatku; { amount, currency } nebo null.
Pole: feeSplit
Význam: Kdo platí poplatek SafePay, ve stejných hodnotách, jaké používají vyjednávání: seller_pays_all, seller_pays_most (75/25), even_split, buyer_pays_most (25/75), buyer_pays_all nebo null.
Pole: paymentMethod
Význam: Platební metoda kupujícího nebo null. canChangePaymentMethod říká, zda ji lze ještě změnit.
Pole: needsSellerReconfirmation
Význam: true, když musí prodávající znovu potvrdit podmínky.
Pole: leaseTerms
Význam: Pro obchod lease-to-own: { total, downPayment, installment, installments } (downPayment může být null); jinak null.
Pole: validUntil
Význam: Kdy obchod vyprší, pokud do té doby nebude dokončen; stejné datum, které vrací marketplace_safepay_deals_list.
Pole: domainExpiresAt / domainExpiresSoon
Význam: Kdy vyprší samotná registrace domény (nebo null, když to není známo nebo je registrována mimo Spaceship), a true, když je registrace už v redemption nebo se maže. Nejde o vypršení obchodu.
Pole: link
Význam: Váš vlastní odkaz na obchod, kde kupující platí.
Pole: counterpartyLink
Význam: Odkaz druhé strany na obchod, který jí můžete poslat (u obchodu, který jste otevřeli jako prodávající, odkaz kupujícího, kde kupující platí).
Pole: nextStep
Význam: Jedna věta, která vám říká, co se z vaší strany stane dál, například Waiting for the buyer to confirm the terms.

`marketplace_safepay_deal_create` — Otevřít obchod SafePay

Přístup: Citlivý zápis — otevře obchod, který může druhá strana přijmout jako závazný.

Otevře obchod SafePay pro doménu, jako prodávající (pro doménu, kterou vlastníte) nebo jako kupující (pro doménu, kterou vlastní někdo jiný). Otevření obchodu nic neúčtuje: druhá strana je upozorněna a stále musí potvrdit podmínky a kupující poté zaplatí prostřednictvím odkazu na obchod. Vyberte s uživatelem každou podmínku: cenu, kdo platí poplatek SafePay, a pro lease_to_own zálohu a počet splátek. Nic se za vás nevyplňuje.

Před otevřením nástroj hledá váš obchod ve stejné roli pro stejnou doménu, který blokuje nový: obchod, který je active, awaiting_payment, processing nebo verification, nebo dosud nepotvrzený obchod (stav pending_*) za stejnou cenu, což je s největší pravděpodobností tentýž obchod otevřený dřívějším voláním. Dosud nepotvrzený obchod za jinou cenu nový neblokuje, stejně jako v SellerHub. Pokud blokující obchod existuje, druhý obchod se neotevře a odpověď je běžný výsledek s status: "already_open", tímto obchodem a poznámkou. Pokud toto vyhledání nelze dokončit, obchod se otevře tak, jako by se bez něj otevřel.

Pole counterpartyEmail se používá pouze k upozornění druhé strany: v odpovědi se nikdy nevrací. Nekonzistentní podmínky (cena s více než dvěma desetinnými místy, chybějící podmínky leasingu nebo podmínky u obchodu buy_now, kupující bez counterpartyEmail nebo paymentMethod, prodávající s paymentMethod) jsou odmítnuty s business.invalidArgument a položkou validationErrors pro každé pole ještě předtím, než se cokoli odešle. Odmítnutí přímo od SafePay, například když už doména má dohodnutý obchod, vrátí business.conflict. Pokud volání selže s infrastructure.serviceUnavailable nebo infrastructure.outcomeUnknown, obchod mohl být otevřen: před dalším otevřením vypište své obchody pomocí marketplace_safepay_deals_list.

Parametr: role
Povinné: Ano
Typ a omezení: seller (doménu vlastníte) nebo buyer (vlastní ji někdo jiný).
Parametr: domain
Povinné: Ano
Typ a omezení: Řetězec, 4–253 znaků. Přijímá Unicode (IDN) nebo ASCII (A-label), normalizováno na punycode.
Parametr: type
Povinné: Ano
Typ a omezení: buy_now (jednorázová platba ceny) nebo lease_to_own (placeno ve splátkách).
Parametr: price
Povinné: Ano
Typ a omezení: Částka v USD jako desetinný řetězec s nejvýše dvěma desetinnými místy, větší než 0 a až do 10000000, například "1500.00". Pro lease_to_own je to celková částka leasingu.
Parametr: feePaidBy
Povinné: Ano
Typ a omezení: Kdo platí poplatek SafePay: seller (celý), seller_pays_most (prodávající 75 %, kupující 25 %), split (napůl), buyer_pays_most (prodávající 25 %, kupující 75 %) nebo buyer (celý).
Parametr: ltoDownPaymentPercent
Povinné: Podmíněně
Typ a omezení: Celé číslo, 0–99: záloha jako procento z celkové částky leasingu. Povinné pro lease_to_own, nepovolené pro buy_now.
Parametr: ltoInstallments
Povinné: Podmíněně
Typ a omezení: Celé číslo, 1–120: počet splátek. Povinné pro lease_to_own, nepovolené pro buy_now.
Parametr: counterpartyEmail
Povinné: Podmíněně
Typ a omezení: E-mailová adresa druhé strany, až 254 znaků; bude upozorněna na obchod. Povinné, když je rolebuyer, volitelné, když je roleseller. V odpovědi se nikdy nevrací.
Parametr: paymentMethod
Povinné: Podmíněně
Typ a omezení: credit_card, paypal, account_funds, btc_pay, wire_transfer nebo alipay: metoda, kterou bude kupující platit. Povinné, když je rolebuyer; volitelné, když je roleseller, který ji může pro kupujícího zvolit předem.

Vrací — nově otevřený obchod:

{
"deal": {
"dealId": "5f0c2a9e-7d41-4b8a-9c3e-2e6f1a7b9d10",
"domain": "greatdomain.com",
"role": "seller",
"status": "pending_buyer_confirm",
"type": "buy_now",
"price": { "amount": "1500.00", "currency": "USD" },
"feePaidBy": "buyer",
"link": "https://www.spaceship.com/safepay/...",
"counterpartyLink": "https://www.spaceship.com/safepay/...",
"nextStep": "Waiting for the buyer to confirm the terms."
}
}

feePaidBy je null, když rozdělení poplatku obchodu není jednou z pěti hodnot feePaidBy. link je váš vlastní odkaz na obchod a counterpartyLink odkaz druhé strany, který jí můžete poslat.

Když už máte pro doménu v dané roli otevřený obchod, obchod má tvar, který vrací marketplace_safepay_deals_list:

{
"status": "already_open",
"deal": {
"dealId": "5f0c2a9e-7d41-4b8a-9c3e-2e6f1a7b9d10",
"domain": "greatdomain.com",
"role": "seller",
"status": "pending_buyer_confirm",
"type": "buy_now",
"openedBy": "seller",
"price": { "amount": "1500.00", "currency": "USD" },
"buyerPays": { "amount": "1575.00", "currency": "USD" },
"sellerReceives": { "amount": "1500.00", "currency": "USD" },
"paymentMethod": null,
"createdAt": "2026-10-26T10:00:00.000Z",
"validUntil": "2026-11-02T10:00:00.000Z",
"negotiationId": null
},
"note": "You already have an open SafePay deal for this domain, so no new deal was opened. Read it with marketplace_safepay_deal_get."
}

`marketplace_safepay_deal_confirm` — Potvrdit obchod SafePay

Přístup: Citlivý zápis — vede k závazné dohodě.

Potvrzuje podmínky dohody SafePay, kterou otevřela druhá strana a která čeká na vás: prodávající potvrzuje dohodu, kterou otevřel kupující (nebo ji potvrzuje znovu poté, co kupující změnil platební metodu), kupující potvrzuje dohodu, kterou otevřel prodávající, a může zvolit platební metodu. Potvrzení nic nestojí; kupující zaplatí až poté prostřednictvím odkazu na dohodu.

Dvoukrokové potvrzení. První volání nic nemění a vrací status: "confirmation_required" spolu se summary podmínek (doména, vaše role, jednorázová platba nebo splátky, co kupující platí a co prodávající obdrží, a vámi zvolená platební metoda) a confirmationToken. Zobrazte souhrn uživateli a poté zavolejte znovu se stejnými argumenty, tokenem a confirmationResponse: "accept" pro potvrzení, nebo "decline" pro zastavení; decline vrací status: "cancelled" a nic nemění. Platnost tokenu po krátké době vyprší a je vázán na argumenty i na podmínky dohody v okamžiku vydání: pokud je zastaralý nebo se mezitím změnila cena, částky, rozdělení poplatku, platební metoda nebo stav, volání místo potvrzení vrátí nový confirmation_required.

Dohoda, jejíž nejste stranou, vrací business.notFound, přesně stejně jako dohoda, která neexistuje.
Dohoda, která nečeká na vaše potvrzení, vrací business.conflict. To zahrnuje i dohodu, která čeká na potvrzení druhé strany.
Hodnota paymentMethod odeslaná prodávajícím nebo kupujícím, který potvrzuje dohodu, již sám otevřel, je odmítnuta s business.invalidArgument.
Po infrastructure.serviceUnavailable nebo infrastructure.outcomeUnknown mohla být dohoda potvrzena. Před dalším potvrzením ji načtěte pomocí marketplace_safepay_deal_get.

Parametr: dealId
Povinné: Ano
Typ a omezení: UUID dohody, jak jej vrací marketplace_safepay_deals_list.
Parametr: paymentMethod
Povinné: Ne
Typ a omezení: credit_card, paypal, account_funds, btc_pay, wire_transfer nebo alipay. Nastavit ji může pouze kupující, a to jen při potvrzování dohody, kterou otevřel prodávající.
Parametr: confirmationToken
Povinné: Ne
Typ a omezení: Řetězec, až 4096 znaků, vrácený předchozím voláním tohoto nástroje pro tyto přesné argumenty. Při prvním volání vynechte; znovu jej odešlete beze změny spolu s confirmationResponse.
Parametr: confirmationResponse
Povinné: Podmíněně
Typ a omezení: accept nebo decline. Má význam pouze spolu s platným confirmationToken. Při prvním volání vynechte.

Vrací — po prvním volání (nic není potvrzeno):

{
"status": "confirmation_required",
"confirmationToken": "eyJ2IjoxLCJ...",
"note": "Zatím nebylo nic změněno. Zobrazte potvrzení uživateli a jakmile bude souhlasit, zavolejte marketplace_safepay_deal_confirm znovu s tímto confirmationToken a confirmationResponse=\"accept\", nebo s confirmationResponse=\"decline\" pro zrušení.",
"summary": "Potvrďte dohodu SafePay pro greatdomain.com jako prodávající: jednorázová platba. Kupující zaplatí 1050.00 USD. Prodávající obdrží 1000.00 USD. Potvrzením se zavazujete k těmto podmínkám; samotná platba se provádí zvlášť prostřednictvím odkazu na dohodu."
}

Po accept vrací { "deal": { ... } } ve tvaru, který vrací marketplace_safepay_deal_get, s novým stavem (například active nebo awaiting_payment) a odpovídajícím nextStep. Po decline:

{ "status": "cancelled", "note": "Nic nebylo změněno, protože akce nebyla potvrzena." }

status: confirmation_required
Význam: Zatím se nic nezměnilo; zobrazte summary a zavolejte znovu s tokenem.
status: cancelled
Význam: Odmítli jste; nic se nezměnilo.

`marketplace_leases_list` — Vypsat leasingy

Přístup: Čtení.

Vypíše smlouvy lease-to-own, jejichž jste součástí, od nejnovějších: domény, které si pronajímáte jako kupující, a domény, které pronajímáte jako prodávající. Každý leasing obsahuje svůj stav, co bylo zaplaceno a co zbývá, splátky a další platbu.

Bez role jsou obě strany sloučeny od nejnovějších, každý leasing je označen vaší role a total počítá obě; v tomto režimu nesmí limit plus offset překročit 100. Obě strany se čtou v rámci jednoho časového limitu: když jednu stranu nelze načíst včas, odpověď obsahuje leasingy druhé strany, total počítá jen tuto stranu a unavailable uvádí stranu, kterou se nepodařilo načíst (["seller"] nebo ["buyer"]); unavailable se vynechá, když byly načteny všechny strany. Když se včas nepodaří načíst žádnou požadovanou stranu, volání selže s infrastructure.serviceUnavailable ("Marketplace neodpověděl včas."). Filtr, který neodpovídá ničemu, vrací prázdný seznam, nikoli chybu. Údaje o účtu druhé strany se nikdy nevracejí.

Parametr: role
Povinné: Ne
Typ a omezení: buyer (domény, které si pronajímáte) nebo seller (domény, které pronajímáte). Pro obě vynechte (pak limit + offset ≤ 100).
Parametr: state
Povinné: Ne
Typ a omezení: Pole 1–5 různých stavů: active, cancelling, cancelled, failed_payment, completed.
Parametr: domain
Povinné: Ne
Typ a omezení: Řetězec, 1–253 znaků. Pouze leasingy, jejichž název domény obsahuje tento text.
Parametr: limit
Povinné: Ne
Typ a omezení: Celé číslo, 1–50. Výchozí 20.
Parametr: offset
Povinné: Ne
Typ a omezení: Celé číslo, 0 nebo více. Výchozí 0.

Vrací — { items, total }:

{
"items": [
{
"leaseId": "8c2e4f61-1a3b-4d5c-9e7f-0b1c2d3e4f50",
"domain": "leasedname.io",
"role": "buyer",
"state": "active",
"total": { "amount": "1200.00", "currency": "USD" },
"paid": { "amount": "300.00", "currency": "USD" },
"left": { "amount": "900.00", "currency": "USD" },
"percentPaid": 25,
"isPaidOff": false,
"installment": { "amount": "100.00", "currency": "USD" },
"installments": 12,
"installmentsPaid": 3,
"downPayment": { "amount": "120.00", "currency": "USD" },
"finalPayment": null,
"nextPayment": {
"amount": { "amount": "100.00", "currency": "USD" },
"date": "2026-11-01T10:00:00.000Z",
"type": "installment"
},
"lastPaymentDate": "2026-10-01T10:00:00.000Z",
"cancellationReason": null,
"canceledAt": null,
"createdAt": "2026-08-01T10:00:00.000Z",
"negotiationId": "6f1d1c2e-3b4a-4c5d-8e9f-0a1b2c3d4e5f"
}
],
"total": 9
}

Pole: role
Význam: Vaše strana: buyer nebo seller.
Pole: state
Význam: active, cancelling, cancelled, failed_payment nebo completed.
Pole: total / paid / left
Význam: Celková částka leasingu, dosud zaplacená částka a zbývající částka; percentPaid je zaplacený podíl v procentech.
Pole: installment / installments / installmentsPaid
Význam: Výše jedné splátky, kolik jich je a kolik jich je zaplaceno.
Pole: downPayment / finalPayment
Význam: { amount, currency } nebo null, pokud leasing žádnou nemá.
Pole: nextPayment.type
Význam: down_payment, installment, final_payment, paid_off nebo unknown.
Pole: cancellationReason
Význam: seller_cancelled, buyer_cancelled, support_cancelled nebo null; canceledAt se nastaví spolu s ní.
Pole: negotiationId
Význam: Vyjednávání v marketplace, ze kterého leasing vznikl.
Pole: unavailable
Význam: Pouze když se stranu nepodařilo načíst včas: ["seller"] nebo ["buyer"].

`marketplace_lease_get` — Získat leasing

Přístup: Čtení.

Načte jednu smlouvu lease-to-own, jejíž jste součástí, podle id: její stav, zaplacenou a zbývající částku, splátky, další platbu a vaši roli v ní. Použijte ji ke sledování stavu leasingu, například když přechází z cancelling do cancelled.

Leasing, jehož nejste stranou, vrací business.notFound (Leasing nebyl nalezen.), přesně stejně jako leasing, který neexistuje.

Parametr: leaseId
Povinné: Ano
Typ a omezení: UUID leasingu, jak jej vrací marketplace_leases_list.

Vrací — { "lease": { ... } }, jeden leasing ve tvaru, který vrací marketplace_leases_list:

{
"lease": {
"leaseId": "8c2e4f61-1a3b-4d5c-9e7f-0b1c2d3e4f50",
"domain": "leasedname.io",
"role": "buyer",
"state": "active",
"total": { "amount": "1200.00", "currency": "USD" },
"paid": { "amount": "300.00", "currency": "USD" },
"left": { "amount": "900.00", "currency": "USD" },
"percentPaid": 25,
"isPaidOff": false,
"installment": { "amount": "100.00", "currency": "USD" },
"installments": 12,
"installmentsPaid": 3,
"downPayment": { "amount": "120.00", "currency": "USD" },
"finalPayment": null,
"nextPayment": {
"amount": { "amount": "100.00", "currency": "USD" },
"date": "2026-11-01T10:00:00.000Z",
"type": "installment"
},
"lastPaymentDate": "2026-10-01T10:00:00.000Z",
"cancellationReason": null,
"canceledAt": null,
"createdAt": "2026-08-01T10:00:00.000Z",
"negotiationId": "6f1d1c2e-3b4a-4c5d-8e9f-0a1b2c3d4e5f"
}
}

`marketplace_lease_cancel` — Zrušit leasing

Přístup: Citlivý zápis — nelze vrátit zpět; již zaplacené částky se nevracejí.

Zruší smlouvu lease-to-own jako kupující. Zbývající splátky se zastaví, již zaplacené částky se nevracejí a doména se vrátí prodávajícímu. Odtud to nelze vrátit zpět. Zrušit může pouze kupující, a to jen active leasing.

Dvoukrokové potvrzení. První volání nic nemění a vrací status: "confirmation_required" spolu se summary (doména, co jste zaplatili, co zbývá a že zaplacené částky se nevracejí) a confirmationToken. Zobrazte souhrn uživateli a poté zavolejte znovu se stejným leaseId, tokenem a confirmationResponse: "accept" pro zrušení, nebo "decline" pro zastavení; decline vrací status: "cancelled" a nic nemění. Platnost tokenu po krátké době vyprší a je vázán na leasing v podobě, v jaké byl při vydání tokenu: pokud je zastaralý nebo byla mezitím zaplacena splátka, volání místo zrušení vrátí nový confirmation_required.

Leasing, jehož nejste stranou, vrací business.notFound, přesně stejně jako leasing, který neexistuje. Jako prodávající dostanete business.conflict (Leasing může zrušit pouze kupující.) a leasing, který není active, vrací business.conflict (Leasing není aktivní, takže jej nelze zrušit.). Pokud volání selže s infrastructure.serviceUnavailable nebo infrastructure.outcomeUnknown, leasing mohl být zrušen: před dalším rušením jej načtěte pomocí marketplace_lease_get.

Parametr: leaseId
Povinné: Ano
Typ a omezení: UUID leasingu, jak jej vrací marketplace_leases_list.
Parametr: confirmationToken
Povinné: Ne
Typ a omezení: Řetězec, až 4096 znaků, vrácený předchozím voláním tohoto nástroje pro tento leasing. Při prvním volání vynechte; znovu jej odešlete beze změny spolu s confirmationResponse.
Parametr: confirmationResponse
Povinné: Podmíněně
Typ a omezení: accept nebo decline. Má význam pouze spolu s platným confirmationToken. Při prvním volání vynechte.

Vrací — po prvním volání (nic není zrušeno):

{
"status": "confirmation_required",
"confirmationToken": "eyJ2IjoxLCJ...",
"note": "Zatím nebylo nic změněno. Zobrazte potvrzení uživateli a jakmile bude souhlasit, zavolejte marketplace_lease_cancel znovu s tímto confirmationToken a confirmationResponse=\"accept\", nebo s confirmationResponse=\"decline\" pro zrušení.",
"summary": "Zrušte lease-to-own pro leasedname.io. Zaplatili jste 300.00 USD a zbývá 900.00 USD. Již zaplacené částky se nevracejí a doména se vrátí prodávajícímu. Odtud to nelze vrátit zpět."
}

Po accept:

{
"status": "cancel_accepted",
"leaseId": "8c2e4f61-1a3b-4d5c-9e7f-0b1c2d3e4f50",
"domain": "leasedname.io",
"note": "Zrušení bylo přijato. Pro sledování jeho stavu načtěte leasing pomocí marketplace_lease_get."
}

status: confirmation_required
Význam: Zatím se nic nezměnilo; zobrazte summary a zavolejte znovu s tokenem.
status: cancelled
Význam: Odmítli jste; nic se nezměnilo. { "status": "cancelled", "note": "Nic nebylo změněno, protože akce nebyla potvrzena." }
status: cancel_accepted
Význam: Zrušení bylo přijato. Leasing může nějakou dobu zobrazovat cancelling, než přejde do cancelled; sledujte jej pomocí marketplace_lease_get.

`marketplace_listings_search` — Hledat nabídky v Marketplace

Přístup: Čtení.

Vyhledává domény, které ostatní lidé nabídli k prodeji na Spaceship marketplace, podle jednoho povinného klíčového slova, zúženého podle TLD, cenového rozpětí v celých dolarech USD, délky názvu a možnosti nákupu (Buy Now, nabídky, lease-to-own). Chcete-li hledat několik slov, volejte jednou pro každé slovo. Výsledky jsou od nejnovějších. Vaše vlastní nabídky jsou vynechány. Každý výsledek obsahuje cenu Buy Now, minimální nabídku a podmínky lease-to-own, pokud je prodávající nastavil, a id vašeho vlastního vyjednávání pro tuto doménu, pokud nějaké máte.

Vyhledávání, které nic nenajde, vrací { "items": [] }, nikoli chybu. Chybějící klíčové slovo, klíčové slovo, které není jedním slovem o alespoň 3 písmenech nebo číslicích, rozsah s minimem vyšším než maximum, opakované TLD (bez ohledu na velikost písmen), více než 10 TLD, desetinná cena, cena, délka, limit nebo offset mimo svůj rozsah v tabulce níže nebo parametr, který není uveden níže, jsou odmítnuty s application.request.badRequest.

Parametr: search
Povinné: Ano
Typ a omezení: Řetězec, až 253 znaků. Jedno klíčové slovo, které se má hledat v názvu domény: jedno slovo bez mezer, čárek nebo středníků, obsahující alespoň 3 písmena nebo číslice za sebou. Pro několik slov volejte jednou pro každé slovo.
Parametr: tlds
Povinné: Ne
Typ a omezení: Pole 1–10 různých TLD bez tečky, například ["com", "io"]. Písmena, číslice, spojovníky a vnitřní tečky (co.uk).
Parametr: minPrice
Povinné: Ne
Typ a omezení: Celé číslo, 0–10000000. Nejnižší cena v celých amerických dolarech. Nesmí být vyšší než maxPrice.
Parametr: maxPrice
Povinné: Ne
Typ a omezení: Celé číslo, 0–10000000. Nejvyšší cena v celých amerických dolarech.
Parametr: minLength
Povinné: Ne
Typ a omezení: Celé číslo, 1–63. Nejkratší délka názvu, počítaná bez TLD. Nesmí být větší než maxLength.
Parametr: maxLength
Povinné: Ne
Typ a omezení: Celé číslo, 1–63. Nejdelší délka názvu, počítaná bez TLD.
Parametr: buyNow
Povinné: Ne
Typ a omezení: Boolean. true: pouze domény, které můžete koupit hned; false: pouze domény bez Buy Now.
Parametr: offers
Povinné: Ne
Typ a omezení: Boolean. true: pouze domény, které přijímají nabídky; false: pouze domény, které je nepřijímají.
Parametr: leaseToOwn
Povinné: Ne
Typ a omezení: Boolean. true: pouze domény s lease-to-own; false: pouze domény bez něj.
Parametr: limit
Povinné: Ne
Typ a omezení: Celé číslo, 1–50. Výchozí 20.
Parametr: offset
Povinné: Ne
Typ a omezení: Celé číslo, 0–1000. Výchozí hodnota 0.

Vrací — { items }, jednu stránku odpovídajících nabídek. Odpověď neobsahuje celkový počet: stránka s menším počtem nabídek než limit je poslední.

{
"items": [
{
"domain": "BestShop.io",
"tld": "io",
"buyNow": true,
"buyNowPrice": { "amount": "900.00", "currency": "USD" },
"minOffer": { "amount": "200.00", "currency": "USD" },
"leaseToOwn": {
"total": { "amount": "1200.00", "currency": "USD" },
"downPayment": { "amount": "120.00", "currency": "USD" },
"installment": { "amount": "100.00", "currency": "USD" },
"installments": 12
},
"negotiationId": null
}
]
}

Pole: domain
Význam: Doména tak, jak ji zobrazuje prodejce (může obsahovat velká písmena).
Pole: tld
Význam: TLD domény bez tečky.
Pole: buyNow / buyNowPrice
Význam: Zda ji lze koupit ihned, a cena Buy Now nebo null.
Pole: minOffer
Význam: Nejnižší nabídka, kterou prodejce přijme, nebo null.
Pole: leaseToOwn
Význam: { total, downPayment, installment, installments } když prodejce nabízí lease-to-own (downPayment může být null); jinak null.
Pole: negotiationId
Význam: ID vašeho vlastního otevřeného vyjednávání pro tuto doménu nebo null.

`marketplace_purchase_link` — Získat platební odkaz Marketplace

Přístup: Zápis.

Poskytne vám jako kupujícímu odkaz k platbě na Spaceship za doménu z marketplace. Vystavení odkazu nic neúčtuje: otevřete jej, zkontrolujete poplatky a konečnou částku na platební stránce Spaceship a zaplatíte tam. Odkaz odráží nabídku, vyjednávání nebo obchod v podobě, v jaké jsou při jeho otevření, a je určen pro váš vlastní účet Spaceship. Opakované volání je bezpečné a poskytne nový odkaz.

Zadejte přesně jednu z možností domain, negotiationId nebo dealId:

domain: doména, kterou jiný prodejce nabízí s Buy Now. Odkaz je pro cenu Buy Now.
negotiationId: vyjednávání, kde jste kupující a bylo dosaženo dohody. Odkaz je pro dohodnutou částku nebo pro dohodnuté podmínky Lease-to-Own, pokud je dohoda pronájem.
dealId: obchod SafePay, kde jste kupující a jehož stav je active, což je jediný stav, ve kterém může kupující zaplatit. Odpovědí je vlastní platební odkaz obchodu. Obchod ve stavu awaiting_payment (kupující zvolil bankovní převod nebo BTCPay a podpora Spaceship ještě nepotvrdila prostředky) zatím nelze přes odkaz zaplatit.

S domain nebo negotiationId zadejte také contactId: jeden z vašich uložených kontaktů z contacts_list nebo nový z contacts_save. Stane se kontaktem registranta, administrativním, technickým a fakturačním kontaktem domény, když se doména přesune do vašeho účtu. dealId nepřijímá contactId, protože se vrací vlastní odkaz obchodu; jeho platební stránka vyžaduje kontakty a nelze ji dokončit, pokud ve vašem účtu nejsou uloženy žádné kontakty.

Žádná nebo více než jedna z těchto tří možností je odmítnuta s application.request.badRequest ("Pass exactly one of domain, negotiationId or dealId."), a domain, která není názvem domény, s business.invalidArgument ("The domain must be a domain name such as "example.com"."). Chybějící contactId s domain nebo negotiationId nebo contactId s dealId je odmítnuto s application.request.badRequest ještě před jakýmkoli vyhledáváním ("contactId is required with domain or negotiationId." nebo "contactId is not used with dealId."). contactId, která není jedním z vašich kontaktů, vrací business.notFound ("Contact not found in this account."), stejně jako contacts_get, a žádný odkaz se nevytvoří.

Parametr: domain
Povinné: Podmíněně
Typ a omezení: Řetězec, 3–253 znaků. Doména nabízená k prodeji s Buy Now, Unicode nebo ASCII. Přesně jedna ze tří možností.
Parametr: negotiationId
Povinné: Podmíněně
Typ a omezení: ID vyjednávání, jak je vráceno z marketplace_negotiations_list. Přesně jedna ze tří možností.
Parametr: dealId
Povinné: Podmíněně
Typ a omezení: UUID obchodu SafePay, jak je vráceno z marketplace_safepay_deals_list. Přesně jedna ze tří možností.
Parametr: contactId
Povinné: Podmíněně
Typ a omezení: ID kontaktu (27–32 alfanumerických znaků), jak je vráceno z contacts_list nebo contacts_save. Povinné s domain nebo negotiationId; není povoleno s dealId.

Vrací — link_ready s odkazem nebo nothing_to_buy:

{
"status": "link_ready",
"case": "buy_now",
"url": "https://www.spaceship.com/...",
"domain": "bestshop.io",
"buyNowPrice": { "amount": "900.00", "currency": "USD" },
"note": "Issuing this link charged nothing. Open it to pay on Spaceship: the payment page shows the fees and the final amount. The link reflects the listing, negotiation or deal as it is when it is opened, and it is for your own Spaceship account. The contact given as contactId becomes the domain's registrant, admin, tech and billing contact when the domain moves to your account."
}

Pole: case
Význam: buy_now, agreement, agreement_lease_to_own nebo safepay.
Pole: url
Význam: Platební odkaz k otevření.
Pole: domain
Význam: Doména, pokud je známa.
Pole: buyNowPrice
Význam: S buy_now: cena Buy Now nabídky.
Pole: acceptedOfferAmount
Význam: S agreement: částka, na které byla dosažena dohoda.
Pole: leaseToOwn
Význam: S agreement_lease_to_own: { total, downPayment, finalPayment, installment, installments } podle dohody (downPayment a finalPayment mohou být null).
Pole: amountBuyerPays
Význam: S safepay: co obchod uvádí, že kupující zaplatí.

Zobrazuje se pouze cena uvedená v nabídce, vyjednávání nebo obchodu; odpověď nikdy nepřidává poplatky ani nepočítá celkovou částku a cena, která není známa, je vynechána.

{
"status": "nothing_to_buy",
"reason": "no_agreement",
"note": "The negotiation has no agreement yet, so there is nothing to pay for."
}

reason: buy_now_off
Význam: Doména je uvedena v nabídce, ale Buy Now je vypnuto. Místo toho můžete učinit nabídku.
reason: lease_to_own_only
Význam: Doména je nabízena pouze s Lease-to-Own, které zde nelze koupit prostřednictvím platebního odkazu. Místo toho můžete učinit nabídku.
reason: no_agreement
Význam: Ve vyjednávání zatím nebylo dosaženo dohody.
reason: not_the_buyer
Význam: Jste prodejce; platí pouze kupující.
reason: deal_not_payable
Význam: Obchod SafePay není ve stavu active, takže jej nyní nelze zaplatit přes jeho odkaz.

reason je uzavřený seznam, který se může rozrůstat: s hodnotou, kterou neznáte, zacházejte jako s „právě teď není za co platit“.

Vyjednávání nebo obchod, jehož nejste stranou, vrací business.notFound přesně stejně jako takový, který neexistuje, a doména, která není nabízena k prodeji, vrací business.notFound s textem "The domain is not listed for sale.". Když nelze odkaz připravit, volání selže s infrastructure.serviceUnavailable ("The payment link could not be prepared. Nothing was charged."); vytvoření odkazu nic neúčtuje, takže opakování volání je bezpečné (viz Opakování zápisů).

Marketplace: hromadné operace

Operace nad mnoha nabídkami nebo vyjednáváními najednou. Spouštějí se po volání: odpověď je status: "working" s identifikátorem operace, který lze sledovat pomocí async_operation_get. Na jeden účet může běžet vždy jen jedna hromadná operace.

`marketplace_listings_import` — Importovat nabídky Marketplace

Přístup: Citlivý zápis — vystaví až 5000 domén k prodeji najednou.

V jedné operaci uvede k prodeji až 5000 domén na marketplace Spaceship, ať už jsou ve vašem účtu Spaceship nebo registrované jinde, každou s volitelnou cenou Buy Now, minimální nabídkou a stránkou For Sale. Doména registrovaná jinde je uvedena v nabídce po ověření jejího vlastnictví. Doména importovaná s cenou Buy Now také získá předvolby Lease-to-Own uložené pro účet, pokud nějaké existují, stejně jako při importu v SellerHub. Když má alespoň jedna doména z volání cenu Buy Now, note v odpovědi to uvede, pokud nebyla uvedena žádná doména. Import se spustí po volání: odpověď je status: "working" s identifikátorem operace bulk: v operation.operationId a checkWith a checkAfterSeconds říká, kdy kontrolovat. Předejte identifikátor do async_operation_get, které hlásí počet zpracovaných domén z celkového počtu a pro každou doménu, která nebyla uvedena, důvod, například "The domain is already listed." nebo "The domain is not in this account.". Neopakujte volání, které vrátilo working: import už byl spuštěn a jeho opakování jej nezrychlí.

Na jeden účet může běžet vždy jen jedna hromadná operace. Zatímco jedna běží, odpověď je status: "already_running" s note, nic nového se nespustí a nejde o chybu: počkejte, až běžící operace skončí, a pak volejte znovu. Vstup, který porušuje níže uvedená pravidla (například stejná doména dvakrát nebo forSalePage bez ceny), je odmítnut s application.request.badRequest ještě před spuštěním čehokoli.

Parametr: domains
Povinné: Ano
Typ a omezení: 1–5000 domén k uvedení v nabídce, každá nejvýše jednou.
Parametr: domains.name
Povinné: Ano
Typ a omezení: Plně kvalifikovaný název domény, 3–253 znaků, například example.com. Porovnává se bez ohledu na velikost písmen.
Parametr: domains.buyNowPrice
Povinné: Ne
Typ a omezení: Cena Buy Now v celých amerických dolarech, 1–10,000,000. Zapíná Buy Now.
Parametr: domains.minOfferPrice
Povinné: Ne
Typ a omezení: Minimální nabídka v celých amerických dolarech, 1–10,000,000. Zapíná nabídky.
Parametr: domains.forSalePage
Povinné: Podmíněně
Typ a omezení: Boolean; zda je stránka For Sale zapnutá. Povoleno pouze společně s buyNowPrice nebo minOfferPrice.

Vrací — sdílenou odpověď operace, která běží po volání:

Pole: status
Význam: working po spuštění importu; already_running když běží jiná hromadná operace účtu (pak se vrací pouze status a note).
Pole: operation
Význam: Operace při posledním čtení, informativně: operationId (identifikátor bulk:), status (pending, success nebo failed, stejné hodnoty, které async_operation_get vrací pro tento identifikátor), type (marketplace_listingsImport; marketplace_listingsBulkUpdate a marketplace_negotiationsBulkCancel pro další dva hromadné nástroje), details (průběh), createdAt a modifiedAt.
Pole: checkWith
Význam: { "tool": "async_operation_get", "arguments": { "operationId": "bulk:…" } } — volání, které je třeba provést pro sledování importu.
Pole: checkAfterSeconds
Význam: Jak dlouho čekat před kontrolou, například 10.
Pole: note
Význam: Co se stalo a co dělat dál; zobrazte to uživateli.

{
"status": "already_running",
"note": "An operation of this kind is already running for this account, so a new one was not started. Wait until it finishes, then try again."
}

`marketplace_listings_bulk_update` — Hromadně aktualizovat nabídky Marketplace

Přístup: Citlivý zápis — mění ceny, které kupující platí, až u 5000 nabídek najednou.

V jedné operaci změní jednu skupinu nastavení u mnoha nabídek marketplace: prices (Buy Now a minimální nabídka s volitelnou zálohou Quality Offer), pageSettings (stránka For Sale, formulář Contact Owner a odkaz na vaše portfolio prodejce) nebo leaseToOwn (vypnutí nebo použití předvoleb lease-to-own uložených pro váš účet). Odešlete přesně jednu ze tří skupin a nabídky vyberte pomocí přesně jedné z možností listingIds (až 5000) nebo filter. Filtr musí uvádět alespoň jedno kritérium; chcete-li změnit každou nabídku, nastavte samostatně filter.allListings na true.

Aktualizace se spustí po volání: odpověď je status: "working" s identifikátorem operace bulk:, který se předá do async_operation_get, jež hlásí počet zpracovaných nabídek z celkového počtu a pro každou nabídku, která nebyla změněna, důvod, například "The domain has no Buy Now price." nebo "No lease-to-own presets are saved for the account.". Neopakujte volání, které vrátilo working. Na jeden účet může běžet vždy jen jedna hromadná operace; zatímco jedna běží, odpověď je status: "already_running" s note, nic nového se nespustí a nejde o chybu. Vstup, který porušuje níže uvedená pravidla, je odmítnut s application.request.badRequest ještě před spuštěním čehokoli.

Parametr: listingIds
Povinné: Podmíněně
Typ a omezení: 1–5000 ID nabídek (UUID), každé nejvýše jednou: listingId z marketplace_listings_list nebo marketplace_listing_get. Odešlete buď listingIds, nebo filter, ne obojí.
Parametr: filter
Povinné: Podmíněně
Typ a omezení: Kritéria vybírající nabídky ke změně. Odešlete buď listingIds, nebo filter, ne obojí. Vyžaduje alespoň jedno kritérium nebo samostatně allListings.
Parametr: filter.allListings
Povinné: Ne
Typ a omezení: true pro změnu každé nabídky účtu. Nekombinuje se s jinými kritérii.
Parametr: filter.tlds
Povinné: Ne
Typ a omezení: 1–50 koncovek bez úvodní tečky, například ["com", "io"].
Parametr: filter.nameContains
Povinné: Ne
Typ a omezení: Pouze nabídky, jejichž název domény obsahuje tento text, 1–63 znaků.
Parametr: filter.buyNowEnabled
Povinné: Ne
Typ a omezení: Boolean; pouze nabídky se zapnutým Buy Now (true) nebo vypnutým (false).
Parametr: filter.minOfferEnabled
Povinné: Ne
Typ a omezení: Boolean; pouze nabídky, které přijímají nabídky (true), nebo ne (false).
Parametr: filter.forSalePageEnabled
Povinné: Ne
Typ a omezení: Boolean; pouze nabídky se zapnutou stránkou For Sale (true) nebo vypnutou (false). V témže volání se nesmí rovnat pageSettings.forSalePageEnabled.
Parametr: prices
Povinné: Podmíněně
Typ a omezení: Nastavení cen. Odešlete přesně jednu z možností prices, pageSettings a leaseToOwn. Vyžaduje buyNowEnabled, minOfferEnabled nebo obojí a obě nemohou být zároveň false.
Parametr: prices.buyNowEnabled
Povinné: Ne
Typ a omezení: Boolean; zapíná nebo vypíná Buy Now.
Parametr: prices.buyNowPrice
Povinné: Podmíněně
Typ a omezení: Celé americké dolary, 1–10,000,000. Povinné, když buyNowEnabled je true, a povoleno pouze tehdy.
Parametr: prices.minOfferEnabled
Povinné: Ne
Typ a omezení: Boolean; zapíná nebo vypíná nabídky.
Parametr: prices.minOfferPrice
Povinné: Podmíněně
Typ a omezení: Celé americké dolary, 1–10,000,000. Povinné, když je minOfferEnabledtrue, a povolené pouze tehdy.
Parametr: prices.qualityOffer
Povinné: Ne
Typ a omezení: Nastavení Quality Offer použité s cenami.
Parametr: prices.qualityOffer.requirement
Povinné: Ano, v rámci qualityOffer
Typ a omezení: Zda kupující při nabídce zaplatí zálohu: disabled, optional nebo mandatory.
Parametr: prices.qualityOffer.depositAmount
Povinné: Podmíněně
Typ a omezení: Záloha v celých amerických dolarech, 10–50. Povinné, když je requirementoptional nebo mandatory; není povoleno s disabled.
Parametr: pageSettings
Povinné: Podmíněně
Typ a omezení: Nastavení stránky Na prodej. Odešlete přesně jedno z prices, pageSettings a leaseToOwn. Musí se změnit alespoň jedno pole.
Parametr: pageSettings.forSalePageEnabled
Povinné: Ne
Typ a omezení: Boolean; zapíná nebo vypíná stránku Na prodej.
Parametr: pageSettings.contactOwnerEnabled
Povinné: Ne
Typ a omezení: Boolean; zapíná nebo vypíná formulář Kontaktovat vlastníka na stránce Na prodej.
Parametr: pageSettings.showSellerPortfolioLink
Povinné: Ne
Typ a omezení: Boolean; zda stránka Na prodej odkazuje na stránku vašeho portfolia prodejce.
Parametr: leaseToOwn
Povinné: Podmíněně
Typ a omezení: Změna lease-to-own. Odešlete přesně jedno z prices, pageSettings a leaseToOwn.
Parametr: leaseToOwn.action
Povinné: Ano, v rámci leaseToOwn
Typ a omezení: disable vypne lease-to-own; apply_saved_presets použije předvolby lease-to-own uložené pro váš účet.

Vrací — stejnou sdílenou odpověď jako marketplace_listings_import: status (working nebo already_running), operation s handlováním bulk:, checkWith, checkAfterSeconds a note. Odpověď working vypadá takto (objekt operation, uvedený informativně, je zde vynechán):

{
"status": "working",
"checkWith": {
"tool": "async_operation_get",
"arguments": { "operationId": "bulk:5b8e2c41-7d3a-4f19-9c06-2e7a1d4b8f53" }
},
"checkAfterSeconds": 10,
"note": "The update is still running; operation.details holds the progress. The operation is not complete yet. Check again with async_operation_get in about 10 seconds. Do not call marketplace_listings_bulk_update again for this request; the operation has already started."
}

`marketplace_negotiations_bulk_cancel` — Hromadné zrušení jednání na Marketplace

Přístup: Citlivý zápis — zruší mnoho jednání najednou.

Zruší mnoho jednání u vašich nabídek v jedné operaci, vybraných přesně jedním z negotiationIds (až 5000) nebo filter. Filtr vybírá pouze otevřená jednání a musí uvádět alespoň jedno kritérium; chcete-li zrušit každé otevřené jednání u vašich nabídek, nastavte samotné filter.allNegotiations na true. Zrušené jednání je pozastaveno, nikoli smazáno: každé lze později samostatně obnovit.

Když výběr neodpovídá žádnému otevřenému jednání, odpovědí je běžný výsledek { "status": "nothing_to_cancel", "matchedCount": 0, "note": "No open negotiation matches the selection, so nothing was cancelled and no confirmation is needed." }: nic se nezruší a není co potvrzovat.

Dvoukrokové potvrzení. Nejprve zavolejte bez confirmationToken: nic se nezruší a odpověď bude status: "confirmation_required" s matchedCount, počtem jednání, kterým výběr právě odpovídá, a confirmationToken. Ukažte uživateli, co bude zrušeno, pak zavolejte znovu se stejnými argumenty, tímto confirmationToken a confirmationResponse: "accept" pro pokračování, nebo confirmationResponse: "decline" pro zastavení; při odmítnutí je odpověď status: "cancelled" a nic se nezmění. Token je vázán na tyto přesné argumenty a na počet shod a po krátké době vyprší: zastaralý nebo již neodpovídající token vrátí nové confirmation_required s novým tokenem, nikdy chybu.

Přijaté volání spustí rušení, které probíhá po volání: odpověď je status: "working" s handlováním operace bulk:, které se předá do async_operation_get; to hlásí počet dokončených jednání z celkového počtu a u každého, které nebylo zrušeno, důvod, například "The negotiation has an agreed sale." nebo "The negotiation is already cancelled.". Neopakujte volání, které vrátilo working. Na účet může současně běžet jen jedna hromadná operace; zatímco jedna běží, odpověď je status: "already_running" s note a nic nového se nespustí.

Parametr: negotiationIds
Povinné: Podmíněně
Typ a omezení: 1–5000 ID jednání (UUID), každé nejvýše jednou. Odešlete buď negotiationIds, nebo filter, ne obojí.
Parametr: filter
Povinné: Podmíněně
Typ a omezení: Kritéria vybírající otevřená jednání u vašich nabídek. Odešlete buď negotiationIds, nebo filter, ne obojí. Vyžaduje alespoň jedno kritérium, nebo samotné allNegotiations.
Parametr: filter.allNegotiations
Povinné: Ne
Typ a omezení: true pro zrušení každého otevřeného jednání u vašich nabídek. Nekombinuje se s jinými kritérii.
Parametr: filter.domainNameContains
Povinné: Ne
Typ a omezení: Pouze jednání, jejichž název domény obsahuje tento text, 1–63 znaků.
Parametr: filter.qualityOfferOnly
Povinné: Ne
Typ a omezení: true pouze pro jednání, která mají zálohu Quality Offer.
Parametr: confirmationToken
Povinné: Ne
Typ a omezení: Token z předchozí odpovědi confirmation_required pro tyto přesné argumenty, až 4096 znaků. Při prvním volání vynechte.
Parametr: confirmationResponse
Povinné: Podmíněně
Typ a omezení: accept nebo decline. Pouze společně s confirmationToken.

Vrací

{
"status": "confirmation_required",
"confirmationToken": "eyJ2IjoxLCJ0IjoibWFya2V0cGxhY2VfbmVnb3RpYXRpb25zX2J1bGtfY2FuY2VsIn0.Qm9yZGVy",
"note": "Nothing has been changed yet. Show the confirmation to the user and, once they agree, call marketplace_negotiations_bulk_cancel again with this confirmationToken and confirmationResponse=\"accept\", or with confirmationResponse=\"decline\" to cancel.",
"matchedCount": 12
}

status: confirmation_required
Význam: Nic nebylo zrušeno. Obsahuje matchedCount a confirmationToken pro potvrzovací volání.
status: cancelled
Význam: Požadavek byl odmítnut; nic se nezměnilo. Obsahuje matchedCount.
status: working
Význam: Rušení bylo spuštěno. Obsahuje operation s handlováním bulk:, checkWith, checkAfterSeconds a note, stejně jako u marketplace_listings_bulk_update.
status: already_running
Význam: Běží jiná hromadná operace účtu; nic nového nebylo spuštěno. Počkejte, až skončí, a pak to zkuste znovu.

Marketplace: exporty

Stáhněte si nabídky nebo prodeje účtu jako soubor CSV. Soubor se připraví po volání: odpověď je status: "working" s handlováním operace event: pro sledování pomocí async_operation_get a dokončená operace obsahuje odkaz na soubor. Na účet může současně běžet pouze jeden export každého druhu.

`marketplace_listings_export` — Export mých nabídek na Marketplace

Přístup: Čtení.

Spustí export CSV aktuálních nabídek vašeho účtu na Spaceship marketplace tak, jak je zobrazuje karta SellerHub Domains, včetně jejich cen a nastavení. status a tld jej zužují stejným způsobem, jako zužují marketplace_listings_list, například jen na nabídky .com.

Parametr: status
Povinné: Ne
Typ a omezení: 1–9 různých stavů nabídek, jako v marketplace_listings_list. Pro aktuální nabídky vynechte.
Parametr: tld
Povinné: Ne
Typ a omezení: 1–20 různých koncovek bez úvodní tečky, např. ["com"].

Odpověď je status: "working" s handlováním operace v operation.operationId, které je také uvedeno jako checkWith. checkAfterSeconds říká, kdy se podívat.

Předejte handlování do async_operation_get. Když export uspěje, details.downloadUrl odkazuje na soubor CSV až do details.downloadUrlExpiresAt.

Neopakujte volání, dokud export stále běží: už byl spuštěn a jeho opakování ho nezrychlí.

Zatímco běží export nabídek účtu, odpověď je status: "already_running" s note, nic nového se nespustí a nejde o chybu: počkejte, až běžící export skončí, a pak zavolejte znovu. Tato odpověď neobsahuje žádné handlování, protože běžící export nelze pojmenovat.

Vrací — sdílenou odpověď operace, která běží po volání:

Pole: status
Význam: working po spuštění exportu; already_running zatímco běží jiný export nabídek účtu (pak se vrací jen status a note).
Pole: export
Význam: listings.
Pole: operation
Význam: Operace při posledním čtení, informativně: operationId (handlování event:), status (pending, success nebo failed, stejné hodnoty, které vrací async_operation_get pro toto handlování), type (marketplace_listingsExport), details, createdAt a modifiedAt.
Pole: checkWith
Význam: { "tool": "async_operation_get", "arguments": { "operationId": "event:…" } } — volání, které je třeba provést pro sledování exportu.
Pole: checkAfterSeconds
Význam: Jak dlouho čekat před kontrolou, například 10.
Pole: note
Význam: Co se stalo a co dělat dál; ukažte to uživateli.

Odpověď working vypadá takto (objekt operation, uvedený informativně, je zde vynechán):

{
"status": "working",
"checkWith": {
"tool": "async_operation_get",
"arguments": { "operationId": "event:0b6cf50e-95a3-4c4b-8f43-2d84e537f3c5" }
},
"checkAfterSeconds": 10,
"export": "listings",
"note": "The export file is being prepared. The operation is not complete yet. Check again with async_operation_get in about 10 seconds. Do not call marketplace_listings_export again for this request; the operation has already started."
}

`marketplace_sales_export` — Export mých prodejů na Marketplace

Přístup: Čtení.

Spustí export CSV domén, které váš účet prodal na Spaceship marketplace mezi soldFrom a soldTo, přičemž obě jsou data UTC a obě se započítávají. Běží po volání přesně stejně jako marketplace_listings_export: odpověď je status: "working" s handlováním event:, které se předá do async_operation_get, jehož odpověď success obsahuje details.downloadUrl a details.downloadUrlExpiresAt. Neopakujte volání, které vrátilo working. Zatímco běží export prodejů účtu, odpověď je status: "already_running" s note a nic nového se nespustí. Datum, které není skutečným kalendářním datem, nebo soldFrom po soldTo, je odmítnuto pomocí application.request.badRequest ještě předtím, než se cokoli spustí.

Parametr: soldFrom
Povinné: Ano
Typ a omezení: První datum prodeje, které se má zahrnout, YYYY-MM-DD (UTC). Nesmí být po soldTo.
Parametr: soldTo
Povinné: Ano
Typ a omezení: Poslední datum prodeje, které se má zahrnout, YYYY-MM-DD (UTC).

Vrací — stejnou sdílenou odpověď jako marketplace_listings_export, s export nastaveným na sales a operací typemarketplace_salesExport.

Asynchronní operace

`async_operation_get` — Získat stav asynchronní operace

Přístup: Čtení.

Kontroluje dlouho běžící operaci na vašem účtu podle jejího operationId. Volejte jej opakovaně, dokud status nebude success nebo failed. U registrace domény vrací také potvrzení o nákupu (viz níže).

Parametr: operationId
Povinné: Ano
Typ a omezení: Alfanumerický řetězec, max. 36 znaků, vrácený nástrojem, který operaci spustil. Může to být také handlování s předponou async:, bulk: nebo event:, přesně tak, jak jej nástroj vrátil.

Vrací

Pole: operationId
Význam: Dotazovaná operace.
Pole: status
Význam: pending, success nebo failed.
Pole: type
Význam: Typ operace nebo null.
Pole: details
Význam: Další podrobnosti o operaci nebo null.
Pole: createdAt / modifiedAt
Význam: Kdy byla operace vytvořena / naposledy aktualizována (modifiedAt může být null).
Pole: orderId
Význam: Pouze pro registrace domén, které skončily (success nebo failed). Objednávka, ke které nákup patří, přítomná tehdy, když operace pojmenovává svou objednávku. Je zadržena, pokud tato objednávka pro tuto doménu nepatří vašemu účtu.
Pole: nextRenewal
Význam: Pouze úspěšné registrace domén. Objekt s date (YYYY-MM-DD), kdy registrovaná doména vyprší v registru, a jednoletou cenou obnovení price (částka a měna). Cena je vynechána, když ji nelze určit, a celé pole je vynecháno, když nelze přečíst záznam registru. Datum pochází z registru, takže nejde o odhad.
Pole: refusalReason
Význam: Pouze neúspěšné registrace domén, když objednávka ukazuje, že platba byla odmítnuta. payment_declined (opravte nebo nahraďte platební metodu a poté nákup spusťte znovu) nebo cardholder_confirmation_required (dokončete nákup na webu pomocí platební metody, kterou může držitel karty potvrdit). Mohou být přidány další hodnoty, proto s neznámou hodnotou zacházejte jako s obecným odmítnutím platby. U jakéhokoli jiného selhání chybí a také kdykoli nelze objednávku přečíst, nepatří vašemu účtu pro tuto doménu nebo její načtení trvá příliš dlouho.
Pole: paymentMethods
Význam: Pouze vedle refusalReason a pouze tehdy, když je bylo možné načíst: uložené platební metody účtu, každá pouze jako { id, label }. Na rozdíl od výsledku payment_unavailable neobsahuje typ, pořadí, zůstatek ani příznak vypršení platnosti.

Potvrzení o registraci domény. Když operace registrace domény skončí, text odpovědi je potvrzení o nákupu — zobrazte ho uživateli beze změn. Potvrzení dostane pouze registrační operace, která dosáhne stavu success nebo failed; každá jiná operace a registrace, která je stále pending, se vrací přesně jako dříve.

Stav success je potvrzené potvrzení:

Váš nákup je potvrzen. example.com je zaregistrována.
ID objednávky: 7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16
Doména: example.com
Období: 1 rok
Účtováno: 9.08 USD
Platební metoda: Visa ···1234
Příští obnovení: Obnoví se 2027-10-13 za 10.98 USD
Potřebujete pomoc? Kontaktujte podporu: https://www.spaceship.com/about/contact-us/
Zásady vrácení peněz: https://www.spaceship.com/legal/refund-policy/

{
"operationId": "2c9a4e7d1b3f48a6b05d9e7c1f2a8b34",
"status": "success",
"type": "domains_Register",
"details": { "name": "example.com", "orderId": "7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16" },
"createdAt": "2026-10-13T09:41:07Z",
"modifiedAt": "2026-10-13T09:41:19Z",
"orderId": "7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16",
"nextRenewal": { "date": "2027-10-13", "price": { "amount": 10.98, "currency": "USD" } }
}

Registrace se stavem failed je popsána poctivě — doména nebyla zaregistrována — a neobsahuje částku, platební metodu ani obnovení:

Tento nákup nebylo možné dokončit a doména nebyla zaregistrována.
Pokud u tohoto nákupu vidíte zaúčtování, kontaktujte podporu.
ID objednávky: 7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16
Doména: example.com
Potřebujete pomoc? Kontaktujte podporu: https://www.spaceship.com/about/contact-us/
Zásady vrácení peněz: https://www.spaceship.com/legal/refund-policy/

Když objednávka ukazuje, že platba byla odmítnuta, neúspěšné potvrzení přidá za nadpis jeden řádek s pokyny a výsledek přidá refusalReason a, pokud je bylo možné načíst, také paymentMethods účtu:

Tento nákup nebylo možné dokončit a doména nebyla zaregistrována.
Pokud u tohoto nákupu vidíte zaúčtování, kontaktujte podporu.
Platba byla odmítnuta. Opravte nebo nahraďte platební metodu a poté nákup spusťte znovu.
ID objednávky: 7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16
Doména: example.com
Potřebujete pomoc? Kontaktujte podporu: https://www.spaceship.com/about/contact-us/
Zásady vrácení peněz: https://www.spaceship.com/legal/refund-policy/

{
"operationId": "2c9a4e7d1b3f48a6b05d9e7c1f2a8b34",
"status": "failed",
"type": "domains_Register",
"details": { "name": "example.com", "orderId": "7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16" },
"createdAt": "2026-10-13T09:41:07Z",
"modifiedAt": "2026-10-13T09:41:19Z",
"orderId": "7f3c1a9e-2b64-4d08-9a51-c0e8d4b27f16",
"refusalReason": "payment_declined",
"paymentMethods": [
{ "id": "3f1c2b7e-8d4a-4f6b-9c0e-1a2b3c4d5e6f", "label": "Visa ···1234" }
]
}

Platba, která vyžaduje potvrzení držitele karty, zní „Platba vyžaduje potvrzení držitele karty, což zde nelze provést. Dokončete nákup na webu pomocí platební metody, kterou můžete potvrdit.“ s refusalReasoncardholder_confirmation_required.

Poznámky k potvrzení:

Účtovaná částka, platební metoda a období pocházejí z objednávky a datum obnovení pochází ze zaregistrované domény. Pokud je zdroj nedostupný nebo pomalý, řádky, které na něm závisejí, se vynechají a volání přesto uspěje — hodnota, kterou nelze určit, se nikdy neodhaduje. Když operace neuvádí žádnou objednávku, potvrzení neobsahuje ID objednávky, částku ani platební metodu a období se odvodí z data registrace a vypršení platnosti, pokud to umožňují.
Řádek obnovení zní „Obnoví se <date> za <price>“, když je pro doménu zapnuté automatické obnovení, a „Vyprší <date>; cena obnovení <price>“, když je vypnuté. Cena je cena obnovení na jeden rok.
Platební metoda se uvádí jako Visa ···1234 (tři prostřední tečky) nebo Account funds; zůstatek prostředků se nikdy nezobrazuje.
U výsledku failed získá structuredContent položku orderId, když je známá a není zadržena, a nikdy nextRenewal. refusalReason a paymentMethods se přidávají pouze tehdy, když objednávka, kterou operace uvádí, patří vašemu účtu pro tuto doménu a její položka zaznamenává odmítnutou platbu; každé jiné selhání, objednávka, kterou nelze včas načíst, nebo objednávka, která patří někomu jinému, zachovává prosté neúspěšné potvrzení. Důvod se čte z vlastního kódu selhání objednávky a nikdy nejde o text poskytovatele plateb.

Hromadné operace marketplace. Identifikátor bulk: vrácený nástroji pro hromadné operace marketplace (viz Marketplace: hromadné operace) odpovídá stavem pending, zatímco operace běží, s průběhem v details: done (položky dokončené bez selhání) z total. Dotazujte se na něj ne častěji, než udává checkAfterSeconds, které poskytl spouštěcí nástroj. Operace, která trvá déle než obvykle, zůstává pending, dokud skutečně neskončí; nikdy není předčasně hlášena jako dokončená nebo neúspěšná.

Když skončí, status je success, pokud prošel alespoň jeden listing nebo vyjednávání, i když jiné selhaly, a failed, pokud neprošlo žádné. V obou případech details.failed uvádí každý listing nebo vyjednávání, které neprošlo, jako { "item": "<domain name>", "reason": "<one sentence>" }, například { "item": "example.com", "reason": "The domain is not in this account." }. details.failedTotal je počet neúspěšných položek a details.failedTruncated je true, když seznam zobrazuje pouze první z nich. Před spuštěním nové operace pro tyto položky opravte příčinu uvedenou v důvodu.

Dokončená odpověď také uvádí operaci podle nástroje, který ji spustil, v type (marketplace_listingsImport, marketplace_listingsBulkUpdate nebo marketplace_negotiationsBulkCancel) a obsahuje note, což je také text odpovědi: při success uvádí počty načtené z operace, například „Import skončil: 2 ze 3 domén byly zalistovány, 1 selhala. operation.details.failed uvádí každou doménu, která nebyla zalistována, a proč.“, s poslední větou uvádějící, kolik selhání seznam obsahuje, když je zkrácen; při failed říká, že neprošla žádná položka. Když operace skončí v rámci volání, které ji spustilo, odpověď tohoto nástroje nese stejné status a type ve svém operation a otevírá své note stejným shrnutím.

Identifikátor bulk:, který patří jinému účtu, odpovídá business.notFound, přesně stejně jako identifikátor, který neexistuje. Dokončená operace zůstává čitelná a pozdější čtení vrátí stejný výsledek.

Exporty marketplace. Identifikátor event: vrácený nástroji marketplace_listings_export a marketplace_sales_export odpovídá stavem pending, zatímco se soubor připravuje, s typemarketplace_listingsExport nebo marketplace_salesExport a details.export nastaveným na listings nebo sales. Když je soubor připraven, odpověď je success a details přidá downloadUrl, odkaz na CSV soubor, a downloadUrlExpiresAt, kdy tento odkaz přestane fungovat; chcete-li poté získat nový odkaz, spusťte nový export. Export se stavem failed obsahuje pouze details.export: soubor nebylo možné připravit a nový export lze spustit později. Export, který trvá déle než obvykle, zůstává pending, dokud skutečně neskončí. Identifikátor event:, který patří jinému účtu, odpovídá business.notFound, přesně stejně jako identifikátor, který neexistuje, takže odkaz ke stažení se zobrazí pouze účtu, který export spustil.

Chyby

Když volání selže, nástroj vrátí chybu s kódem a lidsky čitelným detail vysvětlujícím, co se pokazilo — například neplatný vstup (chybně vytvořený název domény nebo ID kontaktu), doména nebo kontakt, který neexistuje, nebo konflikt s aktuálním stavem. Pokud nástroj není dostupný, protože asistent k němu nedostal přístup, znovu připojte Spaceship MCP Connector a schvalte přístup, o který žádá.

Neúspěšné volání má vždy stejný tvar: isError je true, textový obsah zní <code>: <detail> a structuredContent.error obsahuje code, detail a, když má odmítnutý vstup několik problémů, seznam validationErrors. Tvar je stabilní; příčinu čtěte v detail. Argumenty, které neodpovídají parametrům nástroje (chybějící povinné pole, nesprávný typ, hodnota mimo rozsah), jsou odmítnuty dříve, než nástroj cokoli udělá, s kódem application.request.badRequest: detail uvádí každý problém a validationErrors obsahuje jednu položku pro každý problém s cestou argumentu v field (například items.0.domain) a důvodem v message. Volání nad limit četnosti vrací application.request.tooManyRequests a volání, které rozsahy tokenu nepovolují, vrací application.forbidden. Nástroj, který nespadá do vámi uděleného přístupu, není uveden v seznamu a volání na něj je místo toho zodpovězeno jako neznámý nástroj (viz Přístup, který udělujete).

Každé jiné selhání nese jeden ze šesti kódů, které pojmenovávají situaci, takže se můžete rozhodnout, co dělat dál. Text detail je napsán službou, je pro každou situaci pevně daný a nikdy neobsahuje interní identifikátory ani text z připojeného systému:

Kód: business.notFound
Význam: Doména, kontakt nebo záznam není v tomto účtu nebo pro tuto koncovku není k dispozici ceník.
Pevně dané texty detailu: „Tato doména není v tomto účtu.“; „Kontakt nebyl v tomto účtu nalezen.“; „Jeden nebo více kontaktů nebylo v tomto účtu nalezeno.“; „Ceník pro tuto doménovou koncovku není k dispozici.“; „Požadovaný prostředek nebyl nalezen.“; u nástrojů marketplace: „Listing nebyl nalezen.“; „Vyjednávání nebylo nalezeno.“; „SafePay deal nebyl nalezen.“; „Lease nebyl nalezen.“
Kód: business.invalidArgument
Význam: Požadavek byl pochopen, ale vstup není přijatelný.
Pevně dané texty detailu: „Požadované registrační období není pro tuto doménovou koncovku podporováno.“; „Tato doménová koncovka není podporována.“; „Kontakty nejsou pro tuto doménu platné.“; „Kontaktní údaje byly odmítnuty.“; „Služba požadavek odmítla.“; u nástrojů marketplace, pro chybně vytvořený název domény (položka validationErrors uvádí pole domain s pravidlem pattern): „Doména musí být název domény, například "example.com".“; nebo zpráva pojmenovávající problém
Kód: business.conflict
Význam: Požadavek je v konfliktu s aktuálním stavem.
Pevně dané texty detailu: „Tato doména je již zaregistrována.“; „Tato doména není k registraci dostupná.“; „Kontakt s těmito údaji již existuje.“; „Tyto nameservery jsou pro tuto doménu již nastaveny.“; „Požadavek je v konfliktu s aktuálním stavem prostředku.“; u nástrojů marketplace: „Listing, vyjednávání nebo deal není ve stavu, který tuto akci umožňuje.“; „Pro tento účet již běží operace tohoto druhu.“
Kód: infrastructure.outcomeUnknown
Význam: marketplace_offer_accept, marketplace_safepay_deal_create, marketplace_safepay_deal_confirm a marketplace_lease_cancel pouze: akce byla odeslána a její výsledek není znám, takže mohla být provedena. Před dalším voláním načtěte vyjednávání, deal nebo lease; viz Opakování zápisů.
Pevně dané texty detailu: „Výsledek není znám: akce mohla, ale nemusela být provedena.“
Kód: infrastructure.serviceUnavailable
Význam: Připojená služba nemohla volání dokončit. Zkuste to později znovu. Po neúspěšném zápisu viz Opakování zápisů.
Pevně dané texty detailu: „Připojená služba nemohla požadavek dokončit.“; „Službu nebylo možné kontaktovat.“; „Služba odpověděla neočekávanou chybou.“; „Služba nemohla autorizovat interní volání.“

Když má odmítnutý vstup několik problémů, validationErrors uvádí parametry, které služba odmítla, každý jako { "field": "<parameter name>", "rule": "<kind of rejection>", "message": "<fixed text>" }. rule je jedno z required, length, pattern, range, enum nebo generic a message zapisuje Spaceship MCP z tohoto pravidla: vlastní text služby se nikdy nepředává dál. Pole, které není jedním z vlastních parametrů nástroje, se vynechá, a když nezbude žádné, validationErrors chybí a odmítnutí popisuje pouze detail.

Selhání, které služba nemůže přiřadit k výše uvedené situaci, například neočekávaná interní chyba, vrací kód infrastructure.unhandled s pevným detailem „Požadavek nebylo možné dokončit kvůli interní chybě.“ Takové volání opakujte později; okamžité opakování zřídka pomůže.

Opakování zápisů

Zápis, který selže s infrastructure.serviceUnavailable, mohl být přesto použit. Před dalším voláním:

contacts_save — nejprve vyhledejte kontakt pomocí contacts_list.
dns_records_save — nejprve načtěte záznamy pomocí dns_records_get.
domain_set_contacts — zavolejte jej znovu; znovu přiřadí stejné kontakty.
domain_set_nameservers — zavolejte jej znovu. Opakování, které zjistí, že nameservery jsou již nastavené, odpoví poznámkou „Již nastaveno; nic se nezměnilo.“; domains_list zobrazuje aktuální nameservery, takže jej načtěte, když vás odpověď nechá na pochybách.
dns_records_delete — zavolejte jej znovu; záznam, který první volání již odstranilo, se vrátí v notFound nebo v unconfirmed, když zónu nebylo možné plně načíst.
marketplace_purchase_link — zavolejte jej znovu; vytvoření odkazu nic neúčtuje a opakování poskytne nový odkaz.
ostatní zápisy marketplace — žádný se za vás neopakuje. Nejprve načtěte objekt: listing pomocí marketplace_listing_get, vyjednávání pomocí marketplace_negotiation_get, deal pomocí marketplace_safepay_deal_get, lease pomocí marketplace_lease_get, checkout odkazy pomocí marketplace_checkout_links_list a nastavení pomocí marketplace_seller_settings_get. Po infrastructure.outcomeUnknown u marketplace_offer_accept, marketplace_safepay_deal_create, marketplace_safepay_deal_confirm nebo marketplace_lease_cancel mohla být akce provedena: neopakujte ji, pokud načtení neukáže, že se nestala. Import, hromadná aktualizace nebo hromadné zrušení, které odpověděly working, běží: sledujte je pomocí async_operation_get místo jejich opětovného spouštění.

Nástroje, které pouze čtou, lze kdykoli zavolat znovu. Volání odmítnuté s application.request.tooManyRequests nebylo spuštěno: před dalším voláním chvíli počkejte.

Spaceship MCP Connector — referenční příručka nástrojů

Začínáme

Podmínky a soukromí

Přehled nástrojů

Přístup, který udělujete

Kontakty: odkazované pomocí ID

Běžné pracovní postupy

Kupujte domény přes platební odkaz

Aktualizujte kontakty u domény, kterou vlastníte

Změňte nameservery domény

Spravujte DNS záznamy

Zkontrolujte své portfolio

Prodávejte domény na marketplace

Kupte doménu na marketplace

Referenční příručka nástrojů

Kontakty

contacts_save — Uložit kontakt

contacts_get — Získat kontakt

contacts_list — Seznam kontaktů

Domény

domains_list — Seznam domén

domains_check_availability — Zkontrolovat dostupnost domény

domain_purchase_link — Získat odkazy pro nákup domény

domain_set_contacts — Nastavit kontakty domény

domain_set_nameservers — Nastavit nameservery domény

DNS záznamy

dns_records_get — Získat DNS záznamy

dns_records_save — Uložit DNS záznamy

dns_records_delete — Smazat DNS záznamy

Tvary záznamů

Marketplace: nabídky

marketplace_listings_list — Vypsat moje nabídky na Marketplace

marketplace_listing_get — Získat jednu nabídku na Marketplace

marketplace_listing_create — Zařadit doménu do prodeje

marketplace_listing_update — Aktualizace nabídky na Marketplace

marketplace_listing_delete — Odebrání nabídky z Marketplace

marketplace_listing_verify — Ověření vlastnictví domény nabídky

marketplace_listings_bulk_verify — Ověření vlastnictví všech neověřených nabídek

Marketplace: nastavení prodejce, přehledy, prodeje a odkazy na checkout

marketplace_seller_settings_get — Získání nastavení prodejce

marketplace_seller_settings_update — Aktualizace nastavení prodejce

marketplace_insights_get — Získat přehledy prodejce

marketplace_sales_list — Vypsat prodané domény

marketplace_checkout_links_list — Vypsat checkout odkazy

marketplace_checkout_link_create — Vytvořit checkout odkaz

marketplace_checkout_link_deactivate — Deaktivovat checkout odkaz

Marketplace: jednání a nabídky

marketplace_negotiations_list — Vypsat Marketplace jednání

marketplace_negotiation_get — Získat Marketplace jednání

marketplace_negotiation_message_send — Odeslat zprávu vyjednávání Marketplace

marketplace_offer_make — Vytvořit nabídku Marketplace

marketplace_offer_counter — Protinabídka Marketplace

marketplace_offer_accept — Přijmout nabídku Marketplace

marketplace_offer_decline — Odmítnout nabídku Marketplace

marketplace_offer_withdraw — Stáhnout protinabídku Marketplace

marketplace_negotiation_suspend — Zrušit (pozastavit) vyjednávání Marketplace

marketplace_negotiation_restore — Obnovit vyjednávání Marketplace

Marketplace: obchody SafePay, leasing a vyhledávání

marketplace_safepay_deals_list — Vypsat obchody SafePay

marketplace_safepay_deal_get — Získat obchod SafePay

marketplace_safepay_deal_create — Otevřít obchod SafePay

marketplace_safepay_deal_confirm — Potvrdit obchod SafePay

marketplace_leases_list — Vypsat leasingy

marketplace_lease_get — Získat leasing

marketplace_lease_cancel — Zrušit leasing

marketplace_listings_search — Hledat nabídky v Marketplace

marketplace_purchase_link — Získat platební odkaz Marketplace

Marketplace: hromadné operace

marketplace_listings_import — Importovat nabídky Marketplace

marketplace_listings_bulk_update — Hromadně aktualizovat nabídky Marketplace

marketplace_negotiations_bulk_cancel — Hromadné zrušení jednání na Marketplace

Marketplace: exporty

marketplace_listings_export — Export mých nabídek na Marketplace

marketplace_sales_export — Export mých prodejů na Marketplace

Asynchronní operace

async_operation_get — Získat stav asynchronní operace

Chyby

Opakování zápisů

`contacts_save` — Uložit kontakt

`contacts_get` — Získat kontakt

`contacts_list` — Seznam kontaktů

`domains_list` — Seznam domén

`domains_check_availability` — Zkontrolovat dostupnost domény

`domain_purchase_link` — Získat odkazy pro nákup domény

`domain_set_contacts` — Nastavit kontakty domény

`domain_set_nameservers` — Nastavit nameservery domény

`dns_records_get` — Získat DNS záznamy

`dns_records_save` — Uložit DNS záznamy

`dns_records_delete` — Smazat DNS záznamy

`marketplace_listings_list` — Vypsat moje nabídky na Marketplace

`marketplace_listing_get` — Získat jednu nabídku na Marketplace

`marketplace_listing_create` — Zařadit doménu do prodeje

`marketplace_listing_update` — Aktualizace nabídky na Marketplace

`marketplace_listing_delete` — Odebrání nabídky z Marketplace

`marketplace_listing_verify` — Ověření vlastnictví domény nabídky

`marketplace_listings_bulk_verify` — Ověření vlastnictví všech neověřených nabídek

`marketplace_seller_settings_get` — Získání nastavení prodejce

`marketplace_seller_settings_update` — Aktualizace nastavení prodejce

`marketplace_insights_get` — Získat přehledy prodejce

`marketplace_sales_list` — Vypsat prodané domény

`marketplace_checkout_links_list` — Vypsat checkout odkazy

`marketplace_checkout_link_create` — Vytvořit checkout odkaz

`marketplace_checkout_link_deactivate` — Deaktivovat checkout odkaz

`marketplace_negotiations_list` — Vypsat Marketplace jednání

`marketplace_negotiation_get` — Získat Marketplace jednání

`marketplace_negotiation_message_send` — Odeslat zprávu vyjednávání Marketplace

`marketplace_offer_make` — Vytvořit nabídku Marketplace

`marketplace_offer_counter` — Protinabídka Marketplace

`marketplace_offer_accept` — Přijmout nabídku Marketplace

`marketplace_offer_decline` — Odmítnout nabídku Marketplace

`marketplace_offer_withdraw` — Stáhnout protinabídku Marketplace

`marketplace_negotiation_suspend` — Zrušit (pozastavit) vyjednávání Marketplace

`marketplace_negotiation_restore` — Obnovit vyjednávání Marketplace

`marketplace_safepay_deals_list` — Vypsat obchody SafePay

`marketplace_safepay_deal_get` — Získat obchod SafePay

`marketplace_safepay_deal_create` — Otevřít obchod SafePay

`marketplace_safepay_deal_confirm` — Potvrdit obchod SafePay

`marketplace_leases_list` — Vypsat leasingy

`marketplace_lease_get` — Získat leasing

`marketplace_lease_cancel` — Zrušit leasing

`marketplace_listings_search` — Hledat nabídky v Marketplace

`marketplace_purchase_link` — Získat platební odkaz Marketplace

`marketplace_listings_import` — Importovat nabídky Marketplace

`marketplace_listings_bulk_update` — Hromadně aktualizovat nabídky Marketplace

`marketplace_negotiations_bulk_cancel` — Hromadné zrušení jednání na Marketplace

`marketplace_listings_export` — Export mých nabídek na Marketplace

`marketplace_sales_export` — Export mých prodejů na Marketplace

`async_operation_get` — Získat stav asynchronní operace