Top Banner
Welcome to apidd.com Participation in Shop and Share model presented by Elixir Software Co., Ltd. 1
64

Participation in Shop and Share model with apidd.com

May 15, 2015

Download

Technology

apidd

Welcome to apidd.com.
Participation in Shop and Share model
Welcome message from author
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Page 1: Participation in Shop and Share model with apidd.com

1

Welcome to apidd.com Participation in Shop

and Share model

presented by Elixir Software Co., Ltd.

Page 2: Participation in Shop and Share model with apidd.com

2

Welcome to apidd.com

Page 3: Participation in Shop and Share model with apidd.com

3

Search API

1. Type keyword in to search box

to search API

2. Click “Search” to

search API with specify keyword

Click “Explore” to view all API

Page 4: Participation in Shop and Share model with apidd.com

4

Explore

Click at API name to

explore API information

Click “go” to search API with specify keyword

Click to show APIs

in the specify

category

Filter API results by

specify features

Display API overview

Page 5: Participation in Shop and Share model with apidd.com

5

API Overview - DocumentationAPI

Information

Display View, Test,

Download, Consume, and

Follow Statistic

API Status

API Endpoint Information

PHP Client Library for calling API

Endpoint Parameters

Test API call

Page 6: Participation in Shop and Share model with apidd.com

6

API Overview – Getting Start

Follow API to receive update

information

Getting startinformation

Link to more information on

provider website

Page 7: Participation in Shop and Share model with apidd.com

7

API Overview – Getting Terms&Conditions

Follow API to receive update

information

Terms and Conditionsfor API use

Link to more information on

provider website

Page 8: Participation in Shop and Share model with apidd.com

8

API Overview – Issue

Add new issue

Open Issues:Issue that approved but still not have answer from provider

Close Issues:Issue that already answered from provider

Page 9: Participation in Shop and Share model with apidd.com

9

API Overview - Status

Current status of API

service health

Current Uptime

and Latency

API service health graph

report of latency rate

Weekly report of

API service health

Page 10: Participation in Shop and Share model with apidd.com

10

User Profile

API list partition by published, consumed and follow

Current user activities

Show user profile and the gallery of showcase on the

right

Page 11: Participation in Shop and Share model with apidd.com

11

API Test Endpoint

Page 12: Participation in Shop and Share model with apidd.com

12

API Overview – Test Endpoint

Endpoint Description

Endpoint Name

1. Input testing data to the

input parameters

2. Click “Test” button to test

API call

Input parameters (Required/Optiona

l)

Page 13: Participation in Shop and Share model with apidd.com

13

API Overview – Test Endpoint

Endpoint Description

Endpoint Name

3. response from API call will

display in first tab

Page 14: Participation in Shop and Share model with apidd.com

14

Account Registration

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 15: Participation in Shop and Share model with apidd.com

15

APIDD Website Login / Register

Search API

API Display

Shortcut to Menu

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 16: Participation in Shop and Share model with apidd.com

16

+Join Us(1)1. Click “Join

Us”to register

2. Fill in all required information. * is required

Hint / Information

3. Check availabilitydisplay name.

4. Click “Register” button to register account

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 17: Participation in Shop and Share model with apidd.com

17

+Join Us(2)

5. System will send email to activate the account. Click activate link inside email to confirm email and activate account.

6. When account is activated, system will rlogin and redirect to user dashboard.

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 18: Participation in Shop and Share model with apidd.com

18

Account Management

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 19: Participation in Shop and Share model with apidd.com

19

Login 1. Login to ApiDD

website

2. Fill in email that you

registered to Username3. Fill in your

password

4 Click “Login” to login ApiDD

Website

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 20: Participation in Shop and Share model with apidd.com

20

Main Menu

Show overview

data

Manage the

production key

Manage your APIs

Manage showcase of

the website/system that using

our API

Setup your

profile data

After login, move a mouse under the header.

The main menu will appear as image below.

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 21: Participation in Shop and Share model with apidd.com

21

Dashboard

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 22: Participation in Shop and Share model with apidd.com

22

Dashboard

Key for testing API

List of your APIs

List of your showcases

Recent activities

Click “Setting” button to edit showcase’s detail.

