Customer Auth & Addresses

Visibility

• POST /auth/signup — Public
• POST /auth/login — Public
• GET /auth/me — Authenticated
• GET /customers/me — Public storefront customer context
• POST /auth/me/addresses — Authenticated
• PATCH /auth/me/addresses/{address_id}/default — Authenticated
• DELETE /auth/me/addresses/{address_id} — Authenticated

Authentication Modes

Public auth entrypoints

x-api-key: sk_eco_...

Authenticated customer endpoints

Authorization: Bearer <jwt>

POST /auth/signup

Request Body

Response

AuthResponse containing token and customer user object.

POST /auth/login

Request Body

Response

AuthResponse containing token and customer user object.

GET /auth/me

Returns current authenticated customer profile.

GET /customers/me

Returns current customer context from storefront flow where customer identity is already resolved by storefront session logic.

Address Book Operations

POST /auth/me/addresses

PATCH /auth/me/addresses/{address_id}/default

Sets one address as default.

DELETE /auth/me/addresses/{address_id}

Deletes one address.

cURL

curl -X POST "https://api.ecommaps.com/api/v1/storefront/auth/signup" \
  -H "x-api-key: sk_eco_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"customer@example.com","password":"StrongPass123","full_name":"Customer"}'
 
curl -X GET "https://api.ecommaps.com/api/v1/storefront/auth/me" \
  -H "Authorization: Bearer <jwt>"

SDK Example

const auth = await ecommapsClient.auth.login({
  email: "customer@example.com",
  password: "StrongPass123",
});
 
await ecommapsClient.auth.addAddress(
  {
    line1: "Address line",
    city: "Algiers",
    state: "Algiers",
    country: "DZ",
    postal_code: "16000",
    phone: "0555000000",
  },
  { headers: { Authorization: `Bearer ${auth.token}` } },
);

Error Matrix