rest apis for partners. what's the catch when applying best practices?
DESCRIPTION
Talk a Nordic API Platform Summit 2014. See the video on https://www.youtube.com/watch?v=qjTUpLMN2DU&index=6&list=PLd2MPdlXKO1145w18Zdt1YqF4_qNYoBDPTRANSCRIPT
![Page 1: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/1.jpg)
REST APIs for partnersApplying best practices
![Page 2: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/2.jpg)
![Page 3: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/3.jpg)
![Page 4: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/4.jpg)
Helping clients enable e-commerce
![Page 5: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/5.jpg)
Warehouse
Payments
Delivery
Clients
ERP
Shop frontend
![Page 6: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/6.jpg)
REST API
Warehouse
Payments
Delivery
ERP
Shop frontend
Clients x5
![Page 7: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/7.jpg)
Private API
Small amount of integrations
Huge impact
No public support
No excitement
![Page 8: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/8.jpg)
API is evil
Ph
oto
Cre
dit
: sc
rag
zh
ttp
s://
ww
w.fli
ckr.
com
/ph
oto
s/2
72
61
72
0@
N0
0/1
32
75
07
28
/
![Page 9: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/9.jpg)
Make it smooth
Ph
oto
Cre
dit
: Ela
deM
anu
htt
ps:
//w
ww
.fli
ckr.
com
/ph
oto
s/2
41
41
54
6@
N0
6/9
12
42
53
70
7
![Page 10: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/10.jpg)
Fix processes
Integration is all over the place
Integrate orders List goods
Integrate goods
Integrate orders
List goods
Integrate goods
time
time
Set up correct processes
![Page 11: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/11.jpg)
Have a ready project for them
Data gathering
Business processes
API endpoints
Errors and handling
Communication plan
Acceptance process
![Page 12: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/12.jpg)
Use cases, not tools
Ph
oto
Cre
dit
: sg
race
htt
ps:
//w
ww
.fli
ckr.
com
/ph
oto
s/7
60
45
48
@N
07
/46
74
44
43
8/
![Page 13: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/13.jpg)
Tools focused
![Page 14: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/14.jpg)
Use-case focused
This is an API for …
Adding order
To add an order first make sure you have SKUs uploaded then show user a delivery prompt. Thenadd the order with selected goods and a delivery method.
Showing a delivery prompt
To show delivery prompt…
![Page 15: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/15.jpg)
Ph
oto
Cre
dit
: A
lmaz
UK
htt
ps:
//w
ww
.fli
ckr.
com
/ph
oto
s/8
86
90
29
@N
03
/35
64
24
43
82
/
![Page 16: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/16.jpg)
Log their input and errors
URLs
Request bodies
Errors
![Page 17: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/17.jpg)
Have an integration table
Client 1 Client 2 Client 3
Orders create + + +
Orders read - - +
Goods create + + -
Goods read - - -
![Page 18: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/18.jpg)
Break compatibility
Ph
oto
Cre
dit
: Je
sus
Sola
na
htt
ps:
//w
ww
.fli
ckr.
com
/ph
oto
s/6
50
69
06
7@
N0
0/6
40
69
83
89
1/
![Page 19: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/19.jpg)
Sale it then build it
Ph
oto
Cre
dit
: Je
sus
Sola
na
htt
ps:
//w
ww
.fli
ckr.
com
/ph
oto
s/6
50
69
06
7@
N0
0/6
40
69
83
89
1/
![Page 20: REST APIs for partners. What's the catch when applying best practices?](https://reader034.vdocuments.us/reader034/viewer/2022051817/547e7b49b4af9fef158b563e/html5/thumbnails/20.jpg)
Do their work
Have integration plan
Have testing plan
Log religiously
Watch their usage
Avoid building till needed
Negotiate change