search_gifts
Search gifts deliverable to a country
Find gifts that can be delivered to a destination country, optionally filtered by free text, occasion, budget (minor units) and a needed-by date. Returns a shortlist with final customer prices (delivery included) and delivery days. Paginate with cursor.
输入参数limitquerycursorlocalecountry必填occasionbudget_maxbudget_mindate_needed
get_gift_details
Get gift details
Full description, contents, images, customer price, estimated delivery window (EST cutoff-aware), substitution policy and restrictions for one gift in one destination country.
输入参数localecountry必填gift_id必填
check_delivery
Check delivery feasibility
Is delivery to a country (optionally a city, by a date, for a specific gift) feasible? Returns earliest/latest estimate and warnings (PO box, hotel, holiday window) with a suggested action.
输入参数citylocalecountry必填gift_iddate_needed
create_checkout
Create a checkout link
Create a signed, single-purpose checkout link (30-minute expiry) for one gift to one country. The schema has no recipient fields on purpose: name, address, phone, delivery details and payment are collected on the secure page. Returns an order summary with the link. Retries with the same idempotency_key return the same link.
输入参数localecountry必填gift_id必填quantitydelivery_dategift_card_textidempotency_key必填
get_order_status
Get order status
Customer-facing status, ETA window and next action for an order. Looked up by the buyer's private order token, issued after payment; the token is the only credential. Never returns address, phone or payment details.
输入参数localeorder_token必填
list_my_orders
List my orders (signed-in)
The signed-in user's GiftRoam orders: status, ETA window, gift, destination and the order token for tracking. Requires the authenticated GiftRoam connection (OAuth, scope orders:read); on a guest connection it returns auth_required. Never returns addresses, phone numbers or payment details.
输入参数limitlocale