Preskočiť na obsah

Ž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:

{
  "name": "testName",
  "companyCode": "88888888"
}

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é