Click “API Console” button to view showcase page.

Click “Edit Document” button to edit API’s detail.

Click “API Console” button to view API page.

Click “View More

Activity” to view more

recent activity

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 23: Participation in Shop and Share model with apidd.com

23

Key - Store

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 24: Participation in Shop and Share model with apidd.com

24

Key-Store – Create Production Key

Key for test API

List of production key

1. Input URL or Application

name that will using API

2. Click “Create Key” to create production key

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 25: Participation in Shop and Share model with apidd.com

25

API Management

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 26: Participation in Shop and Share model with apidd.com

26

API Management

API Information Display View, Test, Download, Consume, and Follow Statistic

Click “Usage” button to view the

usage of API

Click “Edit Document” button to edit API’s detail

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 27: Participation in Shop and Share model with apidd.com

27

API Management - Usage

Sub menu of the usage

Hover on the graph to view the detail.

1. Click “Usage” button to view usage

of API

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 28: Participation in Shop and Share model with apidd.com

28

Showcase Management

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 29: Participation in Shop and Share model with apidd.com

29

Showcase Management

The showcase will appear after create production key already Click “Edit Document”

button to edit showcase

Click “Usage” button to view the

usage of API

Display View, Test, Download, Consume, and Follow Statistic

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 30: Participation in Shop and Share model with apidd.com

30

Showcase Management - View

Showcase’s detailShowcase’s image

Display View, Test,

Download, Consume, and Follow Statistic

1. Click on the showcase’s name

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 31: Participation in Shop and Share model with apidd.com

31

Account Setting

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 32: Participation in Shop and Share model with apidd.com

32

Account Setting - Profile Setting

1. Complete the form

2. Click “Upload Image”

button to upload image

Click “View Profile Page” button to view User’s profile that public to

everyone

3. Click “Save Setting” button to save

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 33: Participation in Shop and Share model with apidd.com

33

Account Setting - Account Setting

1. Complete the form

Change Email

Change Password

2. Click “Save Setting” button to

save

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 34: Participation in Shop and Share model with apidd.com

34

Account Setting - Notification1. Select Off/On of

each notification

2. Click “Save Setting” button to save

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 35: Participation in Shop and Share model with apidd.com

35

Add API to ApiDD

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 36: Participation in Shop and Share model with apidd.com

36

Add API – 1. Register

Show all steps of API registration

1 Click “Add an API”

2 Click “Upload image”

to upload API icon (recommend 150x80 px)

3. Fill in API Information

Choose category: Tools

or DataChoose service

protocol: REST or SOAP

Set email notification and API publication

4 click “Add API”

to save data

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 37: Participation in Shop and Share model with apidd.com

37

Add API – 2. Getting Start

1 Fill in the definition, usage, and instruction of API

2 Fill in URL or website for more information.

3 Choose to show/hide this information to consumer

4 Click “Save” to save data

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 38: Participation in Shop and Share model with apidd.com

38

Add API – 3. Term & Condition

1 Fill in terms and conditions of using API

2 Fill in URL or website for more information.

3 Choose to show/hide this information to consumer

4 Click “Save” to save data

You can choose template from example

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 39: Participation in Shop and Share model with apidd.com

39

Add API – 4. Base URLBase URL is the located URL of service

1 Fill in base name 2 Fill in base URL

You can add multiple URL for your service

3 Click “Save” to save data

You can add multiple base by click “Add Base URL”

You can add multiple URL by click “Add URL”

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 40: Participation in Shop and Share model with apidd.com

40

Add API – 7. Endpoints (1)Endpoint is service of API including protocol, route, response, error, and parameters

All endpoints show here

Add new endpoint, click “Add”

Base URL (from created list of Base URL)

Protocol (POST/GET)

1 Fill in Endpoint information

Route/Path to call API

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 41: Participation in Shop and Share model with apidd.com

41

Add API – 7. Endpoints (2)

2 Setup successful Response

3 Setup error Response

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 42: Participation in Shop and Share model with apidd.com

42

Add API – 7. Endpoints (3)4 Setup input parameters

Check optional if allow no input to parameter

Check hidden if do not allow user to see parameter

Show full HTTP route

Show ApiDD key of this API

