Εισαγωγή

Το API του Pexels επιτρέπει την πρόσβαση μέσω προγραμματισμού στην πλήρη βιβλιοθήκη περιεχομένου Pexels, συμπεριλαμβανομένων των φωτογραφιών και βίντεο. Όλο το περιεχόμενο είναι διαθέσιμο δωρεάν και μπορείτε να χρησιμοποιήσετε το περιεχόμενο Pexels για οτιδήποτε θέλετε, αρκεί να ακολουθεί τις Οδηγίες.

Το API του Pexels είναι ένα RESTful JSON API και μπορείτε να αλληλεπιδράσετε με αυτό από οποιαδήποτε γλώσσα ή πλαίσιο με μια βιβλιοθήκη HTTP. Εναλλακτικά, το Pexels διατηρεί κάποιες επίσημες Βιβλιοθήκες πελατών που μπορείτε να χρησιμοποιήσετε.

Εάν έχετε οποιεσδήποτε ερωτήσεις, μη διστάσετε να ρίξετε μια ματιά στις Συχνές ερωτήσεις ή να μας στείλετε email στη διεύθυνση [email protected].

Note: For historical reasons, all endpoints begin with https://api.pexels.com/v1/ except for video endpoints, which begin with https://api.pexels.com/videos/. Please see the individual endpoints listed below for more details about how to call each endpoint.

Οδηγίες

Κάθε φορά που υποβάλλετε ένα αίτημα API, βεβαιωθείτε ότι εμφανίζετε έναν εμφανή σύνδεσμο στο Pexels. Μπορείτε να χρησιμοποιήσετε έναν σύνδεσμο κειμένου (π.χ. «Οι φωτογραφίες παρέχονται από το Pexels») ή έναν σύνδεσμο με το λογότυπό μας.

Όταν αυτό είναι εφικτό, θα πρέπει πάντα να αναφέρετε τους φωτογράφους μας (π.χ. «Φωτογραφία του Χ στο Pexels» με έναν σύνδεσμο στη σελίδα της φωτογραφίας στο Pexels).

Δεν μπορείτε να αντιγράψετε ή να αναπαραγάγετε τις βασικές λειτουργίες του Pexels (συμπεριλαμβανομένης της διάθεσης του περιεχομένου Pexels ως εφαρμογής ταπετσαρίας).

Μην κάνετε κατάχρηση του API. Από προεπιλογή, το API περιορίζεται στα 200 αιτήματα ανά ώρα και στα 20.000 αιτήματα ανά μήνα. Μπορείτε να επικοινωνήσετε μαζί μας για να ζητήσετε υψηλότερο όριο. Ωστόσο, σας παρακαλούμε να συμπεριλάβετε παραδείγματα ή να είστε έτοιμοι να παραδώσετε ένα demo, στο οποίο φαίνεται ξεκάθαρα η χρήση του API με αναφορά. Εάν πληροίτε τους όρους για το API μας, μπορείτε να εξασφαλίσετε απεριόριστα αιτήματα δωρεάν.

Η κατάχρηση του API του Pexels, συμπεριλαμβανομένης, μεταξύ άλλων, της απόπειρας παράκαμψης του ορίου, θα οδηγήσει σε τερματισμό της πρόσβασής σας στο API.

Linking back to Pexels
1
2
3
4
5
6
7
8
9
10
11
12
13
<a href="https://www.pexels.com">Photos provided by Pexels</a>

<!-- or show our white logo -->

<a href="https://www.pexels.com">
  <img src="https://images.pexels.com/lib/api/pexels-white.png" />
</a>

<!-- or show our black logo -->

<a href="https://www.pexels.com">
  <img src="https://images.pexels.com/lib/api/pexels.png" />
</a>
Linking back to a Photo
1
This <a href="https://www.pexels.com/photo/food-dinner-lunch-meal-4147875">Photo</a> was taken by <a href="https://www.pexels.com/@daria">Daria</a> on Pexels.

Βιβλιοθήκες πελατών

