API pro práci se SIM kartami

Součást Odorik.cz API, poskytuje volání umožňující práci se SIM kartami.

• výpis nastavení parametrů SIM karty s telefonním číslem <mobilni_cislo>
• vyžaduje autentizaci
• nepovinné parametry:
  • všechny níže uvedené atributy předané s hodnotou “true” způsobí přidání validních voleb pro dané parametry SIM karty
  • include_available_data_packages
  • include_available_credit_addons
  • include_available_packages_delayed_billing
  • include_available_roaming_settings
• příklad odpovědi na požadavek společně s include_available_data_packages:

{ "id": 5,
  "sim_number": "2145F7Q",
  "state": "active",
  "changes_in_progress": [],
  "data_package": "150MB",
  "data_package_for_next_month": "perKB",
  "data_bought_total": 157286400,
  "data_used": 0,
  "voice_package": "none",
  "voice_package_for_next_month": "none",
  "package_delayed_billing": "none",
  "package_delayed_billing_for_next_month": "none",
  "missed_calls_register": false,
  "mobile_data": false,
  "lte": false,
  "lte_for_next_month": false,
  "roaming": "off",
  "premium_services": "off",
  "available_data_packages": [
    {"name": "perKB", "price": 0},
    {"name": "25MB", "price": 20},
    {"name": "100MB", "price": 50},
    {"name": "150MB", "price": 69},
    {"name": "300MB", "price": 128},
    {"name": "500MB", "price": 190},
    {"name": "1000MB", "price": 290},
    {"name": "1500MB", "price": 390},
    {"name": "2000MB", "price": 450},
    {"name": "3000MB", "price": 490},
    {"name": "10GB", "price": 690} ]
}

• vyvolá změnu nastavení parametrů SIM karty s telefonním číslem <mobilni_cislo>
• vyžaduje autentizaci
• platí několik omezení na prováděné změny:
  • v případě změny stavu (state) se provádí pouze tato změna a ostatní parametry jsou ignorovány
  • v případě již probíhajících změn u SIM karty (neprázdné pole changes_in_progress ve výpise stavu přes GET požadavek) je možné zadávat požadavek na změnu pouze následujících parametrů: requested_data_plan_for_next_month, requested_data_roaming_plan_for_next_month, requested_voice_roaming_plan_for_next_month a requested_tariff_plan_for_next_month
• (nepovinné) parametry:
  • state: active/suspended
  • data_package: viz zdroj dostupných datových balíčků
  • data_package_for_next_month: viz zdroj dostupných datových balíčků
  • voice_package: viz zdroj dostupných hlasových balíčků
  • voice_package_for_next_month: viz zdroj dostupných hlasových balíčků
  • package_delayed_billing: viz zdroj dostupných balíčků naruby
  • package_delayed_billing_for_next_month: viz zdroj dostupných balíčků naruby
  • missed_calls_register: true/false; SMS upozornění o zmeškaných hovorech v době nepřihlášení do sítě; v budoucnu může být zaveden paušální poplatek
  • mobile_data: true/false
  • lte: true/false
  • lte_for_next_month: true/false
  • roaming: viz zdroj dostupných nastavení roamingu
  • premium_services: off/sms_payments_and_dms/all_other_than_sms_payments_and_dms/all

• výpis datových přenosů SIM karty s telefonním číslem <mobilni_cislo> za zvolené období
• povinné parametry:
  • from, to: časové rozmezí hovorů; řetězec formátovaný jako dateTime z XML Schema (například: 2013-06-05T11:15:00+02:00)
• vyžaduje autentizaci

• výpis datových přenosů všech SIM karet přiřazených k danému účtu za zvolené období
• povinné parametry:
  • from, to: časové rozmezí hovorů; řetězec formátovaný jako dateTime z XML Schema (například: 2013-06-05T11:15:00+02:00)
• vyžaduje autentizaci
• příklad odpovědi:

[{"id":133,"date":"2013-07-11T14:43:59Z","bytes_up":151666,"bytes_down":3768,"bytes_total":155434,"price":0.1484,"price_per_mb":1.0,"phone_number":"00420799799799"}]

• přiřadí telefonní číslo <mobilni_cislo> k SIM kartě na základě údajů o této SIM (ICCID a PIN)
• dané telefonní číslo již musí být přiřazeno k lince
• povinné parametry:
  • iccid: číslo SIM karty (viz http://81.31.45.46/wiki/img/sim-gts-popisek9.png)
  • pin: PIN1 SIM karty
• nepovinné parametry:
  • delayed_activation: výchozí hodnota je false; v opačném případě je přiřazení jen předchystáno a je dokončeno až po potvrzení uvnitř uživatelského rozhraní
• vyžaduje autentizaci
• při úspešném provedení vrací prázdný objekt:

  {}

• možné chybové stavy
  • invalid_phone_number - špatné <mobilni_cislo> anebo není ještě přiřazeno k lince
  • invalid_iccid_or_pin
  • sim_already_assigned
  • příklad:

    {"errors": ["invalid_iccid_or_pin"]}