- Previous: pikeo.photos.setPrivacy
- Up: List of the Methods
- Next: Authentication Mechanism
pikeo.photos.upload
Upload one photo to the photo repository, assigning a title, an album, a visibility and associating tags.
Logged authentication is required.
Additional Parameters
| Type | Parameter | Required | Description |
|---|---|---|---|
| Base64 | picture | Yes | An array of bytes in base64 corresponding to the binary serialized photo |
| List | tags | No | A list of tags associated to the uploaded photo |
| Integer | access_type | No | The access type of the picture: 0 for PRIVATE, 2 for FRIEND, 4 for FAMILY, 6 for FRIEND AND FAMILY and 7 for PUBLIC - by default the picture is PUBLIC |
| String | title | No | Title associated to the photo |
| String | description | No | Description of the photo |
| Integer |
album_id |
No |
Id of the album to upload the photo |
| Double |
gps_latitude |
No |
GPS information for latitude |
| Double | gps_longitude | No |
GPS information for longitude |
Returns
The photo id of the picture uploaded.
REST
Call
When used with protocol REST, tags must be separated as below: tags=category:name1,category:name2,...
Where category can be: who, what or where. Only letters, figures and spaces are authorized in the name.
The following code represents the parameters of the HTTP POST request:
api_key=89e2b6457f20b8845213a8900644c0b1&nonce=NjE2NjE1MDQyNjczNTE1OTI1Mw%3D%3D×tamp=2010-03-02T17%3A16%3A34Z&api_sig=a%2Bh56TkDZzb6p8fgMNLNsp%2Fk%2Fsk%3D&login=nicolas&method=pikeo.photos.upload&access_type=6&title=Sky&description=A+nice+sky+picture&tags=what%3Aapi_what_tag%2Cwhere%3Aapi_where_tag%2Cwho%3Aapi_who_tag%2C&gps_latitude=4.616667&gps_longitude=55.45&picture=%2F9j%2F4AAQSkZJRgABAQAAAQABAAD%2F2wBDAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAd%0AHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys%2FRD84QzQ5Ojf%2F2wBDAQoKCg0MDRoPDxo3JR8lNzc3Nzc3%0ANzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzf%2FwAARCABrAI8DASIA%0AAhEBAxEB%2F8QAGwAAAwEBAQEBAAAAAAAAAAAAAwQFAgEGAAf%2FxAA7EAACAgAEAwQHBQYHAAAAAAAB%0AAgADBAURYSExUQYSE0EiMkJxgZGhBxVSwdEUQ3KDk%2BEjU2KCkpTS%2F8QAGgEAAwEBAQEAAAAAAAAA%0AAAAAAQIDAAQFBv%2FEACMRAAICAgEEAwEBAAAAAAAAAAABAgMREgQTMUFRISJhFDL%2F2gAMAwEAAhED%0AEQA%2FAPLBJta9oda4VK59weSLrXCiuMCqEWqYwutc2Ko0lW0IKtocmExVNeFHVpmhTtNkwj4W04ap%0AQ8HacNO0GTE41bTBqlI0zDU7TGJpr2mGrlJqdoJqtoUYmtXBvXKDV7QTpNkOCcyQTJtH2rgmr4wB%0AwU1rhkrm6018oxXXtE2NgGtUItMZrqhkqgcjYF0phBTrG0p2hhTtJuw2oiKZvwdo%2BKNpvwNpN2m1%0AJ3gbTho2lP8AZ9p8cPB1jakk07TDU7Ss1G0E1G0dWm1JRqgXq2lZ6doF6dpRWZNgkvVtAPVtKz07%0AReyrhH2DglPXANXKdlUA9U2wcHVwLoT4NrJr8dI7h6sYgAZ0s3K6GN11iNVJwnLuiuDNCsR6agGN%0A11idrrjNdYiymDU5XVDrTtCVVxlK9pzSmNoLrTCCjaNpTtDrRtIu0PTZP8DaZNO0qeBMtRFVwemS%0AWp2gXp2ld6Yu9UpG0Xpkp6oB69pUeuL2VzojYDQlvXF7KxpKdlcVtr4S6mDQl2JtF3SULUitix1M%0A2oxU415xypxPL1ZiPxcY2mYIw0JBE8x2M61BHqKmEbqYTzFGYogAB4e%2FWPU5mnD0ojtY6qTPSVFY%0A3XpPPU5lWdNGEfpx6cOIkZ3eysePku1IDG0qknDY5DpxEp0Xh%2BRnLO9Fv58LIfweEw9WkYXUjgYC%0A1%2B7zklyI57iKtN4FLU0iloAjF1w8zJ996jznTC%2BIXxmZsilhnLcSvWKW4lePpTpjeiT47O2uIpbY%0ANJm3EL1idt46yquEdJq14nY3GYfF1tr3XB0Oh0OukXsxC684%2FWEdZ%2BbLmF45XMPcZpM0xKHUXMfe%0A0aTAWkcRg9d6z%2BsImX3k%2Brgv%2BDRsr0Q%2BfYOvPMQOdhh%2Fvi5x6Vze7lNDK8Rr6mEI2QxhMru4A4bC%0AHcq36QYXobMvYGjNbK%2FUusX3MZVw3aS9dA2Ibh%2FpEFVlWo9PC4b4Bo0mUYcAd7C0%2FUfnBKEZd0NG%0AycezHsP2wsqYE2d4fwafnLGD%2B0KqkjxKLXHVSB9JBqyXCt61GHUfxH%2F1HKOzmAscDw8Px56OT%2Bc5%0ArOLS%2FwDSOuHIu7Jnp1%2B1HBgaDC3adTodPrA2faPhLBqa7QTtJY7K5UNfEFQHVbf7xW3s%2Fkw4Ko13%0AxAE51w%2BM%2ByY6sth8%2FBSu7eYV%2FVW0fCI29sqH107%2FAMojZkOVezr%2FANgfrF7Mgy8fvGH84S8eJSuw%0AJcy%2F8G37V1tyDQFnaVT1ib5JgB%2B8f%2BqItZlWBB4Paf5wllx4eDnfJs8jtnaIAcNZHzDPLnctRdau%0Avl3jp8pt8swv%2BbZ%2FUBitmV4cn0bm%2BLiUjTFE5XSYrhsxuovDq5AJ9LTzEpffat1iFmWIOTsfiIFs%0AvA9th74zrTEVjR6FE9%2FzhVq66%2FOKJjl%2FCYYY0fhMl9jZQ6lfD2vmYUUqeYb5mKJjR%2BGMJjVA4Axl%0AuH6hhhVJ4LDrgidNFX5GCTHDmFMYrzAA8R9IXKwKUDS5Xa%2Fmn1jlGU4jTTuVsOne0n1OYJ1%2Bkdqz%0AJepk5WWl4Qq8mfua5tP8Cn4sDMnJbF46ULp%2BERsZmN4K3M9jJb3FtKcCl%2BXN3dB4evXuj9JOswF6%0Aa%2BlWR07soW48kn0frE7cY58h85aMrfJCar8CVmEfz8Mf7YJsOPMr8v7xizEWHkQPhFbHc8309wlF%0AKXki1EFdTXyZl%2BKAxO3D1a6hx8BpGbOPtE%2FGKW1qfaMbP6I0AasK2qnQzLsw9tD79P0nWpXqYJ6h%0A1MzkDAJH90MrjhEFJ6w6k9YEgMfR4ZGiCE684ZCesdIGSijjrDJYOsnKx05wyk9YcGyUkuAh0xIH%0AKSVY6c5sMes2iGU2iv8Ate8y2KB85L7zdZwsesPTQeoyg2J3gmvETLHrMMT1m0QNmNG6Ca0RYk8e%0AMGzHrA4oGzDtYIJ7BAsx6wTE9YribIR7B1gWsGsGxOnODLsAQCdDzEXU2x%2F%2F2Q%3D%3D%0A (decoded: api_key=89e2b6457f20b8845213a8900644c0b1&nonce=NjE2NjE1MDQyNjczNTE1OTI1Mw==×tamp=2010-03-02T17:16:34Z&api_sig=a+h56TkDZzb6p8fgMNLNsp/k/sk=&login=nicolas&method=pikeo.photos.upload&access_type=6&title=Sky&description=A nice sky picture&tags=what:api_what_tag,where:api_where_tag,who:api_who_tag,&gps_latitude=4.616667&gps_longitude=55.45&picture=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)
Response
- <?xml version="1.0" encoding="UTF-8"?>
- <response>
- <value>8613234</value>
- </response>
XMLRPC
Call
Response
<?xml version="1.0"?>
<methodResponse>
<params>
<param>
<value>
<i4>8615367</i4>
</value>
</param>
</params>
</methodResponse>
<methodResponse>
<params>
<param>
<value>
<i4>8615367</i4>
</value>
</param>
</params>
</methodResponse>
nonce=NDQyNjI5NjQxMjY2NjI1MDQzMw%3D%3D×tamp=2010-03-02T17%3A07%3A50Z&api_key=89e2b6457f20b8845213a8900644c0b1&api_sig=t3JuIPrV6veuFx3fvCOIoFUnX4w%3D&login=nicolas&method=pikeo.photos.upload&access_type=6&title=Sky&description=A+nice+sky+picture&tags=what%3Aapi_what_tag%2Cwhere%3Aapi_where_tag%2Cwho%3Aapi_who_tag%2C&picture=%2F9j%2F4AAQSkZJRgABAQAAAQABAAD%2F2wBDAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAd%0AHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys%2FRD84QzQ5Ojf%2F2wBDAQoKCg0MDRoPDxo3JR8lNzc3Nzc3%0ANzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzf%2FwAARCABrAI8DASIA%0AAhEBAxEB%2F8QAGwAAAwEBAQEBAAAAAAAAAAAAAwQFAgEGAAf%2FxAA7EAACAgAEAwQHBQYHAAAAAAAB%0AAgADBAURYSExUQYSE0EiMkJxgZGhBxVSwdEUQ3KDk%2BEjU2KCkpTS%2F8QAGgEAAwEBAQEAAAAAAAAA%0AAAAAAQIDAAQFBv%2FEACMRAAICAgEEAwEBAAAAAAAAAAABAgMREgQTMUFRISJhFDL%2F2gAMAwEAAhED%0AEQA%2FAPLBJta9oda4VK59weSLrXCiuMCqEWqYwutc2Ko0lW0IKtocmExVNeFHVpmhTtNkwj4W04ap%0AQ8HacNO0GTE41bTBqlI0zDU7TGJpr2mGrlJqdoJqtoUYmtXBvXKDV7QTpNkOCcyQTJtH2rgmr4wB%0AwU1rhkrm6018oxXXtE2NgGtUItMZrqhkqgcjYF0phBTrG0p2hhTtJuw2oiKZvwdo%2BKNpvwNpN2m1%0AJ3gbTho2lP8AZ9p8cPB1jakk07TDU7Ss1G0E1G0dWm1JRqgXq2lZ6doF6dpRWZNgkvVtAPVtKz07%0AReyrhH2DglPXANXKdlUA9U2wcHVwLoT4NrJr8dI7h6sYgAZ0s3K6GN11iNVJwnLuiuDNCsR6agGN%0A11idrrjNdYiymDU5XVDrTtCVVxlK9pzSmNoLrTCCjaNpTtDrRtIu0PTZP8DaZNO0qeBMtRFVwemS%0AWp2gXp2ld6Yu9UpG0Xpkp6oB69pUeuL2VzojYDQlvXF7KxpKdlcVtr4S6mDQl2JtF3SULUitix1M%0A2oxU415xypxPL1ZiPxcY2mYIw0JBE8x2M61BHqKmEbqYTzFGYogAB4e%2FWPU5mnD0ojtY6qTPSVFY%0A3XpPPU5lWdNGEfpx6cOIkZ3eysePku1IDG0qknDY5DpxEp0Xh%2BRnLO9Fv58LIfweEw9WkYXUjgYC%0A1%2B7zklyI57iKtN4FLU0iloAjF1w8zJ996jznTC%2BIXxmZsilhnLcSvWKW4lePpTpjeiT47O2uIpbY%0ANJm3EL1idt46yquEdJq14nY3GYfF1tr3XB0Oh0OukXsxC684%2FWEdZ%2BbLmF45XMPcZpM0xKHUXMfe%0A0aTAWkcRg9d6z%2BsImX3k%2Brgv%2BDRsr0Q%2BfYOvPMQOdhh%2Fvi5x6Vze7lNDK8Rr6mEI2QxhMru4A4bC%0AHcq36QYXobMvYGjNbK%2FUusX3MZVw3aS9dA2Ibh%2FpEFVlWo9PC4b4Bo0mUYcAd7C0%2FUfnBKEZd0NG%0AycezHsP2wsqYE2d4fwafnLGD%2B0KqkjxKLXHVSB9JBqyXCt61GHUfxH%2F1HKOzmAscDw8Px56OT%2Bc5%0ArOLS%2FwDSOuHIu7Jnp1%2B1HBgaDC3adTodPrA2faPhLBqa7QTtJY7K5UNfEFQHVbf7xW3s%2Fkw4Ko13%0AxAE51w%2BM%2ByY6sth8%2FBSu7eYV%2FVW0fCI29sqH107%2FAMojZkOVezr%2FANgfrF7Mgy8fvGH84S8eJSuw%0AJcy%2F8G37V1tyDQFnaVT1ib5JgB%2B8f%2BqItZlWBB4Paf5wllx4eDnfJs8jtnaIAcNZHzDPLnctRdau%0Avl3jp8pt8swv%2BbZ%2FUBitmV4cn0bm%2BLiUjTFE5XSYrhsxuovDq5AJ9LTzEpffat1iFmWIOTsfiIFs%0AvA9th74zrTEVjR6FE9%2FzhVq66%2FOKJjl%2FCYYY0fhMl9jZQ6lfD2vmYUUqeYb5mKJjR%2BGMJjVA4Axl%0AuH6hhhVJ4LDrgidNFX5GCTHDmFMYrzAA8R9IXKwKUDS5Xa%2Fmn1jlGU4jTTuVsOne0n1OYJ1%2Bkdqz%0AJepk5WWl4Qq8mfua5tP8Cn4sDMnJbF46ULp%2BERsZmN4K3M9jJb3FtKcCl%2BXN3dB4evXuj9JOswF6%0Aa%2BlWR07soW48kn0frE7cY58h85aMrfJCar8CVmEfz8Mf7YJsOPMr8v7xizEWHkQPhFbHc8309wlF%0AKXki1EFdTXyZl%2BKAxO3D1a6hx8BpGbOPtE%2FGKW1qfaMbP6I0AasK2qnQzLsw9tD79P0nWpXqYJ6h%0A1MzkDAJH90MrjhEFJ6w6k9YEgMfR4ZGiCE684ZCesdIGSijjrDJYOsnKx05wyk9YcGyUkuAh0xIH%0AKSVY6c5sMes2iGU2iv8Ate8y2KB85L7zdZwsesPTQeoyg2J3gmvETLHrMMT1m0QNmNG6Ca0RYk8e%0AMGzHrA4oGzDtYIJ7BAsx6wTE9YribIR7B1gWsGsGxOnODLsAQCdDzEXU2x%2F%2F2Q%3D%3D%0A
- Previous: pikeo.photos.setPrivacy
- Up: List of the Methods
- Next: Authentication Mechanism
Docs Navigation
- Home
- API
- pikeo test echo
- pikeo test version
- pikeo test login
- pikeo albums getInfo
- pikeo albums getList
- pikeo albums getPhotos
- pikeo comments addComment
- pikeo comments deleteComment
- pikeo comments getList
- pikeo comments getMyCommentedPhotos
- pikeo comments getPicturesCommentedByMe
- pikeo comments updateComment
- pikeo contacts getList
- pikeo groups addPhotos
- pikeo groups findByName
- pikeo groups getInfo
- pikeo groups getList
- pikeo groups getMembers
- pikeo groups getPhotos
- pikeo groups removePhotos
- pikeo groups search
- pikeo people findByUsername
- pikeo people getInfo
- pikeo people getMyInfo
- pikeo people getPublicPhotos
- pikeo photos addTags
- pikeo photos getContactsPublicPhotos
- pikeo photos getInfo
- pikeo photos getMostViewed
- pikeo photos getUserPhotos
- pikeo photos search
- pikeo photos setMeta
- pikeo photos setPrivacy
- pikeo photos upload
- Authentication
- PictureURL
- Errors
- phpApiKit
- javaApiKit
- DTO

Comments
New comments are not being accepted at this time.