Introduction
Sur cette page, vous trouverez les détails techniques et les directives pour intégrer notre **API REST** dans votre robinet (faucet).
Attention :
Nous pouvons bloquer l'accès à notre API en fonction de votre adresse IP, appareil et site web si nous détectons un abus.
Introduction
On this page, you will find the technical details and guidelines for integrating our **REST API** into your faucet.
Warning:
We may block access to our API based on your IP address, device, and website if we detect abuse.
Introducción
En esta página, encontrará los detalles técnicos y las directrices para integrar nuestra **API REST** en su faucet (grifo).
Advertencia:
Podemos bloquear el acceso a nuestra API según su dirección IP, dispositivo y sitio web si detectamos un abuso.
Введение
На этой странице вы найдете технические детали и рекомендации по интеграции нашего **REST API** в ваш кран (faucet).
Внимание:
Мы можем заблокировать доступ к нашему API на основе вашего IP-адреса, устройства и веб-сайта, если обнаружим злоупотребление.
1. Liste de tous les sites
Requête
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
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
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. Список всех сайтов
Запрос
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
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
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
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. Получить один сайт
Запрос
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
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
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
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. Сайты по категориям
Запрос
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
https://mefaucet.com/api/v1/get-balance?api_key={api_key}¤cy={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
https://mefaucet.com/api/v1/get-balance?api_key={api_key}¤cy={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
https://mefaucet.com/api/v1/get-balance?api_key={api_key}¤cy={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. Баланс сайта
Запрос
https://mefaucet.com/api/v1/get-balance?api_key={api_key}¤cy={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
https://mefaucet.com/api/v1/send?api_key={api_key}¤cy={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
https://mefaucet.com/api/v1/send?api_key={api_key}¤cy={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
https://mefaucet.com/api/v1/send?api_key={api_key}¤cy={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. Отправить платеж
Запрос
https://mefaucet.com/api/v1/send?api_key={api_key}¤cy={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"
}
}