teas.co.uk

{"additionalProperties":false,"properties":{"idempotency_key":{"description":"Optional. A unique key for this change (8 to 128 letters, digits or . _ : -). Sending the same key again within 24 hours returns the first answer instead of making the change twice.","maxLength":128,"minLength":8,"pattern":"^[A-Za-z0-9._:-]{8,128}$","type":"string"},"only_ids":{"description":"Optional: only these  ⟨28 unchanged words⟩ 

 ⟨16 unchanged words⟩ "type":["string","null"]},"unlocks":{"description":"What the points unlock, cheapest first. Redeemed on teas.co.uk only.","items":{"properties":{"affordable":{"description":"True when the balance covers it.","type":"boolean"},"kind":{"description":"voucher, charity, physical or flex.","type":"string"},"label":{"type":"string"},"points":{"description":"Points it costs.","type":"integer"}},"type":"object"},"type":"array"},"url":{"type":"string"},"worth_text" ⟨7 unchanged words⟩ 

 ⟨12 unchanged words⟩ resume or cancel one of their teas.co.uk tea subscriptions, andsubscriptions; confirm which one and which change with them ⟨20 unchanged words⟩  a paused one, and cancel works on either;either. Cancel is final: a cancelled subscription cannot be resumed here, so cancel is final.here. An unknown id, or a change that does not fit the current status (such as pausing one already paused), returns an error and changes nothing. ReturnsIt returns the subscription as it is afterwards. To see theirthe subscriptions first use my_subscriptions.

 ⟨7 unchanged words⟩ to buy what is in their teas.co.uk basket. Leave basket_id picks the basket: leave it out on hosts that identify the customer;customer, and otherwise pass the basket_id an earlier basket tool returned.returned, Returnsso the basket and a secure link that opens teas.co.uk withcarries it,the wherebasket the customer signs in or creates an account, chooses delivery and pays.built. Each call makes a new link, validthat works for 7 days, andon any device; any link opens the basket as it is when opened. There the customer signs in or creates an account, chooses delivery and pays. An empty basket returns an error asking for a product first. The assistant never sees payment details, and no order is placed until the customer pays on teas.co.uk. To buy specific products without the basket, use checkout_session instead.checkout_session.

 ⟨16 unchanged words⟩  away, for example from a product result. PutsIt puts exactly these items in a fresh basket at live teas.co.uk prices and returns it with a secure link to pay on teas.co.uk; the basket the customer built earlier is not used or changed. checkout_session.items takes up tocheckout_session 20holds products,items: each withitem needs an id from find_products (and a quantity of 1 to 99, up to 20 items. offerId from the product feed is tried when thean id is not found) and a quantity of 1found. toDisplay 99;fields (name, description, images, url, merchant_name and, price are for display only and) never change what is charged. Items teas.co.ukthat cannot findbe found are listed in unavailable and the rest go ahead; if none are found it returns an error. Nothing is charged here and no order is placed until the customer pays on teas.co.uk. To check out the basket they have already built, use checkout_link instead.checkout_link.

Use this whenever someone wants to compare two to four teas.co.uk products side by side, for example on strength, caffeine, price per cup, pack size or brewing; they are shown side by side in one table.brewing. ids aretakes product ids from find_productsfind_products; (product links work too):too. repeatsA arerepeated ignored,id anycounts idonce. Ids that are not recognised isare listed in not_found whileand the rest are still compared, andcompared. fewerFewer than two recognised products returns an error. Search for each product first if you only have names;names. forFor everything about one product use get_product.

 ⟨20 unchanged words⟩  returns and refunds work. It takes no input, asbecause the answer is the same for every customer: UK delivery options priced by parcel weight, the free UK delivery threshold (worked out after discount codes, excluding gift cards), the 2pm dispatch cut off, the countries served, the returns rules and links to the full policy pages.everyone. Policy only: it does notnever looklooks at anyan order. To ask for a return use start_return, and to see wherefind an order is use track_order.

 ⟨19 unchanged words⟩  from teas.co.uk, a UK online tea shop. Not for general tea knowledge. query is the customer's own words and maywords; beleave leftit out to browse by filters alone;alone. everyEvery filter given applies at once. max_price is per pack in pounds and max_price_per_cup_pence is per cup in pence; limit is 1 to 12 (default 6);pence. resultsResults come inbest best_matchmatch orderfirst unless sort issays set;otherwise. outOut of stock products stay hidden unless include_out_of_stock is true. PricesThere areis liveno paging: limit caps the list and includetotal VAT.says how many matched, so narrow the filters to see others. If nothing matches every filter, time_of_day, strength, format and with_milk are dropped in that order (then the words, if another filter is left) and relaxed and note saysays which; kind, caffeine, organic, fairtrade, veganlabels, iced and both price limits are never dropped,dropped. soPrices anare emptylive listand meansinclude nothingVAT. fitsNext: them.get_product Forfor one product's details use get_productproduct, compare_products to compare use compare_products, andadd_to_basket to buy use add_to_basket. Not for general tea knowledge.buy.

 ⟨21 unchanged words⟩ with tea. Give query (the kind of recipe in plain words), product_id (from find_products, for recipes that use that product) or both;both. withWith both, recipes that use the product and match the words rank first, andfirst. aWith callneither, withthe neithercall is refused. limit is 1 to 10 (default 5) and. thereThere is no paging:, so the best matches come first, each with its type, prep time, up to three teas.co.uk products it uses and a link, andfirst. anAn empty list means nothing matched. Drinks made with alcohol are never included. To find productsbuy tothe buyproducts use find_products.

Use this wheneverwhen someone asks how to brew a teas.co.uk product ⟨7 unchanged words⟩  advice, or wants its full details. id matchesis the product id (SKU) shown byfrom find_products, compare_products or the basket, in any letter case;case. theThe numeric product id, the barcode or a teas.co.uk/product/ link also work, butwork. aA product name does not, so search with  ⟨7 unchanged words⟩  product no longer sold, returns an error ratherinstead thanof a guess. Price and stock are read live on each call. To set several products side by side use compare_products.

 ⟨5 unchanged words⟩  teas.co.uk account is linked, for example before account tools such as my_orders, my_subscriptions or rewards_balance, or when the  ⟨13 unchanged words⟩ : the account comes from the sign in. ReturnsIt returns an opaque account id that stays the same ⟨47 unchanged words⟩ 

 ⟨25 unchanged words⟩ first, from 1 to 20 (default 5);. thereThere is no paging, so raise it only when the customer asks about older orders. ReturnsEach order numbers, dates, status, totals, items andincludes can_return;can_return. anAn empty list means the linked account has no orders, andorders. withoutWithout a linked account it returns an error asking the customer to sign in. To follow one order with courier tracking use track_order, to buy an order again  ⟨8 unchanged words⟩ 

 ⟨30 unchanged words⟩ active or paused. It takes no input and always lists every subscription on the linked account, each with the id that change_subscription needs;needs. anAn empty list means there are none, andnone. withoutWithout a linked account it returns an error asking ⟨23 unchanged words⟩ 

 ⟨12 unchanged words⟩  an earlier teas.co.uk order. order_number comes from my_orders, (and only orders on the linked account are found);found. only_ids limits it to those product ids from that order,order; otherwise every product is added in its original quantity. AddsProducts themare added to the customer's basket at today's prices, on top of anything already there;there. productsProducts that cannot be added now (no longer  ⟨9 unchanged words⟩  parcel limit) are listed in messages and skipped, andskipped. ifIf nothing from the order (or from only_ids) can be found it returns an error. Calling it again adds themthe products again. Nothing is bought or charged until the customer pays on teas.co.uk. To see earlier orders first use my_orders.

 ⟨16 unchanged words⟩ what they are worth. It takes no input. Returns the points, their value, the tier and the points earned and spent so far; zeroZero points is a normal answer for a new account, andaccount. withoutWithout a linked account it returns an error asking ⟨10 unchanged words⟩  checkout on teas.co.uk, so this cannot redeem them:them. toTo buy, use checkout_link, andcheckout_link; for past orders use my_orders.

 ⟨8 unchanged words⟩ clearly asks to return items from a teas.co.uk order;order. checkConfirm the order, items and reason with them first, and thatcheck thethat order's can_return (from my_orders or track_order) is true.. order_number comes from my_orders and must be an order on the linked account;account. itemsEach areitem is a product idsid from that order, eachand its quantity is capped at the quantity bought, andbought; products not in thatthe order are ignored, (and if none match it returns an error);error. details is what happened, in the customer's words. Sends a returnThe request goes to the teas.co.uk team, who review it  ⟨33 unchanged words⟩ 

 ⟨28 unchanged words⟩ :{"id":{"description":"Product id fromof find_products.an item in that order (as listed by my_orders or track_order).","maxLength":120,"minLength":1,"type ⟨71 unchanged words⟩ 

Use this when a signed in customer asks where theirone teas.co.uk order is. order_number is the number from ⟨20 unchanged words⟩ any other number returns a not found error. ReturnsOnce the status, items,order courierhas trackingshipped numbersit andincludes linkscourier oncetracking shippedlinks; (before that, a note on dispatch times), the delivery method, the town and postcode area it goes to, andtimes. can_return, which says whether start_return can be used. For a ⟨6 unchanged words⟩ 

 ⟨19 unchanged words⟩  0 to 99, not an amount to add, andadd; 0 removes the line;line. id is the product id of the line, (from view_basket or add_to_basket).add_to_basket. If the product is not in the basket yet, a quantity above 0 adds it and 0 does nothing;nothing. anAn id teas.co.uk does not know, or an  ⟨19 unchanged words⟩ no basket at all it returns an error. SettingSending the same quantity again changes nothing. Returns the updated basket with the live subtotal and a delivery estimate; nothingNothing is bought or charged. To add new products use add_to_basket, and to see the basket first use view_basket.add_to_basket.

 ⟨11 unchanged words⟩ , with the live subtotal and a delivery estimate;estimate. pricesPrices and stock are read again on every call. Leave basket_id outis ononly for hosts that do not identify the customer,: orpass oncethe aone teas.co.ukan accountearlier isbasket linked;tool passreturned. itA onlybasket whenis ankept earlierfor basket35 tooldays returnedafter one.its last change. An unknown basket_id, or a basket never filled, comes back as an empty basket with (no lines and, no delivery price) rather than as an error. To add products use add_to_basket,  ⟨10 unchanged words⟩