API referenceShop corner

Shop corner

5 operations. Every schema and example on this page is generated from the platform contract.

Her corner at this shop: what is on its way, to collect, earlier orders, and her settings here.

Dark behind SHOP_SIGN_IN and SHOP_CORNER (off: 404). Signed in at this shop only (this shop’s own cookie); every order read by this shop and her proved email. Never cached.

auth none, publicop getShopCornerrate limitederrors

Parameters

shopstringqueryrequired

Her shop: its handle (flourandbloom).

awayenumqueryoptional

Her corner is open on an item or drop page, not her shop page: each Buy again keeps only what her shop page’s basket would take now.

1

Response, 200

first_namestring, nullablerequired
sincestring, nullablerequired

Her first order here, or when she joined its list.

stampsinteger, nullablerequired

Her stamps here now. Null: the shop runs no loyalty, or none to say.

time_zonestringrequired

Her shop’s clock (IANA, e.g. Europe/London): every day and time in her corner is said on it.

newsbooleanrequired

A posted parcel on its way, or something to collect: the dot on her initial.

comingarray of objectrequired
14 child fields
orderstringrequired

Its order number.

titlestringrequired

What she ordered, in a few words.

photostring, nullablerequired
stepenumrequired

How far it has come: Paid · Packed · Posted · Arrives.

paidpackedpostedarrived
statusenumrequired
to_postlatepostedarrivednot_arrivedcame_back
paid_atstring, nullablerequired

An ISO time.

packed_atstring, nullablerequired

A tracking number was saved.

posted_atstring, nullablerequired

An ISO time.

serviceenumrequired
tracked_48tracked_24
parcel_kindenumrequired
letterboxsmall_parcelmedium_parcel
arrives_onstring, nullablerequired

The day it usually arrives by.

trackingobjectrequired
2 child fields
numberstringrequired
track_urlstring, nullablerequired
going_tostring, nullablerequired

"14 Mill Lane, RH1 4AB": her street and postcode.

total_penceintegerrequired
collectarray of objectrequired
7 child fields
orderstringrequired
countintegerrequired

How many things.

photostring, nullablerequired
daystring, nullablerequired
fromstring, nullablerequired
tostring, nullablerequired
placestring, nullablerequired
earlierarray of objectrequired
7 child fields
orderstringrequired
titlestringrequired
photostring, nullablerequired
howenumrequired
collectedarrived
onstringrequired
total_penceintegerrequired
linesarray of objectrequired

What Buy again puts back into her basket, only what can be ordered now.

3 child fields
item_idstringrequired

Her shop’s menu item.

option_idstring, nullablerequired

Its size or colour row, when it has one.

quantityintegerrequired
hearobjectrequired
1 child field
onbooleanrequired

She is on this shop’s list now.

detailsobjectrequired

Her name and mobile as she gave THIS shop herself (its copy, only when saved by her here or from her own sign-up in its app), and her proved email. Never the shop’s own correction, never a name or mobile typed on an order, never what another shop holds. Null: left out.

4 child fields
namestring, nullablerequired
emailstringrequired

Her proved address. Never changed here.

mobilestring, nullablerequired
can_changebooleanrequired

She can change her name and mobile here: exactly one record with her proved address is linked to this shop, and that link names no other email.

dataobjectrequired

Your data at <shop>. Null while SHOP_DATA_REQUESTS is off.

3 child fields
email_maskedstringrequired
can_sendbooleanrequired

A request can be sent now.

openarray of objectrequired
3 child fields
kindenumrequired
copydelete
sent_atstringrequired

An ISO time.

reply_bystringrequired

The shop answers by this day: one month, as the law says.

curl -G "https://www.membber.com/api/v1/shop-corner" \
  --data-urlencode "shop=flourandbloom"
