Maqsed API

Sign in to the customer app

1. New number? Send the registration form to get a code:

   curl -X POST https://maqsed-api.dev-moltaqa.cloud/v1/customer/auth/register/otp \
     -H 'Content-Type: application/json' \
     -d '{"name":"Sara","mobile":"0551234567","acceptTerms":true}'

2. Send the same form with the code to create the account and get a token:

   curl -X POST https://maqsed-api.dev-moltaqa.cloud/v1/customer/auth/register \
     -H 'Content-Type: application/json' \
     -d '{"name":"Sara","mobile":"0551234567","acceptTerms":true,"code":"1234"}'

3. Next time, log in with login/otp then login ({"mobile","code"}). Call the API with the token:

   curl https://maqsed-api.dev-moltaqa.cloud/v1/customer/... \
     -H 'Authorization: Bearer mq_cus_…'

   Signed in, /account changes the language or the mobile (a code to the new number), DELETE /account deletes it, and POST auth/logout signs out.

Advertisers

Same steps under /v1/advertiser/auth, with one form per account type: register/individual (name, mobile, email, cityId from GET /v1/advertiser/cities) or register/establishment (adds the CR number, tax number and the CR document, uploaded first to register/files). Each has an /otp step first. Login is login/otp then login. The response's nextStep says where the app goes. The control panel's sign-in is on the way.

Uploading files

Upload first with POST /v1/{app}/files?purpose=… (multipart, field file), then send the returned id to the endpoint that uses it. The file type is read from its bytes; each purpose has its own types and size limit (see the docs).