Bouw tegen Run2Mail

Developer API Documentation

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

API-sleutels Authenticatie Kerneindpunten Foutcodes

API-sleutels

Genereer API-sleutels voor ontwikkelaars vanaf uw dashboard. Elke sleutel wordt slechts één keer volledig weergegeven en vervolgens opgeslagen als een veilige hash voor toekomstige verificatie.

Maak sleutels vanaf uw ingelogde dashboard.
Houd sleutels privé en bewaar ze in uw eigen geheime manager.
Trek oude sleutels in wanneer een apparaat, script of teamgenoot geen toegang meer nodig heeft.

Authenticatie

Gebruik voor elk beveiligd verzoek een Bearer-token in de Authorization-header.

Authorization: Bearer YOUR_API_KEY

Als de sleutel ongeldig, ingetrokken of ontbrekend is, reageert de API met een authenticatiefout.

Kerneindpunten

De meest gebruikelijke workflow is: de geverifieerde gebruiker inspecteren, een inbox aanmaken en vervolgens berichten uit die inbox ophalen.

Controleer de lopende rekening

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

Maak een inbox aan

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

Inbox-berichten ophalen

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

Voorbeeld van een JSON-antwoord

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

Tariefbeperking

Run2Mail past op abonnementen gebaseerde verzoeklimieten en dagelijkse limieten voor het aanmaken van inboxen toe om de service te beschermen en de API-toegang stabiel te houden.

Tarieflimieten per minuut zijn afhankelijk van uw actieve abonnement.
De limieten voor het maken van e-mails worden afzonderlijk van de standaard leesoproepen bijgehouden.
Het gebruik wordt geregistreerd voor zichtbaarheid in het beheerdersanalysedashboard.

Foutcodes

401: Ontbrekende of ongeldige API-inloggegevens.
403: Toegang geblokkeerd, beperkt of niet toegestaan voor het verzoek.
429: Het verzoekvolume heeft de huidige limiet overschreden.
503: Developer API tijdelijk uitgeschakeld door het platform.

Dashboard-API-screenshots volgen binnenkort

Dit gebied is gereserveerd voor toekomstige schermafbeeldingen van de API-sleutelbeheerder en het gebruiksdashboard.

Ontwikkelaars-API