Docs·Aktivierungen
⚡

Aktivierungen

Einzel-SMS-Verifizierungen — Lebenszyklus eines Einmal-Codes von der Anfrage bis zur Abrechnung.

Was ist eine Aktivierung?

Eine Aktivierung ist die kurzfristige Anmietung einer Nummer für eine SMS-OTP. Du fragst sie an, die Plattform reserviert eine Nummer, du liest den Code aus der eingehenden SMS, und die Aktivierung schließt — entweder erfolgreich (abgerechnet) oder als expired (kostenlos).

Nutze Aktivierungen, wenn du nur einen einzigen Code brauchst (Anmeldung, Passwort-Reset, KYC). Für mehrere SMS in einem längeren Zeitfenster siehe Rentals.

Lebenszyklus

waiting ─► sms_received ─► finished       (du bestätigst; abgerechnet)
   │                  └──► refunded       (kein Code; kostenlos)
   └─► expired                            (Timeout; kostenlos)
  • waiting — Nummer reserviert, noch keine SMS.
  • sms_received — mindestens eine eingehende SMS erfasst.
  • finished — du hast finish aufgerufen; abgerechnet.
  • expired — Frist abgelaufen ohne SMS; nicht abgerechnet.
  • refunded — du hast vor der Bestätigung storniert; nicht abgerechnet.

Erstellen

curl -X POST https://api.eveses.com/v1/activations \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "country": "ua",
    "service": "telegram",
    "duration_minutes": 15,
    "max_price_cents": 12
  }'
Feld Pflicht Hinweise
country ja ISO-2-Ländercode
service ja Slug aus dem Service-Katalog oder any
duration_minutes nein 5 bis 60. Default 20
max_price_cents nein Erweitert den Failover-Provider-Pool bis zu diesem Cap

Polling

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

Polling alle 1,5–2 Sekunden ist okay; Sub-Sekunden-Polling wird limitiert. In Produktion sind Webhooks dringend empfohlen.

Finish

Bestätigt die Aktivierung und löst die Abrechnung aus. Idempotent — doppelter Aufruf ist sicher.

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

Cancel

Storniert vor SMS-Eingang. Gibt 409 zurück, wenn bereits eine SMS angekommen ist (dann finish aufrufen).

curl -X POST https://api.eveses.com/v1/activations/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e/cancel \
  -H "Authorization: Bearer $EVESES_API_KEY"
← VorherigesSchnellstartNächstes →Authentication