Skip to content

Commit 19f4caf

Browse files
committed
Moved image source to its own folder
1 parent b91ac9d commit 19f4caf

11 files changed

+40
-93
lines changed

.gitbook.yaml

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,7 @@ structure:
55
summary: SUMMARY.md
66

77
redirects:
8-
quick-start-10-minutes-or-less: quickstart.md
8+
quick-start-10-minutes-or-less: quickstart.md
9+
setup/adding-s3-bucket-image-source: setup/source-images/s3.md
10+
setup/adding-image-source: setup/source-images/domain.md
11+
setup/adding-http-image-source: setup/source-images/http.md

.gitbook/assets/api-keys-list.png

-7.35 KB
Binary file not shown.

SUMMARY.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,10 @@
33
* [Overview](README.md)
44
* [Quickstart](quickstart.md)
55
* [Tools and Setup](setup/README.md)
6-
* [Adding Source Image Domain](setup/adding-image-source.md)
7-
* [Adding HTTP Image Source](setup/adding-http-image-source.md)
8-
* [Adding AWS S3 Bucket Image Source](setup/adding-s3-bucket-image-source.md)
6+
* Source Images
7+
* [Adding Source Image Domain](setup/source-images/domain.md)
8+
* [Adding HTTP Image Source](setup/source-images/http.md)
9+
* [Adding AWS S3 Bucket Image Source](setup/source-images/s3.md)
910
* [Managing API Keys](setup/manage-api-keys.md)
1011
* [Managing Users](setup/manage-users.md)
1112
* [Snippet Generator](setup/snippet-generator.md)

quick-start-10-minutes-or-less.md

Lines changed: 0 additions & 70 deletions
This file was deleted.

setup/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# Tools and Setup
22

3-
There is only one step that you need to do to start using Pixboost - [add at least one image domain](adding-image-source.md) or image source.
3+
There is only one step that you need to do to start using Pixboost - [add at least one image domain](source-images/domain.md) or image source.
44

55
You will already have one active API key that you can use, but [you can add more or rotate them](manage-api-keys.md) in case you have different projects and don't want to have all eggs in one basket. It's a good security practice separating you API keys.
66

7-
## [Adding Images Domain](adding-image-source.md)
7+
## [Adding Images Domain](source-images/domain.md)
88

9-
## [Adding HTTP Image Source](adding-http-image-source.md)
9+
## [Adding HTTP Image Source](source-images/http.md)
1010

11-
## [Adding AWS S3 Bucket Image Source](adding-s3-bucket-image-source.md)
11+
## [Adding AWS S3 Bucket Image Source](source-images/s3.md)
1212

1313
## [Managing API Keys](manage-api-keys.md)
1414

setup/cache-invalidation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Cache invalidation is a function that helps you to remove image from the CDN.
55
You can delete images using either
66

77
* URL of the original image
8-
* Path to the image that starts with the [Image Source](./adding-http-image-source.md) alias
8+
* Path to the image that starts with the [Image Source](source-images/http.md) alias
99

1010
![](../.gitbook/assets/cache-invalidation/cache-invalidation-1.png)
1111

setup/manage-api-keys.md

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,20 +6,33 @@ Once you signed up you have one API key that you can see in the dashboard:
66

77
![](../.gitbook/assets/manage-api-keys/api-keys-list.png)
88

9+
## Usage
10+
911
You'll need to pass an API Key in a query parameter called "**auth**" in the transformation URL. For example:
1012

1113
To use the API key add it as a value in the "auth" query parameter when using API:
1214

1315
https://pixboost.com/api/2/img/pixabay.com/logo.png/resize?size=200&auth=MTg4MjMxMzM3MA
1416

15-
You can create new API Keys from the dashboard and add a label to them, so you remember what you use each key for. Labels are only used for information and reporting purposes.
16-
1717
> Be careful when **deleting** API keys. Any API requests that use deleted keys will be failing.
1818
19+
## Labels
20+
21+
You can create new API Keys from the dashboard and add a label to them, so you remember what you use each key for. Labels are only used for information and reporting purposes.
22+
1923
Some useful examples of the label could include a website and environment. For instance:
2024

2125
* dev
2226
* test-site-1
2327
* prod-site-2
2428

