superdeclarative_unsplash_client

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #typescript #golang #go #machine-learning #macos #java #cli #kubernetes #mcp #openai

superdeclarative_unsplash_client

(★ 14)

An Unsplash API client written in Dart

superdeclarative_unsplash_client Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Unsplash Client

A Dart Client for the Unsplash API.

**This is a [SuperDeclarative!](https://superdeclarative.com) project, not an official Unsplash package**

---

If you get value from this package, please consider supporting SuperDeclarative!

---

Unsplash is a service that provides access to royalty free stock photographs. In addition to direct browsing of photographs, Unsplash offers a developer API for accessing photos, collections of photos, users of the platform, and more.

This package is a client for the Unsplash API, built in the Dart language.

Unsplash API documentation: https://unsplash.com/documentation

---

## Quickstart

Create a client:

```dart
final unsplashClient = UnsplashClient(
  accessKey: YOUR_API_KEY,
);
```

Get a random photo:

```dart
final Photo photo = await unsplashClient.getRandomPhoto();
```

Get a specified photo:

```dart
final Photo photo = await unsplashClient.getPhoto(id: 'some_photo_id');
```

Search photos:

```dart
final PhotoSearchPage page = await unsplashClient.searchPhotos(
  query: 'some query or blank for featured photos',
);
```

Load pages of photos:

```dart
final paginator = Paginator.listPhotos(
  client: unsplashClient,
)..loadNextPage();
```

---

## Run Tests

To run the tests in this package, define an environment variable called `UNSPLASH_KEY` and set its value to your unsplash API key.

```bash
$ dart test
```

or

```bash
$ flutter test
```

Support for `flutter test` will probably be removed as soon as the CI
system supports the Dart version. This is because a Dart package should
not depend upon Flutter's testing system.

---

## Example Project

An example project, built with Flutter, is available in the `/example` directory.

---

## Supported Calls

### API Version 1

#### Authentication

- [x] HTTP Basic Authentication
- [ ] User Authentication Flow
- [ ] Dynamic Client Registration

#### Current User

- [ ] GET /me
- [ ] PUT /me

#### Users

- [ ] GET /users/:username
- [ ] GET /users/:username/portfolio
- [ ] GET /users/:username/photos
- [ ] GET /users/:username/likes
- [ ] GET /users/:username/collections
- [ ] GET /users/:username/statistics

#### Photos

- [x] GET /photos
- [x] GET /photos/:id
- [x] GET /photos/random
- [x] GET /photos/:id/statistics
- [ ] GET /photos/:id/download
- [ ] PUT /photos/:id
- [ ] POST /photos/:id/like
- [ ] DELETE /photos/:id/like

#### Search

- [x] GET /search/photos
- [x] GET /search/collections
- [x] GET /search/users

#### Collections

- [x] GET /collections
- [x] GET /collections/featured
- [x] GET /collections/:id
- [ ] GET /collections/:id/photos
- [ ] GET /collections/:id/related
- [ ] POST /collections
- [ ] PUT /collections/:id
- [ ] DELETE /collections/:id
- [ ] POST /collections/:collection_id/add
- [ ] DELETE /collections/:collection_id/remove

#### Stats

- [x] GET /stats/total
- [x] GET /stats/month

superdeclarative_unsplash_client

superdeclarative_unsplash_client Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

superdeclarative_unsplash_client

superdeclarative_unsplash_client Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README