aboutsummaryrefslogtreecommitdiffstats
path: root/doc/old/nb-no/api_functions.md
blob: f385dee0204ddb6443ae62b1f77185befe158822 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
Red Twitter API
===============

Det "grunnleggende" Red web API-et er basert på Twitter API-et, siden dette gir umiddelbar samhandling med et stort antall tredjepartsklienter og programmer uten å kreve noen kodeendring hos disse. Det er også et super-set av StatusNet-versjonen av Twitter API-et, siden den også har bred eksisterende støtte.

Red har flere muligheter som ikke vises gjennom Twitter-grensesnittene, der vi tvinges til å gjøre API-funksjoner "dummere" for å kunne arbeide med den primitive kommunikasjons- og personvernmodellen i Twitter/StatusNet. Vi planlegger å utvide Twitter-API-et slik at Red-spesifikke klienter kan ta i bruk alle funksjoner i Red uten begrensninger.

Et dedikert Red API som samvirker med egne datastrukturer og tillatelser er under utvikling, og dette krever ikke oversettelse til andre personvern- og tillatelsesmodeller og lagringsformater. Denne vil bli beskrevet i andre dokumenter. Prefikset for alle egne endepunkter er 'api/red'.

Red tilbyr tilgang til flere kanaler via samme innloggingskonto. Med Red vil enhver API-funksjon som krever autentisering akseptere et parameter - &channel={channel_nickname} - og vil velge den kanalen og gjøre den gjeldende før utføring av API-kommandoen. Som standard er det standardkanalen i kontoen som velges.

Red tilbyr også en utvidet tillatelsesmodell. Grunnet fraværet av Red-spesifikke API kall til å angi tillatelser, så vil disse innstillingene bli satt til standardtillatelsene assosiert med den gjeldende kanalen.

Red vil antakelig aldri helt kunne støtte Twitter sine 'api/friendships' funksjoner, fordi Red er ikke et sosialt nettverk og har ikke innebygget noe konsept om "vennskap" - den gjenkjenner tillatelser til å gjøre ting (eller ikke gjøre ting hvis det er det som trengs).

Tegnforklaring: T= Twitter, S= StatusNet, F= Friendica, R= Red, ()=Virker ikke ennå, J= kun JSON (XML-formater er avlegs)



Twitter API kompatible funksjoner:

*	api/account/verify_credentials		T,S,F,R
*	api/statuses/update					T,S,F,R
*	api/users/show						T,S,F,R
*	api/statuses/home_timeline			T,S,F,R
*	api/statuses/friends_timeline		T,S,F,R
*	api/statuses/public_timeline		T,S,F,R
*	api/statuses/show					T,S,F,R
*	api/statuses/retweet				T,S,F,R
*	api/statuses/destroy				T,S,F,(R)
*	api/statuses/mentions				T,S,F,(R)
*	api/statuses/replies				T,S,F,(R)
*	api/statuses/user_timeline			T,S,F,(R)
*	api/favorites						T,S,F,(R)
*	api/account/rate_limit_status		T,S,F,R
*	api/help/test						T,S,F,R
*	api/statuses/friends				T,S,F,R
*	api/statuses/followers				T,S,F,R
*	api/friends/ids						T,S,F,R
*	api/followers/ids					T,S,F,R
*	api/direct_messages/new				T,S,F,(R)
*	api/direct_messages/conversation	T,S,F,(R)
*	api/direct_messages/all				T,S,F,(R)
*	api/direct_messages/sent			T,S,F,(R)
*	api/direct_messages					T,S,F,(R)
*	api/oauth/request_token				T,S,F,R
*	api/oauth/access_token				T,S,F,R


Twitter API funksjoner støttet av StatusNet men for øyeblikket ikke av Friendica eller Red

*	api/favorites						T,S
*	api/favorites/create				T,S
*	api/favorites/destroy				T,S
*	api/statuses/retweets_of_me			T,S
*	api/friendships/create				T,S
*	api/friendships/destroy				T,S
*	api/friendships/exists				T,S
*	api/friendships/show				T,S
*	api/account/update_location			T,S
*	api/account/update_profile_background_image			T,S
*	api/account/update_profile_image			T,S
*	api/blocks/create					T,S
*	api/blocks/destroy					T,S

Twitter API funksjoner som for øyeblikket ikke er støttet av StatusNet 

*	api/statuses/retweeted_to_me		T
*	api/statuses/retweeted_by_me		T
*	api/direct_messages/destroy			T
*	api/account/end_session				T,(R)
*	api/account/update_delivery_device	T
*	api/notifications/follow			T
*	api/notifications/leave				T
*	api/blocks/exists					T
*	api/blocks/blocking					T
*	api/lists							T


StatusNet kompatible utvidelser til Twitter API-et støttet av både Friendica og Red

*	api/statusnet/version				S,F,R
*	api/statusnet/config				S,F,R

Friendica API utvidelser til Twitter API-et støttet av både Friendica og Red

*	api/statuses/mediap					F,R


Red-spesifikke API utvidelser til Twitter API-et som ikke er støttet av Friendica

*	api/account/logout					R
*	api/export/basic					R,J
*	api/friendica/config				R
*	api/red/config						R
*	api/friendica/version				R
*	api/red/version						R

*   api/red/channel/export/basic        R,J
*   api/red/channel/stream              R,J (currently post only)
*   api/red/albums                      R,J
*   api/red/photos                      R,J (option album=xxxx)


Foreslåtte Red API utvidelser til Twitter API-et

*	api/statuses/edit					(R),J
*	api/statuses/permissions			(R),J
*	api/statuses/permissions/update		(R),J
*	api/statuses/ids					(R),J   # søk  etter eksisterende message_id før importering av fremmed innlegg
*	api/files/show						(R),J
*	api/files/destroy					(R),J
*	api/files/update					(R),J
*	api/files/permissions				(R),J
*	api/files/permissions/update		(R),J
*	api/pages/show						(R),J
*	api/pages/destroy					(R),J
*	api/pages/update					(R),J
*	api/pages/permissions				(R),J
*	api/pages/permissions/update		(R),J
*	api/events/show						(R),J
*	api/events/update					(R),J
*	api/events/permissions				(R),J
*	api/events/permissions/update		(R),J
*	api/events/destroy					(R),J
*	api/photos/show						(R),J
*	api/photos/update					(R),J
*	api/photos/permissions				(R),J
*	api/photos/permissions/update		(R),J
*	api/albums/destroy					(R),J
*	api/albums/show						(R),J
*	api/albums/update					(R),J
*	api/albums/permissions				(R),J
*	api/albums/permissions/update		(R),J
*	api/albums/destroy					(R),J
*	api/friends/permissions				(R),J