====== API pro práci s linkami ======

Součást [[:api|Odorik.cz API]] určená pro práci s linkami.

=== GET /lines ===

  * vrací seznam linek přiřazených k uživatelskému účtu
  * formát odpovědi: plain-text, hodnoty oddělené čárkou
  * vyžaduje [[:api#autentizace|autentizaci]]
  * příklad odpovědi: <code>300100,300110</code>

=== GET /lines.json ===

  * vrací seznam linek přiřazených k uživatelskému účtu včetně detailů o nastavení a připojených zařízeních
  * formát odpovědi: JSON
  * vyžaduje [[:api#autentizace|autentizaci]]
  * příklad odpovědi:
<code javascript>
[{"id":700660,
  "name":"infolinka",
  "caller_id":"00420533533533",
  "public_number":"00420533533533",
  "backup_number":"00420581110860",
  "sip_password":"XXXXXXX",
  "active_822":false,
  "active_cz_restriction":false,
  "active_iax":false,
  "active_password":true,
  "active_pin":false,
  "active_ping":false,
  "active_rtp":false,
  "active_sip":true,
  "active_anonymous":true,
  "active_greeting":false,
  "missed_call_email":"kontaktXXX@odorik.cz",
  "recording_email":"kontaktXXX@odorik.cz",
  "voicemail_email":"kontaktXXX@odorik.cz",
  "backup_number_email":null,
  "incoming_call_name_format":0,
  "incoming_call_number_format":0,
  "connected_devices": [{ "user_agent":"A510 IP/42.245.00.000.000",
                          "public_socket":"50.200.57.161:6023",
                          "local_socket":"192.168.0.211:6023",
                          "last_registration_at":"2018-06-15T10:20:03+02:00",
                          "registration_expires_at":"2018-06-15T11:20:03+02:00"},
                        { "user_agent":"A510 IP/42.240.00.000.000",
                          "public_socket":"35.102.230.251:10235",
                          "local_socket":"10.0.0.59:10235",
                          "last_registration_at":"2018-06-15T10:53:38+02:00",
                          "registration_expires_at":"2018-06-15T10:56:38+02:00"}]
}]
</code>

=== POST /lines.json ===

  * zakoupení nové linky k uživatelskému účtu
  * cena je stejná jako při koupi v uživatelském rozhraní (5 Kč)
  * vyžaduje [[:api#autentizace|autentizaci]] platnou pro celý účet (API heslo)
  * vrací informace o zakoupené lince
  * možné chybové stavy:
    * //low_balance//: uživatelský účet nedisponuje dostatečným kreditem pro nákup linky