Το Pexels διατηρεί διάφορες επίσημες βιβλιοθήκες πελατών API που μπορείτε να χρησιμοποιήσετε για να αλληλεπιδράσετε με το API του Pexels:

Language Package Github Changelog Version
Ruby rubygems pexels-ruby changelog 0.3.0
Javascript npm pexels-javascript changelog 1.2.1
.net nuget PexelsDotNetSDK changelog 1.0.6

Διαβάστε την τεκμηρίωση για τη βιβλιοθήκη πελατών που θέλετε να χρησιμοποιήσετε για περισσότερες πληροφορίες σχετικά με τη σύνταξη (δείγματα κώδικα για κάθε βιβλιοθήκη διατίθενται σε αυτήν την τεκμηρίωση). Ζητήματα και αιτήματα έλξης στο Github είναι επίσης ευπρόσδεκτα!

Εάν έχετε δημιουργήσει μια ανεπίσημη βιβλιοθήκη API του Pexels για διαφορετική γλώσσα, μη διστάσετε να μας ενημερώσετε!

Εξουσιοδότηση

Απαιτείται εξουσιοδότηση για το API του Pexels. Οποιοσδήποτε με λογαριασμό Pexels μπορεί να ζητήσει ένα κλειδί API , το οποίο θα λάβετε αμέσως.

Όλα τα αιτήματα που υποβάλλετε στο API θα πρέπει να περιλαμβάνουν το κλειδί σας. Αυτό παρέχεται με την προσθήκη μιας κεφαλίδας Authorization.

Example of Authorization
1
2
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/v1/search?query=people"

Στατιστικά αιτημάτων

Για να δείτε πόσα αιτήματα έχουν απομείνει από το μηνιαίο όριό σας, τα επιτυχή αιτήματα από το API του Pexels περιλαμβάνουν τρεις κεφαλίδες HTTP:

Response Header Meaning
X-Ratelimit-Limit Το συνολικό σας όριο αιτημάτων για τη μηνιαία περίοδο
X-Ratelimit-Remaining Πόσα από αυτά τα αιτήματα παραμένουν
X-Ratelimit-Reset Η χρονική σήμανση UNIX για το πότε θα ανανεωθεί η τρέχουσα μηνιαία περίοδος

Σημείωση: Αυτές οι κεφαλίδες απόκρισης επιστρέφονται μόνο σε επιτυχημένες αποκρίσεις ( 2xx ). Δεν περιλαμβάνονται με άλλες αποκρίσεις, συμπεριλαμβανομένης της 429 Too Many Requests, που υποδηλώνει ότι έχετε υπερβεί το όριο. Φροντίστε να παρακολουθείτε τα X-Ratelimit-Remaining και X-Ratelimit-Reset για να διαχειρίζεστε τα όρια αιτημάτων σας.

Example of Rate Limit Headers
1
2
3
X-Ratelimit-Limit: 20000
X-Ratelimit-Remaining: 19684
X-Ratelimit-Reset: 1590529646

Σελιδοποίηση

Η πλειοψηφία των αιτημάτων API του Pexels επιστρέφουν πολλές εγγραφές ταυτόχρονα. Όλα αυτά τα τελικά σημεία είναι σελιδοποιημένα και μπορούν να επιστρέψουν έως και 80 αιτήματα ταυτόχρονα. Κάθε σελιδοποιημένο αίτημα αποδέχεται τις ίδιες παραμέτρους και επιστρέφει τα ίδια δεδομένα σελιδοποίησης στην απόκριση.

Σημείωση: Τα χαρακτηριστικά απόκρισης prev_page και next_page θα επιστραφούν μόνο εάν υπάρχει αντίστοιχη σελίδα.

Pagination Request Parameters
1
GET https://api.pexels.com/v1/curated?page=2&per_page=40
Pagination Response Attributes
1
2
3
4
5
6
7
{
  "page": 2,
  "per_page": 40,
  "total_results": 8000,
  "next_page": "https://api.pexels.com/v1/curated?page=3&per_page=40",
  "prev_page": "https://api.pexels.com/v1/curated?page=1&per_page=40"
}

Ο πόρος φωτογραφιών

