This repository has been archived on 2023-10-14. You can view files and clone it, but cannot push or open issues or pull requests.
canteenlib/quick-start.md
2022-06-02 16:45:40 +02:00

1.7 KiB

description
Jak začít s používáním API

Quick Start

{% hint style="danger" %} Využívání balíku je na vlastní nebezpečí, neručíme za škody způsobené používáním! {% endhint %}

Instalace balíku

Knihovna je hostována na pub.dev, instalace se provede jednoduše pomocí dart pub add canteenlib, pokud používáte Flutter pak flutter pub add canteenlib

Vytvořit instanci

Základem je vytvoření instance třídy Canteen, která obsahuje všechny metody pro komunikaci s iCanteen. Jediný parametr této třídy je URL k vašemu kýženému iCanteen.

import 'package:canteenlib/canteenlib.dart';
// ...
Canteen c = Canteen("https://kantyna.neco.cz");
// ...

Přihlášení

Přihlášení za váš účet provedete pomocí metody login, parametry jsou uživatelské jméno a heslo.

{% hint style="info" %} Knihovna používá hlavně asynchronní funkce, které vrací Future, doporučujeme používat uvnitř jiné asynchronní funkce s await. {% endhint %}

// ...
Canteen c = Canteen("https://kantyna.neco.cz");
var l = await c.login("jmeno","heslo")

Metoda vrací bool nebo chybu. Pokud se nelze přihlásit pomocí jména nebo hesla, vrací metoda false, v případě jiné chyby Future.error a při úspěšném přihlášení true.

Dělejte co potřebujete

Nyní byste měli být připravení na to, abyste posílali ostatní požadavky. Prohlédněte si referenci, podrobnou dokumentaci nebo příklady pro pomoc s pokračováním.