Connect domain operations without losing their meaning.

Use the public API contract

The Spaceship API documentation describes domain operations and SellerHub functions, including listing retrieval, creation, updates, and removal. It also labels some operations as under development. Verify the exact operation’s current status and required permission rather than assuming every documented heading is an available production feature.

Preserve SellerHub listing semantics

A SellerHub record can distinguish a fixed purchase price from a minimum offer setting. Those values should remain separate in your data model. Listing a name for sale does not mean it has been sold, and updating the minimum offer does not confirm a buyer’s proposal. Retain the source domain, listing state, currency, and observation time with each imported record.

Keep credentials and scopes narrow

The public reference specifies authentication and per-operation permissions. Store secrets in your server-side integration component and request only the access the workflow needs. A read-only portfolio view should not require a browser to hold credentials capable of modifying domain or DNS settings. Use explicit approval and audit records around changes with material operational consequences.

Separate checkout and completion

A documented checkout or transaction route should be modelled according to its actual response, not treated as proof of completed payment or domain delivery. Track the transaction identifier, relevant confirmation state, and later handoff evidence. Use the domain acquisition guide to distinguish a commercial outcome from a registrar or DNS configuration milestone.

Before you ship

Check pagination, partial updates, required fields, current rate limits, and any operation marked unavailable. Validate domain identity before changing a listing or configuration. Test duplicate requests and ambiguous timeouts using safe fixtures. Keep a source-of-truth policy so delayed imports cannot overwrite a newer, intentionally approved price or availability change.