[ANNOUNCE] Provisional Users API

3,648 views
Skip to first unread message

Matt Graham

unread,
Nov 27, 2013, 8:29:57 PM11/27/13
to Etsy API V2
Hello,
Here are the first real API calls in the v3 API. They are for managing your applications provisional users. Applications that don't need or don't yet have Full Access can, by default, authenticate only for the user who owns the application. It was possible to add additional users, "Provisional Users", but required emailing us and we would do it manually. Now this is available to application developers to do directly via the Provisional Users API calls. Here are the 3 calls:

Prefix all paths with https://openapi.etsy.com/v3/
Also submit your API key in the "x-api-key" header.

Application_ProvisionalUsers_Get

GET application/provisional-users

Returns all provisional users currently added for your application. Initially, this will be an empty list, []. This list does not include the user who owns the application, so seeing an empty list does not indicate that you can no longer authenticate as the application owner.

Application_ProvisionalUsers_Add

POST application/provisional-users/:user_id

Submit this request as a POST, and replace :user_id with the login name or ID of the user you would like to add as a provisional user. Once this user is added, your provisional application will be able to authenticate this user via OAuth. Note that this call only works for applications that do not yet have full access.

Application_ProvisionalUsers_Remove

DELETE application/provisional-users/:user_id

Submit this with the DELETE method, and again, replace :user_id with the login_name or ID of the user you would like to remove as a provisional user.

Please let me know if you have any questions about these methods or notice any unexpected behavior.

Thanks,
Matt

Graeme Grant

unread,
Nov 27, 2013, 8:36:04 PM11/27/13
to EtsyAPI Forum
Hi Matt,
 
As a suggestion, for those who are going to be taking part in the V3 BETA and those who are not, can you please identify in the Subject line whether the post is for V2 or V3 API  - this will make it easy for us to filter.
 
Thanks,
 
G.

 

Date: Wed, 27 Nov 2013 20:29:57 -0500
Subject: [ANNOUNCE] Provisional Users API
From: mgr...@etsy.com
To: etsy-...@googlegroups.com
--
You received this message because you are subscribed to the Google Groups "Etsy API" group.
To unsubscribe from this group and stop receiving emails from it, send an email to etsy-api-v2...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.
Reply all
Reply to author
Forward
0 new messages