Zahtjevi za alfa imena
API rute za kreiranje i listanje alfa imena (provjerena imena preduzeća koja se koriste kao pošiljalac poruke).
1. Kreirajte alfa naziv organizacije
Ovaj POST zahtjev se koristi za kreiranje novog alfa imena povezanog s organizacijom. Zahtjev zahtijeva ključ autorizacije organizacije u zaglavljima.
Zahtjev
- URL: https://restapi.smsbat.com/organizations/alpha_name
- Metoda: POST
- Zaglavlja:
- Prihvati: aplikacija/json
- X-Authorization-Key: {organization_token} (Kreirano u odjeljku Profil korisnika).
Tijelo:
Parametri tijela:
1. name (String): predloženo alfa ime.
- Uslov: Dužina treba da bude manja od 12 karaktera.
2. companyCode (String): Registracijski kod kompanije povezan sa alfaimom (ERPOU/IPN za Ukrajinu).
Mogući odgovori:
- 200 OK: Alfa ime je uspješno poslano na moderiranje/kreaciju.
- 400 Loš zahtjev: Greška u validaciji (npr. ime je predugačko).
- 401 Neovlašteno: Nevažeći ili nedostaje X-Authorization-Key.
2. Dohvati AlphaName Listu
Dohvaća ažurnu listu alfa imena, uključujući njihove trenutne statuse moderiranja.
Zahtjev
- URL: https://restapi.smsbat.com/organizations/alpha_name/list
- Metoda: GET
- Zaglavlja:
- X-Ključ autorizacije: {organization_token}
Odgovor (200 OK):
[
{
"name": "test1",
"status": "Pending Approval",
"statusCode": "PA",
"statusUpdateDate": "2024-07-24T16:34:40.137432Z"
},
{
"name": "test2",
"status": "Approved",
"statusCode": "A",
"statusUpdateDate": "2024-07-24T15:46:50.494443Z"
}
]
Statusi alfa imena (statusCode):
- PA - Čeka odobrenje
- A - Odobreno
- D - Odbio