Docs·Schnellstart
🚀

Schnellstart

Deine erste SMS-Verifizierung in unter 90 Sekunden — anmelden, API-Schlüssel erstellen, Code abholen.

Einleitung

Eveses stellt Telefonnummern auf Abruf für SMS-Verifizierungen bereit. Du buchst eine Nummer, holst dir den einmaligen Code ab und zahlst nur, wenn die SMS tatsächlich ankommt.

Diese Seite führt dich in drei Schritten durch deine erste End-to-End-Anfrage.

1. API-Schlüssel anlegen

Melde dich an und öffne Account → API Keys. Klicke auf New key, vergib einen Namen (z. B. local-dev) und kopiere den Wert aus dem Dialog. Das Token wird nur einmal angezeigt — lege es sofort in deinem Passwortmanager oder einer .env-Datei ab.

export EVESES_API_KEY="17|aBcDeFgHiJ…"

2. Nummer bestellen

Wähle ein Land (ISO-2) und einen Dienst-Slug (telegram, whatsapp, discord, any, …) und sende einen POST an /v1/activations:

curl -X POST https://api.eveses.com/v1/activations \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "ua", "service": "telegram", "duration_minutes": 5}'

Die Antwort enthält die Nummer und eine Aktivierungs-id, über die du den Code abholst:

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"waiting","price_cents":50,"expires_at":"2026-05-26T14:35:00Z"}

3. SMS-Code lesen

Gib die Nummer im Verifizierungsformular des Drittanbieters ein und frage die Aktivierung ab, bis die SMS eintrifft:

curl https://api.eveses.com/v1/activations/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e \
  -H "Authorization: Bearer $EVESES_API_KEY"

Sobald die SMS ankommt, enthält die Antwort ein sms-Array mit dem OTP. Die meisten Anbieter liefern innerhalb von 30 Sekunden. Kommt bis zum Ablauf der Aktivierung nichts an, wird nichts berechnet.

{"id":"9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e","phone":"+380635551822","status":"sms_received","price_cents":50,"expires_at":"2026-05-26T14:35:00Z","sms":[{"code":"123456","text":"Your code: 123456","received_at":"2026-05-26T14:30:14Z"}]}

Nächste Schritte

  • Polling vermeiden, Webhooks nutzen — abonniere activation.sms_received und wir senden dir den OTP. Siehe Abschnitt Webhooks.
  • SDK verwenden — offizielle Bibliotheken für PHP, JavaScript, Python und Go sind unter SDKs dokumentiert.
  • Idempotenz lesen — verpacke den Create-Aufruf in einen Idempotency-Key, damit Retries nicht doppelt abrechnen.
Nächstes →Aktivierungen