{ "info": { "_postman_id": "e6e308d2-a4db-4c63-a1ca-bce4fbcc9241", "name": "ReValue API", "description": "ReValue marketplace API (Laravel Sanctum).\n\n## Folders\n- **General** — public catalog & site\n- **Client** — buyer cycles\n- **Provider** — seller cycles\n\n## Auth\n1. Run Client/Provider → Auth Cycle → Login then Verify login (OTP `1234`)\n2. Verify-login / activate scripts auto-save `data.token` → `client_token` or `provider_token` (+ `auth_token`)\n3. Or paste the token manually into the environment\n\n## Headers\n- `Authorization: Bearer …`\n- `Lang: ar|en`\n- `Accept: application/json`\n\n## Body\nPOST/PUT/PATCH use **form-data** (`multipart/form-data`).\n\n## Tests\nEvery request includes Postman **Tests** scripts:\n- HTTP 200 + JSON\n- Envelope `key` / `msg`\n- Expected `key` values for the endpoint\n- Token persistence on verify/activate\n- Optional resource id capture (`listing_id`, `order_id`, …)\n\n## Response\n`{ key, msg, data }` — validation failures often return HTTP 200 with `key=fail`.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "base_url", "value": "http://localhost" }, { "key": "lang", "value": "en" }, { "key": "auth_token", "value": "" }, { "key": "client_token", "value": "" }, { "key": "provider_token", "value": "" }, { "key": "listing_id", "value": "1" }, { "key": "order_id", "value": "1" }, { "key": "conversation_id", "value": "1" }, { "key": "address_id", "value": "1" }, { "key": "notification_id", "value": "1" }, { "key": "complain_id", "value": "1" }, { "key": "withdrawal_id", "value": "1" }, { "key": "country_id", "value": "1" }, { "key": "city_id", "value": "1" }, { "key": "category_id", "value": "1" }, { "key": "condition_id", "value": "1" }, { "key": "unit_id", "value": "1" }, { "key": "reason_id", "value": "1" }, { "key": "phone", "value": "512345678" }, { "key": "country_code", "value": "966" }, { "key": "provider_email", "value": "seller@example.com" }, { "key": "provider_password", "value": "Password1!" } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{auth_token}}", "type": "string" } ] }, "item": [ { "name": "General", "description": "Shared / public endpoints.", "item": [ { "name": "01 Catalog & Settings", "description": "Public lookup data — no auth.", "item": [ { "name": "Settings", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/settings", "host": [ "{{base_url}}" ], "path": [ "api", "settings" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Settings — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/settings", "host": [ "{{base_url}}" ], "path": [ "api", "settings" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Is production", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/is-production", "host": [ "{{base_url}}" ], "path": [ "api", "is-production" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Is production — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/is-production", "host": [ "{{base_url}}" ], "path": [ "api", "is-production" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Countries", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/countries", "host": [ "{{base_url}}" ], "path": [ "api", "countries" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Countries — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/countries", "host": [ "{{base_url}}" ], "path": [ "api", "countries" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Cities", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/cities?country_id=%7B%7Bcountry_id%7D%7D", "host": [ "{{base_url}}" ], "path": [ "api", "cities" ], "query": [ { "key": "country_id", "value": "{{country_id}}", "description": "optional|integer — filter by country", "disabled": false } ] }, "description": "**Validation**\n- `country_id`: optional|integer", "auth": { "type": "noauth" } }, "response": [ { "name": "Cities — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/cities?country_id=%7B%7Bcountry_id%7D%7D", "host": [ "{{base_url}}" ], "path": [ "api", "cities" ], "query": [ { "key": "country_id", "value": "{{country_id}}", "description": "optional|integer — filter by country", "disabled": false } ] }, "description": "**Validation**\n- `country_id`: optional|integer", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Countries with cities", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/countries-with-cities", "host": [ "{{base_url}}" ], "path": [ "api", "countries-with-cities" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Countries with cities — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/countries-with-cities", "host": [ "{{base_url}}" ], "path": [ "api", "countries-with-cities" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Country cities", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/country/{{country_id}}/cities", "host": [ "{{base_url}}" ], "path": [ "api", "country", "{{country_id}}", "cities" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Country cities — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/country/{{country_id}}/cities", "host": [ "{{base_url}}" ], "path": [ "api", "country", "{{country_id}}", "cities" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Listing categories", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/listing-categories", "host": [ "{{base_url}}" ], "path": [ "api", "listing-categories" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Listing categories — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/listing-categories", "host": [ "{{base_url}}" ], "path": [ "api", "listing-categories" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Material conditions", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/material-conditions", "host": [ "{{base_url}}" ], "path": [ "api", "material-conditions" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Material conditions — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/material-conditions", "host": [ "{{base_url}}" ], "path": [ "api", "material-conditions" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Units", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/units", "host": [ "{{base_url}}" ], "path": [ "api", "units" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Units — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/units", "host": [ "{{base_url}}" ], "path": [ "api", "units" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Market pulse", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/market-pulse", "host": [ "{{base_url}}" ], "path": [ "api", "market-pulse" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Market pulse — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/market-pulse", "host": [ "{{base_url}}" ], "path": [ "api", "market-pulse" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Guidance steps", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/guidance-steps", "host": [ "{{base_url}}" ], "path": [ "api", "guidance-steps" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Guidance steps — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/guidance-steps", "host": [ "{{base_url}}" ], "path": [ "api", "guidance-steps" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Motivational messages", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/motivational-messages?context=bidding", "host": [ "{{base_url}}" ], "path": [ "api", "motivational-messages" ], "query": [ { "key": "context", "value": "bidding", "description": "optional|in:bidding,outbid,leading", "disabled": false } ] }, "description": "**Validation**\n- `context`: optional|in:bidding,outbid,leading", "auth": { "type": "noauth" } }, "response": [ { "name": "Motivational messages — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/motivational-messages?context=bidding", "host": [ "{{base_url}}" ], "path": [ "api", "motivational-messages" ], "query": [ { "key": "context", "value": "bidding", "description": "optional|in:bidding,outbid,leading", "disabled": false } ] }, "description": "**Validation**\n- `context`: optional|in:bidding,outbid,leading", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Google Maps key", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/google-maps-key", "host": [ "{{base_url}}" ], "path": [ "api", "google-maps-key" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Google Maps key — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/google-maps-key", "host": [ "{{base_url}}" ], "path": [ "api", "google-maps-key" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Main", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/main", "host": [ "{{base_url}}" ], "path": [ "api", "main" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Main — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/main", "host": [ "{{base_url}}" ], "path": [ "api", "main" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Who is us", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/who-is-us", "host": [ "{{base_url}}" ], "path": [ "api", "who-is-us" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Who is us — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/who-is-us", "host": [ "{{base_url}}" ], "path": [ "api", "who-is-us" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Contact info", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/contact", "host": [ "{{base_url}}" ], "path": [ "api", "contact" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Contact info — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/contact", "host": [ "{{base_url}}" ], "path": [ "api", "contact" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] } ] }, { "name": "02 CMS & Contact", "item": [ { "name": "FAQs", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/faqs?type=&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "faqs" ], "query": [ { "key": "type", "value": "", "description": "string — required for filter; empty may return empty", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "**Validation**\n- `type`: string (filter)\n- `perPage`: int default 15", "auth": { "type": "noauth" } }, "response": [ { "name": "FAQs — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/faqs?type=&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "faqs" ], "query": [ { "key": "type", "value": "", "description": "string — required for filter; empty may return empty", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "**Validation**\n- `type`: string (filter)\n- `perPage`: int default 15", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "About", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/about", "host": [ "{{base_url}}" ], "path": [ "api", "about" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "About — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/about", "host": [ "{{base_url}}" ], "path": [ "api", "about" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Terms", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/terms", "host": [ "{{base_url}}" ], "path": [ "api", "terms" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Terms — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/terms", "host": [ "{{base_url}}" ], "path": [ "api", "terms" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Privacy", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/privacy", "host": [ "{{base_url}}" ], "path": [ "api", "privacy" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Privacy — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/privacy", "host": [ "{{base_url}}" ], "path": [ "api", "privacy" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Socials", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/socials", "host": [ "{{base_url}}" ], "path": [ "api", "socials" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Socials — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/socials", "host": [ "{{base_url}}" ], "path": [ "api", "socials" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Contact types", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/contact/types", "host": [ "{{base_url}}" ], "path": [ "api", "contact", "types" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Contact types — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/contact/types", "host": [ "{{base_url}}" ], "path": [ "api", "contact", "types" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Contact store", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/contact/store", "host": [ "{{base_url}}" ], "path": [ "api", "contact", "store" ] }, "description": "**Validation**\n- `name`: required|string|max:50\n- `country_code`: required|string|max:10\n- `phone`: required|string|min:8|max:15\n- `message`: required|string\n- `type`: required|in:trip_issue,payment_issue,damaged_scooter,suggestion,general_inquiry\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "required|string|max:50", "value": "Tester" }, { "key": "phone", "type": "text", "description": "required|string|min:8|max:15", "value": "{{phone}}" }, { "key": "country_code", "type": "text", "description": "required|string|max:10", "value": "{{country_code}}" }, { "key": "message", "type": "text", "description": "required|string", "value": "Hello from Postman" }, { "key": "type", "type": "text", "description": "required|in:trip_issue,payment_issue,damaged_scooter,suggestion,general_inquiry", "value": "general_inquiry" } ] } }, "response": [ { "name": "Contact store — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/contact/store", "host": [ "{{base_url}}" ], "path": [ "api", "contact", "store" ] }, "description": "**Validation**\n- `name`: required|string|max:50\n- `country_code`: required|string|max:10\n- `phone`: required|string|min:8|max:15\n- `message`: required|string\n- `type`: required|in:trip_issue,payment_issue,damaged_scooter,suggestion,general_inquiry\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "required|string|max:50", "value": "Tester" }, { "key": "phone", "type": "text", "description": "required|string|min:8|max:15", "value": "{{phone}}" }, { "key": "country_code", "type": "text", "description": "required|string|max:10", "value": "{{country_code}}" }, { "key": "message", "type": "text", "description": "required|string", "value": "Hello from Postman" }, { "key": "type", "type": "text", "description": "required|in:trip_issue,payment_issue,damaged_scooter,suggestion,general_inquiry", "value": "general_inquiry" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "03 Site Intro", "item": [ { "name": "Site home", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/home", "host": [ "{{base_url}}" ], "path": [ "api", "site", "home" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Site home — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/home", "host": [ "{{base_url}}" ], "path": [ "api", "site", "home" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Site clients", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/clients", "host": [ "{{base_url}}" ], "path": [ "api", "site", "clients" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Site clients — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/clients", "host": [ "{{base_url}}" ], "path": [ "api", "site", "clients" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Site providers", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/providers", "host": [ "{{base_url}}" ], "path": [ "api", "site", "providers" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Site providers — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/providers", "host": [ "{{base_url}}" ], "path": [ "api", "site", "providers" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Site companies", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/companies", "host": [ "{{base_url}}" ], "path": [ "api", "site", "companies" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Site companies — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/companies", "host": [ "{{base_url}}" ], "path": [ "api", "site", "companies" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Contact us", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/contact-us", "host": [ "{{base_url}}" ], "path": [ "api", "site", "contact-us" ] }, "description": "Throttle: 5/min\n\n**Validation**\n- `name`: required (site form)\n- `email`: required|email\n- `message`: required|string\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "required (site form)", "value": "Visitor" }, { "key": "email", "type": "text", "description": "required|email", "value": "visitor@example.com" }, { "key": "message", "type": "text", "description": "required|string", "value": "Hello" } ] } }, "response": [ { "name": "Contact us — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/contact-us", "host": [ "{{base_url}}" ], "path": [ "api", "site", "contact-us" ] }, "description": "Throttle: 5/min\n\n**Validation**\n- `name`: required (site form)\n- `email`: required|email\n- `message`: required|string\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "required (site form)", "value": "Visitor" }, { "key": "email", "type": "text", "description": "required|email", "value": "visitor@example.com" }, { "key": "message", "type": "text", "description": "required|string", "value": "Hello" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Newsletter", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/newsletter", "host": [ "{{base_url}}" ], "path": [ "api", "site", "newsletter" ] }, "description": "**Validation**\n- `email`: required|email\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email", "value": "visitor@example.com" } ] } }, "response": [ { "name": "Newsletter — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/site/newsletter", "host": [ "{{base_url}}" ], "path": [ "api", "site", "newsletter" ] }, "description": "**Validation**\n- `email`: required|email\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email", "value": "visitor@example.com" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] } ] }, { "name": "Client", "description": "Buyer (Client) API — use `client_token`.", "item": [ { "name": "01 Auth Cycle", "description": "Register → activate → login → verify OTP.", "item": [ { "name": "Register", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"needActive\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/register", "host": [ "{{base_url}}" ], "path": [ "api", "client", "register" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:2,5\n- `phone`: required|numeric|digits_between:9,10|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:2,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|starts_with:5", "value": "{{phone}}" } ] } }, "response": [ { "name": "Register — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/register", "host": [ "{{base_url}}" ], "path": [ "api", "client", "register" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:2,5\n- `phone`: required|numeric|digits_between:9,10|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:2,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|starts_with:5", "value": "{{phone}}" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"needActive\",\n \"msg\": \"Account created — activate with OTP\",\n \"data\": {\n \"phone\": \"{{phone}}\",\n \"country_code\": \"{{country_code}}\"\n }\n}" } ] }, { "name": "Activate", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"needs_acceptance\",\"needApproval\",\"needActive\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Auth success returns a token\", function () {", " if ([\"success\", \"needs_acceptance\", \"needApproval\"].includes(json.key)) {", " pm.expect(json.data).to.be.an(\"object\");", " pm.expect(json.data.token).to.be.a(\"string\").and.not.empty;", " }", "});", "", "// Persist Sanctum token for later authenticated requests", "if (json.data && json.data.token) {", " pm.environment.set(\"client_token\", json.data.token);", " pm.environment.set(\"auth_token\", json.data.token);", " console.log(\"Saved client_token (+ auth_token) from response\");", "}", "" ] } } ], "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/activate", "host": [ "{{base_url}}" ], "path": [ "api", "client", "activate" ] }, "description": "**Validation**\n- `code`: required|digits:4\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|digits:4", "value": "1234" }, { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" } ] } }, "response": [ { "name": "Activate — Example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/activate", "host": [ "{{base_url}}" ], "path": [ "api", "client", "activate" ] }, "description": "**Validation**\n- `code`: required|digits:4\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|digits:4", "value": "1234" }, { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Logged in successfully\",\n \"data\": {\n \"id\": 1,\n \"name\": \"Example User\",\n \"phone\": \"{{phone}}\",\n \"country_code\": \"{{country_code}}\",\n \"token\": \"1|exampleSanctumTokenReplaceMe\"\n }\n}" } ] }, { "name": "Resend code", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/resend-code", "host": [ "{{base_url}}" ], "path": [ "api", "client", "resend-code" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" } ] } }, "response": [ { "name": "Resend code — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/resend-code", "host": [ "{{base_url}}" ], "path": [ "api", "client", "resend-code" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Login", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"needVerification\",\"blocked\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/login", "host": [ "{{base_url}}" ], "path": [ "api", "client", "login" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n- `device_type`: required|in:ios,android,web\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" } ] } }, "response": [ { "name": "Login — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/login", "host": [ "{{base_url}}" ], "path": [ "api", "client", "login" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n- `device_type`: required|in:ios,android,web\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"needVerification\",\n \"msg\": \"Verification code sent\",\n \"data\": {\n \"phone\": \"{{phone}}\",\n \"country_code\": \"{{country_code}}\"\n }\n}" } ] }, { "name": "Verify login (OTP)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"needs_acceptance\",\"needApproval\",\"needActive\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Auth success returns a token\", function () {", " if ([\"success\", \"needs_acceptance\", \"needApproval\"].includes(json.key)) {", " pm.expect(json.data).to.be.an(\"object\");", " pm.expect(json.data.token).to.be.a(\"string\").and.not.empty;", " }", "});", "", "// Persist Sanctum token for later authenticated requests", "if (json.data && json.data.token) {", " pm.environment.set(\"client_token\", json.data.token);", " pm.environment.set(\"auth_token\", json.data.token);", " console.log(\"Saved client_token (+ auth_token) from response\");", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/verify-login", "host": [ "{{base_url}}" ], "path": [ "api", "client", "verify-login" ] }, "description": "Copy `data.token` → `client_token` (and optionally `auth_token`). Test OTP: `1234`.\n\n**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n- `code`: required|digits:4\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n- `mac_address`: required|max:250\n- `preferred_locale`: required|in:ar,en\n- `uuid`: sometimes|string\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|digits:4", "value": "1234" }, { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" }, { "key": "mac_address", "type": "text", "description": "required|max:250", "value": "00:00:00:00:00:00" }, { "key": "preferred_locale", "type": "text", "description": "required|in:ar,en", "value": "en" } ] } }, "response": [ { "name": "Verify login (OTP) — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/verify-login", "host": [ "{{base_url}}" ], "path": [ "api", "client", "verify-login" ] }, "description": "Copy `data.token` → `client_token` (and optionally `auth_token`). Test OTP: `1234`.\n\n**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n- `code`: required|digits:4\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n- `mac_address`: required|max:250\n- `preferred_locale`: required|in:ar,en\n- `uuid`: sometimes|string\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|digits:4", "value": "1234" }, { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" }, { "key": "mac_address", "type": "text", "description": "required|max:250", "value": "00:00:00:00:00:00" }, { "key": "preferred_locale", "type": "text", "description": "required|in:ar,en", "value": "en" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"needVerification\",\n \"msg\": \"Verification code sent\",\n \"data\": {\n \"phone\": \"{{phone}}\",\n \"country_code\": \"{{country_code}}\"\n }\n}" } ] }, { "name": "Forget password", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/password/forget", "host": [ "{{base_url}}" ], "path": [ "api", "client", "password", "forget" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" } ] } }, "response": [ { "name": "Forget password — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/password/forget", "host": [ "{{base_url}}" ], "path": [ "api", "client", "password", "forget" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Check reset code", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/password/check-code", "host": [ "{{base_url}}" ], "path": [ "api", "client", "password", "check-code" ] }, "description": "**Validation**\n- `code`: required|max:10\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|max:10", "value": "1234" } ] } }, "response": [ { "name": "Check reset code — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/password/check-code", "host": [ "{{base_url}}" ], "path": [ "api", "client", "password", "check-code" ] }, "description": "**Validation**\n- `code`: required|max:10\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:clients,phone\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:clients,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|max:10", "value": "1234" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Reset password", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/password/reset", "host": [ "{{base_url}}" ], "path": [ "api", "client", "password", "reset" ] }, "description": "**Validation**\n- `code`: required|max:10\n- `country_code`: required|exists:clients,country_code\n- `phone`: required|exists:clients,phone\n- `password`: required|string|min:8|letters|numbers\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|exists:clients,country_code", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|exists:clients,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|max:10", "value": "1234" }, { "key": "password", "type": "text", "description": "required|string|min:8|letters|numbers", "value": "Password1!" } ] } }, "response": [ { "name": "Reset password — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/password/reset", "host": [ "{{base_url}}" ], "path": [ "api", "client", "password", "reset" ] }, "description": "**Validation**\n- `code`: required|max:10\n- `country_code`: required|exists:clients,country_code\n- `phone`: required|exists:clients,phone\n- `password`: required|string|min:8|letters|numbers\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|exists:clients,country_code", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|exists:clients,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|max:10", "value": "1234" }, { "key": "password", "type": "text", "description": "required|string|min:8|letters|numbers", "value": "Password1!" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Logout", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/logout", "host": [ "{{base_url}}" ], "path": [ "api", "client", "logout" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Logout — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/logout", "host": [ "{{base_url}}" ], "path": [ "api", "client", "logout" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Delete account", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/delete-account", "host": [ "{{base_url}}" ], "path": [ "api", "client", "delete-account" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Delete account — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/delete-account", "host": [ "{{base_url}}" ], "path": [ "api", "client", "delete-account" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "02 Profile & Settings", "item": [ { "name": "Get profile", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/profile", "host": [ "{{base_url}}" ], "path": [ "api", "client", "profile" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Get profile — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/profile", "host": [ "{{base_url}}" ], "path": [ "api", "client", "profile" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Complete profile", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needs_acceptance\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/profile/complete", "host": [ "{{base_url}}" ], "path": [ "api", "client", "profile", "complete" ] }, "description": "Multipart also accepts `image`.\n\n**Validation**\n- `name`: required|string|min:2|max:50\n- `city_id`: required|integer|exists:cities,id\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `map_desc`: required|string|max:500\n- `national_id`: required|regex:/^[12]\\d{9}$/|unique:clients\n- `image`: nullable|image|max:5120\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "required|string|min:2|max:50", "value": "Buyer Name" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "map_desc", "type": "text", "description": "required|string|max:500", "value": "Riyadh" }, { "key": "national_id", "type": "text", "description": "required|regex:/^[12]\\d{9}$/|unique:clients", "value": "1000000001" }, { "key": "image[]", "type": "file", "src": [], "value": "", "description": "nullable|image|max:5120" } ] } }, "response": [ { "name": "Complete profile — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/profile/complete", "host": [ "{{base_url}}" ], "path": [ "api", "client", "profile", "complete" ] }, "description": "Multipart also accepts `image`.\n\n**Validation**\n- `name`: required|string|min:2|max:50\n- `city_id`: required|integer|exists:cities,id\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `map_desc`: required|string|max:500\n- `national_id`: required|regex:/^[12]\\d{9}$/|unique:clients\n- `image`: nullable|image|max:5120\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "required|string|min:2|max:50", "value": "Buyer Name" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "map_desc", "type": "text", "description": "required|string|max:500", "value": "Riyadh" }, { "key": "national_id", "type": "text", "description": "required|regex:/^[12]\\d{9}$/|unique:clients", "value": "1000000001" }, { "key": "image[]", "type": "file", "src": [], "value": "", "description": "nullable|image|max:5120" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Profile completed\",\n \"data\": {\n \"id\": 1,\n \"name\": \"Example User\",\n \"is_completed\": true\n }\n}" } ] }, { "name": "Update profile", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/update/profile", "host": [ "{{base_url}}" ], "path": [ "api", "client", "update", "profile" ] }, "description": "**Validation**\n- `image`: sometimes|nullable|image|max:5120\n- `name`: sometimes|string|min:2|max:50\n- `country_code`: sometimes|numeric|digits_between:2,5\n- `city_id`: sometimes|integer|exists:cities,id\n- `lat`: sometimes|numeric|between:-90,90\n- `lng`: sometimes|numeric|between:-180,180\n- `map_desc`: sometimes|string|max:500\n- `national_id`: sometimes|NationalIdRule|unique:clients\n- `email`: sometimes|email|unique:clients\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "sometimes|string|min:2|max:50", "value": "Buyer Updated" }, { "key": "city_id", "type": "text", "description": "sometimes|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "lat", "type": "text", "description": "sometimes|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "sometimes|numeric|between:-180,180", "value": "46.6753" }, { "key": "map_desc", "type": "text", "description": "sometimes|string|max:500", "value": "Riyadh" }, { "key": "image[]", "type": "file", "src": [], "value": "", "description": "sometimes|nullable|image|max:5120" } ] } }, "response": [ { "name": "Update profile — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/update/profile", "host": [ "{{base_url}}" ], "path": [ "api", "client", "update", "profile" ] }, "description": "**Validation**\n- `image`: sometimes|nullable|image|max:5120\n- `name`: sometimes|string|min:2|max:50\n- `country_code`: sometimes|numeric|digits_between:2,5\n- `city_id`: sometimes|integer|exists:cities,id\n- `lat`: sometimes|numeric|between:-90,90\n- `lng`: sometimes|numeric|between:-180,180\n- `map_desc`: sometimes|string|max:500\n- `national_id`: sometimes|NationalIdRule|unique:clients\n- `email`: sometimes|email|unique:clients\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "sometimes|string|min:2|max:50", "value": "Buyer Updated" }, { "key": "city_id", "type": "text", "description": "sometimes|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "lat", "type": "text", "description": "sometimes|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "sometimes|numeric|between:-180,180", "value": "46.6753" }, { "key": "map_desc", "type": "text", "description": "sometimes|string|max:500", "value": "Riyadh" }, { "key": "image[]", "type": "file", "src": [], "value": "", "description": "sometimes|nullable|image|max:5120" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Remove profile image", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/profile/image", "host": [ "{{base_url}}" ], "path": [ "api", "client", "profile", "image" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Remove profile image — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/profile/image", "host": [ "{{base_url}}" ], "path": [ "api", "client", "profile", "image" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Change language", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/change-lang", "host": [ "{{base_url}}" ], "path": [ "api", "client", "change-lang" ] }, "description": "**Validation**\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n- `mac_address`: required|max:250\n- `preferred_locale`: required|in:ar,en\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" }, { "key": "mac_address", "type": "text", "description": "required|max:250", "value": "00:00:00:00:00:00" }, { "key": "preferred_locale", "type": "text", "description": "required|in:ar,en", "value": "ar" } ] } }, "response": [ { "name": "Change language — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/change-lang", "host": [ "{{base_url}}" ], "path": [ "api", "client", "change-lang" ] }, "description": "**Validation**\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n- `mac_address`: required|max:250\n- `preferred_locale`: required|in:ar,en\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" }, { "key": "mac_address", "type": "text", "description": "required|max:250", "value": "00:00:00:00:00:00" }, { "key": "preferred_locale", "type": "text", "description": "required|in:ar,en", "value": "ar" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Check password", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/check-password", "host": [ "{{base_url}}" ], "path": [ "api", "client", "check-password" ] }, "description": "**Validation**\n- `password`: required (must match current password)\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "password", "type": "text", "description": "required (must match current password)", "value": "Password1!" } ] } }, "response": [ { "name": "Check password — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/check-password", "host": [ "{{base_url}}" ], "path": [ "api", "client", "check-password" ] }, "description": "**Validation**\n- `password`: required (must match current password)\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "password", "type": "text", "description": "required (must match current password)", "value": "Password1!" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Update password", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/update-password", "host": [ "{{base_url}}" ], "path": [ "api", "client", "update-password" ] }, "description": "**Validation**\n- `old_password`: required|min:6|max:100\n- `password`: required|string|min:8|letters|numbers\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "old_password", "type": "text", "description": "required|min:6|max:100", "value": "Password1!" }, { "key": "password", "type": "text", "description": "required|string|min:8|letters|numbers", "value": "Password2!" } ] } }, "response": [ { "name": "Update password — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/update-password", "host": [ "{{base_url}}" ], "path": [ "api", "client", "update-password" ] }, "description": "**Validation**\n- `old_password`: required|min:6|max:100\n- `password`: required|string|min:8|letters|numbers\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "old_password", "type": "text", "description": "required|min:6|max:100", "value": "Password1!" }, { "key": "password", "type": "text", "description": "required|string|min:8|letters|numbers", "value": "Password2!" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Contact admin", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/contact", "host": [ "{{base_url}}" ], "path": [ "api", "client", "contact" ] }, "description": "**Validation**\n- `message`: required|string\n- `type`: sometimes|in:trip_issue,payment_issue,damaged_scooter,suggestion,general_inquiry\n- `images`: nullable|array\n- `images.*`: nullable|image|mimes:jpeg,png,jpg,gif,svg|max:10000\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "message", "type": "text", "description": "required|string", "value": "Need help with my order" }, { "key": "type", "type": "text", "description": "sometimes|in:trip_issue,payment_issue,damaged_scooter,suggestion,general_inquiry", "value": "general_inquiry" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "nullable|image|mimes:jpeg,png,jpg,gif,svg|max:10000" } ] } }, "response": [ { "name": "Contact admin — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/contact", "host": [ "{{base_url}}" ], "path": [ "api", "client", "contact" ] }, "description": "**Validation**\n- `message`: required|string\n- `type`: sometimes|in:trip_issue,payment_issue,damaged_scooter,suggestion,general_inquiry\n- `images`: nullable|array\n- `images.*`: nullable|image|mimes:jpeg,png,jpg,gif,svg|max:10000\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "message", "type": "text", "description": "required|string", "value": "Need help with my order" }, { "key": "type", "type": "text", "description": "sometimes|in:trip_issue,payment_issue,damaged_scooter,suggestion,general_inquiry", "value": "general_inquiry" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "nullable|image|mimes:jpeg,png,jpg,gif,svg|max:10000" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "About (client)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/about", "host": [ "{{base_url}}" ], "path": [ "api", "client", "about" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "About (client) — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/about", "host": [ "{{base_url}}" ], "path": [ "api", "client", "about" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Terms (client)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/terms", "host": [ "{{base_url}}" ], "path": [ "api", "client", "terms" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Terms (client) — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/terms", "host": [ "{{base_url}}" ], "path": [ "api", "client", "terms" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Privacy (client)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/privacy", "host": [ "{{base_url}}" ], "path": [ "api", "client", "privacy" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Privacy (client) — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/privacy", "host": [ "{{base_url}}" ], "path": [ "api", "client", "privacy" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Socials (client)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/socials", "host": [ "{{base_url}}" ], "path": [ "api", "client", "socials" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "Socials (client) — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/socials", "host": [ "{{base_url}}" ], "path": [ "api", "client", "socials" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "App intro", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/app-intro", "host": [ "{{base_url}}" ], "path": [ "api", "client", "app-intro" ] }, "description": "", "auth": { "type": "noauth" } }, "response": [ { "name": "App intro — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/app-intro", "host": [ "{{base_url}}" ], "path": [ "api", "client", "app-intro" ] }, "description": "", "auth": { "type": "noauth" } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Example\"\n }\n ]\n}" } ] }, { "name": "Update email", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/email/update", "host": [ "{{base_url}}" ], "path": [ "api", "client", "email", "update" ] }, "description": "**Validation**\n- `email`: required|email|unique:clients\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email|unique:clients", "value": "buyer@example.com" } ] } }, "response": [ { "name": "Update email — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/email/update", "host": [ "{{base_url}}" ], "path": [ "api", "client", "email", "update" ] }, "description": "**Validation**\n- `email`: required|email|unique:clients\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email|unique:clients", "value": "buyer@example.com" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Verify email", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/email/verify", "host": [ "{{base_url}}" ], "path": [ "api", "client", "email", "verify" ] }, "description": "**Validation**\n- `email`: required|email\n- `code`: required\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email", "value": "buyer@example.com" }, { "key": "code", "type": "text", "description": "required", "value": "1234" } ] } }, "response": [ { "name": "Verify email — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/email/verify", "host": [ "{{base_url}}" ], "path": [ "api", "client", "email", "verify" ] }, "description": "**Validation**\n- `email`: required|email\n- `code`: required\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email", "value": "buyer@example.com" }, { "key": "code", "type": "text", "description": "required", "value": "1234" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "03 Phone Change", "description": "BUY phone-change flow: old phone OTP → new phone OTP.", "item": [ { "name": "Send code to old phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/send-code-to-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "send-code-to-old-phone" ] }, "description": "Uses auth user phone when body omitted.\n\n_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Send code to old phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/send-code-to-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "send-code-to-old-phone" ] }, "description": "Uses auth user phone when body omitted.\n\n_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Resend code to old phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/resend-code-to-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "resend-code-to-old-phone" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Resend code to old phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/resend-code-to-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "resend-code-to-old-phone" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Verify old phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/verify-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "verify-old-phone" ] }, "description": "**Validation**\n- `code`: required|string|digits_between:4,6\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "code", "type": "text", "description": "required|string|digits_between:4,6", "value": "1234" } ] } }, "response": [ { "name": "Verify old phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/verify-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "verify-old-phone" ] }, "description": "**Validation**\n- `code`: required|string|digits_between:4,6\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "code", "type": "text", "description": "required|string|digits_between:4,6", "value": "1234" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Send code to new phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/send-code-to-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "send-code-to-new-phone" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5", "value": "511111111" } ] } }, "response": [ { "name": "Send code to new phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/send-code-to-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "send-code-to-new-phone" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5", "value": "511111111" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Resend code to new phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/resend-code-to-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "resend-code-to-new-phone" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5", "value": "511111111" } ] } }, "response": [ { "name": "Resend code to new phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/resend-code-to-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "resend-code-to-new-phone" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5", "value": "511111111" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Verify new phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/verify-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "verify-new-phone" ] }, "description": "**Validation**\n- `code`: required|string|digits_between:4,6\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "code", "type": "text", "description": "required|string|digits_between:4,6", "value": "1234" }, { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5", "value": "511111111" } ] } }, "response": [ { "name": "Verify new phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/verify-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "client", "verify-new-phone" ] }, "description": "**Validation**\n- `code`: required|string|digits_between:4,6\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "code", "type": "text", "description": "required|string|digits_between:4,6", "value": "1234" }, { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:clients,phone|starts_with:5", "value": "511111111" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "04 Addresses", "item": [ { "name": "List addresses", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"address_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "client", "addresses" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "List addresses — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "client", "addresses" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Create address", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"address_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "client", "addresses" ] }, "description": "**Validation**\n- `label`: required|in:home,work,other\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `address`: required|string|max:500\n- `is_default`: nullable|boolean\n- `save_address`: nullable|boolean (false = preview only)\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "label", "type": "text", "description": "required|in:home,work,other", "value": "home" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "address", "type": "text", "description": "required|string|max:500", "value": "Riyadh" }, { "key": "is_default", "type": "text", "description": "nullable|boolean", "value": "1" }, { "key": "save_address", "type": "text", "description": "nullable|boolean (false = preview only)", "value": "1" } ] } }, "response": [ { "name": "Create address — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "client", "addresses" ] }, "description": "**Validation**\n- `label`: required|in:home,work,other\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `address`: required|string|max:500\n- `is_default`: nullable|boolean\n- `save_address`: nullable|boolean (false = preview only)\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "label", "type": "text", "description": "required|in:home,work,other", "value": "home" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "address", "type": "text", "description": "required|string|max:500", "value": "Riyadh" }, { "key": "is_default", "type": "text", "description": "nullable|boolean", "value": "1" }, { "key": "save_address", "type": "text", "description": "nullable|boolean (false = preview only)", "value": "1" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Update address", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"address_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/addresses/{{address_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "addresses", "{{address_id}}" ] }, "description": "**Validation**\n- `label`: sometimes|required|in:home,work,other\n- `lat`: sometimes|required|numeric|between:-90,90\n- `lng`: sometimes|required|numeric|between:-180,180\n- `address`: sometimes|required|string|max:500\n- `is_default`: nullable|boolean\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "label", "type": "text", "description": "sometimes|required|in:home,work,other", "value": "work" }, { "key": "lat", "type": "text", "description": "sometimes|required|numeric|between:-90,90", "value": "24.72" }, { "key": "lng", "type": "text", "description": "sometimes|required|numeric|between:-180,180", "value": "46.68" }, { "key": "address", "type": "text", "description": "sometimes|required|string|max:500", "value": "Riyadh north" } ] } }, "response": [ { "name": "Update address — Example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/addresses/{{address_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "addresses", "{{address_id}}" ] }, "description": "**Validation**\n- `label`: sometimes|required|in:home,work,other\n- `lat`: sometimes|required|numeric|between:-90,90\n- `lng`: sometimes|required|numeric|between:-180,180\n- `address`: sometimes|required|string|max:500\n- `is_default`: nullable|boolean\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "label", "type": "text", "description": "sometimes|required|in:home,work,other", "value": "work" }, { "key": "lat", "type": "text", "description": "sometimes|required|numeric|between:-90,90", "value": "24.72" }, { "key": "lng", "type": "text", "description": "sometimes|required|numeric|between:-180,180", "value": "46.68" }, { "key": "address", "type": "text", "description": "sometimes|required|string|max:500", "value": "Riyadh north" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Set default", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"address_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/addresses/{{address_id}}/default", "host": [ "{{base_url}}" ], "path": [ "api", "client", "addresses", "{{address_id}}", "default" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Set default — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/addresses/{{address_id}}/default", "host": [ "{{base_url}}" ], "path": [ "api", "client", "addresses", "{{address_id}}", "default" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Delete address", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"address_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/addresses/{{address_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "addresses", "{{address_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Delete address — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/addresses/{{address_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "addresses", "{{address_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "05 Notifications", "item": [ { "name": "List notifications", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/notifications?type=&paginateNum=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "notifications" ], "query": [ { "key": "type", "value": "", "description": "optional — unread filters unread only", "disabled": false }, { "key": "paginateNum", "value": "15", "description": "pagination size", "disabled": false } ] }, "description": "**Validation**\n- `type`: optional (unread|all)\n- `paginateNum`: int", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "List notifications — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/notifications?type=&paginateNum=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "notifications" ], "query": [ { "key": "type", "value": "", "description": "optional — unread filters unread only", "disabled": false }, { "key": "paginateNum", "value": "15", "description": "pagination size", "disabled": false } ] }, "description": "**Validation**\n- `type`: optional (unread|all)\n- `paginateNum`: int", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Unread count", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/count-notifications", "host": [ "{{base_url}}" ], "path": [ "api", "client", "count-notifications" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Unread count — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/count-notifications", "host": [ "{{base_url}}" ], "path": [ "api", "client", "count-notifications" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Mark all read", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/notifications/read-all", "host": [ "{{base_url}}" ], "path": [ "api", "client", "notifications", "read-all" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Mark all read — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/notifications/read-all", "host": [ "{{base_url}}" ], "path": [ "api", "client", "notifications", "read-all" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Mark one read", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/notifications/{{notification_id}}/read", "host": [ "{{base_url}}" ], "path": [ "api", "client", "notifications", "{{notification_id}}", "read" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Mark one read — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/notifications/{{notification_id}}/read", "host": [ "{{base_url}}" ], "path": [ "api", "client", "notifications", "{{notification_id}}", "read" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Delete one", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/delete-notification/{{notification_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "delete-notification", "{{notification_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Delete one — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/delete-notification/{{notification_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "delete-notification", "{{notification_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Delete all", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/delete-notifications", "host": [ "{{base_url}}" ], "path": [ "api", "client", "delete-notifications" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Delete all — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/delete-notifications", "host": [ "{{base_url}}" ], "path": [ "api", "client", "delete-notifications" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Switch notify", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/switch-notify", "host": [ "{{base_url}}" ], "path": [ "api", "client", "switch-notify" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Switch notify — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/switch-notify", "host": [ "{{base_url}}" ], "path": [ "api", "client", "switch-notify" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "06 Browse & Search", "item": [ { "name": "Home", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/home?lat=24.7136&lng=46.6753", "host": [ "{{base_url}}" ], "path": [ "api", "client", "home" ], "query": [ { "key": "lat", "value": "24.7136", "description": "optional|float — else user location", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false } ] }, "description": "**Validation**\n- `lat`: optional|float\n- `lng`: optional|float", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Home — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/home?lat=24.7136&lng=46.6753", "host": [ "{{base_url}}" ], "path": [ "api", "client", "home" ], "query": [ { "key": "lat", "value": "24.7136", "description": "optional|float — else user location", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false } ] }, "description": "**Validation**\n- `lat`: optional|float\n- `lng`: optional|float", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Search", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/search?q=scrap&type=all&lat=24.7136&lng=46.6753&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "search" ], "query": [ { "key": "q", "value": "scrap", "description": "string default empty", "disabled": false }, { "key": "type", "value": "all", "description": "all|auction|direct_offer", "disabled": false }, { "key": "lat", "value": "24.7136", "description": "optional|float", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "**Validation**\n- `q`: string default \"\"\n- `type`: string default all (all|auction|direct_offer)\n- `lat`: optional|float\n- `lng`: optional|float\n- `perPage`: int default 15", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Search — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/search?q=scrap&type=all&lat=24.7136&lng=46.6753&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "search" ], "query": [ { "key": "q", "value": "scrap", "description": "string default empty", "disabled": false }, { "key": "type", "value": "all", "description": "all|auction|direct_offer", "disabled": false }, { "key": "lat", "value": "24.7136", "description": "optional|float", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "**Validation**\n- `q`: string default \"\"\n- `type`: string default all (all|auction|direct_offer)\n- `lat`: optional|float\n- `lng`: optional|float\n- `perPage`: int default 15", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Auctions list", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions?lat=24.7136&lng=46.6753&nearby=0&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions" ], "query": [ { "key": "lat", "value": "24.7136", "description": "optional|float", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false }, { "key": "nearby", "value": "0", "description": "bool default false", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "**Validation**\n- `lat`: optional|float\n- `lng`: optional|float\n- `nearby`: bool default false\n- `perPage`: int default 15", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Auctions list — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions?lat=24.7136&lng=46.6753&nearby=0&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions" ], "query": [ { "key": "lat", "value": "24.7136", "description": "optional|float", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false }, { "key": "nearby", "value": "0", "description": "bool default false", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "**Validation**\n- `lat`: optional|float\n- `lng`: optional|float\n- `nearby`: bool default false\n- `perPage`: int default 15", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Auction show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}?lat=24.7136&lng=46.6753", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}" ], "query": [ { "key": "lat", "value": "24.7136", "description": "optional|float", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Auction show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}?lat=24.7136&lng=46.6753", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}" ], "query": [ { "key": "lat", "value": "24.7136", "description": "optional|float", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Offers list", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/offers?lat=24.7136&lng=46.6753&nearby=0&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "offers" ], "query": [ { "key": "lat", "value": "24.7136", "description": "optional|float", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false }, { "key": "nearby", "value": "0", "description": "bool default false", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Offers list — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/offers?lat=24.7136&lng=46.6753&nearby=0&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "offers" ], "query": [ { "key": "lat", "value": "24.7136", "description": "optional|float", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false }, { "key": "nearby", "value": "0", "description": "bool default false", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Offer show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/offers/{{listing_id}}?lat=24.7136&lng=46.6753", "host": [ "{{base_url}}" ], "path": [ "api", "client", "offers", "{{listing_id}}" ], "query": [ { "key": "lat", "value": "24.7136", "description": "optional|float", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Offer show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/offers/{{listing_id}}?lat=24.7136&lng=46.6753", "host": [ "{{base_url}}" ], "path": [ "api", "client", "offers", "{{listing_id}}" ], "query": [ { "key": "lat", "value": "24.7136", "description": "optional|float", "disabled": false }, { "key": "lng", "value": "46.6753", "description": "optional|float", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Favorites list", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/favorites?per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "favorites" ], "query": [ { "key": "per_page", "value": "15", "description": "int clamped 1..50 default 15", "disabled": false } ] }, "description": "**Validation**\n- `per_page`: int 1..50 default 15", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Favorites list — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/favorites?per_page=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "favorites" ], "query": [ { "key": "per_page", "value": "15", "description": "int clamped 1..50 default 15", "disabled": false } ] }, "description": "**Validation**\n- `per_page`: int 1..50 default 15", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Favorite add/toggle", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/listings/{{listing_id}}/favorite", "host": [ "{{base_url}}" ], "path": [ "api", "client", "listings", "{{listing_id}}", "favorite" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Favorite add/toggle — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/listings/{{listing_id}}/favorite", "host": [ "{{base_url}}" ], "path": [ "api", "client", "listings", "{{listing_id}}", "favorite" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Favorite remove", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/listings/{{listing_id}}/favorite", "host": [ "{{base_url}}" ], "path": [ "api", "client", "listings", "{{listing_id}}", "favorite" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Favorite remove — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/listings/{{listing_id}}/favorite", "host": [ "{{base_url}}" ], "path": [ "api", "client", "listings", "{{listing_id}}", "favorite" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "07 Auction Cycle", "description": "Deposit → bid → win → final pay → creates order.", "item": [ { "name": "1 Deposit meta", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/deposit", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "deposit" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "1 Deposit meta — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/deposit", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "deposit" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "2 Pay deposit", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/deposit", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "deposit" ] }, "description": "**Validation**\n- `payment_method`: required|in:wallet\n- `terms_accepted`: required|accepted\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "payment_method", "type": "text", "description": "required|in:wallet", "value": "wallet" }, { "key": "terms_accepted", "type": "text", "description": "required|accepted", "value": "1" } ] } }, "response": [ { "name": "2 Pay deposit — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/deposit", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "deposit" ] }, "description": "**Validation**\n- `payment_method`: required|in:wallet\n- `terms_accepted`: required|accepted\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "payment_method", "type": "text", "description": "required|in:wallet", "value": "wallet" }, { "key": "terms_accepted", "type": "text", "description": "required|accepted", "value": "1" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "3 Bidding access", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/bidding-access", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "bidding-access" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "3 Bidding access — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/bidding-access", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "bidding-access" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "4 Bidding room", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/bidding-room", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "bidding-room" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "4 Bidding room — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/bidding-room", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "bidding-room" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "5 Place bid", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/bids", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "bids" ] }, "description": "**Validation**\n- `amount`: required|numeric|min:0.01\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "amount", "type": "text", "description": "required|numeric|min:0.01", "value": "1050" } ] } }, "response": [ { "name": "5 Place bid — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/bids", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "bids" ] }, "description": "**Validation**\n- `amount`: required|numeric|min:0.01\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "amount", "type": "text", "description": "required|numeric|min:0.01", "value": "1050" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "6 Bidders list", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/bidders", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "bidders" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "6 Bidders list — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/bidders", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "bidders" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "7 Outcome preview", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/outcome-preview", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "outcome-preview" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "7 Outcome preview — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/outcome-preview", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "outcome-preview" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "8 Result", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/result", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "result" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "8 Result — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/result", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "result" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "9 Final payment meta", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/final-payment", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "final-payment" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "9 Final payment meta — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/final-payment", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "final-payment" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "10 Pay final", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/final-payment", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "final-payment" ] }, "description": "**Validation**\n- `payment_method`: required|in:wallet\n- `confirm`: required|accepted\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "payment_method", "type": "text", "description": "required|in:wallet", "value": "wallet" }, { "key": "confirm", "type": "text", "description": "required|accepted", "value": "1" } ] } }, "response": [ { "name": "10 Pay final — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/auctions/{{listing_id}}/final-payment", "host": [ "{{base_url}}" ], "path": [ "api", "client", "auctions", "{{listing_id}}", "final-payment" ] }, "description": "**Validation**\n- `payment_method`: required|in:wallet\n- `confirm`: required|accepted\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "payment_method", "type": "text", "description": "required|in:wallet", "value": "wallet" }, { "key": "confirm", "type": "text", "description": "required|accepted", "value": "1" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "08 Direct Offer & Chat Cycle", "description": "Browse offer → chat → accept seller price → order.", "item": [ { "name": "1 Make offer (open chat)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/offers/{{listing_id}}/make-offer", "host": [ "{{base_url}}" ], "path": [ "api", "client", "offers", "{{listing_id}}", "make-offer" ] }, "description": "No FormRequest body — opens conversation.\n\n_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "1 Make offer (open chat) — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/offers/{{listing_id}}/make-offer", "host": [ "{{base_url}}" ], "path": [ "api", "client", "offers", "{{listing_id}}", "make-offer" ] }, "description": "No FormRequest body — opens conversation.\n\n_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "2 Conversations list", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "2 Conversations list — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "3 Conversation show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations/{{conversation_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations", "{{conversation_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "3 Conversation show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations/{{conversation_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations", "{{conversation_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "4 Messages", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations/{{conversation_id}}/messages?perPage=30", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations", "{{conversation_id}}", "messages" ], "query": [ { "key": "perPage", "value": "30", "description": "int default 30", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "4 Messages — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations/{{conversation_id}}/messages?perPage=30", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations", "{{conversation_id}}", "messages" ], "query": [ { "key": "perPage", "value": "30", "description": "int default 30", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "5 Send message", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations/{{conversation_id}}/messages", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations", "{{conversation_id}}", "messages" ] }, "description": "Also supports multipart `attachment` image.\n\n**Validation**\n- `body`: nullable|string|max:5000\n- `attachment`: nullable|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "body", "type": "text", "description": "nullable|string|max:5000", "value": "Interested in this lot" }, { "key": "attachment[]", "type": "file", "src": [], "value": "", "description": "nullable|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "response": [ { "name": "5 Send message — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations/{{conversation_id}}/messages", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations", "{{conversation_id}}", "messages" ] }, "description": "Also supports multipart `attachment` image.\n\n**Validation**\n- `body`: nullable|string|max:5000\n- `attachment`: nullable|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "body", "type": "text", "description": "nullable|string|max:5000", "value": "Interested in this lot" }, { "key": "attachment[]", "type": "file", "src": [], "value": "", "description": "nullable|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "6 Accept price offer", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations/{{conversation_id}}/price-offer/accept", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations", "{{conversation_id}}", "price-offer", "accept" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "6 Accept price offer — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations/{{conversation_id}}/price-offer/accept", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations", "{{conversation_id}}", "price-offer", "accept" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "7 Reject price offer", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations/{{conversation_id}}/price-offer/reject", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations", "{{conversation_id}}", "price-offer", "reject" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "7 Reject price offer — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/conversations/{{conversation_id}}/price-offer/reject", "host": [ "{{base_url}}" ], "path": [ "api", "client", "conversations", "{{conversation_id}}", "price-offer", "reject" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "09 Order & Delivery Cycle", "description": "Inspect → pay → handshake → confirm → rate.", "item": [ { "name": "Orders list", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders?tab=offers&status=active&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders" ], "query": [ { "key": "tab", "value": "offers", "description": "offers|auctions default offers", "disabled": false }, { "key": "status", "value": "active", "description": "review|active|completed|cancelled default active", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "**Validation**\n- `tab`: offers|auctions default offers\n- `status`: review|active|completed|cancelled default active\n- `perPage`: int default 15", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Orders list — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders?tab=offers&status=active&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders" ], "query": [ { "key": "tab", "value": "offers", "description": "offers|auctions default offers", "disabled": false }, { "key": "status", "value": "active", "description": "review|active|completed|cancelled default active", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "**Validation**\n- `tab`: offers|auctions default offers\n- `status`: review|active|completed|cancelled default active\n- `perPage`: int default 15", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Order show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Order show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Confirm inspection", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/confirm-inspection", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "confirm-inspection" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Confirm inspection — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/confirm-inspection", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "confirm-inspection" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Price change meta", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/price-change", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "price-change" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Price change meta — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/price-change", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "price-change" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Price change preview", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/price-change/preview", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "price-change", "preview" ] }, "description": "**Validation**\n- `quantity`: required|numeric|gt:0\n- `price_per_unit`: required|numeric|gt:0\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "quantity", "type": "text", "description": "required|numeric|gt:0", "value": "2" }, { "key": "price_per_unit", "type": "text", "description": "required|numeric|gt:0", "value": "450" } ] } }, "response": [ { "name": "Price change preview — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/price-change/preview", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "price-change", "preview" ] }, "description": "**Validation**\n- `quantity`: required|numeric|gt:0\n- `price_per_unit`: required|numeric|gt:0\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "quantity", "type": "text", "description": "required|numeric|gt:0", "value": "2" }, { "key": "price_per_unit", "type": "text", "description": "required|numeric|gt:0", "value": "450" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Request price change", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/price-change", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "price-change" ] }, "description": "**Validation**\n- `quantity`: required|numeric|gt:0\n- `price_per_unit`: required|numeric|gt:0\n- `reason`: nullable|string|max:300\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "quantity", "type": "text", "description": "required|numeric|gt:0", "value": "2" }, { "key": "price_per_unit", "type": "text", "description": "required|numeric|gt:0", "value": "450" }, { "key": "reason", "type": "text", "description": "nullable|string|max:300", "value": "Condition adjustment" } ] } }, "response": [ { "name": "Request price change — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/price-change", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "price-change" ] }, "description": "**Validation**\n- `quantity`: required|numeric|gt:0\n- `price_per_unit`: required|numeric|gt:0\n- `reason`: nullable|string|max:300\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "quantity", "type": "text", "description": "required|numeric|gt:0", "value": "2" }, { "key": "price_per_unit", "type": "text", "description": "required|numeric|gt:0", "value": "450" }, { "key": "reason", "type": "text", "description": "nullable|string|max:300", "value": "Condition adjustment" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Payment meta", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/payment", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "payment" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Payment meta — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/payment", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "payment" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Pay order", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/pay", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "pay" ] }, "description": "No body — wallet escrow debit.\n\n_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Pay order — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/pay", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "pay" ] }, "description": "No body — wallet escrow debit.\n\n_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Handshake (buyer code)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/handshake", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "handshake" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Handshake (buyer code) — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/handshake", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "handshake" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Confirm receipt", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/confirm-receipt", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "confirm-receipt" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Confirm receipt — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/confirm-receipt", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "confirm-receipt" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Rate meta", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/rate", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "rate" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Rate meta — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/rate", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "rate" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Rate seller", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/rate", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "rate" ] }, "description": "**Validation**\n- `stars`: required|integer|min:1|max:5\n- `tag_ids`: nullable|array\n- `tag_ids.*`: integer|exists:rating_tags,id\n- `comment`: nullable|string|max:1000\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "stars", "type": "text", "description": "required|integer|min:1|max:5", "value": "5" }, { "key": "comment", "type": "text", "description": "nullable|string|max:1000", "value": "Great deal" } ] } }, "response": [ { "name": "Rate seller — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/rate", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "rate" ] }, "description": "**Validation**\n- `stars`: required|integer|min:1|max:5\n- `tag_ids`: nullable|array\n- `tag_ids.*`: integer|exists:rating_tags,id\n- `comment`: nullable|string|max:1000\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "stars", "type": "text", "description": "required|integer|min:1|max:5", "value": "5" }, { "key": "comment", "type": "text", "description": "nullable|string|max:1000", "value": "Great deal" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Invoice", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/invoice", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "invoice" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Invoice — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/invoice", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "invoice" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Complaint reasons", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/complaint-reasons", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "complaint-reasons" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Complaint reasons — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/complaint-reasons", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "complaint-reasons" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Raise order complaint", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/complaints", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "complaints" ] }, "description": "Multipart also accepts images[0..4].\n\n**Validation**\n- `reason_id`: required|integer|exists:complaint_reasons,id\n- `custom_reason`: nullable|string|max:500\n- `description`: nullable|string|max:1000\n- `images`: nullable|array|max:5\n- `images.*`: image|mimes:jpeg,png,jpg,gif,webp|max:10000\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "reason_id", "type": "text", "description": "required|integer|exists:complaint_reasons,id", "value": "{{reason_id}}" }, { "key": "description", "type": "text", "description": "nullable|string|max:1000", "value": "Item mismatch details" }, { "key": "custom_reason", "type": "text", "description": "nullable|string|max:500", "value": "" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "image|mimes:jpeg,png,jpg,gif,webp|max:10000" } ] } }, "response": [ { "name": "Raise order complaint — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/orders/{{order_id}}/complaints", "host": [ "{{base_url}}" ], "path": [ "api", "client", "orders", "{{order_id}}", "complaints" ] }, "description": "Multipart also accepts images[0..4].\n\n**Validation**\n- `reason_id`: required|integer|exists:complaint_reasons,id\n- `custom_reason`: nullable|string|max:500\n- `description`: nullable|string|max:1000\n- `images`: nullable|array|max:5\n- `images.*`: image|mimes:jpeg,png,jpg,gif,webp|max:10000\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "reason_id", "type": "text", "description": "required|integer|exists:complaint_reasons,id", "value": "{{reason_id}}" }, { "key": "description", "type": "text", "description": "nullable|string|max:1000", "value": "Item mismatch details" }, { "key": "custom_reason", "type": "text", "description": "nullable|string|max:500", "value": "" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "image|mimes:jpeg,png,jpg,gif,webp|max:10000" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "10 Wallet & Withdrawals", "item": [ { "name": "Wallet show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Wallet show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Transactions", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/transactions?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "transactions" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Transactions — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/transactions?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "transactions" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Ledger", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/ledger?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "ledger" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Ledger — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/ledger?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "ledger" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Charge wallet", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/charge", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "charge" ] }, "description": "`type` is auto-merged to online.\n\n**Validation**\n- `amount`: required|numeric|min:{min_wallet_charge|1}|max:999999999999.99\n- `type`: required (auto: online)\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "amount", "type": "text", "description": "required|numeric|min:{min_wallet_charge|1}|max:999999999999.99", "value": "100" } ] } }, "response": [ { "name": "Charge wallet — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/charge", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "charge" ] }, "description": "`type` is auto-merged to online.\n\n**Validation**\n- `amount`: required|numeric|min:{min_wallet_charge|1}|max:999999999999.99\n- `type`: required (auto: online)\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "amount", "type": "text", "description": "required|numeric|min:{min_wallet_charge|1}|max:999999999999.99", "value": "100" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Withdrawals meta", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"withdrawal_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/withdrawals/meta", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "withdrawals", "meta" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Withdrawals meta — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/withdrawals/meta", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "withdrawals", "meta" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Withdrawals list", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"withdrawal_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/withdrawals?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "withdrawals" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Withdrawals list — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/withdrawals?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "withdrawals" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Request withdrawal", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"withdrawal_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/withdrawals", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "withdrawals" ] }, "description": "Valid test IBAN: SA0380000000608010167519\n\n**Validation**\n- `amount`: required|numeric|min:{min_withdrawal|100}|max:999999999.99\n- `bank_name`: required|string|min:2|max:100\n- `account_holder`: required|string|min:2|max:100\n- `account_number`: required|string|min:4|max:34\n- `iban`: required|string|SaudiIbanRule\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "amount", "type": "text", "description": "required|numeric|min:{min_withdrawal|100}|max:999999999.99", "value": "100" }, { "key": "bank_name", "type": "text", "description": "required|string|min:2|max:100", "value": "Al Rajhi" }, { "key": "account_holder", "type": "text", "description": "required|string|min:2|max:100", "value": "Buyer Name" }, { "key": "account_number", "type": "text", "description": "required|string|min:4|max:34", "value": "1234567890" }, { "key": "iban", "type": "text", "description": "required|string|SaudiIbanRule", "value": "SA0380000000608010167519" } ] } }, "response": [ { "name": "Request withdrawal — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/withdrawals", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "withdrawals" ] }, "description": "Valid test IBAN: SA0380000000608010167519\n\n**Validation**\n- `amount`: required|numeric|min:{min_withdrawal|100}|max:999999999.99\n- `bank_name`: required|string|min:2|max:100\n- `account_holder`: required|string|min:2|max:100\n- `account_number`: required|string|min:4|max:34\n- `iban`: required|string|SaudiIbanRule\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "amount", "type": "text", "description": "required|numeric|min:{min_withdrawal|100}|max:999999999.99", "value": "100" }, { "key": "bank_name", "type": "text", "description": "required|string|min:2|max:100", "value": "Al Rajhi" }, { "key": "account_holder", "type": "text", "description": "required|string|min:2|max:100", "value": "Buyer Name" }, { "key": "account_number", "type": "text", "description": "required|string|min:4|max:34", "value": "1234567890" }, { "key": "iban", "type": "text", "description": "required|string|SaudiIbanRule", "value": "SA0380000000608010167519" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Withdrawal show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"withdrawal_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/withdrawals/{{withdrawal_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "withdrawals", "{{withdrawal_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Withdrawal show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/wallet/withdrawals/{{withdrawal_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "wallet", "withdrawals", "{{withdrawal_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] } ] }, { "name": "11 Support Complains", "item": [ { "name": "Complaint reasons", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"complain_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/complains/reasons", "host": [ "{{base_url}}" ], "path": [ "api", "client", "complains", "reasons" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Complaint reasons — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/complains/reasons", "host": [ "{{base_url}}" ], "path": [ "api", "client", "complains", "reasons" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "List complains", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"complain_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/complains", "host": [ "{{base_url}}" ], "path": [ "api", "client", "complains" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "List complains — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/complains", "host": [ "{{base_url}}" ], "path": [ "api", "client", "complains" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Create complain", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"complain_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/complains", "host": [ "{{base_url}}" ], "path": [ "api", "client", "complains" ] }, "description": "**Validation**\n- `reason_id`: required|integer|exists:complaint_reasons,id\n- `custom_reason`: nullable|string|max:500\n- `description`: nullable|string|max:1000\n- `images`: nullable|array|max:5\n- `images.*`: image|mimes:jpeg,png,jpg,gif,webp|max:5120\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "reason_id", "type": "text", "description": "required|integer|exists:complaint_reasons,id", "value": "1" }, { "key": "description", "type": "text", "description": "nullable|string|max:1000", "value": "Need assistance with the app flow" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "image|mimes:jpeg,png,jpg,gif,webp|max:5120" } ] } }, "response": [ { "name": "Create complain — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/complains", "host": [ "{{base_url}}" ], "path": [ "api", "client", "complains" ] }, "description": "**Validation**\n- `reason_id`: required|integer|exists:complaint_reasons,id\n- `custom_reason`: nullable|string|max:500\n- `description`: nullable|string|max:1000\n- `images`: nullable|array|max:5\n- `images.*`: image|mimes:jpeg,png,jpg,gif,webp|max:5120\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "reason_id", "type": "text", "description": "required|integer|exists:complaint_reasons,id", "value": "1" }, { "key": "description", "type": "text", "description": "nullable|string|max:1000", "value": "Need assistance with the app flow" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "image|mimes:jpeg,png,jpg,gif,webp|max:5120" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Show complain", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"complain_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/complains/{{complain_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "complains", "{{complain_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "response": [ { "name": "Show complain — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/client/complains/{{complain_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "client", "complains", "{{complain_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{client_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] } ] } ] }, { "name": "Provider", "description": "Seller (Provider) API — use `provider_token`.", "item": [ { "name": "01 Auth Cycle", "item": [ { "name": "Register", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"needActive\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/register", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "register" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:2,5\n- `phone`: required|numeric|digits_between:9,10|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:2,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|starts_with:5", "value": "{{phone}}" } ] } }, "response": [ { "name": "Register — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/register", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "register" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:2,5\n- `phone`: required|numeric|digits_between:9,10|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:2,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|starts_with:5", "value": "{{phone}}" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"needActive\",\n \"msg\": \"Account created — activate with OTP\",\n \"data\": {\n \"phone\": \"{{phone}}\",\n \"country_code\": \"{{country_code}}\"\n }\n}" } ] }, { "name": "Activate", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"needs_acceptance\",\"needApproval\",\"needActive\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Auth success returns a token\", function () {", " if ([\"success\", \"needs_acceptance\", \"needApproval\"].includes(json.key)) {", " pm.expect(json.data).to.be.an(\"object\");", " pm.expect(json.data.token).to.be.a(\"string\").and.not.empty;", " }", "});", "", "// Persist Sanctum token for later authenticated requests", "if (json.data && json.data.token) {", " pm.environment.set(\"provider_token\", json.data.token);", " pm.environment.set(\"auth_token\", json.data.token);", " console.log(\"Saved provider_token (+ auth_token) from response\");", "}", "" ] } } ], "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/activate", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "activate" ] }, "description": "**Validation**\n- `code`: required|digits:4\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:providers,phone\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:providers,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|digits:4", "value": "1234" }, { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" } ] } }, "response": [ { "name": "Activate — Example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/activate", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "activate" ] }, "description": "**Validation**\n- `code`: required|digits:4\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:providers,phone\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:providers,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|digits:4", "value": "1234" }, { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Logged in successfully\",\n \"data\": {\n \"id\": 1,\n \"name\": \"Example User\",\n \"phone\": \"{{phone}}\",\n \"country_code\": \"{{country_code}}\",\n \"token\": \"1|exampleSanctumTokenReplaceMe\"\n }\n}" } ] }, { "name": "Resend code", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/resend-code", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "resend-code" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:providers,phone\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:providers,phone", "value": "{{phone}}" } ] } }, "response": [ { "name": "Resend code — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/resend-code", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "resend-code" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:providers,phone\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:providers,phone", "value": "{{phone}}" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Login (phone OTP)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"needVerification\",\"blocked\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/login", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "login" ] }, "description": "Phone-first seller login — sends OTP. Password is not used.\n\n**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:providers,phone\n- `device_type`: nullable|in:ios,android,web\n- `device_id`: nullable|string|max:255\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:providers,phone", "value": "{{phone}}" }, { "key": "device_type", "type": "text", "description": "nullable|in:ios,android,web", "value": "web" }, { "key": "device_id", "type": "text", "description": "nullable|string|max:255", "value": "postman-device" } ] } }, "response": [ { "name": "Login (phone OTP) — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/login", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "login" ] }, "description": "Phone-first seller login — sends OTP. Password is not used.\n\n**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:providers,phone\n- `device_type`: nullable|in:ios,android,web\n- `device_id`: nullable|string|max:255\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:providers,phone", "value": "{{phone}}" }, { "key": "device_type", "type": "text", "description": "nullable|in:ios,android,web", "value": "web" }, { "key": "device_id", "type": "text", "description": "nullable|string|max:255", "value": "postman-device" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"needVerification\",\n \"msg\": \"Verification code sent\",\n \"data\": {\n \"phone\": \"{{phone}}\",\n \"country_code\": \"{{country_code}}\"\n }\n}" } ] }, { "name": "Verify login (OTP)", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"needs_acceptance\",\"needApproval\",\"needActive\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Auth success returns a token\", function () {", " if ([\"success\", \"needs_acceptance\", \"needApproval\"].includes(json.key)) {", " pm.expect(json.data).to.be.an(\"object\");", " pm.expect(json.data.token).to.be.a(\"string\").and.not.empty;", " }", "});", "", "// Persist Sanctum token for later authenticated requests", "if (json.data && json.data.token) {", " pm.environment.set(\"provider_token\", json.data.token);", " pm.environment.set(\"auth_token\", json.data.token);", " console.log(\"Saved provider_token (+ auth_token) from response\");", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/verify-login", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "verify-login" ] }, "description": "Copy `data.token` → `provider_token`. Test OTP: `1234`.\n\n**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:providers,phone\n- `code`: required|digits:4\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n- `mac_address`: required|max:250\n- `preferred_locale`: required|in:ar,en\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:providers,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|digits:4", "value": "1234" }, { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" }, { "key": "mac_address", "type": "text", "description": "required|max:250", "value": "00:00:00:00:00:00" }, { "key": "preferred_locale", "type": "text", "description": "required|in:ar,en", "value": "en" } ] } }, "response": [ { "name": "Verify login (OTP) — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/verify-login", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "verify-login" ] }, "description": "Copy `data.token` → `provider_token`. Test OTP: `1234`.\n\n**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|exists:providers,phone\n- `code`: required|digits:4\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n- `mac_address`: required|max:250\n- `preferred_locale`: required|in:ar,en\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|exists:providers,phone", "value": "{{phone}}" }, { "key": "code", "type": "text", "description": "required|digits:4", "value": "1234" }, { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" }, { "key": "mac_address", "type": "text", "description": "required|max:250", "value": "00:00:00:00:00:00" }, { "key": "preferred_locale", "type": "text", "description": "required|in:ar,en", "value": "en" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"needVerification\",\n \"msg\": \"Verification code sent\",\n \"data\": {\n \"phone\": \"{{phone}}\",\n \"country_code\": \"{{country_code}}\"\n }\n}" } ] }, { "name": "Forget password", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/password/forget", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "password", "forget" ] }, "description": "Still email-based (legacy password reset).\n\n**Validation**\n- `email`: required|email|exists:providers,email\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email|exists:providers,email", "value": "{{provider_email}}" } ] } }, "response": [ { "name": "Forget password — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/password/forget", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "password", "forget" ] }, "description": "Still email-based (legacy password reset).\n\n**Validation**\n- `email`: required|email|exists:providers,email\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email|exists:providers,email", "value": "{{provider_email}}" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Check reset code", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/password/check-code", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "password", "check-code" ] }, "description": "**Validation**\n- `email`: required|email|exists:providers,email\n- `code`: required|max:10\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email|exists:providers,email", "value": "{{provider_email}}" }, { "key": "code", "type": "text", "description": "required|max:10", "value": "1234" } ] } }, "response": [ { "name": "Check reset code — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/password/check-code", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "password", "check-code" ] }, "description": "**Validation**\n- `email`: required|email|exists:providers,email\n- `code`: required|max:10\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email|exists:providers,email", "value": "{{provider_email}}" }, { "key": "code", "type": "text", "description": "required|max:10", "value": "1234" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Reset password", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/password/reset", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "password", "reset" ] }, "description": "**Validation**\n- `email`: required|email|exists:providers,email\n- `code`: required|max:10\n- `password`: required|string|confirmed|min:8|letters|numbers\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email|exists:providers,email", "value": "{{provider_email}}" }, { "key": "code", "type": "text", "description": "required|max:10", "value": "1234" }, { "key": "password", "type": "text", "description": "required|string|confirmed|min:8|letters|numbers", "value": "Password1!" }, { "key": "password_confirmation", "type": "text", "description": "", "value": "Password1!" } ] } }, "response": [ { "name": "Reset password — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/password/reset", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "password", "reset" ] }, "description": "**Validation**\n- `email`: required|email|exists:providers,email\n- `code`: required|max:10\n- `password`: required|string|confirmed|min:8|letters|numbers\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "noauth" }, "body": { "mode": "formdata", "formdata": [ { "key": "email", "type": "text", "description": "required|email|exists:providers,email", "value": "{{provider_email}}" }, { "key": "code", "type": "text", "description": "required|max:10", "value": "1234" }, { "key": "password", "type": "text", "description": "required|string|confirmed|min:8|letters|numbers", "value": "Password1!" }, { "key": "password_confirmation", "type": "text", "description": "", "value": "Password1!" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Logout", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/logout", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "logout" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Logout — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/logout", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "logout" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Delete account", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/delete-account", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "delete-account" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Delete account — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/delete-account", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "delete-account" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "02 Registration & Nafath", "item": [ { "name": "Set seller type", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/register/seller-type", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "register", "seller-type" ] }, "description": "**Validation**\n- `seller_type`: required|in:individual,company\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "seller_type", "type": "text", "description": "required|in:individual,company", "value": "individual" } ] } }, "response": [ { "name": "Set seller type — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/register/seller-type", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "register", "seller-type" ] }, "description": "**Validation**\n- `seller_type`: required|in:individual,company\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "seller_type", "type": "text", "description": "required|in:individual,company", "value": "individual" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Seller type saved\",\n \"data\": {\n \"seller_type\": \"individual\"\n }\n}" } ] }, { "name": "Nafath initiate", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/auth/nafath/initiate", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "auth", "nafath", "initiate" ] }, "description": "**Validation**\n- `national_id`: required|NationalIdRule|unique:providers\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "national_id", "type": "text", "description": "required|NationalIdRule|unique:providers", "value": "1000000001" } ] } }, "response": [ { "name": "Nafath initiate — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/auth/nafath/initiate", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "auth", "nafath", "initiate" ] }, "description": "**Validation**\n- `national_id`: required|NationalIdRule|unique:providers\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "national_id", "type": "text", "description": "required|NationalIdRule|unique:providers", "value": "1000000001" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Nafath request accepted\",\n \"data\": {\n \"status\": \"WAITING\",\n \"transId\": \"example-trans-id\"\n }\n}" } ] }, { "name": "Nafath resend", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/auth/nafath/resend", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "auth", "nafath", "resend" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Nafath resend — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/auth/nafath/resend", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "auth", "nafath", "resend" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Nafath request accepted\",\n \"data\": {\n \"status\": \"WAITING\",\n \"transId\": \"example-trans-id\"\n }\n}" } ] }, { "name": "Nafath status", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/auth/nafath/status", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "auth", "nafath", "status" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Nafath status — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/auth/nafath/status", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "auth", "nafath", "status" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Nafath request accepted\",\n \"data\": {\n \"status\": \"WAITING\",\n \"transId\": \"example-trans-id\"\n }\n}" } ] }, { "name": "Nafath confirm", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/auth/nafath/confirm", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "auth", "nafath", "confirm" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Nafath confirm — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/auth/nafath/confirm", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "auth", "nafath", "confirm" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Nafath request accepted\",\n \"data\": {\n \"status\": \"WAITING\",\n \"transId\": \"example-trans-id\"\n }\n}" } ] }, { "name": "Registration status", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/register/status", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "register", "status" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Registration status — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/register/status", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "register", "status" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"seller_type\": \"individual\",\n \"is_verified_nafath\": true,\n \"is_approved\": true,\n \"step\": \"done\"\n }\n}" } ] } ] }, { "name": "03 Profile & Settings", "item": [ { "name": "Get profile", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/profile", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "profile" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Get profile — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/profile", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "profile" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Complete profile", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needs_acceptance\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/profile/complete", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "profile", "complete" ] }, "description": "Multipart: `commercial_register` file is required, `image` is optional.\n\n**Validation**\n- `name`: required|string|min:2|max:100\n- `city_id`: required|integer|exists:cities,id\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `map_desc`: required|string|max:500\n- `image`: nullable|image|max:5120\n- `company_name`: required|string|min:2|max:150\n- `commercial_register`: required|file|mimes:jpg,jpeg,png,pdf|max:5120\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "required|string|min:2|max:100", "value": "Seller Name" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "map_desc", "type": "text", "description": "required|string|max:500", "value": "Riyadh warehouse" }, { "key": "company_name", "type": "text", "description": "required|string|min:2|max:150", "value": "Seller Establishment" }, { "key": "image[]", "type": "file", "src": [], "value": "", "description": "nullable|image|max:5120" }, { "key": "commercial_register[]", "type": "file", "src": [], "value": "", "description": "required|file|mimes:jpg,jpeg,png,pdf|max:5120" } ] } }, "response": [ { "name": "Complete profile — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/profile/complete", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "profile", "complete" ] }, "description": "Multipart: `commercial_register` file is required, `image` is optional.\n\n**Validation**\n- `name`: required|string|min:2|max:100\n- `city_id`: required|integer|exists:cities,id\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `map_desc`: required|string|max:500\n- `image`: nullable|image|max:5120\n- `company_name`: required|string|min:2|max:150\n- `commercial_register`: required|file|mimes:jpg,jpeg,png,pdf|max:5120\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "required|string|min:2|max:100", "value": "Seller Name" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "map_desc", "type": "text", "description": "required|string|max:500", "value": "Riyadh warehouse" }, { "key": "company_name", "type": "text", "description": "required|string|min:2|max:150", "value": "Seller Establishment" }, { "key": "image[]", "type": "file", "src": [], "value": "", "description": "nullable|image|max:5120" }, { "key": "commercial_register[]", "type": "file", "src": [], "value": "", "description": "required|file|mimes:jpg,jpeg,png,pdf|max:5120" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Profile completed\",\n \"data\": {\n \"id\": 1,\n \"name\": \"Example User\",\n \"is_completed\": true\n }\n}" } ] }, { "name": "Update profile", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/update/profile", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "update", "profile" ] }, "description": "**Validation**\n- `name`: sometimes|required|string|min:2|max:100\n- `country_code`: required_with:phone|sometimes|numeric|digits_between:2,5\n- `phone`: required_with:country_code|sometimes|numeric|digits_between:9,10|starts_with:5|unique:providers\n- `national_id`: sometimes|NationalIdRule|unique:providers\n- `iban`: sometimes|nullable|string|size:24|regex:/^SA[0-9]{22}$/|unique:providers\n- `image`: nullable|image|mimes:jpg,jpeg,png|max:5120\n- `city_id`: sometimes|integer|exists:cities,id\n- `company_name`: sometimes|nullable|string|min:2|max:150\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "sometimes|required|string|min:2|max:100", "value": "Seller Updated" }, { "key": "city_id", "type": "text", "description": "sometimes|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "image[]", "type": "file", "src": [], "value": "", "description": "nullable|image|mimes:jpg,jpeg,png|max:5120" } ] } }, "response": [ { "name": "Update profile — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/update/profile", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "update", "profile" ] }, "description": "**Validation**\n- `name`: sometimes|required|string|min:2|max:100\n- `country_code`: required_with:phone|sometimes|numeric|digits_between:2,5\n- `phone`: required_with:country_code|sometimes|numeric|digits_between:9,10|starts_with:5|unique:providers\n- `national_id`: sometimes|NationalIdRule|unique:providers\n- `iban`: sometimes|nullable|string|size:24|regex:/^SA[0-9]{22}$/|unique:providers\n- `image`: nullable|image|mimes:jpg,jpeg,png|max:5120\n- `city_id`: sometimes|integer|exists:cities,id\n- `company_name`: sometimes|nullable|string|min:2|max:150\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "name", "type": "text", "description": "sometimes|required|string|min:2|max:100", "value": "Seller Updated" }, { "key": "city_id", "type": "text", "description": "sometimes|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "image[]", "type": "file", "src": [], "value": "", "description": "nullable|image|mimes:jpg,jpeg,png|max:5120" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Change language", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/change-lang", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "change-lang" ] }, "description": "**Validation**\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n- `mac_address`: required|max:250\n- `preferred_locale`: required|in:ar,en\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" }, { "key": "mac_address", "type": "text", "description": "required|max:250", "value": "00:00:00:00:00:00" }, { "key": "preferred_locale", "type": "text", "description": "required|in:ar,en", "value": "ar" } ] } }, "response": [ { "name": "Change language — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/change-lang", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "change-lang" ] }, "description": "**Validation**\n- `device_id`: required|max:250\n- `device_type`: required|in:ios,android,web\n- `mac_address`: required|max:250\n- `preferred_locale`: required|in:ar,en\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "device_id", "type": "text", "description": "required|max:250", "value": "postman-device" }, { "key": "device_type", "type": "text", "description": "required|in:ios,android,web", "value": "web" }, { "key": "mac_address", "type": "text", "description": "required|max:250", "value": "00:00:00:00:00:00" }, { "key": "preferred_locale", "type": "text", "description": "required|in:ar,en", "value": "ar" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Check password", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/check-password", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "check-password" ] }, "description": "**Validation**\n- `password`: required (must match current password)\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "password", "type": "text", "description": "required (must match current password)", "value": "Password1!" } ] } }, "response": [ { "name": "Check password — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/check-password", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "check-password" ] }, "description": "**Validation**\n- `password`: required (must match current password)\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "password", "type": "text", "description": "required (must match current password)", "value": "Password1!" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Update password", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/update-password", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "update-password" ] }, "description": "**Validation**\n- `old_password`: required|min:6|max:100\n- `password`: required|string|min:8|letters|numbers\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "old_password", "type": "text", "description": "required|min:6|max:100", "value": "Password1!" }, { "key": "password", "type": "text", "description": "required|string|min:8|letters|numbers", "value": "Password2!" } ] } }, "response": [ { "name": "Update password — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/update-password", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "update-password" ] }, "description": "**Validation**\n- `old_password`: required|min:6|max:100\n- `password`: required|string|min:8|letters|numbers\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "old_password", "type": "text", "description": "required|min:6|max:100", "value": "Password1!" }, { "key": "password", "type": "text", "description": "required|string|min:8|letters|numbers", "value": "Password2!" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Contact admin", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/contact", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "contact" ] }, "description": "**Validation**\n- `message`: required|string\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "message", "type": "text", "description": "required|string", "value": "Seller support request" } ] } }, "response": [ { "name": "Contact admin — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/contact", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "contact" ] }, "description": "**Validation**\n- `message`: required|string\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "message", "type": "text", "description": "required|string", "value": "Seller support request" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "04 Phone Change", "description": "SEL phone-change flow: old phone OTP → new phone OTP.", "item": [ { "name": "Send code to old phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/send-code-to-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "send-code-to-old-phone" ] }, "description": "Uses auth user phone when body omitted.\n\n_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Send code to old phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/send-code-to-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "send-code-to-old-phone" ] }, "description": "Uses auth user phone when body omitted.\n\n_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Resend code to old phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/resend-code-to-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "resend-code-to-old-phone" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Resend code to old phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/resend-code-to-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "resend-code-to-old-phone" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Verify old phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/verify-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "verify-old-phone" ] }, "description": "**Validation**\n- `code`: required|string|digits_between:4,6\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "code", "type": "text", "description": "required|string|digits_between:4,6", "value": "1234" } ] } }, "response": [ { "name": "Verify old phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/verify-old-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "verify-old-phone" ] }, "description": "**Validation**\n- `code`: required|string|digits_between:4,6\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "code", "type": "text", "description": "required|string|digits_between:4,6", "value": "1234" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Send code to new phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/send-code-to-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "send-code-to-new-phone" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5", "value": "511111112" } ] } }, "response": [ { "name": "Send code to new phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/send-code-to-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "send-code-to-new-phone" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5", "value": "511111112" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Resend code to new phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"needActive\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/resend-code-to-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "resend-code-to-new-phone" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5", "value": "511111112" } ] } }, "response": [ { "name": "Resend code to new phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/resend-code-to-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "resend-code-to-new-phone" ] }, "description": "**Validation**\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5", "value": "511111112" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Code sent successfully\",\n \"data\": {\n \"phone\": \"{{phone}}\"\n }\n}" } ] }, { "name": "Verify new phone", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/verify-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "verify-new-phone" ] }, "description": "**Validation**\n- `code`: required|string|digits_between:4,6\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "code", "type": "text", "description": "required|string|digits_between:4,6", "value": "1234" }, { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5", "value": "511111112" } ] } }, "response": [ { "name": "Verify new phone — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/verify-new-phone", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "verify-new-phone" ] }, "description": "**Validation**\n- `code`: required|string|digits_between:4,6\n- `country_code`: required|numeric|digits_between:1,5\n- `phone`: required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "code", "type": "text", "description": "required|string|digits_between:4,6", "value": "1234" }, { "key": "country_code", "type": "text", "description": "required|numeric|digits_between:1,5", "value": "{{country_code}}" }, { "key": "phone", "type": "text", "description": "required|numeric|digits_between:9,10|unique:providers,phone|starts_with:5", "value": "511111112" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "05 Addresses", "item": [ { "name": "List addresses", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"address_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "addresses" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "List addresses — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "addresses" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Create address", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"address_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "addresses" ] }, "description": "**Validation**\n- `label`: required|in:home,work,other\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `address`: required|string|max:500\n- `is_default`: nullable|boolean\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "label", "type": "text", "description": "required|in:home,work,other", "value": "work" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "address", "type": "text", "description": "required|string|max:500", "value": "Industrial area" }, { "key": "is_default", "type": "text", "description": "nullable|boolean", "value": "1" } ] } }, "response": [ { "name": "Create address — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/addresses", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "addresses" ] }, "description": "**Validation**\n- `label`: required|in:home,work,other\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `address`: required|string|max:500\n- `is_default`: nullable|boolean\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "label", "type": "text", "description": "required|in:home,work,other", "value": "work" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "address", "type": "text", "description": "required|string|max:500", "value": "Industrial area" }, { "key": "is_default", "type": "text", "description": "nullable|boolean", "value": "1" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Update address", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"address_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/addresses/{{address_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "addresses", "{{address_id}}" ] }, "description": "**Validation**\n- `label`: sometimes|required|in:home,work,other\n- `lat`: sometimes|required|numeric|between:-90,90\n- `lng`: sometimes|required|numeric|between:-180,180\n- `address`: sometimes|required|string|max:500\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "label", "type": "text", "description": "sometimes|required|in:home,work,other", "value": "work" }, { "key": "lat", "type": "text", "description": "sometimes|required|numeric|between:-90,90", "value": "24.72" }, { "key": "lng", "type": "text", "description": "sometimes|required|numeric|between:-180,180", "value": "46.68" }, { "key": "address", "type": "text", "description": "sometimes|required|string|max:500", "value": "Updated yard" } ] } }, "response": [ { "name": "Update address — Example", "originalRequest": { "method": "PUT", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/addresses/{{address_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "addresses", "{{address_id}}" ] }, "description": "**Validation**\n- `label`: sometimes|required|in:home,work,other\n- `lat`: sometimes|required|numeric|between:-90,90\n- `lng`: sometimes|required|numeric|between:-180,180\n- `address`: sometimes|required|string|max:500\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "label", "type": "text", "description": "sometimes|required|in:home,work,other", "value": "work" }, { "key": "lat", "type": "text", "description": "sometimes|required|numeric|between:-90,90", "value": "24.72" }, { "key": "lng", "type": "text", "description": "sometimes|required|numeric|between:-180,180", "value": "46.68" }, { "key": "address", "type": "text", "description": "sometimes|required|string|max:500", "value": "Updated yard" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Set default", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"address_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/addresses/{{address_id}}/default", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "addresses", "{{address_id}}", "default" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Set default — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/addresses/{{address_id}}/default", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "addresses", "{{address_id}}", "default" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Delete address", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"address_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/addresses/{{address_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "addresses", "{{address_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Delete address — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/addresses/{{address_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "addresses", "{{address_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "06 Notifications", "item": [ { "name": "List notifications", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/notifications?type=", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "notifications" ], "query": [ { "key": "type", "value": "", "description": "optional — unread filters unread", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "List notifications — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/notifications?type=", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "notifications" ], "query": [ { "key": "type", "value": "", "description": "optional — unread filters unread", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Unread count", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/count-notifications", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "count-notifications" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Unread count — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/count-notifications", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "count-notifications" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Mark all read", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/notifications/read-all", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "notifications", "read-all" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Mark all read — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/notifications/read-all", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "notifications", "read-all" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Mark one read", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/notifications/{{notification_id}}/read", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "notifications", "{{notification_id}}", "read" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Mark one read — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/notifications/{{notification_id}}/read", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "notifications", "{{notification_id}}", "read" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Delete one", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/delete-notification/{{notification_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "delete-notification", "{{notification_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Delete one — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/delete-notification/{{notification_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "delete-notification", "{{notification_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Delete all", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/delete-notifications", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "delete-notifications" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Delete all — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/delete-notifications", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "delete-notifications" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Switch notify", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "" ] } } ], "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/switch-notify", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "switch-notify" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Switch notify — Example", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/switch-notify", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "switch-notify" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "07 Home", "item": [ { "name": "Home", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/home", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "home" ] }, "description": "Seller dashboard (SEL-030..043): greeting, stats, active auctions, ongoing orders.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Home — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/home", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "home" ] }, "description": "Seller dashboard (SEL-030..043): greeting, stats, active auctions, ongoing orders.", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "08 Performance", "item": [ { "name": "Performance", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/performance?period=month", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "performance" ], "query": [ { "key": "period", "value": "month", "description": "today|week|month|year (invalid → today)", "disabled": false } ] }, "description": "**Validation**\n- `period`: today|week|month|year default today", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Performance — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/performance?period=month", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "performance" ], "query": [ { "key": "period", "value": "month", "description": "today|week|month|year (invalid → today)", "disabled": false } ] }, "description": "**Validation**\n- `period`: today|week|month|year default today", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Performance export", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/performance/export?period=month&format=pdf", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "performance", "export" ], "query": [ { "key": "period", "value": "month", "description": "today|week|month|year", "disabled": false }, { "key": "format", "value": "pdf", "description": "pdf|xls", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Performance export — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/performance/export?period=month&format=pdf", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "performance", "export" ], "query": [ { "key": "period", "value": "month", "description": "today|week|month|year", "disabled": false }, { "key": "format", "value": "pdf", "description": "pdf|xls", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "09 Auction Listing Cycle", "description": "Create auction → admin review → live → bidders.", "item": [ { "name": "Listings meta", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/meta", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "meta" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Listings meta — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/meta", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "meta" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "My listings", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings?tab=active&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings" ], "query": [ { "key": "tab", "value": "active", "description": "active|review|ended default active", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "**Validation**\n- `tab`: active|review|ended default active\n- `perPage`: int default 15", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "My listings — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings?tab=active&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings" ], "query": [ { "key": "tab", "value": "active", "description": "active|review|ended default active", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "**Validation**\n- `tab`: active|review|ended default active\n- `perPage`: int default 15", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Create auction", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/auctions", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "auctions" ] }, "description": "Production uses multipart/form-data with `images[]` (required 1..10). Title is generated from category/subcategory. JSON shows field names.\n\n**Validation**\n- `description`: required|string|min:10|max:5000\n- `category_id`: required|integer|exists:categories,id\n- `subcategory_id`: nullable|integer|exists:categories,id\n- `condition_id`: required|integer|exists:material_conditions,id\n- `unit_id`: required|integer|exists:units,id\n- `city_id`: required|integer|exists:cities,id\n- `quantity`: required|numeric|min:0.001|max:999999999\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `pickup_address_text`: required|string|max:500\n- `start_price`: required|numeric|min:1|max:999999999.99\n- `min_bid_increment`: required|numeric|min:1|max:999999999.99\n- `deposit_amount`: required|numeric|min:1|max:999999999.99\n- `starts_at`: required|date|after:now\n- `ends_at`: required|date|after:starts_at\n- `images`: required|array|min:1|max:10\n- `images.*`: required|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "description", "type": "text", "description": "required|string|min:10|max:5000", "value": "Clean scrap iron ready for pickup" }, { "key": "category_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "subcategory_id", "type": "text", "description": "nullable|integer|exists:categories,id", "value": "" }, { "key": "condition_id", "type": "text", "description": "required|integer|exists:material_conditions,id", "value": "{{condition_id}}" }, { "key": "unit_id", "type": "text", "description": "required|integer|exists:units,id", "value": "{{unit_id}}" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "quantity", "type": "text", "description": "required|numeric|min:0.001|max:999999999", "value": "10" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "pickup_address_text", "type": "text", "description": "required|string|max:500", "value": "Riyadh industrial" }, { "key": "start_price", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "1000" }, { "key": "min_bid_increment", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "50" }, { "key": "deposit_amount", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "200" }, { "key": "starts_at", "type": "text", "description": "required|date|after:now", "value": "2026-12-01 10:00:00" }, { "key": "ends_at", "type": "text", "description": "required|date|after:starts_at", "value": "2026-12-05 10:00:00" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "required|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "response": [ { "name": "Create auction — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/auctions", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "auctions" ] }, "description": "Production uses multipart/form-data with `images[]` (required 1..10). Title is generated from category/subcategory. JSON shows field names.\n\n**Validation**\n- `description`: required|string|min:10|max:5000\n- `category_id`: required|integer|exists:categories,id\n- `subcategory_id`: nullable|integer|exists:categories,id\n- `condition_id`: required|integer|exists:material_conditions,id\n- `unit_id`: required|integer|exists:units,id\n- `city_id`: required|integer|exists:cities,id\n- `quantity`: required|numeric|min:0.001|max:999999999\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `pickup_address_text`: required|string|max:500\n- `start_price`: required|numeric|min:1|max:999999999.99\n- `min_bid_increment`: required|numeric|min:1|max:999999999.99\n- `deposit_amount`: required|numeric|min:1|max:999999999.99\n- `starts_at`: required|date|after:now\n- `ends_at`: required|date|after:starts_at\n- `images`: required|array|min:1|max:10\n- `images.*`: required|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "description", "type": "text", "description": "required|string|min:10|max:5000", "value": "Clean scrap iron ready for pickup" }, { "key": "category_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "subcategory_id", "type": "text", "description": "nullable|integer|exists:categories,id", "value": "" }, { "key": "condition_id", "type": "text", "description": "required|integer|exists:material_conditions,id", "value": "{{condition_id}}" }, { "key": "unit_id", "type": "text", "description": "required|integer|exists:units,id", "value": "{{unit_id}}" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "quantity", "type": "text", "description": "required|numeric|min:0.001|max:999999999", "value": "10" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "pickup_address_text", "type": "text", "description": "required|string|max:500", "value": "Riyadh industrial" }, { "key": "start_price", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "1000" }, { "key": "min_bid_increment", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "50" }, { "key": "deposit_amount", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "200" }, { "key": "starts_at", "type": "text", "description": "required|date|after:now", "value": "2026-12-01 10:00:00" }, { "key": "ends_at", "type": "text", "description": "required|date|after:starts_at", "value": "2026-12-05 10:00:00" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "required|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Update auction", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/{{listing_id}}/auctions", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "{{listing_id}}", "auctions" ] }, "description": "Same rules as create; images nullable. Title is generated from category/subcategory.\n\n**Validation**\n- `description`: required|string|min:10|max:5000\n- `category_id`: required|integer|exists:categories,id\n- `subcategory_id`: nullable|integer|exists:categories,id\n- `condition_id`: required|integer|exists:material_conditions,id\n- `unit_id`: required|integer|exists:units,id\n- `city_id`: required|integer|exists:cities,id\n- `quantity`: required|numeric|min:0.001|max:999999999\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `pickup_address_text`: required|string|max:500\n- `start_price`: required|numeric|min:1|max:999999999.99\n- `min_bid_increment`: required|numeric|min:1|max:999999999.99\n- `deposit_amount`: required|numeric|min:1|max:999999999.99\n- `starts_at`: required|date|after:now\n- `ends_at`: required|date|after:starts_at\n- `images`: nullable|array|min:1|max:10\n- `images.*`: required|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "description", "type": "text", "description": "required|string|min:10|max:5000", "value": "Updated description for the lot" }, { "key": "category_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "condition_id", "type": "text", "description": "required|integer|exists:material_conditions,id", "value": "{{condition_id}}" }, { "key": "unit_id", "type": "text", "description": "required|integer|exists:units,id", "value": "{{unit_id}}" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "quantity", "type": "text", "description": "required|numeric|min:0.001|max:999999999", "value": "12" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "pickup_address_text", "type": "text", "description": "required|string|max:500", "value": "Riyadh industrial" }, { "key": "start_price", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "1100" }, { "key": "min_bid_increment", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "50" }, { "key": "deposit_amount", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "200" }, { "key": "starts_at", "type": "text", "description": "required|date|after:now", "value": "2026-12-01 10:00:00" }, { "key": "ends_at", "type": "text", "description": "required|date|after:starts_at", "value": "2026-12-06 10:00:00" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "required|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "response": [ { "name": "Update auction — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/{{listing_id}}/auctions", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "{{listing_id}}", "auctions" ] }, "description": "Same rules as create; images nullable. Title is generated from category/subcategory.\n\n**Validation**\n- `description`: required|string|min:10|max:5000\n- `category_id`: required|integer|exists:categories,id\n- `subcategory_id`: nullable|integer|exists:categories,id\n- `condition_id`: required|integer|exists:material_conditions,id\n- `unit_id`: required|integer|exists:units,id\n- `city_id`: required|integer|exists:cities,id\n- `quantity`: required|numeric|min:0.001|max:999999999\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `pickup_address_text`: required|string|max:500\n- `start_price`: required|numeric|min:1|max:999999999.99\n- `min_bid_increment`: required|numeric|min:1|max:999999999.99\n- `deposit_amount`: required|numeric|min:1|max:999999999.99\n- `starts_at`: required|date|after:now\n- `ends_at`: required|date|after:starts_at\n- `images`: nullable|array|min:1|max:10\n- `images.*`: required|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "description", "type": "text", "description": "required|string|min:10|max:5000", "value": "Updated description for the lot" }, { "key": "category_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "condition_id", "type": "text", "description": "required|integer|exists:material_conditions,id", "value": "{{condition_id}}" }, { "key": "unit_id", "type": "text", "description": "required|integer|exists:units,id", "value": "{{unit_id}}" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "quantity", "type": "text", "description": "required|numeric|min:0.001|max:999999999", "value": "12" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "pickup_address_text", "type": "text", "description": "required|string|max:500", "value": "Riyadh industrial" }, { "key": "start_price", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "1100" }, { "key": "min_bid_increment", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "50" }, { "key": "deposit_amount", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "200" }, { "key": "starts_at", "type": "text", "description": "required|date|after:now", "value": "2026-12-01 10:00:00" }, { "key": "ends_at", "type": "text", "description": "required|date|after:starts_at", "value": "2026-12-06 10:00:00" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "required|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Listing show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/{{listing_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "{{listing_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Listing show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/{{listing_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "{{listing_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Listing bidders", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/{{listing_id}}/bidders", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "{{listing_id}}", "bidders" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Listing bidders — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/{{listing_id}}/bidders", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "{{listing_id}}", "bidders" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Delete listing", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/{{listing_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "{{listing_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Delete listing — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/{{listing_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "{{listing_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "10 Offer Listing Cycle", "item": [ { "name": "Create offer listing", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/offers", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "offers" ] }, "description": "Multipart with images[] required. Title is generated from category/subcategory.\n\n**Validation**\n- `description`: required|string|min:10|max:5000\n- `category_id`: required|integer|exists:categories,id\n- `subcategory_id`: required|integer|exists:categories,id\n- `condition_id`: required|integer|exists:material_conditions,id\n- `unit_id`: required|integer|exists:units,id\n- `city_id`: required|integer|exists:cities,id\n- `quantity`: required|numeric|min:0.001|max:999999999\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `pickup_address_text`: required|string|max:500\n- `asking_price_per_unit`: required|numeric|min:1|max:999999999.99\n- `images`: required|array|min:1|max:10\n- `images.*`: required|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "description", "type": "text", "description": "required|string|min:10|max:5000", "value": "Direct offer copper lot ready now" }, { "key": "category_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "subcategory_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "condition_id", "type": "text", "description": "required|integer|exists:material_conditions,id", "value": "{{condition_id}}" }, { "key": "unit_id", "type": "text", "description": "required|integer|exists:units,id", "value": "{{unit_id}}" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "quantity", "type": "text", "description": "required|numeric|min:0.001|max:999999999", "value": "5" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "pickup_address_text", "type": "text", "description": "required|string|max:500", "value": "Riyadh" }, { "key": "asking_price_per_unit", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "120" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "required|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "response": [ { "name": "Create offer listing — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/offers", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "offers" ] }, "description": "Multipart with images[] required. Title is generated from category/subcategory.\n\n**Validation**\n- `description`: required|string|min:10|max:5000\n- `category_id`: required|integer|exists:categories,id\n- `subcategory_id`: required|integer|exists:categories,id\n- `condition_id`: required|integer|exists:material_conditions,id\n- `unit_id`: required|integer|exists:units,id\n- `city_id`: required|integer|exists:cities,id\n- `quantity`: required|numeric|min:0.001|max:999999999\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `pickup_address_text`: required|string|max:500\n- `asking_price_per_unit`: required|numeric|min:1|max:999999999.99\n- `images`: required|array|min:1|max:10\n- `images.*`: required|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "description", "type": "text", "description": "required|string|min:10|max:5000", "value": "Direct offer copper lot ready now" }, { "key": "category_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "subcategory_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "condition_id", "type": "text", "description": "required|integer|exists:material_conditions,id", "value": "{{condition_id}}" }, { "key": "unit_id", "type": "text", "description": "required|integer|exists:units,id", "value": "{{unit_id}}" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "quantity", "type": "text", "description": "required|numeric|min:0.001|max:999999999", "value": "5" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "pickup_address_text", "type": "text", "description": "required|string|max:500", "value": "Riyadh" }, { "key": "asking_price_per_unit", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "120" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "required|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Update offer listing", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/{{listing_id}}/offers", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "{{listing_id}}", "offers" ] }, "description": "Same rules as create; images nullable. Title is generated from category/subcategory.\n\n**Validation**\n- `description`: required|string|min:10|max:5000\n- `category_id`: required|integer|exists:categories,id\n- `subcategory_id`: required|integer|exists:categories,id\n- `condition_id`: required|integer|exists:material_conditions,id\n- `unit_id`: required|integer|exists:units,id\n- `city_id`: required|integer|exists:cities,id\n- `quantity`: required|numeric|min:0.001|max:999999999\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `pickup_address_text`: required|string|max:500\n- `asking_price_per_unit`: required|numeric|min:1|max:999999999.99\n- `images`: nullable|array|min:1|max:10\n- `images.*`: required|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "description", "type": "text", "description": "required|string|min:10|max:5000", "value": "Updated copper offer details here" }, { "key": "category_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "subcategory_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "condition_id", "type": "text", "description": "required|integer|exists:material_conditions,id", "value": "{{condition_id}}" }, { "key": "unit_id", "type": "text", "description": "required|integer|exists:units,id", "value": "{{unit_id}}" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "quantity", "type": "text", "description": "required|numeric|min:0.001|max:999999999", "value": "5" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "pickup_address_text", "type": "text", "description": "required|string|max:500", "value": "Riyadh" }, { "key": "asking_price_per_unit", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "110" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "required|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "response": [ { "name": "Update offer listing — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/listings/{{listing_id}}/offers", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "listings", "{{listing_id}}", "offers" ] }, "description": "Same rules as create; images nullable. Title is generated from category/subcategory.\n\n**Validation**\n- `description`: required|string|min:10|max:5000\n- `category_id`: required|integer|exists:categories,id\n- `subcategory_id`: required|integer|exists:categories,id\n- `condition_id`: required|integer|exists:material_conditions,id\n- `unit_id`: required|integer|exists:units,id\n- `city_id`: required|integer|exists:cities,id\n- `quantity`: required|numeric|min:0.001|max:999999999\n- `lat`: required|numeric|between:-90,90\n- `lng`: required|numeric|between:-180,180\n- `pickup_address_text`: required|string|max:500\n- `asking_price_per_unit`: required|numeric|min:1|max:999999999.99\n- `images`: nullable|array|min:1|max:10\n- `images.*`: required|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "description", "type": "text", "description": "required|string|min:10|max:5000", "value": "Updated copper offer details here" }, { "key": "category_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "subcategory_id", "type": "text", "description": "required|integer|exists:categories,id", "value": "{{category_id}}" }, { "key": "condition_id", "type": "text", "description": "required|integer|exists:material_conditions,id", "value": "{{condition_id}}" }, { "key": "unit_id", "type": "text", "description": "required|integer|exists:units,id", "value": "{{unit_id}}" }, { "key": "city_id", "type": "text", "description": "required|integer|exists:cities,id", "value": "{{city_id}}" }, { "key": "quantity", "type": "text", "description": "required|numeric|min:0.001|max:999999999", "value": "5" }, { "key": "lat", "type": "text", "description": "required|numeric|between:-90,90", "value": "24.7136" }, { "key": "lng", "type": "text", "description": "required|numeric|between:-180,180", "value": "46.6753" }, { "key": "pickup_address_text", "type": "text", "description": "required|string|max:500", "value": "Riyadh" }, { "key": "asking_price_per_unit", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "110" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "required|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "My offers", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/offers?tab=active&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "offers" ], "query": [ { "key": "tab", "value": "active", "description": "active|review|ended", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "My offers — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/offers?tab=active&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "offers" ], "query": [ { "key": "tab", "value": "active", "description": "active|review|ended", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Offer show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/offers/{{listing_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "offers", "{{listing_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Offer show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/offers/{{listing_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "offers", "{{listing_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Pause offer", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/offers/{{listing_id}}/pause", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "offers", "{{listing_id}}", "pause" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Pause offer — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/offers/{{listing_id}}/pause", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "offers", "{{listing_id}}", "pause" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Delete offer", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"listing_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/offers/{{listing_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "offers", "{{listing_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Delete offer — Example", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/offers/{{listing_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "offers", "{{listing_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "11 Chat & Negotiate Cycle", "description": "Buyer opens chat → seller price-offer → buyer accepts.", "item": [ { "name": "Conversations", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/conversations?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "conversations" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Conversations — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/conversations?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "conversations" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Conversation show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/conversations/{{conversation_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "conversations", "{{conversation_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Conversation show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/conversations/{{conversation_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "conversations", "{{conversation_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Messages", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/conversations/{{conversation_id}}/messages?perPage=30", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "conversations", "{{conversation_id}}", "messages" ], "query": [ { "key": "perPage", "value": "30", "description": "int default 30", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Messages — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/conversations/{{conversation_id}}/messages?perPage=30", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "conversations", "{{conversation_id}}", "messages" ], "query": [ { "key": "perPage", "value": "30", "description": "int default 30", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Send message", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/conversations/{{conversation_id}}/messages", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "conversations", "{{conversation_id}}", "messages" ] }, "description": "**Validation**\n- `body`: nullable|string|max:5000\n- `attachment`: nullable|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "body", "type": "text", "description": "nullable|string|max:5000", "value": "Hello buyer" }, { "key": "attachment[]", "type": "file", "src": [], "value": "", "description": "nullable|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "response": [ { "name": "Send message — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/conversations/{{conversation_id}}/messages", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "conversations", "{{conversation_id}}", "messages" ] }, "description": "**Validation**\n- `body`: nullable|string|max:5000\n- `attachment`: nullable|image|mimes:jpeg,png,jpg,webp|max:10240\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "body", "type": "text", "description": "nullable|string|max:5000", "value": "Hello buyer" }, { "key": "attachment[]", "type": "file", "src": [], "value": "", "description": "nullable|image|mimes:jpeg,png,jpg,webp|max:10240" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Send price offer", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"conversation_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/conversations/{{conversation_id}}/price-offer", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "conversations", "{{conversation_id}}", "price-offer" ] }, "description": "**Validation**\n- `price`: required|numeric|min:1|max:999999999.99\n- `quantity`: required|numeric|min:0.001|max:999999999\n- `inspection_location`: required|string|max:500\n- `inspection_at`: required|date|after:now\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "price", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "5000" }, { "key": "quantity", "type": "text", "description": "required|numeric|min:0.001|max:999999999", "value": "5" }, { "key": "inspection_location", "type": "text", "description": "required|string|max:500", "value": "Riyadh warehouse" }, { "key": "inspection_at", "type": "text", "description": "required|date|after:now", "value": "2026-12-10 11:00:00" } ] } }, "response": [ { "name": "Send price offer — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/conversations/{{conversation_id}}/price-offer", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "conversations", "{{conversation_id}}", "price-offer" ] }, "description": "**Validation**\n- `price`: required|numeric|min:1|max:999999999.99\n- `quantity`: required|numeric|min:0.001|max:999999999\n- `inspection_location`: required|string|max:500\n- `inspection_at`: required|date|after:now\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "price", "type": "text", "description": "required|numeric|min:1|max:999999999.99", "value": "5000" }, { "key": "quantity", "type": "text", "description": "required|numeric|min:0.001|max:999999999", "value": "5" }, { "key": "inspection_location", "type": "text", "description": "required|string|max:500", "value": "Riyadh warehouse" }, { "key": "inspection_at", "type": "text", "description": "required|date|after:now", "value": "2026-12-10 11:00:00" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "12 Order & Delivery Cycle", "description": "Schedule → handshake verify → rate.", "item": [ { "name": "Orders list", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders?tab=offers&status=active&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders" ], "query": [ { "key": "tab", "value": "offers", "description": "offers|auctions default offers", "disabled": false }, { "key": "status", "value": "active", "description": "review|active|completed|cancelled", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Orders list — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders?tab=offers&status=active&perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders" ], "query": [ { "key": "tab", "value": "offers", "description": "offers|auctions default offers", "disabled": false }, { "key": "status", "value": "active", "description": "review|active|completed|cancelled", "disabled": false }, { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Order show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Order show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Schedule inspection", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/schedule-inspection", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "schedule-inspection" ] }, "description": "**Validation**\n- `inspection_at`: required|date|after:now\n- `inspection_location`: required|string|max:255\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "inspection_at", "type": "text", "description": "required|date|after:now", "value": "2026-12-12 11:00:00" }, { "key": "inspection_location", "type": "text", "description": "required|string|max:255", "value": "Warehouse gate 2" } ] } }, "response": [ { "name": "Schedule inspection — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/schedule-inspection", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "schedule-inspection" ] }, "description": "**Validation**\n- `inspection_at`: required|date|after:now\n- `inspection_location`: required|string|max:255\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "inspection_at", "type": "text", "description": "required|date|after:now", "value": "2026-12-12 11:00:00" }, { "key": "inspection_location", "type": "text", "description": "required|string|max:255", "value": "Warehouse gate 2" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Accept price change", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/price-change/accept", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "price-change", "accept" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "response": [ { "name": "Accept price change — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/price-change/accept", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "price-change", "accept" ] }, "description": "_No FormRequest rules (empty body or server-side only)._\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Reject price change", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/price-change/reject", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "price-change", "reject" ] }, "description": "**Validation**\n- `note`: nullable|string|max:500\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "note", "type": "text", "description": "nullable|string|max:500", "value": "Price too low" } ] } }, "response": [ { "name": "Reject price change — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/price-change/reject", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "price-change", "reject" ] }, "description": "**Validation**\n- `note`: nullable|string|max:500\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "note", "type": "text", "description": "nullable|string|max:500", "value": "Price too low" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Verify handshake", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/handshake/verify", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "handshake", "verify" ] }, "description": "**Validation**\n- `code`: required|string|size:4|regex:/^\\d{4}$/\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "code", "type": "text", "description": "required|string|size:4|regex:/^\\d{4}$/", "value": "1234" } ] } }, "response": [ { "name": "Verify handshake — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/handshake/verify", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "handshake", "verify" ] }, "description": "**Validation**\n- `code`: required|string|size:4|regex:/^\\d{4}$/\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "code", "type": "text", "description": "required|string|size:4|regex:/^\\d{4}$/", "value": "1234" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Rate meta", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/rate", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "rate" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Rate meta — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/rate", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "rate" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Rate buyer", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/rate", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "rate" ] }, "description": "**Validation**\n- `stars`: required|integer|min:1|max:5\n- `tag_ids`: nullable|array\n- `tag_ids.*`: integer|exists:rating_tags,id\n- `comment`: nullable|string|max:1000\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "stars", "type": "text", "description": "required|integer|min:1|max:5", "value": "5" }, { "key": "comment", "type": "text", "description": "nullable|string|max:1000", "value": "Smooth pickup" } ] } }, "response": [ { "name": "Rate buyer — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/rate", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "rate" ] }, "description": "**Validation**\n- `stars`: required|integer|min:1|max:5\n- `tag_ids`: nullable|array\n- `tag_ids.*`: integer|exists:rating_tags,id\n- `comment`: nullable|string|max:1000\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "stars", "type": "text", "description": "required|integer|min:1|max:5", "value": "5" }, { "key": "comment", "type": "text", "description": "nullable|string|max:1000", "value": "Smooth pickup" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Invoice", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/invoice", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "invoice" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Invoice — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/invoice", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "invoice" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Complaint reasons", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/complaint-reasons", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "complaint-reasons" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Complaint reasons — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/complaint-reasons", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "complaint-reasons" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Raise order complaint", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"order_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/complaints", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "complaints" ] }, "description": "**Validation**\n- `reason_id`: required|integer|exists:complaint_reasons,id\n- `custom_reason`: nullable|string|max:500\n- `description`: nullable|string|max:1000\n- `images`: nullable|array|max:5\n- `images.*`: image|mimes:jpeg,png,jpg,gif,webp|max:10000\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "reason_id", "type": "text", "description": "required|integer|exists:complaint_reasons,id", "value": "{{reason_id}}" }, { "key": "description", "type": "text", "description": "nullable|string|max:1000", "value": "Buyer no-show details here" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "image|mimes:jpeg,png,jpg,gif,webp|max:10000" } ] } }, "response": [ { "name": "Raise order complaint — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/orders/{{order_id}}/complaints", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "orders", "{{order_id}}", "complaints" ] }, "description": "**Validation**\n- `reason_id`: required|integer|exists:complaint_reasons,id\n- `custom_reason`: nullable|string|max:500\n- `description`: nullable|string|max:1000\n- `images`: nullable|array|max:5\n- `images.*`: image|mimes:jpeg,png,jpg,gif,webp|max:10000\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "reason_id", "type": "text", "description": "required|integer|exists:complaint_reasons,id", "value": "{{reason_id}}" }, { "key": "description", "type": "text", "description": "nullable|string|max:1000", "value": "Buyer no-show details here" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "image|mimes:jpeg,png,jpg,gif,webp|max:10000" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] } ] }, { "name": "13 Wallet & Withdrawals", "item": [ { "name": "Wallet", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Wallet — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Wallet ledger", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet/ledger?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet", "ledger" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Wallet ledger — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet/ledger?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet", "ledger" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Withdrawals meta", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"withdrawal_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet/withdrawals/meta", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet", "withdrawals", "meta" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Withdrawals meta — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet/withdrawals/meta", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet", "withdrawals", "meta" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] }, { "name": "Withdrawals list", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"withdrawal_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet/withdrawals?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet", "withdrawals" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Withdrawals list — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet/withdrawals?perPage=15", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet", "withdrawals" ], "query": [ { "key": "perPage", "value": "15", "description": "int default 15", "disabled": false } ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Request withdrawal", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"withdrawal_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet/withdrawals", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet", "withdrawals" ] }, "description": "**Validation**\n- `amount`: required|numeric|min:{min_withdrawal|100}|max:999999999.99\n- `bank_name`: required|string|min:2|max:100\n- `account_holder`: required|string|min:2|max:100\n- `account_number`: required|string|min:4|max:34\n- `iban`: required|string|SaudiIbanRule\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "amount", "type": "text", "description": "required|numeric|min:{min_withdrawal|100}|max:999999999.99", "value": "100" }, { "key": "bank_name", "type": "text", "description": "required|string|min:2|max:100", "value": "Al Rajhi" }, { "key": "account_holder", "type": "text", "description": "required|string|min:2|max:100", "value": "Seller Name" }, { "key": "account_number", "type": "text", "description": "required|string|min:4|max:34", "value": "1234567890" }, { "key": "iban", "type": "text", "description": "required|string|SaudiIbanRule", "value": "SA0380000000608010167519" } ] } }, "response": [ { "name": "Request withdrawal — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet/withdrawals", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet", "withdrawals" ] }, "description": "**Validation**\n- `amount`: required|numeric|min:{min_withdrawal|100}|max:999999999.99\n- `bank_name`: required|string|min:2|max:100\n- `account_holder`: required|string|min:2|max:100\n- `account_number`: required|string|min:4|max:34\n- `iban`: required|string|SaudiIbanRule\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "amount", "type": "text", "description": "required|numeric|min:{min_withdrawal|100}|max:999999999.99", "value": "100" }, { "key": "bank_name", "type": "text", "description": "required|string|min:2|max:100", "value": "Al Rajhi" }, { "key": "account_holder", "type": "text", "description": "required|string|min:2|max:100", "value": "Seller Name" }, { "key": "account_number", "type": "text", "description": "required|string|min:4|max:34", "value": "1234567890" }, { "key": "iban", "type": "text", "description": "required|string|SaudiIbanRule", "value": "SA0380000000608010167519" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Withdrawal show", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"withdrawal_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet/withdrawals/{{withdrawal_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet", "withdrawals", "{{withdrawal_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Withdrawal show — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/wallet/withdrawals/{{withdrawal_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "wallet", "withdrawals", "{{withdrawal_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] } ] }, { "name": "14 Support Complains", "item": [ { "name": "Complaint reasons", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"complain_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/complains/reasons", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "complains", "reasons" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Complaint reasons — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/complains/reasons", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "complains", "reasons" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "List complains", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"complain_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/complains", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "complains" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "List complains — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/complains", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "complains" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"data\": [\n {\n \"id\": 1\n }\n ],\n \"pagination\": {\n \"total\": 1,\n \"count\": 1,\n \"per_page\": 15,\n \"current_page\": 1,\n \"total_pages\": 1\n }\n }\n}" } ] }, { "name": "Create complain", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"complain_id\", String(json.data.id));", "}", "" ] } } ], "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/complains", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "complains" ] }, "description": "**Validation**\n- `reason_id`: required|integer|exists:complaint_reasons,id\n- `custom_reason`: nullable|string|max:500\n- `description`: nullable|string|max:1000\n- `images`: nullable|array|max:5\n- `images.*`: image|mimes:jpeg,png,jpg,gif,webp|max:5120\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "reason_id", "type": "text", "description": "required|integer|exists:complaint_reasons,id", "value": "1" }, { "key": "description", "type": "text", "description": "nullable|string|max:1000", "value": "Need help with settlement timing" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "image|mimes:jpeg,png,jpg,gif,webp|max:5120" } ] } }, "response": [ { "name": "Create complain — Example", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/complains", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "complains" ] }, "description": "**Validation**\n- `reason_id`: required|integer|exists:complaint_reasons,id\n- `custom_reason`: nullable|string|max:500\n- `description`: nullable|string|max:1000\n- `images`: nullable|array|max:5\n- `images.*`: image|mimes:jpeg,png,jpg,gif,webp|max:5120\n\n_Body: `multipart/form-data` (form-data)._", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] }, "body": { "mode": "formdata", "formdata": [ { "key": "reason_id", "type": "text", "description": "required|integer|exists:complaint_reasons,id", "value": "1" }, { "key": "description", "type": "text", "description": "nullable|string|max:1000", "value": "Need help with settlement timing" }, { "key": "images[]", "type": "file", "src": [], "value": "", "description": "image|mimes:jpeg,png,jpg,gif,webp|max:5120" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {}\n}" } ] }, { "name": "Show complain", "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test(\"HTTP status is 200 (API envelope)\", function () {", " pm.response.to.have.status(200);", "});", "", "pm.test(\"Response is JSON\", function () {", " pm.response.to.be.json;", "});", "", "const json = pm.response.json();", "", "pm.test(\"Envelope has key + msg\", function () {", " pm.expect(json).to.have.property(\"key\");", " pm.expect(json.key).to.be.a(\"string\").and.not.empty;", " pm.expect(json).to.have.property(\"msg\");", " pm.expect(json.msg).to.be.a(\"string\");", "});", "", "pm.test(\"key is an expected API status\", function () {", " pm.expect([\"success\",\"fail\",\"unauthenticated\",\"blocked\",\"needApproval\",\"needs_acceptance\",\"profileNotCompleted\",\"needActive\",\"needVerification\"]).to.include(json.key);", "});", "", "pm.test(\"Non-fail responses include data\", function () {", " if (json.key !== \"fail\" && json.key !== \"unauthenticated\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "", "if (json.key === \"success\" && json.data && typeof json.data === \"object\" && !Array.isArray(json.data) && json.data.id) {", " pm.environment.set(\"complain_id\", String(json.data.id));", "}", "", "pm.test(\"Successful GET includes data\", function () {", " if (json.key === \"success\") {", " pm.expect(json).to.have.property(\"data\");", " }", "});", "" ] } } ], "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/complains/{{complain_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "complains", "{{complain_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "response": [ { "name": "Show complain — Example", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Lang", "value": "{{lang}}" } ], "url": { "raw": "{{base_url}}/api/provider/complains/{{complain_id}}", "host": [ "{{base_url}}" ], "path": [ "api", "provider", "complains", "{{complain_id}}" ] }, "description": "", "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{provider_token}}", "type": "string" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "body": "{\n \"key\": \"success\",\n \"msg\": \"Done successfully\",\n \"data\": {\n \"id\": 1\n }\n}" } ] } ] } ] } ] }