MobileUnlockStar API: Офіційна Документація (v1.0)

Ласкаво просимо до офіційної документації MobileUnlockStar API. Наш сервіс надає розробникам, сервісним центрам та бізнесу миттєвий доступ до детальної інформації про пристрої Apple у реальному часі.

За допомогою єдиного шлюзу ви можете інтегрувати у свій проект перевірку статусу Find My, наявність MDM-профілю, блокування оператора (SIM Lock) та отримувати найповніші звіти з бази GSX.

1. Авторизація (Authentication)

Усі запити до API є приватними і вимагають авторизації за допомогою вашого унікального API-ключа. Кошти списуються з вашого балансу лише у випадку успішного виконання запиту (Failed-запити безкоштовні).

2. Базові налаштування та ліміти

• Базовий URL: https://www.mobileunlockstar.com/api/v1
• Формат відповідей: Усі відповіді сервера повертаються виключно у форматі JSON.
• Ліміти (Rate Limits):
  • Максимум 60 запитів на хвилину з однієї IP-адреси.
  • Максимум 1000 запитів на добу для одного API-ключа.

3. Перевірка пристрою (Check Device)

Основний метод (Endpoint) для отримання інформації про пристрій за його IMEI або серійним номером.

HTTP Метод: POST /check

Параметри тіла запиту (JSON):

Доступні команди (параметр command):

Приклад запиту (cURL):

curl -X POST https://www.mobileunlockstar.com/api/v1/check \
  -H "X-API-Key: ВАШ_УНІКАЛЬНИЙ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "command": "mdm",
    "identifier": "357222096370290"
  }'

Приклад успішної відповіді (200 OK):

Кожна успішна відповідь завжди повертає ваш залишок балансу (credits) та ID запиту для траблшутингу.

{
  "success": true,
  "model": "iPhone 15 Pro Max",
  "serial": "GJK3YFCFW0",
  "mdmStatus": "OFF",
  "credits": 49.50,
  "request_id": "req_mus_a1b2c3d4e5"
}

4. Перевірка балансу та цін (Check Balance)

Метод дозволяє динамічно перевірити ваш поточний баланс, назву вашого тарифного плану та актуальні ціни на всі доступні послуги.

HTTP Метод: GET /balance

curl -H "X-API-Key: ВАШ_УНІКАЛЬНИЙ_КЛЮЧ" \
  https://www.mobileunlockstar.com/api/v1/balance

{
  "success": true,
  "username": "MyProject_Bot",
  "balance": 125.40,
  "plan": "VIP",
  "prices": {
    "findmy": 0.40,
    "lost": 0.35,
    "simlock": 0.50,
    "mdm": 0.60,
    "gsx": 1.20,
    "gsxfast": 1.50,
    "gsxpremium": 2.50,
    "sntoimei": 0.40
  }
}

5. Обробка помилок (Error Handling)

Якщо запит не вдалося виконати, API повертає JSON із полем "success": false та описом проблеми (message). При помилках на стороні постачальника або при таймауті кошти з вашого балансу повертаються автоматично.

Приклад відповіді з помилкою (402):

{
  "success": false,
  "message": "Insufficient funds",
  "required": 1.50,
  "request_id": "req_mus_f6g7h8i9j0"
}