Kompiluj w oparciu o Run2Mail

Developer API Documentation

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

Klucze API Uwierzytelnianie Podstawowe punkty końcowe Kody błędów

Klucze API

Wygeneruj klucze API programisty ze swojego pulpitu nawigacyjnego. Każdy klucz jest pokazywany w całości tylko raz, a następnie przechowywany jako bezpieczny skrót do przyszłej weryfikacji.

Twórz klucze z poziomu zalogowanego pulpitu nawigacyjnego.
Trzymaj klucze w tajemnicy i przechowuj je we własnym tajnym menedżerze.
Unieważnij stare klucze, gdy urządzenie, skrypt lub członek zespołu nie potrzebuje już dostępu.

Uwierzytelnianie

Użyj tokenu okaziciela w nagłówku autoryzacji dla każdego chronionego żądania.

Authorization: Bearer YOUR_API_KEY

Jeśli klucz jest nieprawidłowy, unieważniony lub go brakuje, interfejs API odpowiada błędem uwierzytelnienia.

Podstawowe punkty końcowe

Najpopularniejszy sposób działania to: sprawdzenie uwierzytelnionego użytkownika, utworzenie skrzynki odbiorczej, a następnie pobranie wiadomości z tej skrzynki odbiorczej.

Sprawdź aktualny rachunek

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

Utwórz skrzynkę odbiorczą

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"
  }'

Pobierz wiadomości ze skrzynki odbiorczej

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

Przykładowa odpowiedź JSON

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

Ograniczanie szybkości

Run2Mail stosuje limity żądań oparte na planie i dzienne limity tworzenia skrzynek odbiorczych, aby chronić usługę i zapewnić stabilny dostęp do API.

Limity stawek za minutę zależą od Twojego aktywnego planu.
Limity tworzenia wiadomości e-mail są śledzone oddzielnie od podstawowych połączeń dotyczących odczytu.
Użycie jest rejestrowane w celu zapewnienia widoczności w panelu administracyjnym analitycznym.

Kody błędów

401: Brakujące lub nieprawidłowe dane uwierzytelniające interfejsu API.
403: Dostęp zablokowany, ograniczony lub niedozwolony dla żądania.
429: Liczba żądań przekroczyła bieżący limit.
503: Interfejs API programisty tymczasowo wyłączony przez platformę.

Zrzuty ekranu interfejsu API panelu sterowania będą dostępne wkrótce

Ten obszar jest zarezerwowany dla przyszłych zrzutów ekranu menedżera kluczy API i pulpitu nawigacyjnego użytkowania.

API Programisty