Simple and hackable request for dart.
Installing
-
Add dependencies to
pubspec.yamldependencies: hequest: git: url: https://github.com/teixeirazeus/hequest
-
Run pub get.
flutter pub get
-
Import package.
import 'package:hequest/hequest.dart';
Using
Hequest was created with simplicity in mind to handle multiple API requests.
You start by declaring an object of type Hequest and passing the baseUrl of your api.
final githubApi = Hequest(baseUrl: 'https://api.github.com');
GET
final response = await githubApi.get('/users/teixeirazeus');
POST
final response = await githubApi.post('/users/teixeirazeus', body: {
'name': 'Zeus Teixeira',
});
PUT
final response = await githubApi.put('/users/teixeirazeus', body: {
'name': 'Zeus Teixeira',
});
DELETE
final response = await githubApi.delete('/users/teixeirazeus');
JWT
All requests support sending jwt token.
To use to use the WithToken postfix and pass the token as a parameter.
final response = await githubApi.getWithToken('/users/teixeirazeus', token);
Tips
It is highly recommended that you use try catch to handle errors. Along with a larger abstraction with a class for each endpoint of your api.
class GithubApi {
final Hequest _hequest;
GithubApi(this._hequest);
Future<Map> getUser(String username) async {
try {
final response = await _hequest.get('/users/$username');
if (response.statusCode == 200) {
return json.decode(response.body);
} else if (response.statusCode == 404) {
throw Exception('User not found');
} else {
throw Exception('Failed to load user');
}
} catch (e) {
throw Exception('Error getting user');
}
}
}
final hequest = Hequest(baseUrl: 'https://api.github.com');
final githubApi = GithubApi(hequest);
final user = await githubApi.getUser('teixeirazeus');
print(user.toString());
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
46 Dec 19, 2021
11.2k Jan 3, 2023
4 Apr 19, 2022
1.7k Dec 31, 2022
1 Nov 26, 2020
19 Sep 7, 2022
8 Dec 14, 2022
4 Jun 14, 2022
27 Dec 2, 2022