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>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({phone_number: '<string>'})
};
fetch('https://app.famulor.de/api/user/phone-numbers/purchase', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.famulor.de/api/user/phone-numbers/purchase"
payload = { "phone_number": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.de/api/user/phone-numbers/purchase",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone_number' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.de/api/user/phone-numbers/purchase"
payload := strings.NewReader("{\n \"phone_number\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"message": "Phone number purchased successfully.",
"data": {
"id": 123,
"phone_number": "+14155551234",
"country_code": "US",
"type": "normal",
"sms_capable": true
}
}
{
"error": "This phone number is already in use."
}
{
"error": "This phone number is not available for purchase. Please search for available numbers first."
}
{
"error": "No payment method found. Please add a payment method to your account."
}
{
"error": "Payment failed. Please update your payment method."
}
{
"error": "Unable to parse phone number. Please provide a valid E.164 format number."
}
{
"error": "Failed to purchase phone number from provider. Please contact support."
}
Telefonnummer kaufen
Kaufe eine dedizierte Telefonnummer in Famulor per API. Lokale, mobile oder gebührenfreie Rufnummern für Inbound- oder Outbound-KI-Telefonate.
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>"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({phone_number: '<string>'})
};
fetch('https://app.famulor.de/api/user/phone-numbers/purchase', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.famulor.de/api/user/phone-numbers/purchase"
payload = { "phone_number": "<string>" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.famulor.de/api/user/phone-numbers/purchase",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'phone_number' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.famulor.de/api/user/phone-numbers/purchase"
payload := strings.NewReader("{\n \"phone_number\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"message": "Phone number purchased successfully.",
"data": {
"id": 123,
"phone_number": "+14155551234",
"country_code": "US",
"type": "normal",
"sms_capable": true
}
}
{
"error": "This phone number is already in use."
}
{
"error": "This phone number is not available for purchase. Please search for available numbers first."
}
{
"error": "No payment method found. Please add a payment method to your account."
}
{
"error": "Payment failed. Please update your payment method."
}
{
"error": "Unable to parse phone number. Please provide a valid E.164 format number."
}
{
"error": "Failed to purchase phone number from provider. Please contact support."
}
Dieser Endpunkt ermöglicht es dir, eine Telefonnummer zu kaufen, die über den Such-Endpunkt gefunden wurde. Die Plattform übernimmt automatisch Preisgestaltung, Abrechnung und Bereitstellung.
Du musst eine gültige Zahlungsmethode hinterlegt haben, bevor du eine Telefonnummer kaufen kannst. Der Kauf erstellt ein monatliches Abonnement, das automatisch verlängert wird.
Request Body
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
string
Erfolgsmeldung
object
Funktionsweise
- Suchen - Verwende zuerst den Such-Endpunkt, um verfügbare Nummern zu finden
- Kaufen - Übermittle die gewünschte Telefonnummer an diesen Endpunkt
- 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 deiner Zahlungsmethode
- Stellt die Nummer bei unserem Telefonieanbieter bereit
- Erstellt den Telefonnummern-Datensatz in deinem Konto
Telefonnummern-Käufe sind nicht erstattungsfähig. Das Abonnement wird fortgesetzt, bis du die Nummer freigibst.
{
"message": "Phone number purchased successfully.",
"data": {
"id": 123,
"phone_number": "+14155551234",
"country_code": "US",
"type": "normal",
"sms_capable": true
}
}
{
"error": "This phone number is already in use."
}
{
"error": "This phone number is not available for purchase. Please search for available numbers first."
}
{
"error": "No payment method found. Please add a payment method to your account."
}
{
"error": "Payment failed. Please update your payment method."
}
{
"error": "Unable to parse phone number. Please provide a valid E.164 format number."
}
{
"error": "Failed to purchase phone number from provider. Please contact support."
}
⌘I