api_access(비교)

[[분류:the seed/권한]]

[include(틀:the seed/권한)]

[목차]

== 개요 ==

the seed 엔진에서 존재하는 권한 중 하나이다.

기존 방식의 자동 편집이 불가능해지고 api를 통해 자동 편집할 수 있게 되었는데 이때 api를 사용하기 위해서 필수적으로 필요한 권한이 api_access이다.

[[https://doc.theseed.io/]]에서 사용 방법을 확인할 수 있다.

== 방법 ==

1. 사용자가 요청하면 JSON으로 반환하게 된다.

2. API_TOKEN[* 'Authorization': 'Bearer API_TOKEN'의 API_TOKEN[br] 이때, Bearer는 제거하면 안된다.]에는 [[https://theseed.io/member/mypage|내 정보]]의 API Token[* 유출되지 않도록 유의해야한다.] 발급 버튼을 눌러 자신의 계정 비밀번호를 입력한 뒤 나오는 token값을 적으면 된다.

=== python ===

==== 편집 시작 ====

{{{#!syntax python

import requests

headers = {

'Authorization': 'Bearer API_TOKEN',

}

requests.get('https://theseed.io/api/edit/%EB%8D%94%EC%83%88%EB%93%9C%EC%9C%84%ED%82%A4', headers=headers)

}}}

===== 결과 =====

||{

"text": "\[[분류:더새드위키]]\\n[include\(틀:더새드위키)]\\n|\|<-2><table align=right><:><#fedcba>''\'{{\{#black 더새드위키[br]The Sad Wiki}}}''\' |\|\\n|\|<:><#fedcba>''\'{{\{#black 개설 일자}}}''\' |\|<#FFFFFF> 2021년 1월 25일[\* \[[더새드위키:가짜규칙]] 문서가 처음 \\"차단회피\\"라는 문서명으로 생성되고 더새드위키:가짜규칙 문서명으로 이동된 날짜 기준] |\|\\n|\|<:><#fedcba>''\'{{\{#black 대표색}}}''\' |\|<#FFFFFF> {{\{#!wiki style=\\"display: inline; background: #fedcba; border-radius: 3px; padding: 3px 4px\\"\\n{{\{#000000 ''\'살구색''\' {{\{-2 (#fedcba)}}}}}}}}}[\* 알파위키의 대표색인 #abcdef를 거꾸로 한 것이다.] |\|\\n|\|<:><#fedcba>''\'{{\{#black 언어}}}''\' |\|<#FFFFFF> 한국어 |\|\\n|\|<:><#fedcba>''\'{{\{#black 위키 엔진}}}''\' |\|<#FFFFFF> the seed |\|\\n|\|<:><#fedcba>''\'{{\{#black 라이선스}}}''\' |\|<#FFFFFF> CC BY-SA 4.0 |\|\\n|\|<:><#fedcba>''\'{{\{#black 창립자}}}''\' |\|<#FFFFFF> \[[사용자:maca|maca]] |\|\\n|\|<:><#fedcba>''\'{{\{#black 소유자}}}''\' |\|<#FFFFFF> \[[사용자:maca|maca]] |\|\\n|\|<:><#fedcba>''\'{{\{#black 사무관}}}''\' |\|<#FFFFFF> \[[사용자:maca|maca]] |\|\\n|\|<:><#fedcba>''\'{{\{#black 상임 관리자}}}''\' |\|<#FFFFFF> \[[사용자:maca|maca]][\*+], \[[사용자:Blank|Blank]] |\|\\n|\|<:><#fedcba>''\'{{\{#black 운영관리관}}}''\' |\|<#FFFFFF> \[[사용자:maca|maca]], \[[사용자:Blank|Blank]] |\|\\n|\|<:><#fedcba>''\'{{\{#black 관리자}}}''\' |\|<#FFFFFF> \[[사용자:chodyyy|chodyyy]] |\|\\n\[목차]\\n= 개요 =\\n>우리 모두가 창조해 나가는 가상의 위키, 더새드위키\\n>-\--\-\\n>더새드위키의 슬로건\\n2021년 1월 25일 더시드위키에서 만들어진 더시드위키 내 가상의 위키이다. -\-더시드위키의 식민지다.-\- 실제로 있는 위키는 아니다.\\n\\n= 트리비아 =\\n * 번역하면 슬픈(sad) 위키라고 한다.\\n * 네이버에 더새드위키라고 검색하면 더샌드위치(...)로 나온다.\\n\[각주]",

"exists": true,

"token": "Gg1GLvxEks+V3rS30qa2oelNP2VNxrGWC2HLKtBmH21/xoWCHpEdRbZ5liNh7IWI"

}

||

==== 편집 제출 ====

* 이곳의 token에는 편집 시작에서 JSON으로 받은 token값을 입력하면 된다.

{{{#!syntax python

import requests

import json

headers = {

'Content-Type': 'application/json',

'Authorization': 'Bearer API_TOKEN',

}

data = {

'text': 'Hello, world', #수정할 내용

'log': '', #자동 편집 시 남길 편집 요약

'token': received_token #편집 시작 시 받은 token

}

response = requests.post('https://theseed.io/api/edit/%EB%8D%94%EC%83%88%EB%93%9C%EC%9C%84%ED%82%A4', headers=headers, data=json.dumps(data))

}}}

===== 결과 =====

{{{#!syntax json

{

"status":"success",

"rev":28

}

}}}

==== 역링크 조회 ====

{{{#!syntax python

import requests

headers = {

'Content-Type': 'application/json',

'Authorization': 'Bearer API_TOKEN',

}

response = requests.get('https://theseed.io/api/backlink/%EB%8D%94%EC%83%88%EB%93%9C%EC%9C%84%ED%82%A4', headers=headers)

}}}

===== 결과 =====

{{{#!syntax json

{

"namespaces":[

{"namespace":"문서","count":6},

{"namespace":"틀","count":5},

{"namespace":"분류","count":1}

],

"backlinks":[

{"document":"Thesadwiki","flags":"redirect"},

{"document":"thesadwiki","flags":"redirect"},

{"document":"더새드위키:sad스킨","flags":"link"},

{"document":"더새드위키:권한 요청","flags":"link"},

{"document":"슬픈 위키","flags":"redirect"},

{"document":"위키 등급분류","flags":"link"}

],

"from":null,

"until":null

}

}}}