1. Introduction

Rentify Stack offers a robust, secure, and scalable API for developers to access our rental services programmatically. Our APIs enable you to manage rentals for SMM panels, business websites, e-commerce platforms, Shopify stores, and developer tools. All APIs are REST-based, use JSON for data exchange, and are secured with API keys and OAuth 2.0.

• Base URL: https://api.rentifystack.com/v1
• Authentication: Requires API key or OAuth 2.0 token.
• Support: Email support@rentifystack.com or call +92-123-4567890.

2. Getting Started

To use our APIs, follow these steps:

• Register: Sign up at rentifystack.com/signup to get your API key.
• Obtain API Key: Find your API key in your account dashboard after login.
• Test Endpoints: Use tools like Postman or cURL to test API calls.
• Review Terms: Ensure compliance with our Terms of Service and Privacy Policy.

3. Authentication

Authenticate requests using an API key in the request header:

Authorization: Bearer YOUR_API_KEY

For OAuth 2.0, request a token:

POST /v1/oauth/token HTTP/1.1
Host: api.rentifystack.com
Content-Type: application/json

{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET",
  "grant_type": "client_credentials"
}

Response:

{
  "access_token": "YOUR_ACCESS_TOKEN",
  "token_type": "Bearer",
  "expires_in": 3600
}

4. Key Endpoints

Below are the primary endpoints for managing rentals:

• GET /v1/rentals: List all available rentals (APIs, SMM panels, websites, Shopify stores).
• POST /v1/rentals: Create a new rental request.
• GET /v1/rentals/{id}: Retrieve details of a specific rental.
• PUT /v1/rentals/{id}: Update an existing rental.
• DELETE /v1/rentals/{id}: Cancel a rental.

5. Example API Calls

Python Example (List Rentals)

import requests

url = "https://api.rentifystack.com/v1/rentals"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}")

JavaScript Example (Create Rental)

const url = 'https://api.rentifystack.com/v1/rentals';
const headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
};
const data = {
    type: 'smm-panel',
    plan: 'premium',
    duration: 'monthly'
};

fetch(url, {
    method: 'POST',
    headers: headers,
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

PHP Example (Retrieve Rental Details)

Error: HTTP 0

6. Rate Limits

Our APIs are rate-limited to ensure fair usage:

• Free Plan: 100 requests per hour.
• Premium Plan: 1000 requests per hour.
• Exceeding limits returns a 429 Too Many Requests response.

Monitor the X-RateLimit-Remaining header in responses to track your usage.

7. Best Practices

• Always use HTTPS to secure API requests.
• Keep your API key confidential and rotate it periodically.
• Cache responses where possible to reduce API calls.
• Adhere to our Terms of Service and avoid abusive usage.
• Contact support@rentifystack.com for integration assistance.

8. Error Handling

Common error responses include:

• 400 Bad Request: Invalid request parameters.
• 401 Unauthorized: Invalid or missing API key.
• 403 Forbidden: Access denied to the requested resource.
• 429 Too Many Requests: Rate limit exceeded.
• 500 Internal Server Error: Server-side issue; contact support.

9. Compliance with FBR and State Bank of Pakistan

Rentify Stack is officially verified by the Federal Board of Revenue (FBR) and complies with State Bank of Pakistan regulations:

• Transparent reporting of API transactions for tax purposes as per FBR guidelines.
• Secure payment processing for API rentals in accordance with State Bank standards.
• Data protection measures aligned with Pakistani laws, as detailed in our Privacy Policy.

10. Contact Us

For API integration support or questions, please contact us:

• Email: support@rentifystack.com
• Phone: +92-123-4567890
• Address: Lahore, Pakistan