Créer un Sender
Cette méthode permet d'envoyer une nouvelle demande à l'expéditeur.
Certains pays exigent que vous vous enregistriez en tant qu'expéditeur avant de pouvoir envoyer un SMS avec un expéditeur personnalisé. Voici la liste des pays concernés :
Chaque demande d'enregistrement est traitée par notre service client.
POST
/sender
Paramètres du body
sender
requis
|
Votre sender |
country_code
requis
|
Pays où vous utiliserez ce sender (ISO 3166-1 alpha-2) |
company_name
requis
|
Votre entreprise |
general_contact
requis
|
Votre adresse email |
phone_number
requis
|
Votre numéro de téléphone |
vat | Votre numéro de TVA |
fiscal_code | Votre code fiscal |
complete_address | L'adresse de votre entreprise |
escalation_contact | Votre adresse PEC |
website | Votre site internet |
type_of_service | Votre activité professionnelle |
type_of_sms | Dans certains pays, le contenu du SMS est demandé |
Exemples
POST /sender HTTP/1.1
Host: api.smsup.ch
Authorization: Bearer your.token
Accept: application/json
{
"sender": {
"sender": "MySender",
"country_code": "FR",
"company_name": "My company",
"vat": "FR123456789",
"fiscal_code": "FR123456789",
"complete_address": "1 rue de la paix",
"escalation_contact": "email@domain.com",
"general_contact": "email@domain.com",
"website": "www.domain.com",
"type_of_service": "services",
"phone_number": "41781234567",
"message_type": "My SMS content"
}
}
Format de la réponse
{
"status": 1,
"message": "OK",
"sender": {
"id": 7,
"sender": "MySender",
"country_code": "FR",
"status": "0", //Status of the sender request
"company_name": "My company",
"vat_number": "FR123456789",
"fiscal_code": "FR123456789",
"full_address": "1 rue de la paix",
"escalation_contact": "email@domain.com",
"general_contact": "email@domain.com",
"website": "www.domain.com",
"type_of_service": "services",
"phone_number": "41781234567",
"created_at": "2024-11-21 10:27:57",
"message_type": "My SMS content"
}
}
<response>
<status>1</status>
<message>OK</message>
<sender>
<id>7</id>
<sender>MySender</sender>
<country_code>FR</country_code>
<status>0</status>
<company_name>My company</company_name>
<vat_number>FR123456789</vat_number>
<fiscal_code>FR123456789</fiscal_code>
<full_address>1 rue de la paix</full_address>
<escalation_contact>email@domain.com</escalation_contact>
<general_contact>email@domain.com</general_contact>
<website>www.domain.com</website>
<type_of_service>services</type_of_service>
<phone_number>41781234567</phone_number>
<created_at>2024-11-21 10:27:57</created_at>
<message_type>My SMS content</message_type>
</sender>
</response>
Statuts
Code | Value |
---|---|
-1 | Demande rejetée |
0 | Demande en cours |
1 | Demande envoyé aux opérateurs |
2 | Demande validée |
3 | Demande annulée |