## API URL

Adresa URL, ktorá sa používa na odosielanie HTTP požiadaviek:

```url
https://portal.bulkgate.com/api/1.0/simple/info
```

> [!NOTE]
> Ak sa požiadavka nedostane k cieľu, zopakujte ju na [záložnom serveri](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/zalozny-server/) `backup1.bulkgate.com`.

## Podporované HTTP metódy

- `GET`
- `POST` - `application/x-www-form-urlencoded`
- `POST` - `application/json`

Príklady pre každú z nich nájdete v [metódach požiadavky](https://www.bulkgate.com/sk/dokumentacia/simple-api/simple-poziadavky/).

## Tabuľka s parametrami

| NÁZOV PARAMETRA   | HODNOTA                                                | POVINNÝ | PREDVOLENÁ HODNOTA |
|:------------------|:-------------------------------------------------------|:--------|:-------------------|
| application_id    | [Identifikátor aplikácie](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/administracia-api/) | **Áno** | -                  |
| application_token | [Overovací token aplikácie](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/api-tokeny/)       | **Áno** | -                  |
| wallet            | Identifikátor peňaženky, ktorej zostatok chcete zistiť. Bez neho sa vráti predvolená peňaženka účtu. | Nie | - |

## Príklad požiadavky

```http-json
POST /api/1.0/simple/info HTTP/1.1
Host: portal.bulkgate.com
Content-Type: application/json

{
    "application_id": 451, 
    "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj"
}
```

## Odpoveď

**V prípade úspechu:**

```json
{
    "data": {
        "wallet": "bg1805151838000001",
        "credit": 215.8138,
        "currency": "credits",
        "free_messages": 51,
        "datetime": "2018-06-13T09:57:21+02:00"
    }
}
```

**V prípade chyby:**

```json
{
  "type": "unknown_identity",
  "code": 401,
  "error": "Unknown identity / unauthorized / empty application_id",
  "detail": null
}
```

Kde:

- **type** a **error** (popis chyby) nájdete v [tabuľke typov chýb](https://www.bulkgate.com/sk/dokumentacia/api-administracia-a-tokeny/typy-chyb-api/)
- **code** je HTTP kód chyby
- **detail** obsahuje doplňujúcu informáciu k chybe