3 Click “Save” or “Finish” to save data

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 43: Participation in Shop and Share model with apidd.com

43

Add API – 5. Namespace (for SOAP)Namespace use in defined new model for SOAP

method

1 Fill in Namespace URL and description

2 Click “Save” to save data

You can add multiple namespace by click “Add Namespace”

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 44: Participation in Shop and Share model with apidd.com

44

Add API – 6. Models (Optional)Model is customize type of parameter that you defined for using in endpoint.

All models show here

Add new model, click “Add”

1 Fill in model information

2 Choose parameter type. If you have multiple type, choose “Model”

You can add multiple parameter type in one model

3 Click “Save” to save data

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 45: Participation in Shop and Share model with apidd.com

45

API Overview - DocumentationAPI

Information

Display View, Test,

Download, Consume, and

Follow Statistic

API Status

API Endpoint Information

PHP Client Library for calling API

Endpoint Parameters

Test API call

After finish, you will lead to Test Console

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 46: Participation in Shop and Share model with apidd.com

46

API Client Library(How to use API in your application)

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 47: Participation in Shop and Share model with apidd.com

47

Login 1. Login to ApiDD

website

2. Fill in email that you

registered to Username3. Fill in your

password

4 Click “Login” to login ApiDD

Website

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 48: Participation in Shop and Share model with apidd.com

48

Dashboard – Create Key-Store

1 Click “Key-Store” to

generate key for application

Page 49: Participation in Shop and Share model with apidd.com

49

Dashboard – Create Key-Store

2 Fill in website or application

name and description that

will use API

“Key-Store” use for authorizing between your application and called API

3 Click “Create Key” to generate Key-

Store

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 50: Participation in Shop and Share model with apidd.com

50

Dashboard – Create Key-Store

4 system will generate key for your website/application

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 51: Participation in Shop and Share model with apidd.com

51

API Overview – Download Library Code

5 Click “Explore” to view API

6 Choose API that you want to use

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 52: Participation in Shop and Share model with apidd.com

52

API Overview – Download Library Code

8 Click “PHP” to download client

library

7 Choose your registered website/

application

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 53: Participation in Shop and Share model with apidd.com

53

API Overview – Apply Code to Your Web

9. Extract download file, you will get lib folder and service in PHP

code

Inside Thai_SoundexService.php

Page 54: Participation in Shop and Share model with apidd.com

54

API Overview – Apply Code to Your Web

input parameters of API function

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 55: Participation in Shop and Share model with apidd.com

55

API Overview – Apply Code to Your WebThai_SoundexService.p

hp(download file)

process.php (your

website/application)

include download file

input parameter value

new class

call function

display output resultfrom API

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 56: Participation in Shop and Share model with apidd.com

56

API Overview – Output from APIprocess.php output from API (JSON format)

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 57: Participation in Shop and Share model with apidd.com

57

Showcase(Display your website on ApiDD)

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 58: Participation in Shop and Share model with apidd.com

58

Showcase – Display your website

You can post your website information on ApiDD to

publish your web

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 59: Participation in Shop and Share model with apidd.com

59

Showcase – Display your website

Your website will display as showcase in ApiDD

Viewer can link to your website

Show No. of Viewer

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 60: Participation in Shop and Share model with apidd.com

60

Showcase Management

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 61: Participation in Shop and Share model with apidd.com

61

Login 1. Login to ApiDD

website

2. Fill in email that you

registered to Username3. Fill in your

password

4 Click “Login” to login ApiDD

Website

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 62: Participation in Shop and Share model with apidd.com

62

Dashboard – Create Key-Store

1 Click “Key-Store” to setup your

website information

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 63: Participation in Shop and Share model with apidd.com

63

Key-Store

2 Click “Edit Document” on website

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)

Page 64: Participation in Shop and Share model with apidd.com

64

Showcase Management – Edit Document3 Fill in all information

4 Upload website Interface

6 Click “save” to record data

5 Set “public” to show in ApiDD showcase

งาน Digitized Thailand เปิ�ดตัว Digital Platform สำ าหรับนกพัฒนา software service พัรั�อมเปิ�ดตัวเพั��อการัปิรัะยุ�กตั�ใช้�งานจรั งใน Thailand One Click (T1C)