Response, 200
{
  "first_name": "Alex",
  "since": "<since>",
  "stamps": -9007199254740991,
  "time_zone": "<time_zone>",
  "news": true,
  "coming": [
    {
      "order": "<order>",
      "title": "Morning class",
      "photo": "<photo>",
      "step": "paid",
      "status": "to_post",
      "paid_at": "<paid_at>",
      "packed_at": "<packed_at>",
      "posted_at": "<posted_at>",
      "service": "tracked_48",
      "parcel_kind": "letterbox",
      "arrives_on": "<arrives_on>",
      "tracking": {
        "number": "<number>",
        "track_url": "https://example.com/image.jpg"
      },
      "going_to": "<going_to>",
      "total_pence": 1500
    }
  ],
  "collect": [
    {
      "order": "<order>",
      "count": 1,
      "photo": "<photo>",
      "day": "<day>",
      "from": "<from>",
      "to": "<to>",
      "place": "<place>"
    }
  ],
  "earlier": [
    {
      "order": "<order>",
      "title": "Morning class",
      "photo": "<photo>",
      "how": "collected",
      "on": "<on>",
      "total_pence": 1500,
      "lines": [
        {
          "item_id": "7e22b9c7-0000-4000-8000-d0c50000007e",
          "option_id": "6dff1925-0000-4000-8000-d0c50000006d",
          "quantity": 1
        }
      ]
    }
  ],
  "hear": {
    "on": true
  },
  "details": {
    "name": "Example name",
    "email": "alex@example.com",
    "mobile": "<mobile>",
    "can_change": true
  },
  "data": {
    "email_masked": "alex@example.com",
    "can_send": true,
    "open": [
      {
        "kind": "copy",
        "sent_at": "<sent_at>",
        "reply_by": "<reply_by>"
      }
    ]
  }
}

Ask THIS shop for a copy of her data there, or to delete her details there. A request, never a deletion.

Dark behind SHOP_SIGN_IN, SHOP_CORNER and SHOP_DATA_REQUESTS (off: 404). Same origin only. One open request per shop, person and kind; the shop replies within one month. She is emailed at her proved address that it was sent.

auth none, publicop sendShopDataRequestidempotent retryrate limitederrors

Request body

shopstringrequired

Her shop: its handle (flourandbloom).

kindenumrequired
copydelete
curl -X POST "https://www.membber.com/api/v1/shop-corner/data-request" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "shop": "<shop>",
    "kind": "copy"
  }'
Response, 200
"<value>"

Your details: change her name and mobile as THIS shop holds them, for her proved email. Never her email, never another shop.

Dark behind SHOP_SIGN_IN and SHOP_CORNER (off: 404). Same origin only. Writes only her link to this shop (customer_store_memberships given_name / given_phone, marked as saved by her), never the shop’s own correction, never customers.*. Only the fields she changed are sent. A mobile is kept in E.164. Audited by field name, never a value. Never cached.

auth none, publicop changeShopCornerDetailsidempotent retryrate limitederrors

Request body

shopstringrequired

Her shop: its handle (flourandbloom).

namestringoptional

Her name as this shop should hold it, sent only when she changed it. Blank: take it out.

mobilestringoptional

Her mobile as she types it (07700 900123, or with its country), sent only when she changed it. Blank: take it out.

curl -X POST "https://www.membber.com/api/v1/shop-corner/details" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "shop": "<shop>"
  }'
Response, 200
"<value>"

Hear from <shop>: her own yes or no to this shop’s list, at once, for her proved email.

Dark behind SHOP_SIGN_IN and SHOP_CORNER (off: 404). Same origin only. On: the list’s own joining path with the list’s own words. Off: her rows here stop, each stop recorded as hers (drop_alert_changes, via shop_page).

auth none, publicop setShopCornerHearidempotent retryrate limitederrors

Request body

shopstringrequired

Her shop: its handle (flourandbloom).

onbooleanrequired

Response, 200

onbooleanrequired

She is on this shop’s list now.

curl -X POST "https://www.membber.com/api/v1/shop-corner/hear" \
  -H "Idempotency-Key: 1f0e2d3c-4b5a-4678-9abc-def012345678" \
  -H "Content-Type: application/json" \
  -d '{
    "shop": "<shop>",
    "on": true
  }'
Response, 200
{
  "on": true
}

The dot on her initial: something posted is on its way, or something is to collect.

Dark behind SHOP_SIGN_IN and SHOP_CORNER (off: 404). Signed in at this shop only. Never cached.

auth none, publicop getShopCornerNewsrate limitederrors

Parameters

shopstringqueryrequired

Her shop: its handle (flourandbloom).

Response, 200

newsbooleanrequired
curl -G "https://www.membber.com/api/v1/shop-corner/news" \
  --data-urlencode "shop=flourandbloom"
Response, 200
{
  "news": true
}
WhatsApp
Book a Call
Get Started
Shop corner API | Membber Developers