# JSON API

API pro odesílání zpráv přes SMS, Viber, WhatsApp a další komunikační kanály.

## JSON API v2

API klíč je vyžadován pro všechny požadavky. Svůj API klíč naleznete v [nastavení účtu](https://app.smsmanager.com/api-cloud).

Verze API (http-api a xml-api) jsou také zastaralé a měli byste místo nich používat toto JSON API v2.


Version: v2

## Servers

Odpoví s daty vašeho požadavku
```
https://api.smsmngr.com/v2
```

## Security

### x-api-key

Type: apiKey
In: header
Name: x-api-key

### apikey

Type: apiKey
In: query
Name: apikey

## Download OpenAPI description

[JSON API](https://api-ref.smsmanager.com/_bundle/openapi/cs/json/jsonapi_v2.yaml)

## Odesílání

Pro odesílání zpráv použijte jeden z následujících koncových bodů.
- `/message` pro odeslání zprávy až 10 příjemcům
- `/messages` pro odeslání více zpráv (až 10 zpráv najednou, každá až s 10 příjemci)
- `/simple/message` pro odeslání jednoduché zprávy (GET a POST)


### Odeslat zprávu

 - [POST /message](https://api-ref.smsmanager.com/openapi/cs/json/jsonapi_v2/sending/paths/~1message/post.md): Použijte tento koncový bod k odeslání zprávy jednomu nebo více příjemcům (až 10 příjemců). Pokud chcete použít jiné kanály než SMS (Viber, WhatsApp atd.), musíte použít vlastnost flow.

### Odeslat více zpráv

 - [POST /messages](https://api-ref.smsmanager.com/openapi/cs/json/jsonapi_v2/sending/paths/~1messages/post.md): Tento endpoint slouží k hromadnému odeslání identických zpráv více příjemcům (můžete nastavit až 10 příjemců na jeden požadavek a až 10 požadavků na jedno volání API). To znamená, že můžete odeslat až 100 příjemcům v rámci jednoho volání HTTP API. Pokud chcete použít jiné kanály než SMS (Viber, WhatsApp atd.), musíte použít vlastnost flow. Při použití tohoto endpointu obdržíte message_id pro každý z požadavků (nikoli pro každého příjemce). Chcete-li získat message_id pro každého příjemce, musíte k message_id připojit -. Více informací o message_id naleznete v dokumentaci.

### Odeslat jednoduchou zprávu (GET požadavek)

 - [GET /simple/message](https://api-ref.smsmanager.com/openapi/cs/json/jsonapi_v2/sending/paths/~1simple~1message/get.md)

### Odeslat jednoduchou zprávu (POST požadavek)

 - [POST /simple/message](https://api-ref.smsmanager.com/openapi/cs/json/jsonapi_v2/sending/paths/~1simple~1message/post.md)

## Webhooks

### Webhook odeslané zprávy

 - [POST sentMessage](https://api-ref.smsmanager.com/openapi/cs/json/jsonapi_v2/webhooks/paths/sentmessage/post.md): Tento webhook vám zasílá informace o odeslaných zprávách. Tento webhook můžete použít k ukládání informací o odeslaných zprávách, jako jsou message_id, gateway, timestamp, payload atd.

### Webhook příchozí odpovědní zprávy

 - [POST incomingReplyMessage](https://api-ref.smsmanager.com/openapi/cs/json/jsonapi_v2/webhooks/paths/incomingreplymessage/post.md)

### Webhook příchozí zprávy

 - [POST incomingMessage](https://api-ref.smsmanager.com/openapi/cs/json/jsonapi_v2/webhooks/paths/incomingmessage/post.md)