Zum Hauptinhalt springen
POST
/
api
/
user
/
phone-numbers
/
purchase
Telefonnummer kaufen
curl --request POST \
  --url https://app.famulor.de/api/user/phone-numbers/purchase \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "<string>"
}
'
{
  "message": "Phone number purchased successfully.",
  "data": {
    "id": 123,
    "phone_number": "+14155551234",
    "country_code": "US",
    "type": "normal",
    "sms_capable": true
  }
}
Dieser Endpunkt ermöglicht es Ihnen, eine Telefonnummer zu kaufen, die über den Such-Endpunkt gefunden wurde. Die Plattform übernimmt automatisch Preisgestaltung, Abrechnung und Bereitstellung.
Sie müssen eine gültige Zahlungsmethode hinterlegt haben, bevor Sie eine Telefonnummer kaufen können. Der Kauf erstellt ein monatliches Abonnement, das automatisch verlängert wird.

​
Request Body

​
phone_number
string
erforderlich
Die zu kaufende Telefonnummer im E.164-Format (z.B. +14155551234). Muss eine Nummer sein, die vom Such-Endpunkt zurückgegeben wurde.

​
Antwort-Felder

​
message
string
Erfolgsmeldung
​
data
object
Die Details der gekauften Telefonnummer

​
Funktionsweise

  1. Suchen - Verwenden Sie zuerst den Such-Endpunkt, um verfügbare Nummern zu finden
  2. Kaufen - Übermitteln Sie die gewünschte Telefonnummer an diesen Endpunkt
  3. Automatische Verarbeitung - Die Plattform:
    • Validiert, dass die Nummer noch verfügbar ist
    • Bestimmt den korrekten Preis basierend auf dem Land
    • Erstellt ein monatliches Abonnement auf Ihrer Zahlungsmethode
    • Stellt die Nummer bei unserem Telefonieanbieter bereit
    • Erstellt den Telefonnummern-Datensatz in Ihrem Konto
Telefonnummern-Käufe sind nicht erstattungsfähig. Das Abonnement wird fortgesetzt, bis Sie die Nummer freigeben.
{
  "message": "Phone number purchased successfully.",
  "data": {
    "id": 123,
    "phone_number": "+14155551234",
    "country_code": "US",
    "type": "normal",
    "sms_capable": true
  }
}