# Select requests explicitly. This file never executes itself.
# Set SENDEN_API_KEY in your HTTP client's private environment; do not commit it.
@baseUrl = https://api-senden.ru/api/v1
@instanceId = REPLACE_WITH_INSTANCE_ID
@chatId = REPLACE_WITH_ID_FROM_GET_CHATS
@fileId = REPLACE_WITH_UPLOADED_FILE_ID
@idempotencyKey = REPLACE_WITH_ONE_STABLE_KEY_8_TO_128_CHARACTERS

### Read: primary discovery, all HTTP commands + safe instances + permissions
GET {{baseUrl}}/integrations/manifest
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}

### Read: discover instances; filter state=connected in your program
GET {{baseUrl}}/instances
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}

### Read: supported native operations (subset of the full manifest commands)
GET {{baseUrl}}/methods
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}

### Read: obtain the real destination ID
GET {{baseUrl}}/instances/{{instanceId}}/chats
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}

### Read: saved history (no messenger access required)
GET {{baseUrl}}/instances/{{instanceId}}/messages?limit=50
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}

### Read: native history; requires connected and transport support
POST {{baseUrl}}/instances/{{instanceId}}/operations/messages.history
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}
Content-Type: application/json

{"chatId":"{{chatId}}","count":20}

### EXPLICIT WRITE ONLY: queue one text;202 is not delivery
POST {{baseUrl}}/instances/{{instanceId}}/messages
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}
Idempotency-Key: {{idempotencyKey}}
Content-Type: application/json

{"to":"{{chatId}}","text":"Сообщение из вашей интеграции"}

### EXPLICIT WRITE ONLY: upload a chosen local file (<=20 MiB), does not send it
POST {{baseUrl}}/files
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}
Content-Type: application/octet-stream
X-Filename: document.pdf
X-File-Mime: application/pdf

< ./REPLACE_WITH_LOCAL_DOCUMENT.pdf

### Read: local uploaded copy, not the remote messenger attachment
GET {{baseUrl}}/files/{{fileId}}
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}

### EXPLICIT WRITE ONLY: one uploaded file, use its own stable logical-send key
POST {{baseUrl}}/instances/{{instanceId}}/messages
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}
Idempotency-Key: {{idempotencyKey}}
Content-Type: application/json

{"to":"{{chatId}}","fileId":"{{fileId}}","text":"Документ"}

### Read: inspect status before any decision to repeat; unknown must not be replayed
GET {{baseUrl}}/instances/{{instanceId}}/queue
Authorization: Bearer {{$processEnv SENDEN_API_KEY}}