Jak nejlépe na API pro nette aplikaci

@JanTvrdík Díky. Přednášku jsem zkouknul, ale měl jsem namysli úplný začátek jak vytvořit api pro nette aplikaci.

@JanTvrdík Mám aplikaci, kde se člověk přihlásí. Aplikace rozpozná podle přihlašovacích údajů jestli ho má hodit do uživatelského nebo admin rozhraní. A jako admin vidím v /admin/events/show všechny akce a počty přihlášených lidí na akci. Tak tenhle počet bych chtěl přes api vytáhnout. Samozřejmě je víc věcí co bych chtěl přes api dělat, ale tohle je to nejjednodušší co by měla umět.

@JanTvrdík Problém je, že jsem to nikdy nedělal, tak jsem nevěděl ani jak bych začal. Jestli to tedy dobře chápu tak EventAttendeesCountApiPresenter si vložím do modules/api/presenters a pak dotaz na api je domena.cz/api/eventattendeescountapi ??

@JanTvrdík Mám upravenou strukturu a i routerFactory. Tak jen jestli jsem dobře pochopil. Přidám pod modules Api…a do router factory tedy api část viz níže

struktura

app
├── modules
│   ├── Web
│   │   ├── presenters
│   │   │   ├── Default
│   │   │   │   ├── templates
│   │   │   │   │   └── default.latte
│   │   │   │   └── DefaultPresenter.php
│   │   │   └── Product
│   │   │       ├── templates
│   │   │       │   ├── default.latte
│   │   │       │   └── edit.latte
│   │   │       └── ProductPresenter.php
│   │   └── templates
│   │       └── @layout.latte
│   └── Admin
│       ├── modules
│       │   └── (more modules)
│       ├── presenters
│       │   └── Default
│       │       ├── templates
│       │       │   └── default.latte
│       │       └── DefaultPresenter.php
│       └── templates
│           └── @layout.latte
├── presenters
│   └── Base
│       └── BasePresenter.php
└── templates
    └── @layout.latte

router

		$router = new RouteList;
$router[] = new Route('[index.[php][html]]', 'Homepage:default', Route::ONE_WAY);
$router[] = new Route('[wp-login.php]', 'Homepage:default', Route::ONE_WAY);

$router[] = new Route('[<locale=cs cs|en>/]sign/<action>', 'Sign:', Route::ONE_WAY);


$api= new RouteList('Api');
$api[] = new Route('api/<presenter>/[<action>]');
$router[] = $api;

$admin = new RouteList('Admin');
$admin[] = new Route('[<locale=cs cs|en>/]admin/<presenter>/<action>[/<id>]', 'Dashboard:default');
$router[] = $admin;

$web = new RouteList('Web');
$web[] = new Route('[<locale=cs cs|en>/]<presenter>/<action>[/<id>]', 'Homepage:default');
$router[] = $web;

$router[] = new Route('[<locale=cs cs|en>/]<presenter>/<action>[/<id>]', 'Homepage:default');

return $router;

Editoval jarda256 (10. 1. 2017 20:46)

@lukas.kupka Stačí takto?

class HelloWorldApiPresenter implements IPresenter
{
    public function run(Request $request)
    {
        $name = $request->getParameter('name');
        return new TextResponse("Hello $name");
    }
}

@lukas.kupka Mělo by fungovat něco jako

$apiRouter = new Route('api/<presenter>', ['module' => 'Api']);

@lukas.kupka možno ti to bude hlásiť problém, že neexistuje na to mapping, to bude potom treba pridať v configu…

podíval bych se na Appite – https://github.com/apitte/core
propracované knihovna na api, je tam i middleware na authorizaci

@mcmatak mrkni na projekt forest je tam nastaven cely apitte vcetne napojeni na doctrine https://github.com/…tte-skeleton

treba tam vyctes co potrebujes, pokud ne … tak je to zaminka tam neco noveho doplnit

@mcmatak
Snapshot je interní mechanizmus, proto vůbec není v dokumentaci.

Vícenásobné odesílání hlaviček znamená většinou spíš nepochopení PSR-7. withHeader() přepíše stejnojmennou hlavičku, withAddedHeader() přidá hlavičku nezávisle na tom, zda už stejnojmenná existuje
Pamatuju si, že zrovna v tvém případě to kolidovalo s nette/http, které odesílá hlavičky ihned při startu DIC, což je bohužel kombinace několika menších problémů a nedalo se to předvídat.

K middlewares – contributte/middlewares byly původně určené pro nette, budou se konceptuelně oddělovat. Konkrétně u tracy middleware by bylo asi dobré zmínit, že řeší totéž, co nette/bootstrap, jeho použití s bootstrapem není tedy nutné.

Debug plugin – U negotiations byl bug → pokud byla na konci url proměnná, např. {id}, tak nefungovaly koncovky .debug apod. Spraveno tuším od 0.5?

Logování errorů – od 0.5 má apitte vlastní error handler, od 0.7 (nynější dev alias) se zapíná automaticky i logování pokud je dostupný PSR logger

Na developmentu něco funguje, na produkci ne – nemám vůbec tušení, co řešíš nebo čím by to mohlo být. Pokud jde o debug mód, tak v tom je jen minimum změn oproti produkci. Chtělo by to víc rozvést.

A příště prosím piš někam, kde máš jistotu, že to zahlédne autor knihovny.

Editoval Mabar (7. 9. 2019 21:51)

Na co to potřebuješ? Potomci ApiException (ServerErrorException a ClientErrorException) jsou čistě pro zobrazení chyby uživateli. Pokud tento typ výjimky způsobila skutečná výjimka, tak můžeš využít ClientErrorException::create()->withPrevious($exception) a originální chyba se zaloguje.

Služby z extensions (a tedy i apitte pluginů) můžeš přetěžovat jako kterékoli jiné služby v neonu, přes název služby, jen vyměníš třídu.

Editoval Mabar (28. 11. 2019 17:27)

Založ issue, je možné že jde o bug