Ο πόρος Photo είναι μια έκδοση φωτογραφίας Pexels σε μορφή JSON. Τα τελικά σημεία API της φωτογραφίας ανταποκρίνονται στα δεδομένα της φωτογραφίας που έχουν μορφοποιηθεί σε αυτό το σχήμα.

Απόκριση

Ο πόρος φωτογραφιών
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "id": 2014422,
  "width": 3024,
  "height": 3024,
  "url": "https://www.pexels.com/photo/brown-rocks-during-golden-hour-2014422/",
  "photographer": "Joey Farina",
  "photographer_url": "https://www.pexels.com/@joey",
  "photographer_id": 680589,
  "avg_color": "#978E82",
  "src": {
    "original": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg",
    "large2x": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&dpr=2&h=650&w=940",
    "large": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=650&w=940",
    "medium": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=350",
    "small": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=130",
    "portrait": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=1200&w=800",
    "landscape": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=627&w=1200",
    "tiny": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&dpr=1&fit=crop&h=200&w=280"
  },
  "liked": false,
  "alt": "Brown Rocks During Golden Hour"
}

Επιμελημένες φωτογραφίες

GET https://api.pexels.com/v1/curated

Αυτό το τελικό σημείο σάς επιτρέπει να λαμβάνετε επιμελημένες φωτογραφίες από την ομάδα του Pexels σε πραγματικό χρόνο.

Προσθέτουμε τουλάχιστον μία νέα φωτογραφία ανά ώρα στη λίστα επιμελημένων, ώστε να έχετε πάντα τη δυνατότητα επιλογής από μια ενημερωμένη γκάμα δημοφιλών φωτογραφιών.

Παράμετροι

Απόκριση

Παράδειγμα αιτήματος
1
2
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/v1/curated?per_page=1"
Παράδειγμα απόκρισης
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
  "page": 1,
  "per_page": 1,
  "photos": [
    {
      "id": 2880507,
      "width": 4000,
      "height": 6000,
      "url": "https://www.pexels.com/photo/woman-in-white-long-sleeved-top-and-skirt-standing-on-field-2880507/",
      "photographer": "Deden Dicky Ramdhani",
      "photographer_url": "https://www.pexels.com/@drdeden88",
      "photographer_id": 1378810,
      "avg_color": "#7E7F7B",
      "src": {
        "original": "https://images.pexels.com/photos/2880507/pexels-photo-2880507.jpeg",
        "large2x": "https://images.pexels.com/photos/2880507/pexels-photo-2880507.jpeg?auto=compress&cs=tinysrgb&dpr=2&h=650&w=940",
        "large": "https://images.pexels.com/photos/2880507/pexels-photo-2880507.jpeg?auto=compress&cs=tinysrgb&h=650&w=940",
        "medium": "https://images.pexels.com/photos/2880507/pexels-photo-2880507.jpeg?auto=compress&cs=tinysrgb&h=350",
        "small": "https://images.pexels.com/photos/2880507/pexels-photo-2880507.jpeg?auto=compress&cs=tinysrgb&h=130",
        "portrait": "https://images.pexels.com/photos/2880507/pexels-photo-2880507.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=1200&w=800",
        "landscape": "https://images.pexels.com/photos/2880507/pexels-photo-2880507.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=627&w=1200",
        "tiny": "https://images.pexels.com/photos/2880507/pexels-photo-2880507.jpeg?auto=compress&cs=tinysrgb&dpr=1&fit=crop&h=200&w=280"
      },
      "liked": false,
      "alt": "Brown Rocks During Golden Hour"
    }
  ],
  "next_page": "https://api.pexels.com/v1/curated/?page=2&per_page=1"
}

Ανάκτηση φωτογραφίας

GET https://api.pexels.com/v1/photos/:id

Ανακτήστε μια συγκεκριμένη φωτογραφία Photo από το αναγνωριστικό της.

Παράμετροι

Απόκριση

Returns a Photo object

