Perfect Panel API Integration Guide

This document provides the necessary API parameters for integrating your website with our automated order routing system. Our system acts as a Perfect Panel Provider, receiving order requests via Webhook.

API Endpoint

Your API endpoint will be a Webhook URL provided by our system (n8n). Please contact us to get your unique Webhook URL.

Example (replace with your actual URL):

POST https://your-n8n-instance.com/webhook/your-unique-webhook-path

Authentication

All requests must include a valid API key for authentication. This key ensures the security of your orders.

API Parameters

The following parameters should be sent in the request body (JSON format) to the API endpoint:

Parameter	Type	Required	Description
api_key	String	Yes	Your unique API key for authentication.
service_id	Integer	Yes	The ID of the service being ordered (e.g., 101 for Instagram Likes).
link	String	Yes	The link or URL associated with the order (e.g., Instagram post link).
quantity	Integer	Yes	The desired quantity for the service (e.g., 1000 likes).
order_id	String	Yes	A unique order identifier from your Perfect Panel account. This is used for tracking and reconciliation.
runs	Integer	No	Number of runs to be delivered.
interval	Integer	No	Delay in minutes between runs.

Example Request Body (JSON)

{
        "api_key": "YOUR_API_KEY_HERE",
        "service_id": 101,
        "link": "https://www.instagram.com/p/your-post-id/",
        "quantity": 1000,
        "order_id": "YOUR_UNIQUE_ORDER_ID_12345",
        "runs": 5,
        "interval": 60
    }

Response

Upon successful order submission, you will receive a JSON response indicating the status of the order. Example:

{
        "status": "success",
        "message": "Order received successfully",
        "your_order_id": "YOUR_UNIQUE_ORDER_ID_12345",
        "provider_order_id": "INTERNAL_TRACKING_ID_XYZ"
    }

In case of an error, the response will include an error status and a descriptive message:

{
        "status": "error",
        "message": "Invalid API key provided"
    }

Error Handling

Our system will provide descriptive error messages for issues such as invalid API keys, missing parameters, or invalid data. Please ensure your integration handles these responses appropriately.

Future Enhancements

This system is designed with future enhancements in mind, including:

• Comprehensive logging for all order transactions.
• Advanced error handling and retry mechanisms.
• Support for multi-provider distribution to optimize order fulfillment.
• Additional order parameters and service types.

For any further assistance or to obtain your Webhook URL, please contact our support team.