The Voomerr Add Offer API allows users to add an offer. The API accepts various parameters such as user IDs, gig IDs, delivery information, payment information, and more. This API is used to add offers in the Voomerr marketplace.
Endpoint #
The Voomerr Add Offer API endpoint is POST https://admin.voomerr.com/api/add_offers.php
Request Parameters #
The following parameters are required to add an offer:
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | Yes | The ID of the user adding the offer. |
| fromUserId | string | Yes | The ID of the user who created the gig. |
| gig_id | string | Yes | The ID of the gig to which the offer is being made. |
| delivery_lat | float | Yes | The latitude of the delivery location. |
| delivery_long | float | Yes | The longitude of the delivery location. |
| delivery_address | string | Yes | The address of the delivery location. |
| required_time | string | Yes | The time at which the delivery is required. |
| delivery_type | string | Yes | The type of delivery, such as “normal” or “express”. |
| card_id | string | No | The ID of the payment card to be used for payment. |
| amount | float | Yes | The amount to be paid for the gig. |
| currency | string | Yes | The currency in which the payment will be made. |
| transportation_cost | float | No | The cost of transportation to be paid. |
| product_ids | string | No | The IDs of the products to be delivered. |
| is_buynow | boolean | Yes | A flag indicating whether the offer is for a “buy now” gig. |
Example Request #
POST https://admin.voomerr.com/api/add_offers.php
{
"user_id": "123456789",
"fromUserId": "987654321",
"gig_id": "G1234567",
"delivery_lat": 37.7749,
"delivery_long": -122.4194,
"delivery_address": "123 Main Street, San Francisco, CA",
"required_time": "2023-03-15 08:00:00",
"delivery_type": "normal",
"card_id": "C1234567",
"amount": 100.00,
"currency": "USD",
"transportation_cost": 10.00,
"product_ids": "P12345,P67890",
"is_buynow": false
}
Response #
The response from the API will contain a JSON object with the following fields:
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request was successful or not. |
| message | string | A message indicating the success or failure of the request. |
| offer_id | string | The ID of the offer that was created. |
If the request is successful, the ‘success’ field will be ‘true’, the ‘message’ field will contain a success message indicating that the offer was successfully created, and the ‘offer_id’ field will contain the ID of the offer that was created. If the request fails, the ‘success’ field will be ‘false’, and the ‘message’ field will contain an error message indicating that the creation of the offer has failed.
Example Response #
{
"success": true,
"message": "Offer created successfully"
}