Παράδειγμα αιτήματος
1
2
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/v1/photos/2014422"
Παράδειγμα απόκρισης
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "id": 2014422,
  "width": 3024,
  "height": 3024,
  "url": "https://www.pexels.com/photo/brown-rocks-during-golden-hour-2014422/",
  "photographer": "Joey Farina",
  "photographer_url": "https://www.pexels.com/@joey",
  "photographer_id": 680589,
  "avg_color": "#978E82",
  "src": {
    "original": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg",
    "large2x": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&dpr=2&h=650&w=940",
    "large": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=650&w=940",
    "medium": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=350",
    "small": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=130",
    "portrait": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=1200&w=800",
    "landscape": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=627&w=1200",
    "tiny": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&dpr=1&fit=crop&h=200&w=280"
  },
  "liked": false,
  "alt": "Brown Rocks During Golden Hour"
}

Ο πόρος βίντεο

Ο πόρος Video είναι μια έκδοση βίντεο Pexels σε μορφή JSON. Τα τελικά σημεία API του βίντεο ανταποκρίνονται στα δεδομένα βίντεο που έχουν μορφοποιηθεί σε αυτό το σχήμα.

Απόκριση

Ο πόρος βίντεο
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
{
  "id": 2499611,
  "width": 1080,
  "height": 1920,
  "url": "https://www.pexels.com/video/2499611/",
  "image": "https://images.pexels.com/videos/2499611/free-video-2499611.jpg?fit=crop&w=1200&h=630&auto=compress&cs=tinysrgb",
  "full_res": null,
  "tags": [],
  "duration": 22,
  "user": {
    "id": 680589,
    "name": "Joey Farina",
    "url": "https://www.pexels.com/@joey"
  },
  "video_files": [
    {
      "id": 125004,
      "quality": "hd",
      "file_type": "video/mp4",
      "width": 1080,
      "height": 1920,
      "fps": 23.976,
      "link": "https://player.vimeo.com/external/342571552.hd.mp4?s=6aa6f164de3812abadff3dde86d19f7a074a8a66&profile_id=175&oauth2_token_id=57447761"
    },
    {
      "id": 125005,
      "quality": "sd",
      "file_type": "video/mp4",
      "width": 540,
      "height": 960,
      "fps": 23.976,
      "link": "https://player.vimeo.com/external/342571552.sd.mp4?s=e0df43853c25598dfd0ec4d3f413bce1e002deef&profile_id=165&oauth2_token_id=57447761"
    },
    {
      "id": 125006,
      "quality": "sd",
      "file_type": "video/mp4",
      "width": 240,
      "height": 426,
      "fps": 23.976,
      "link": "https://player.vimeo.com/external/342571552.sd.mp4?s=e0df43853c25598dfd0ec4d3f413bce1e002deef&profile_id=139&oauth2_token_id=57447761"
    }
    ...
  ],
  "video_pictures": [
    {
      "id": 308178,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-0.jpg",
      "nr": 0
    },
    {
      "id": 308179,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-1.jpg",
      "nr": 1
    },
    {
      "id": 308180,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-2.jpg",
      "nr": 2
    },
    {
      "id": 308181,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-3.jpg",
      "nr": 3
    }
    ...
  ]
}

Ανάκτηση βίντεο

GET https://api.pexels.com/videos/videos/:id

Ανακτήστε μια συγκεκριμένη φωτογραφία Video από το αναγνωριστικό της.

Παράμετροι

Απόκριση

Returns a Video object

