Žiadosti o mená alfa
API trasy na vytváranie a zoznam názvov Alpha (overené obchodné názvy používané ako odosielateľ správ).
1. Vytvorte alfa názov organizácie
Táto požiadavka POST sa používa na vytvorenie nového názvu alfa priradeného k organizácii. Požiadavka vyžaduje autorizačný kľúč organizácie v hlavičkách.
Žiadosť
- URL: https://restapi.smsbat.com/organizations/alpha_name
- Spôsob: POST
- Hlavičky:
- "Prijať: application/json".
- X-Authorization-Key: {organization_token} (Vytvorené v sekcii Profil používateľa).
Telo:
Parametre tela: 1. „name“ (reťazec): Navrhovaný názov alfa. - Požiadavka: Dĺžka by mala byť menšia ako 12 znakov. 2. "CompanyCode" (reťazec): Registračný kód spoločnosti spojený s Alphaname (ERPOU/IPN pre Ukrajinu).
Možné odpovede: - 200 OK: Alfa meno bolo úspešne odoslané na moderovanie/vytvorenie. - 400 zlá požiadavka: Chyba overenia (napr. názov je príliš dlhý). - 401 Unauthorized: Neplatný alebo chýbajúci kľúč X-Authorization-Key.
2. Získajte zoznam názvov alfa
Načíta aktuálny zoznam mien alfa vrátane ich aktuálnych stavov moderovania.
Žiadosť
- URL: https://restapi.smsbat.com/organizations/alpha_name/list
- Spôsob: GET
- Hlavičky:
- X-Authorization-Key: {organization_token}
Odpoveď (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"
}
]
Stavy názvu alfa (statusCode):
- "PA" - Čaká na schválenie
- "A" - Schválené
- "D" - Odmietnuté