Мої номери

Адреса POST-запитів

https://telcowiki.info/get_number

Заголовки

Content-Type: application/json

Параметри запиту

Параметри передаються у форматі JSON у тілі запиту.

Параметр	Тип	Обов'язковий	Опис
key/Key	string	Так	"Для отримання API-ключа зверніться до тімліда"
Operator	string	Так	Назва оператора або список операторів через кому. Може бути значення "all" для вибору всіх операторів.
Service	string	Ні	Назва сервісу, для якого потрібні номери.
Quantity	integer / string	Ні	Кількість номерів. Якщо не вказано, за замовчуванням 1 для одного оператора або "all" для кількох операторів. Може бути числом або "all".

Опис параметрів

• key/Key: Ваш унікальний API-ключ, пов'язаний з вашим обліковим записом.
• Operator: Назва оператора або список операторів через кому (наприклад, "Banglalink_add" або "Azerfon_GH_ext, Bakcell_add"). Використовуйте "all", щоб вибрати всі оператори.
• Service: Назва сервісу, для якого потрібні номери (наприклад, "Binance"). Якщо не вказано, будуть використані номери незалежно від сервісу.
• Quantity: Кількість номерів для отримання. Якщо не вказано:
  • Для одного оператора за замовчуванням 1.
  • Якщо вказано більше одного оператора або "all", за замовчуванням "all".
  Значення може бути числом або "all". Якщо вказано більше одного оператора або "all", то Quantity має бути "all".

Приклади запитів

Запит 1: Отримати 1 номер оператора "Banglalink_add" для сервісу "Binance"

{
    "key": "Ваш_API_ключ",
    "Operator": "Banglalink_add",
    "Service": "Binance",
    "Quantity": 1
}

Запит 2: Отримати всі номери для операторів "Azerfon_GH_ext", "Bakcell_add", "Globe_add"

{
    "key": "Ваш_API_ключ",
    "Operator": "Azerfon_GH_ext, Bakcell_add, Globe_add",
    "Quantity": "all"
}

Запит 3: Отримати всі номери для всіх операторів

{
    "key": "Ваш_API_ключ",
    "Operator": "all",
    "Quantity": "all"
}

Запит 4: Отримати 1 номер для оператора "Banglalink_add" без вказання сервісу

{
    "key": "Ваш_API_ключ",
    "Operator": "Banglalink_add"
} 

Відповідь сервера

Успішна відповідь: список номерів, розділених комами.

8801911304121,8801911304122,8801911304123

Коди помилок

• 400 Bad Request – Невірний запит (наприклад, неправильні назви операторів або сервісів).
• 403 Forbidden – Відсутній або некоректний API-ключ.
• 404 Not Found – Немає доступних номерів.
• 429 Too Many Requests – Перевищено ліміт запитів (максимум 100 запитів на секунду).

Примітки

• Оновлення дати використання:
  • Якщо Quantity вказано числом, то для виданих номерів оновлюється дата останнього використання як для загального випадку, так і для вказаного сервісу (якщо він вказаний).
  • Якщо Quantity дорівнює "all", то дати останнього використання не оновлюються.
• Доступ до номерів:
  • Користувач має доступ лише до номерів, закріплених за його обліковим записом.
  • Всі операції з номерами виконуються в межах номерів, прив'язаних до API-ключа користувача.
• Чутливість до регістру:
  • Параметр key може бути вказаний як key або Key.
  • Значення параметрів Operator та Quantity не чутливі до регістру, коли перевіряються на значення "all".

Обмеження

• Ліміт запитів: Максимум 100 запитів на секунду для одного API-ключа.

Важливі зауваження

• Якщо вказано більше одного оператора або "all", то параметр Quantity може бути тільки "all".
• Якщо сервіс не вказано, сервер повертає номери не прив'язуючись до використання під конкретний сервіс.
• Номери, які використовувалися сьогодні для вказаного сервісу, не будуть повторно видані в той же день для того ж сервіса, але можуть бути видані вже для іншого сервіса.
• Допускаються тільки стандартизовані назви операторів і сервісів, у відповідності до того, як вони записані в нашій базі даних.