Παράδειγμα αιτήματος
1
2
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/videos/videos/2499611"
Παράδειγμα απόκρισης
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
{
  "id": 2499611,
  "width": 1080,
  "height": 1920,
  "url": "https://www.pexels.com/video/2499611/",
  "image": "https://images.pexels.com/videos/2499611/free-video-2499611.jpg?fit=crop&w=1200&h=630&auto=compress&cs=tinysrgb",
  "duration": 22,
  "user": {
    "id": 680589,
    "name": "Joey Farina",
    "url": "https://www.pexels.com/@joey"
  },
  "video_files": [
    {
      "id": 125004,
      "quality": "hd",
      "file_type": "video/mp4",
      "width": 1080,
      "height": 1920,
      "link": "https://player.vimeo.com/external/342571552.hd.mp4?s=6aa6f164de3812abadff3dde86d19f7a074a8a66&profile_id=175&oauth2_token_id=57447761"
    },
    {
      "id": 125005,
      "quality": "sd",
      "file_type": "video/mp4",
      "width": 540,
      "height": 960,
      "link": "https://player.vimeo.com/external/342571552.sd.mp4?s=e0df43853c25598dfd0ec4d3f413bce1e002deef&profile_id=165&oauth2_token_id=57447761"
    },
    {
      "id": 125006,
      "quality": "sd",
      "file_type": "video/mp4",
      "width": 240,
      "height": 426,
      "link": "https://player.vimeo.com/external/342571552.sd.mp4?s=e0df43853c25598dfd0ec4d3f413bce1e002deef&profile_id=139&oauth2_token_id=57447761"
    },
    {
      "id": 125007,
      "quality": "hd",
      "file_type": "video/mp4",
      "width": 720,
      "height": 1280,
      "link": "https://player.vimeo.com/external/342571552.hd.mp4?s=6aa6f164de3812abadff3dde86d19f7a074a8a66&profile_id=174&oauth2_token_id=57447761"
    },
    {
      "id": 125008,
      "quality": "sd",
      "file_type": "video/mp4",
      "width": 360,
      "height": 640,
      "link": "https://player.vimeo.com/external/342571552.sd.mp4?s=e0df43853c25598dfd0ec4d3f413bce1e002deef&profile_id=164&oauth2_token_id=57447761"
    },
    {
      "id": 125009,
      "quality": "hls",
      "file_type": "video/mp4",
      "width": null,
      "height": null,
      "link": "https://player.vimeo.com/external/342571552.m3u8?s=53433233e4176eead03ddd6fea04d9fb2bce6637&oauth2_token_id=57447761"
    }
  ],
  "video_pictures": [
    {
      "id": 308178,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-0.jpg",
      "nr": 0
    },
    {
      "id": 308179,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-1.jpg",
      "nr": 1
    },
    {
      "id": 308180,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-2.jpg",
      "nr": 2
    },
    {
      "id": 308181,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-3.jpg",
      "nr": 3
    },
    {
      "id": 308182,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-4.jpg",
      "nr": 4
    },
    {
      "id": 308183,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-5.jpg",
      "nr": 5
    },
    {
      "id": 308184,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-6.jpg",
      "nr": 6
    },
    {
      "id": 308185,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-7.jpg",
      "nr": 7
    },
    {
      "id": 308186,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-8.jpg",
      "nr": 8
    },
    {
      "id": 308187,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-9.jpg",
      "nr": 9
    },
    {
      "id": 308188,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-10.jpg",
      "nr": 10
    },
    {
      "id": 308189,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-11.jpg",
      "nr": 11
    },
    {
      "id": 308190,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-12.jpg",
      "nr": 12
    },
    {
      "id": 308191,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-13.jpg",
      "nr": 13
    },
    {
      "id": 308192,
      "picture": "https://static-videos.pexels.com/videos/2499611/pictures/preview-14.jpg",
      "nr": 14
    }
  ]
}

Επισκόπηση

Οι Συλλογές Pexels είναι ένας τρόπος ομαδοποίησης συγκεκριμένων φωτογραφιών και βίντεο σε μία ενοποιημένη συλλογή. Αυτό μπορεί να είναι χρήσιμο εάν, για παράδειγμα, θέλετε να εκθέσετε ένα συγκεκριμένο υποσύνολο περιεχομένου Pexels στους χρήστες σας. Μπορείτε να αποκτήσετε πρόσβαση σε όλες τις συλλογές σας και τα μέσα που περιλαμβάνονται σε αυτές μέσω του API του Pexels.

Σημείωση: Δεν είναι δυνατή η δημιουργία ή τροποποίηση των συλλογών χρησιμοποιώντας το API του Pexels. Αντίθετα, μπορείτε να διαχειριστείτε τις συλλογές σας στον ιστότοπο ή στην εφαρμογή iOS ή Android του Pexels. Το API σάς δίνει πρόσβαση μόνο στις προτεινόμενες συλλογές και στις δικές σας συλλογές.

