Acheter un numéro de téléphone

curl --request POST \
  --url https://app.famulor.de/api/user/phone-numbers/purchase \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "<string>"
}
'

import requests

url = "https://app.famulor.de/api/user/phone-numbers/purchase"

payload = { "phone_number": "<string>" }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'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));

<?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 => [
    "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("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.famulor.de/api/user/phone-numbers/purchase")
  .header("Content-Type", "application/json")
  .body("{\n  \"phone_number\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.famulor.de/api/user/phone-numbers/purchase")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phone_number\": \"<string>\"\n}"

response = http.request(request)
puts response.read_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."
}

POST

api

user

phone-numbers

purchase

Acheter un numéro de téléphone

curl --request POST \
  --url https://app.famulor.de/api/user/phone-numbers/purchase \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "<string>"
}
'

import requests

url = "https://app.famulor.de/api/user/phone-numbers/purchase"

payload = { "phone_number": "<string>" }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'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));

<?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 => [
    "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("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.famulor.de/api/user/phone-numbers/purchase")
  .header("Content-Type", "application/json")
  .body("{\n  \"phone_number\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.famulor.de/api/user/phone-numbers/purchase")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phone_number\": \"<string>\"\n}"

response = http.request(request)
puts response.read_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."
}

API Famulor 1.0 (héritée). Cette page concerne uniquement Famulor 1.0 (app.famulor.de) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la référence API Famulor 2.0.

Ce point de terminaison vous permet d’acheter un numéro de téléphone trouvé via le point de terminaison de recherche. La plateforme gère automatiquement la tarification, la facturation et le provisionnement.

Vous devez disposer d’un moyen de paiement valide enregistré avant de pouvoir acheter un numéro de téléphone. L’achat crée un abonnement mensuel à renouvellement automatique.

Corps de la requête

string

requis

Le numéro de téléphone à acheter au format E.164 (par ex. +14155551234). Doit être un numéro renvoyé par le point de terminaison de recherche.

Champs de réponse

string

Message de succès

object

Les détails du numéro de téléphone acheté

Afficher Propriétés des données

integer

L’identifiant unique du numéro de téléphone

string

Le numéro de téléphone au format E.164

string

Le code pays ISO

string

Le type de numéro de téléphone (toujours normal pour les numéros achetés)

boolean

Indique si le numéro prend en charge les SMS

Fonctionnement

Recherche - Utilisez d’abord le point de terminaison de recherche pour trouver des numéros disponibles
Achat - Envoyez le numéro de téléphone souhaité à ce point de terminaison
Traitement automatique - La plateforme :
- Vérifie que le numéro est toujours disponible
- Détermine le prix correct en fonction du pays
- Crée un abonnement mensuel sur votre moyen de paiement
- Provisionne le numéro auprès de notre fournisseur de téléphonie
- Crée l’enregistrement du numéro de téléphone dans votre compte

Les achats de numéros de téléphone ne sont pas remboursables. L’abonnement se poursuit jusqu’à ce que vous libériez le numéro.

{
  "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."
}

Référence API

Assistants IA

Dossiers

Étiquettes

Prospects

Campagnes

Automatisations

Actions en cours d’appel

Chatbot IA

Réponses IA

Bases de connaissances

SMS

WhatsApp

Numéros de téléphone

Trunks SIP

Appels

Webhooks

Acheter un numéro de téléphone

Corps de la requête

Champs de réponse

Fonctionnement

​Corps de la requête

​Champs de réponse

​Fonctionnement

Corps de la requête

Champs de réponse

Fonctionnement