Assign-list API Documentation

This document provides the necessary details to interact with the Assign-list API endpoints. The API allows users to retrieve information about equipment assigned to riders, including various filtering options.

Base URL

https://talabatkw.wearyourebrand.com/api/v2

Endpoints

GET /assign-list

Retrieve information about equipment assigned to riders. This endpoint allows various filtering options to narrow down the results based on the provided parameters.

Query Parameters

Parameter	Type	Description
rider_id	bigint	(optional) Filter by rider ID.
3pl	text	(optional) Filter by third-party logistics (3PL) name.
product_id	bigint	(optional) Filter by product ID.
variation_id	bigint	(optional) Filter by product variation ID.
assign_date_from	date	(optional) Filter by assign date (start range).
assign_date_to	date	(optional) Filter by assign date (end range).
assign_type	tinyint(1)	(optional) Filter by assign type (0 or 1).

Response

The response will be a JSON array of rider equipment details. Each object in the array contains the following fields:

Field	Description
Rider ID	(bigint) ID of the rider.
3PL	(text) Name of the third-party logistics.
Product ID	(bigint) ID of the product.
Product Name	(longtext) Name of the product.
Product Variation ID	(bigint) ID of the product variation.
Product Variation Name	(longtext) Name of the product variation.
Assign Date	(datetime) Date when the product was assigned.
Assignee Name	(text) Name of the user who assigned the product.
Assign Type	(tinyint(1)) Indicates if the assignment was manual or physical.

Caution

Retrieving an equipment model returns every field; the ones that are empty have a value of null. For example, you shouldn’t rely simply on the presence of the “Assign Date” field if you want to check if an item is assigned; you also have to check if it has a null value.

Example Request

GET /assign-list?rider_id=50&assign_date_from=2024-01-01&assign_date_to=2024-06-01

Example Response

[
    {
        "Rider ID": 50,
        "3PL": "Logistics Company A",
        "Product ID": 123,
        "Product Name": "Helmet",
        "Product Variation ID": 1,
        "Product Variation Name": "Size L",
        "Assign Date": "2024-01-15 10:30:00",
        "Assignee Name": "John Doe",
        "Assign Type": "Manual"
    },
    {
        "Rider ID": 50,
        "3PL": "Logistics Company B",
        "Product ID": 456,
        "Product Name": "Jacket",
        "Product Variation ID": 2,
        "Product Variation Name": "Size M",
        "Assign Date": "2024-02-10 14:45:00",
        "Assignee Name": "Jane Smith",
        "Assign Type": "Physical"
    }
]

Notes

Ensure that the date format for assign_date_from and assign_date_to is YYYY-MM-DD. The parameter names are case-sensitive. If no parameters are provided, the endpoint returns all rider equipment details.

Example

Scenario: Filtering by Rider ID and Date Range To retrieve equipment assigned to rider with ID 50 between 2024-01-01 and 2024-06-01:

GET /assign-list?rider_id=50&assign_date_from=2024-01-01&assign_date_to=2024-06-01

Response

[
    {
        "Rider ID": 50,
        "3PL": "Logistics Company A",
        "Product ID": 123,
        "Product Name": "Helmet",
        "Product Variation ID": 1,
        "Product Variation Name": "Size L",
        "Assign Date": "2024-01-15 10:30:00",
        "Assignee Name": "John Doe",
        "Assign Type": "Manual"
    }
]