Undocumented Features & Inconsistencies

[pascalfree]

Hi

I recently found, that some API functions behave differently than documented. Some of the inconsistencies may be minor, but I listed them anyway for completeness. The (imo) more important problems have a bold font in the description.

These are the inconsistencies that I've found:

posts/delete

Description	API docs	real
delete by md5 hash	not documented	?md5=...

posts/all

Description	API docs	real
privacy status	not documented	redundant: private="no" shared="yes"
empty attributes	are ommited in example	extended=""

posts/add

Description	API docs	real
Description argument	required	optional

posts/get

Description	API docs	real
others attribute in response	yes in example	no
undocumented keys in attributes of <posts>	none	bookmark_key="some_hash" inbox_key="some_other_hash" network_key="more_hash"
privacy status	not documented	redundant: private="no" shared="yes"

posts/recent

Description	API docs	real
privacy status	not documented	redundant: private="no" shared="yes"

posts/update [FIXED]

Description	API docs	real
Response for empty inbox	inboxnew="0"	inboxnew=""
Undocumented attributes in response	-	code="200" message="success"

posts/dates

Description	API docs	real
tag(s) attr. in <dates>	tag=	tags=

[dlo]

@pascalfree thank you so much for writing this. Super helpful.

🍻

[jamesxv7]

I had problems using the URL mentioned in the documentation for API calls in my PHP code, https://delicious.com/<API_URL>. Every time I use the URL mentioned in the documentation I receive a 302 HTTP code (I'm not sure if this is related to PHP's CURL functions...). Using https://api.del.icio.us/<API_URL> resolve the issue.

[peoplemerge]

Pull requests are welcome!

[jamesxv7]

@peoplemerge Count on it!

[jamesxv7]

PR created with minors modifications to documentation.

[peoplemerge]

thanks