Zahtjevi za alfa imena
API rute za stvaranje i popis Alpha naziva (potvrđeni nazivi tvrtki koji se koriste kao pošiljatelji poruka).
1. Stvorite alfa naziv organizacije
Ovaj POST zahtjev koristi se za stvaranje 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} (Stvoreno u odjeljku Korisničkog profila).
Tijelo:
Parametri tijela:
1. ime (niz): predloženo alfa ime.
- Zahtjev: Duljina bi trebala biti manja od 12 znakova.
2. companyCode (niz): Registracijski kod tvrtke povezan s alfanimom (ERPOU/IPN za Ukrajinu).
Mogući odgovori:
- 200 OK: Alfa naziv je uspješno poslan na moderiranje/kreiranje.
- 400 Loš zahtjev: Pogreška provjere (npr. ime je predugačko).
- 401 Neovlašteno: Nevažeći ili nedostaje X-Authorization-Key.
2. Dohvati popis AlphaName
Dohvaća ažuran popis alfa naziva, uključujući njihove trenutne statuse moderiranja.
Zahtjev
- URL: https://restapi.smsbat.com/organizations/alpha_name/list
- Metoda: GET
- Zaglavlja:
- X-Authorization-Key: {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 naziva (statusCode):
- PA - Čeka se odobrenje
- A - Odobreno
- D - Odbijeno