jlgomes / swapi-php
Projeto utilizado para simplificar a utilização da API do Starwars(SWAPI), utilizando pela url ou entidade+id
v1.0.1
2022-10-12 13:47 UTC
Requires
- php: >=8.0
- guzzlehttp/guzzle: ^7.5
- netresearch/jsonmapper: ^4.0
This package is auto-updated.
Last update: 2024-04-12 17:37:37 UTC
README
Busca os dados na api com a opção do retorno normal(default) ou com busca adicional nos atributos que pussem uma url.
Versão recomendada do PHP:
>=8.0
Forma de buscar os dados
- url: (
https://swapi.dev/api/starships/5
) - entidade e id: (
starships
,5
)
Retorno dos dados
- JSON (default)
- ARRAY
Tipo de atributos com url que possuem a possibilidade de busca adicional
homeworld
films
people
planets
vehicles
species
starships
characters
pilots
residents
Installation
Instalar com composer
composer require jlgomes/swapi-php
Funções Principais
Exemplos de utilização
Buscar dados pela url:
- parâmetro 1(obrigatório): (string) url para realizar a busca na API
- parâmetro 2(opcional default false): (bool) informa se deve ser realizada a busca adicional nos atributos com url.
- parâmetro 3(opcional default true): (bool) informa se deve retornar um Json ou um Array
- Com os parâmetros utilizados abaixo serão retornados os dados simples da Api em json
use Jlgomes\Swapi\Swapi; $swapi = new Swapi(); $dataStarships = $swapi->getDataByUrl("https://swapi.dev/api/starships/5"); // Resultado em: https://github.com/jonasbenti/fetch-swapi-data/blob/master/attachment/Sample1.png echo($dataStarships);
Buscar dados pela entidade e id:
- parâmetro 1(obrigatório): (string) entidade para realizar a busca na API
- parâmetro 2(obrigatório): (int) id para realizar a busca na API
- parâmetro 3(opcional default false): (bool) informa se deve ser realizada a busca adicional nos atributos com url.
- parâmetro 4(opcional default true): (bool) informa se deve retornar um Json ou um Array
- Com os parâmetros utilizados abaixo serão retornados os dados com informações adiconais da Api em json
use Jlgomes\Swapi\Swapi; $swapi = new Swapi(); $dataPeople = $swapi->getDataByModelAndId('people', 5, true); // Resultado em: https://github.com/jonasbenti/fetch-swapi-data/blob/master/attachment/Sample2.json echo($dataPeople);