Skip to main content

15 docs tagged with "Mobile"

Written for the mobile app team.

View all tags

Address book

List, read, create, edit and delete the client's saved delivery addresses — replaces the five Shukah /maeda/address-book calls.

Client lookup

Find a client by phone number from a signed-in session — replaces Shukah GET /maeda/client.

Exchange token

Trade a Shukah token for a Locate token, or a Locate token for a Shukah token — a Locate-only endpoint with no Shukah equivalent.

Migration progress

Which Shukah APIs the mobile app calls for users and points already have a Locate replacement, which do not, and how each one was checked on dev.

OTP login

Log in or register with a phone number and a 4-digit SMS code — replaces Shukah GET /maeda/api/reset-otp and GET /maeda/api/verify-otp.

Point history

List the client's point transactions, newest first, one page at a time — replaces Shukah GET /maeda/client/point-history.

Point offers

List the point packages a client can buy or gift, read one package, and list the gift occasions — replaces Shukah GET /maeda/point-offer and /maeda/point-occasion.

Point orders

Create, read and pay a point gift order, and build the gift message — replaces the Shukah point-order calls and the two checkout-payment calls the app uses for gifts.

Points FAQ

List the points questions and answers in English and Arabic — replaces Shukah GET /maeda/points-faq.

Points wallet

Read the client's point balance and expiry date, the earn-rate table, and redeem a gift-card code — replaces Shukah client/points, point-rate and giftcard-code/use.

Profile and settings

Update the client's profile, switch push notifications on or off, and register a device — replaces Shukah PUT /maeda/client/:client_id and POST /maeda/client/add-device-id.

Shukah vs Locate

The Shukah (legacy) side of every API the mobile app calls in the user and points areas, set against the Locate API that replaces it, with the differences that cut across all of them.

Switch checklist

Every change the mobile app must make to move from Shukah to Locate in the user and points areas, from the 2026-10-02 parity audit.

User Migration

What replaced each Shukah API the mobile app calls for users, addresses and points — field by field — what is still missing, and how to get a test token to try the endpoints.

Verify token

Check the app's Locate token and get the signed-in client's profile — replaces Shukah GET /maeda/api/verify-token.