Збірка проти Run2Mail

Developer API Documentation

Learn how to create API keys, authenticate requests, create inboxes, fetch messages, and handle common Run2Mail API responses.

Ключі API Аутентифікація Основні кінцеві точки Коди помилок

Ключі API

Створюйте ключі API розробника зі своєї інформаційної панелі. Кожен ключ відображається повністю лише один раз, а потім зберігається як безпечний хеш для майбутньої перевірки.

Створюйте ключі з інформаційної панелі, увійшовши в систему.
Тримайте ключі в таємниці та зберігайте їх у власному секретному менеджері.
Відкликайте старі ключі щоразу, коли пристрій, сценарій або товариш по команді більше не потребують доступу.

Аутентифікація

Використовуйте маркер носія в заголовку авторизації для кожного захищеного запиту.

Authorization: Bearer YOUR_API_KEY

Якщо ключ недійсний, відкликаний або відсутній, API відповідає помилкою автентифікації.

Основні кінцеві точки

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

Перевірте поточний рахунок

curl -X GET "https://run2mail.com/api/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Створіть папку "Вхідні".

curl -X POST "https://run2mail.com/api/v1/emails/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "random"
  }'

Отримати повідомлення вхідних повідомлень

curl -X GET "https://run2mail.com/api/v1/emails/example@2mail.lol/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Зразок відповіді JSON

{
  "success": true,
  "data": {
    "email": "example@2mail.lol",
    "messages": []
  }
}

Обмеження швидкості

Run2Mail застосовує ліміти на запити на основі плану та щоденні ліміти на створення вхідних повідомлень, щоб захистити службу та забезпечити стабільний доступ до API.

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

Коди помилок

401: Відсутні або недійсні облікові дані API.
403: Доступ заблоковано, обмежено або заборонено для запиту.
429: Обсяг запитів перевищив поточний ліміт.
503: API розробника тимчасово вимкнено платформою.

Скріншоти API інформаційної панелі незабаром

Ця область зарезервована для майбутніх скріншотів менеджера ключів API та інформаційної панелі використання.