Remove member
curl --request DELETE \
--url https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}"
headers = {"Authorization": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: '<api-key>'}};
fetch('https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}', 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://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"error": {}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"retry_after_seconds": 123
}
}{
"error": {}
}{
"error": {}
}{
"error": {}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"retry_after_seconds": 123
}
}Membres et numéros
Retirer un membre
Removes a member from one of your accounts. Allo revokes the member’s eSIMs first, so their phone stops ringing right away, then removes the member from the account’s workspace. The member’s numbers stay on the account, with their history. The seat stays paid until the end of the current billing period, and from the next invoice the account’s subscription bills the kept numbers as extra numbers, with no proration. Requires the PARTNER scope.
DELETE
/
v2
/
api
/
partner
/
accounts
/
{id}
/
members
/
{member_id}
Remove member
curl --request DELETE \
--url https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id} \
--header 'Authorization: <api-key>'import requests
url = "https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}"
headers = {"Authorization": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: '<api-key>'}};
fetch('https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}', 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://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.withallo.com/v2/api/partner/accounts/{id}/members/{member_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"error": {}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"retry_after_seconds": 123
}
}{
"error": {}
}{
"error": {}
}{
"error": {}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"retryable": true,
"request_id": "<string>",
"retry_after_seconds": 123
}
}Scope requis :
PARTNER204, sans corps.
Ce que fait Allo
1
Révoque les eSIM du membre
Allo révoque toutes les eSIM du membre, et toutes les eSIM de ses numéros (y compris une eSIM commandée sans
holder_id), avant toute autre étape, pour que son téléphone cesse de sonner immédiatement, même si une étape suivante échoue. Le palier de données de chaque eSIM s’arrête tout de suite.2
Retire le membre du workspace
Le membre perd l’accès au workspace du compte. Ses numéros passent au compte lui-même, avec leur historique d’appels et de messages, et sonnent sur les apps Allo.
3
Remplace le siège par des numéros supplémentaires
Le siège du membre reste payé jusqu’à la fin de la période de facturation en cours. À partir de la facture suivante, l’abonnement du compte facture les numéros conservés comme numéros supplémentaires à la place du siège, sans prorata. Allo n’ajoute que les numéros supplémentaires que le compte ne paie pas déjà.
Comment donner le numéro à un nouveau collaborateur
Appelez Ajouter un membre avec le numéro conservé commephone_number. Le nouveau membre le reprend avec son historique. Voir Comment remplacer un collaborateur qui part pour le parcours complet, nouvelle eSIM comprise.
Erreurs
| Code | Signification |
|---|---|
PARTNER_ACCOUNT_OWNER_NOT_REMOVABLE | member_id est le compte lui-même, qui n’est pas un membre (400). Pour mettre fin au compte, utilisez Désactiver un compte. |
PARTNER_ACCOUNT_MEMBER_NOT_FOUND | Aucun membre avec cet id dans le workspace du compte (404). Listez-les avec Lister les membres. |
PARTNER_ACCOUNT_NOT_FOUND | Votre API key n’a pas créé ce compte, ou le compte est désactivé (404). |
PARTNER_ESIM_MOVE_IN_PROGRESS | L’une des eSIM du membre est en cours de bascule entre le réseau et l’eSIM (409). Toujours retryable: true : réessayez dans quelques minutes. Rien n’a été modifié. |
PARTNER_ESIM_MOVE_FAILED | La bascule de l’une des eSIM du membre entre le réseau et l’eSIM a échoué (409). Contactez le support Allo. Rien n’a été modifié. |
PARTNER_ACCOUNT_BUSY | Un autre membre ou numéro est en cours de modification sur ce compte (409). Toujours retryable: true : réessayez dans quelques secondes. |
Cette page vous a-t-elle été utile ?