LINE Notify API Document

2016­10­24 upload

2016­09­29

 

API API   OAuth2  LINE

1.  LINE2.   OAuth2 authorization endpoint 3. LINE4.   OAuth2 token endpoint 5. 6. ( )  API7. ( )  API8. ( )  API

OAuth2   URL OAuth2 

API( )  API( )  API

API

OAuth2 (https://tools.ietf.org/html/rfc6749)   authorization_code 

 API   notify­bot.line.me 

 

GET https://notify­bot.line.me/oauth/authorize

OAuth2   authorization endpoint URI 

/

Method GET

������������� "code" 

client_id string  OAuth  ID

redirect_uri uri URI

code  URI  https 

scope "notify" 

state string CSRF ID redirect_uri   state 

CSRF

LINE Notify   state   

response_mode string "form_post"   form post   redirect_uri   POST : https://openid.net/specs/oauth­v2­form­post­response­mode­1_0.html

 code 

http://arstechnica.com/security/2016/07/new­attack­that­cripples­https­crypto­works­on­macs­windows­and­linux/

 

 redirect_uri  POST

 

code string access token 

state string  state 

 

 redirect_uri 

����� string OAuth2https://tools.ietf.org/html/rfc6749#section­4.1.2 

state string  state 

error_description string OAuth2https://tools.ietf.org/html/rfc6749#section­4.1.2 

 

 

POST https://notify­bot.line.me/oauth/token

OAuth2   token endpoint  

/

Method POST

Content­Type ���������������������������������

grant_type "authorization_code" 

code string  code 

redirect_uri uri authorization endpoint API   redirect_uri 

client_id string  OAuth  ID

client_secret string  OAuth 

 

Status 200: 

400: 

: 

Content­Type application/json

JSON object

name type value description

access_token stringAPI

 

 

LINE  API  OAuth 

 API   notify­api.line.me 

 

 Authorization: Bearer <access_token>  RFC6750   401  WWW­Authenticate 

POST https://notify­api.line.me/api/notify

API  401   LINE Notify   ( ) 

 application/x­www­form­urlencoded (HTML )  POST 

 LINE 

/

Method POST

Content­Type ���������������������������������

��

�������������������

Authorization Bearer <access_token>

message String  1000

imageThumbnail HTTP/HTTPS URL   240×240px / JPEG 

imageFullsize HTTP/HTTPS URL  1024×1024px / JPEG 

imageFile File LINEpng, jpeg

imageThumbnail/imageFullsize imageFile

1 uploadAPI Rate Limit  

API

ref. https://developers.line.me/businessconnect/api­reference#sending_message

 

Status 200: 

400: 

401: 

500: 

: 

Content­Type application/json

JSON object

name type value description

status number HTTP 

200: 

400: 

401: 

message string

 

 

 

GET https://notify­api.line.me/api/status

API  API 

/api/notify   /api/revoke  API

API  401   LINE Notify   ( ) 

$ curl ‐X POST ‐H 'Authorization: Bearer <access_token>' ‐F 'message=foobar' \https://notify‐api.line.me/api/notify{"status":200,"message":"ok"}  $  curl ‐v ‐X POST ‐H 'Authorization: Bearer invalidtoken' ‐F 'message=foobar' \https://notify‐api.line.me/api/notify{"status":400,"message":"Invalid access token"}

LINE Notify  API

/

Method GET

Authorization Bearer <access_token>

JSON

Status 200: 

401: 

: 

Content­Type application/json

JSON object

name type value description

status number HTTP 

200: 

401: 

message string

targetType string  "USER"

 "GROUP"

target string null

 null

 

 

 

POST https://notify­api.line.me/api/revoke

API API API

1. /api/revoke 2. 1   200 3. 1   401 4.   ( )

 

LINE Notify  API

/  

$ curl ‐H 'Authorization: Bearer <access_token>' \https://notify‐api.line.me/api/status{"status":200,"message":"ok","target":"foobar"} $ curl ‐H 'Authorization: Bearer invalidtoken' \https://notify‐api.line.me/api/status{"status":400,"message":"Invalid access token"}

Method POST

Content­Type ���������������������������������

Authorization Bearer <access_token>

 

JSON

Status 200: 

401: 

: 

Content­Type application/json

JSON object

name type value description

status number HTTP 

200: 

401: 

message string

 

API Rate Limit1 API call

1000

access token

API Rate Limit status API response header

Header name Description

X­RateLimit­Limit 1 API call

X­RateLimit­Remaining

API call

X­RateLimit­ImageLimit

1 Image upload

X­RateLimit­ImageRemaining

Image upload

X­RateLimit­Reset  ( UTC epochseconds )

ex:1472195604

 

$ curl ‐X POST ‐H 'Authorization: Bearer <access_token>' \https://notify‐api.line.me/api/revoke{"status":200,"message":"ok"} $ curl ‐X POST ‐H 'Authorization: Bearer invalidtoken' \https://notify‐api.line.me/api/revoke{"status":400,"message":"Invalid access token"}