Ο πόρος συλλογών

Ο πόρος Collection είναι μια έκδοση συλλογής Pexels σε μορφή JSON. Τα τελικά σημεία API της λίστας της συλλογής ανταποκρίνονται στα δεδομένα της συλλογής που έχουν μορφοποιηθεί σε αυτό το σχήμα.

Απόκριση

Ο πόρος συλλογών
1
2
3
4
5
6
7
8
9
{
  "id": "8xntbhr",
  "title": "Hello Spring",
  "description": "Baby chicks, rabbits & pretty flowers. What's not to love?",
  "private": false,
  "media_count": 130,
  "photos_count": 121,
  "videos_count": 9
}

Οι συλλογές μου

GET https://api.pexels.com/v1/collections

Αυτό το τελικό σημείο επιστρέφει όλες τις συλλογές σας.

Παράμετροι

Απόκριση

Παράδειγμα αιτήματος
1
2
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/v1/collections?per_page=1"
Παράδειγμα απόκρισης
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
  "collections": [
    {
      "id": "9mp14cx",
      "title": "Cool Cats",
      "description": null,
      "private": false,
      "media_count": 6,
      "photos_count": 5,
      "videos_count": 1
    }
  ],

  "page": 2,
  "per_page": 1,
  "total_results": 5,
  "next_page": "https://api.pexels.com/v1/collections/?page=3&per_page=1",
  "prev_page": "https://api.pexels.com/v1/collections/?page=1&per_page=1"
}

Μέσα συλλογής

GET https://api.pexels.com/v1/collections/:id

Αυτό το τελικό σημείο επιστρέφει όλα τα μέσα (φωτογραφίες και βίντεο) σε μία μόνο συλλογή. Μπορείτε να φιλτράρετε για να λαμβάνετε μόνο φωτογραφίες ή βίντεο χρησιμοποιώντας την παράμετρο type.

Παράμετροι

Απόκριση