29+
## Security
30+
31+
API keys are not secrets and are shared publicly when used to access API.
32+
33+
When passing an API key with a request, the service can link the request to an account, therefore limiting
34+
the source image destination to image sources/domains you specified.
35+
36+
## Limits
37+
2538
There is a soft limit of 10 API keys per account. If you need more - please contact [support](mailto:[email protected]).

setup/adding-image-source.md renamed to setup/source-images/domain.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,23 @@
44

55
When you login for the first time then you will see a "Welcome" banner:
66

7-
![](../.gitbook/assets/welcome.png)
7+
![](../../.gitbook/assets/welcome.png)
88

99
Click on the "Plus" button, and you will have to add your domain name in a dialog window "Add domain":
1010

11-
![](../.gitbook/assets/add-domain-1.png)
11+
![](../../.gitbook/assets/add-domain-1.png)
1212

1313
{% hint style="info" %}
1414
If you'd like to load images from a private AWS S3 bucket then click on the "Bucket" icon and follow [steps from here](adding-s3-bucket-image-source.md)
1515
{% endhint %}
1616

1717
Enter your domain and click the "Add" button:
1818

19-
![](../.gitbook/assets/add-domain-2.png)
19+
![](../../.gitbook/assets/add-domain-2.png)
2020

2121
You will see adeed domain in the list now:
2222

23-
![](../.gitbook/assets/domains-list.png)
23+
![](../../.gitbook/assets/domains-list.png)
2424

2525
That's enough to start using the service. Try it out it in your browser:
2626

setup/adding-http-image-source.md renamed to setup/source-images/http.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,21 @@
22

33
You could add HTTP image source to shorten URLs that you are using for the integration.
44

5-
![](../.gitbook/assets/http-image-source-concept.png)
5+
![](../../.gitbook/assets/http-image-source-concept.png)
66

77
## Adding a new source
88

99
* [Login](https://pixboost.com/customer/#login) to your Pixboost account.
1010
* Click on "Add source" link under the "Images Sources" panel
1111

12-
![](../.gitbook/assets/add-images-source.png)
12+
![](../../.gitbook/assets/add-images-source.png)
1313

1414
* In the appeared form set Type to "HTTP" and fill in the details
1515
* _Alias_ is a unique identifier of the images source that will be used in the URL when calling API
1616
* _Images location_ is a URL where the original images stored
1717

18-
![](../.gitbook/assets/add-http-images-source.png)
18+
![](../../.gitbook/assets/add-http-images-source.png)
1919

2020
* Click on "Add" button and verify that the source has been created
2121

22-
![](../.gitbook/assets/verify-http-images-source.png)
22+
![](../../.gitbook/assets/verify-http-images-source.png)

setup/adding-s3-bucket-image-source.md renamed to setup/source-images/s3.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ To set up the integration:
4545
* [Login](https://pixboost.com/customer/#login) to your Pixboost account.
4646
* Click on "Add source" link under the "Images Sources" panel
4747

48-
![](../.gitbook/assets/add-images-source.png)
48+
![](../../.gitbook/assets/add-images-source.png)
4949

5050
* In the appeared form set Type to "Amazon AWS S3 Bucket" and fill in the details
5151
* _Alias_ is a unique identifier of the images source that will be used in the URL when calling API
@@ -58,11 +58,11 @@ To set up the integration:
5858
* _Access Key_ is an AWS IAM user's access key created in the step above
5959
* _Secret Key_ is an AWS IAM user's secret key created in the step above
6060

61-
![](../.gitbook/assets/add-s3-images-source.png)
61+
![](../../.gitbook/assets/add-s3-images-source.png)
6262

6363
* Click on "Add" button and verify that the source has been created
6464

65-
![](../.gitbook/assets/verify-s3-images-source.png)
65+
![](../../.gitbook/assets/verify-s3-images-source.png)
6666

6767
## Using API
6868

workflows/cache-invalidation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ API\_SECRET - [secret key](api-secrets.md).
2222

2323
202 - Invalidation process began and will finish soon. Usually it will take up to the 5 minutes.
2424

25-
401 - Failed authorization. Image domain is not in the list of [images sources](../setup/adding-image-source.md)
25+
401 - Failed authorization. Image domain is not in the list of [images sources](../setup/source-images/domain.md)
2626

2727
## Example
2828

0 commit comments

Comments
 (0)