Documentation API REST MeFaucet

1. Liste de tous les sites

Requête

GET https://mefaucet.com/api/v1/get-all

Obtient la liste de tous les sites référencés sur mefaucet. Aucun paramètre n'est requis.

Paramètres (aucun)

Paramètre	Type	Obligatoire	Description
-	-	Non	Aucun paramètre requis pour cet endpoint.

Exemple de Réponse (200 OK)

{
    "all_faucet": [
        {
            "id": "1",
            "name": "Bigoo Faucet",
            "description": "Bigoo Faucet is free reward faucet where you can claim your reward",
            "url": "https://bigoofaucet.com",
            "types": "faucet",
            "currencies": "usd",
            "created_at": "2025-02-20 15:20:34"
        },
        {
            "id": "2",
            "name": "Wylcoin",
            "description": "Wylcoin",
            "url": "https://wylcoin.com",
            "types": "tma",
            "currencies": "",
            "created_at": "2025-02-20 15:20:34"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

1. List All Sites

Request

GET https://mefaucet.com/api/v1/get-all

Retrieves a list of all registered sites on mefaucet. No parameters are required.

Parameters (None)

Parameter	Type	Required	Description
-	-	No	No parameters are required for this endpoint.

Example Response (200 OK)

{
    "all_faucet": [
        {
            "id": "1",
            "name": "Bigoo Faucet",
            "description": "Bigoo Faucet is free reward faucet where you can claim your reward",
            "url": "https://bigoofaucet.com",
            "types": "faucet",
            "currencies": "usd",
            "created_at": "2025-02-20 15:20:34"
        },
        {
            "id": "2",
            "name": "Wylcoin",
            "description": "Wylcoin",
            "url": "https://wylcoin.com",
            "types": "tma",
            "currencies": "",
            "created_at": "2025-02-20 15:20:34"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

1. Listar Todos los Sitios

Solicitud

GET https://mefaucet.com/api/v1/get-all

Obtiene la lista de todos los sitios registrados en mefaucet. No se requieren parámetros.

Parámetros (ninguno)

Parámetro	Tipo	Obligatorio	Descripción
-	-	No	Ningún parámetro requerido para este endpoint.

Ejemplo de Respuesta (200 OK)

{
    "all_faucet": [
        {
            "id": "1",
            "name": "Bigoo Faucet",
            "description": "Bigoo Faucet is free reward faucet where you can claim your reward",
            "url": "https://bigoofaucet.com",
            "types": "faucet",
            "currencies": "usd",
            "created_at": "2025-02-20 15:20:34"
        },
        {
            "id": "2",
            "name": "Wylcoin",
            "description": "Wylcoin",
            "url": "https://wylcoin.com",
            "types": "tma",
            "currencies": "",
            "created_at": "2025-02-20 15:20:34"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

1. Список всех сайтов

Запрос

GET https://mefaucet.com/api/v1/get-all

Получает список всех зарегистрированных сайтов на mefaucet. Параметры не требуются.

Параметры (нет)

Параметр	Тип	Требуется	Описание
-	-	Нет	Для этого эндпоинта параметры не требуются.

Пример Ответа (200 OK)

{
    "all_faucet": [
        {
            "id": "1",
            "name": "Bigoo Faucet",
            "description": "Bigoo Faucet is free reward faucet where you can claim your reward",
            "url": "https://bigoofaucet.com",
            "types": "faucet",
            "currencies": "usd",
            "created_at": "2025-02-20 15:20:34"
        },
        {
            "id": "2",
            "name": "Wylcoin",
            "description": "Wylcoin",
            "url": "https://wylcoin.com",
            "types": "tma",
            "currencies": "",
            "created_at": "2025-02-20 15:20:34"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

2. Obtenir un site unique

Requête

GET https://mefaucet.com/api/v1/get-single/{id}

Vous pouvez obtenir toutes les informations sur un site spécifique. L'inclusion de votre **clé API** est facultative : elle permet d'obtenir des informations complètes, y compris les soldes (balances) du site.

URL complète (avec clé) : https://mefaucet.com/api/v1/get-single/{id}?api_key={api_key}
URL de base (sans clé) : https://mefaucet.com/api/v1/get-single/{id}

Paramètres de la requête

Paramètre	Type	Obligatoire	Description
`id`	`path`	Oui	L'identifiant unique du site.
`api_key`	`query string`	Non	Une clé API valide. Nécessaire pour obtenir les informations complètes (solde).

Exemple de Réponse Complète (200 OK)

{
    "result": [
        {
            "id": "1",
            "faucet_owner": "1",
            "name": "Faucet",
            "description": "where you can claim your reward",
            "url": "http://localhost/faucet",
            "types": "faucet",
            "currencies": "usd",
            "usd_balance": "1.455000",
            "btc_balance": "0.0007",
            "eth_balance": "0.00300000",
            "usdt_balance": "2.0045000",
            "created_at": "2025-02-02 12:00:00"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

2. Get Single Site

Request

GET https://mefaucet.com/api/v1/get-single/{id}

You can retrieve all information for a specific site. Including your **API key** is optional, but it allows you to get full information, including the site's balances.

Full URL (with key): https://mefaucet.com/api/v1/get-single/{id}?api_key={api_key}
Base URL (without key): https://mefaucet.com/api/v1/get-single/{id}

Request Parameters

Parameter	Type	Required	Description
`id`	`path`	Yes	The unique site identifier.
`api_key`	`query string`	No	A valid API key. Necessary to retrieve full information (balance).

Example Complete Response (200 OK)

{
    "result": [
        {
            "id": "1",
            "faucet_owner": "1",
            "name": "Faucet",
            "description": "where you can claim your reward",
            "url": "http://localhost/faucet",
            "types": "faucet",
            "currencies": "usd",
            "usd_balance": "1.455000",
            "btc_balance": "0.0007",
            "eth_balance": "0.00300000",
            "usdt_balance": "2.0045000",
            "created_at": "2025-02-02 12:00:00"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

2. Obtener un Solo Sitio

Solicitud

GET https://mefaucet.com/api/v1/get-single/{id}

Puede recuperar toda la información para un sitio específico. Incluir su **clave API** es opcional, pero le permite obtener información completa, incluido el saldo del sitio.

URL completa (con clave): https://mefaucet.com/api/v1/get-single/{id}?api_key={api_key}
URL base (sin clave): https://mefaucet.com/api/v1/get-single/{id}

Parámetros de Solicitud

Parámetro	Tipo	Obligatorio	Descripción
`id`	`path`	Sí	El identificador único del sitio.
`api_key`	`query string`	No	Una clave API válida. Necesaria para obtener información completa (saldo).

Ejemplo de Respuesta Completa (200 OK)

{
    "result": [
        {
            "id": "1",
            "faucet_owner": "1",
            "name": "Faucet",
            "description": "where you can claim your reward",
            "url": "http://localhost/faucet",
            "types": "faucet",
            "currencies": "usd",
            "usd_balance": "1.455000",
            "btc_balance": "0.0007",
            "eth_balance": "0.00300000",
            "usdt_balance": "2.0045000",
            "created_at": "2025-02-02 12:00:00"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

2. Получить один сайт

Запрос

GET https://mefaucet.com/api/v1/get-single/{id}

Вы можете получить всю информацию по конкретному сайту. Включение вашего **API ключа** является необязательным, но позволяет получить полную информацию, включая балансы сайта.

Полный URL (с ключом): https://mefaucet.com/api/v1/get-single/{id}?api_key={api_key}
Базовый URL (без ключа): https://mefaucet.com/api/v1/get-single/{id}

Параметры Запроса

Параметр	Тип	Требуется	Описание
`id`	`path`	Да	Уникальный идентификатор сайта.
`api_key`	`query string`	Нет	Действительный API ключ. Необходим для получения полной информации (баланса).

Пример Полного Ответа (200 OK)

{
    "result": [
        {
            "id": "1",
            "faucet_owner": "1",
            "name": "Faucet",
            "description": "where you can claim your reward",
            "url": "http://localhost/faucet",
            "types": "faucet",
            "currencies": "usd",
            "usd_balance": "1.455000",
            "btc_balance": "0.0007",
            "eth_balance": "0.00300000",
            "usdt_balance": "2.0045000",
            "created_at": "2025-02-02 12:00:00"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

3. Sites par catégorie

Requête

GET https://mefaucet.com/api/v1/get-all-{category}

Obtient la liste complète des sites par catégorie. Les catégories possibles incluent : faucet, telegram mini app, adnetwork, etc.
**Exemple :** pour obtenir tous les sites de type 'faucet', utilisez : https://mefaucet.com/api/v1/get-all-faucet

Paramètres (dans l'URL)

Paramètre	Type	Obligatoire	Description
`{category}`	`path`	Oui	Nom de la catégorie désirée.

Exemple de Réponse (200 OK)

{
    "all_faucet": [
        {
            "id": "1",
            "name": "LightFaucet",
            "description": "Is the best",
            "url": "http://localhost/lastfaucet",
            "types": "faucet",
            "currencies": "usd,btc",
            "created_at": "0000-00-00 00:00:00"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

3. Sites by Category

Request

GET https://mefaucet.com/api/v1/get-all-{category}

Retrieves the complete list of sites by category. Possible categories include: faucet, telegram mini app, adnetwork, etc.
**Example:** To get all 'faucet' type sites, use: https://mefaucet.com/api/v1/get-all-faucet

Parameters (in URL)

Parameter	Type	Required	Description
`{category}`	`path`	Yes	Name of the desired category.

Example Response (200 OK)

{
    "all_faucet": [
        {
            "id": "1",
            "name": "LightFaucet",
            "description": "Is the best",
            "url": "http://localhost/lastfaucet",
            "types": "faucet",
            "currencies": "usd,btc",
            "created_at": "0000-00-00 00:00:00"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

3. Sitios por Categoría

Solicitud

GET https://mefaucet.com/api/v1/get-all-{category}

Recupera la lista completa de sitios por categoría. Las posibles categorías incluyen: faucet, telegram mini app, adnetwork, etc.
**Ejemplo:** Para obtener todos los sitios de tipo 'faucet', use: https://mefaucet.com/api/v1/get-all-faucet

Parámetros (en la URL)

Parámetro	Tipo	Obligatorio	Descripción
`{category}`	`path`	Sí	Nombre de la categoría deseada.

Ejemplo de Respuesta (200 OK)

{
    "all_faucet": [
        {
            "id": "1",
            "name": "LightFaucet",
            "description": "Is the best",
            "url": "http://localhost/lastfaucet",
            "types": "faucet",
            "currencies": "usd,btc",
            "created_at": "0000-00-00 00:00:00"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

3. Сайты по категориям

Запрос

GET https://mefaucet.com/api/v1/get-all-{category}

Получает полный список сайтов по категориям. Возможные категории: faucet, telegram mini app, adnetwork и т.д.
**Пример:** Чтобы получить все сайты типа 'faucet', используйте: https://mefaucet.com/api/v1/get-all-faucet

Параметры (в URL)

Параметр	Тип	Требуется	Описание
`{category}`	`path`	Да	Название требуемой категории.

Пример Ответа (200 OK)

{
    "all_faucet": [
        {
            "id": "1",
            "name": "LightFaucet",
            "description": "Is the best",
            "url": "http://localhost/lastfaucet",
            "types": "faucet",
            "currencies": "usd,btc",
            "created_at": "0000-00-00 00:00:00"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

4. Solde du site

Requête

GET https://mefaucet.com/api/v1/get-balance?api_key={api_key}&currency={currency}

Permet de connaître le solde disponible pour votre site, par devise.

Paramètres de la requête

Paramètre	Type	Obligatoire	Description
`api_key`	`string`	Oui	Votre clé API valide.
`currency`	`string`	Oui	La devise dont vous souhaitez connaître le solde (ex: `usd`, `btc`).

Exemple de Réponse (200 OK)

{
    "result": [
        {
            "name": "My Faucet",
            "usd_balance": "3.455000"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

4. Site Balance

Request

GET https://mefaucet.com/api/v1/get-balance?api_key={api_key}&currency={currency}

Allows you to retrieve the available balance for your site, per currency.

Request Parameters

Parameter	Type	Required	Description
`api_key`	`string`	Yes	Your valid API key.
`currency`	`string`	Yes	The currency for which you want to know the balance (e.g., `usd`, `btc`).

Example Response (200 OK)

{
    "result": [
        {
            "name": "My Faucet",
            "usd_balance": "3.455000"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

4. Saldo del Sitio

Solicitud

GET https://mefaucet.com/api/v1/get-balance?api_key={api_key}&currency={currency}

Le permite recuperar el saldo disponible para su sitio, por moneda.

Parámetros de Solicitud

Parámetro	Tipo	Obligatorio	Descripción
`api_key`	`string`	Sí	Su clave API válida.
`currency`	`string`	Sí	La moneda para la que desea conocer el saldo (ej: `usd`, `btc`).

Ejemplo de Respuesta (200 OK)

{
    "result": [
        {
            "name": "My Faucet",
            "usd_balance": "3.455000"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

4. Баланс сайта

Запрос

GET https://mefaucet.com/api/v1/get-balance?api_key={api_key}&currency={currency}

Позволяет получить доступный баланс для вашего сайта, в разрезе валют.

Параметры Запроса

Параметр	Тип	Требуется	Описание
`api_key`	`string`	Да	Ваш действительный API ключ.
`currency`	`string`	Да	Валюта, баланс которой вы хотите узнать (например: `usd`, `btc`).

Пример Ответа (200 OK)

{
    "result": [
        {
            "name": "My Faucet",
            "usd_balance": "3.455000"
        }
    ],
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

5. Envoyer un paiement

Requête

POST

https://mefaucet.com/api/v1/send?api_key={api_key}&currency={currency}&amount={amount}&ip_address={ip_address}&receiver={receiver}

Utilisez cet endpoint pour envoyer des paiements à vos utilisateurs. Tous les paramètres doivent être envoyés dans la **query string** ou dans le corps de la requête (form-data).

Paramètres de la requête

Paramètre	Type	Obligatoire	Description
`api_key`	`string`	Oui	Votre clé API valide.
`currency`	`string`	Oui	La devise à envoyer.
`amount`	`integer`	Oui	Le montant que vous souhaitez envoyer.
`receiver`	`string`	Oui	Adresse, email, ID utilisateur ou nom d'utilisateur du bénéficiaire.
`ip_address`	`string`	Non	Fournissez l'adresse IP de votre utilisateur si vous souhaitez utiliser notre système anti-fraude.

Exemple de Réponse (200 OK)

{
    "result": "success",
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

5. Send Payment

Request

POST

https://mefaucet.com/api/v1/send?api_key={api_key}&currency={currency}&amount={amount}&ip_address={ip_address}&receiver={receiver}

Use this endpoint to send payments to your users. All parameters must be sent in the **query string** or in the request body (form-data).

Request Parameters

Parameter	Type	Required	Description
`api_key`	`string`	Yes	Your valid API key.
`currency`	`string`	Yes	The currency to send.
`amount`	`integer`	Yes	The amount you wish to send.
`receiver`	`string`	Yes	Receiver address, email, user ID, or username.
`ip_address`	`string`	No	Provide your user's IP address if you wish to use our anti-fraud system.

Example Response (200 OK)

{
    "result": "success",
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

5. Enviar un Pago

Solicitud

POST

https://mefaucet.com/api/v1/send?api_key={api_key}&currency={currency}&amount={amount}&ip_address={ip_address}&receiver={receiver}

Utilice este endpoint para enviar pagos a sus usuarios. Todos los parámetros deben enviarse en la **query string** o en el cuerpo de la solicitud (form-data).

Parámetros de Solicitud

Parámetro	Type	Obligatorio	Descripción
`api_key`	`string`	Sí	Su clave API válida.
`currency`	`string`	Sí	La moneda a enviar.
`amount`	`integer`	Sí	La cantidad que desea enviar.
`receiver`	`string`	Sí	Dirección, correo electrónico, ID de usuario o nombre de usuario del beneficiario.
`ip_address`	`string`	No	Proporcione la dirección IP de su usuario si desea utilizar nuestro sistema antifraude.

Ejemplo de Réponse (200 OK)

{
    "result": "success",
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

5. Отправить платеж

Запрос

POST

https://mefaucet.com/api/v1/send?api_key={api_key}&currency={currency}&amount={amount}&ip_address={ip_address}&receiver={receiver}

Используйте этот эндпоинт для отправки платежей вашим пользователям. Все параметры должны быть отправлены в **query string** или в теле запроса (form-data).

Параметры Запроса

Параметр	Тип	Требуется	Описание
`api_key`	`string`	Да	Ваш действительный API ключ.
`currency`	`string`	Да	Отправляемая валюта.
`amount`	`integer`	Да	Сумма, которую вы хотите отправить.
`receiver`	`string`	Да	Адрес, email, ID пользователя или имя пользователя получателя.
`ip_address`	`string`	Нет	Укажите IP-адрес вашего пользователя, если хотите использовать нашу систему защиты от мошенничества.

Пример Ответа (200 OK)

{
    "result": "success",
    "status": 200,
    "error": null,
    "messages": {
        "success": "Success"
    }
}

Introduction

Introduction

Introducción

Введение

1. Liste de tous les sites

Requête

Paramètres (aucun)

Exemple de Réponse (200 OK)

1. List All Sites

Request

Parameters (None)

Example Response (200 OK)

1. Listar Todos los Sitios

Solicitud

Parámetros (ninguno)

Ejemplo de Respuesta (200 OK)

1. Список всех сайтов

Запрос

Параметры (нет)

Пример Ответа (200 OK)

2. Obtenir un site unique

Requête

Paramètres de la requête

Exemple de Réponse Complète (200 OK)

2. Get Single Site

Request

Request Parameters

Example Complete Response (200 OK)

2. Obtener un Solo Sitio

Solicitud

Parámetros de Solicitud

Ejemplo de Respuesta Completa (200 OK)

2. Получить один сайт

Запрос

Параметры Запроса

Пример Полного Ответа (200 OK)

3. Sites par catégorie

Requête

Paramètres (dans l'URL)

Exemple de Réponse (200 OK)

3. Sites by Category

Request

Parameters (in URL)

Example Response (200 OK)

3. Sitios por Categoría

Solicitud

Parámetros (en la URL)

Ejemplo de Respuesta (200 OK)

3. Сайты по категориям

Запрос

Параметры (в URL)

Пример Ответа (200 OK)

4. Solde du site

Requête

Paramètres de la requête

Exemple de Réponse (200 OK)

4. Site Balance

Request

Request Parameters

Example Response (200 OK)

4. Saldo del Sitio

Solicitud

Parámetros de Solicitud

Ejemplo de Respuesta (200 OK)

4. Баланс сайта

Запрос

Параметры Запроса

Пример Ответа (200 OK)

5. Envoyer un paiement

Requête

Paramètres de la requête

Exemple de Réponse (200 OK)

5. Send Payment

Request

Request Parameters

Example Response (200 OK)

5. Enviar un Pago

Solicitud

Parámetros de Solicitud

Ejemplo de Réponse (200 OK)