Παράδειγμα αιτήματος
1
2
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.pexels.com/v1/collections/9mp14cx?per_page=1&sort=desc"
Παράδειγμα απόκρισης
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
{
  "id": "9mp14cx",
  "media": [
    {
      "type": "Photo",
      "id": 2061057,
      "width": 4850,
      "height": 3224,
      "url": "https://www.pexels.com/photo/gray-and-white-kitten-on-white-bed-2061057/",
      "photographer": "Tranmautritam",
      "photographer_url": "https://www.pexels.com/@tranmautritam",
      "photographer_id": 8509,
      "avg_color": "#BBBEC3",
      "src": {
        "original": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg",
        "large2x": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&dpr=2&h=650&w=940",
        "large": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&h=650&w=940",
        "medium": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&h=350",
        "small": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&h=130",
        "portrait": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=1200&w=800",
        "landscape": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&fit=crop&h=627&w=1200",
        "tiny": "https://images.pexels.com/photos/2061057/pexels-photo-2061057.jpeg?auto=compress&cs=tinysrgb&dpr=1&fit=crop&h=200&w=280"
      },
      "liked": false
    },
    {
      "type": "Video",
      "id": 854982,
      "width": 1280,
      "height": 720,
      "duration": 11,
      "full_res": null,
      "tags": [],
      "url": "https://www.pexels.com/video/video-of-a-tabby-cat-854982/",
      "image": "https://images.pexels.com/videos/854982/free-video-854982.jpg?auto=compress&cs=tinysrgb&fit=crop&h=630&w=1200",
      "avg_color": null,
      "user": {
        "id": 2659,
        "name": "Pixabay",
        "url": "https://www.pexels.com/@pixabay"
      },
      "video_files": [
        {
          "id": 17755,
          "quality": "hd",
          "file_type": "video/mp4",
          "width": 1280,
          "height": 720,
          "link": "https://player.vimeo.com/external/199433617.hd.mp4?s=1770018c20604d41d60e4f574e7680a1bd15edb8&profile_id=174&oauth2_token_id=57447761"
        },
        {
          "id": 17756,
          "quality": "sd",
          "file_type": "video/mp4",
          "width": 640,
          "height": 360,
          "link": "https://player.vimeo.com/external/199433617.sd.mp4?s=457abd2452a52548b8c02c503a91035ce8a713f0&profile_id=164&oauth2_token_id=57447761"
        },
        {
          "id": 17757,
          "quality": "sd",
          "file_type": "video/mp4",
          "width": 960,
          "height": 540,
          "link": "https://player.vimeo.com/external/199433617.sd.mp4?s=457abd2452a52548b8c02c503a91035ce8a713f0&profile_id=165&oauth2_token_id=57447761"
        },
        {
          "id": 17758,
          "quality": "hls",
          "file_type": "video/mp4",
          "width": null,
          "height": null,
          "link": "https://player.vimeo.com/external/199433617.m3u8?s=115ec8875069ea6203ddca51dae78cebd934b86e&oauth2_token_id=57447761"
        }
      ],
      "video_pictures": [
        {
          "id": 19591,
          "nr": 0,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-0.jpg"
        },
        {
          "id": 19592,
          "nr": 1,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-1.jpg"
        },
        {
          "id": 19593,
          "nr": 2,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-2.jpg"
        },
        {
          "id": 19594,
          "nr": 3,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-3.jpg"
        },
        {
          "id": 19595,
          "nr": 4,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-4.jpg"
        },
        {
          "id": 19596,
          "nr": 5,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-5.jpg"
        },
        {
          "id": 19597,
          "nr": 6,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-6.jpg"
        },
        {
          "id": 19598,
          "nr": 7,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-7.jpg"
        },
        {
          "id": 19599,
          "nr": 8,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-8.jpg"
        },
        {
          "id": 19600,
          "nr": 9,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-9.jpg"
        },
        {
          "id": 19601,
          "nr": 10,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-10.jpg"
        },
        {
          "id": 19602,
          "nr": 11,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-11.jpg"
        },
        {
          "id": 19603,
          "nr": 12,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-12.jpg"
        },
        {
          "id": 19604,
          "nr": 13,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-13.jpg"
        },
        {
          "id": 19605,
          "nr": 14,
          "picture": "https://images.pexels.com/videos/854982/pictures/preview-14.jpg"
        }
      ]
    }
  ],
  "page": 2,
  "per_page": 2,
  "total_results": 6,
  "next_page": "https://api.pexels.com/v1/collections/9mp14cx/?page=3&per_page=2",
  "prev_page": "https://api.pexels.com/v1/collections/9mp14cx/?page=1&per_page=2"
}

Αρχείο καταγραφής αλλαγών

Είναι μια λίστα με τις σημαντικές αλλαγές στο API του Pexels.

22/11/2023

  • Added sort query parameter to the /collections/:id endpoint.

15/09/2022

  • Added video_file.fps attribute for the Video resource.

14/12/2021

  • Added alt attribute to the Photo resource.
  • Added previously-exposed liked attribute to the Photo responses.

13/09/2021

  • Updated image attribute for the Video resource to use the correct orientation.
  • Updated video_picture.picture attribute for the Video resource to use the correct orientation.

12/08/2021

  • Added Featured Collections endpoint.
  • Updated /collections/:id. Returns a collection if the collection is featured or belongs to the authenticated user.

19/04/2021

  • Added Collections resource and endpoints.

11/12/2020

  • Added avg_color attribute to the Photo resource.

12/11/2020

  • Added orientation, size and color filters to Photo Search.
  • Added orientation and size filters to Video Search.

28/05/2020

  • Initial version of this documentation.
Επιλογή γλώσσας: English Português Español Català Deutsch Italiano Français Svenska Bahasa Indonesia Polski 日本語 繁體中文 简体中文 한국어 ภาษาไทย Nederlands Magyar Tiếng Việt Čeština Dansk Suomi Українська Ελληνικά Română Norsk Slovenčina Türkçe Русский