For programmers
SILK uses OAuth 2.0 with the authorization code flow and PKCE (S256), the same flow X, Google and GitHub use, so existing OAuth libraries work. Exchange codes from your server, never from a browser: SILK's endpoints don't allow cross-site browser calls.
Share links (no app needed)
Like Facebook's share link and X's post link: send visitors to a network site with the link filled in. If they're signed out, they sign in first. Nothing is posted until they press Post.
<a href="https://pinitin.com/share?url=https%3A%2F%2Fexample.com%2Fstory&title=Great%20story">Share on PinItIn</a>
<a href="https://eatdrama.com/share?url=https%3A%2F%2Fexample.com%2Fstory&text=You%20have%20to%20see%20this">Share on EatDrama</a>
| Field | What it does |
|---|---|
url | The link to share (required). Tracking bits like utm_ are removed. |
title | A title to start with. Without one, the site reads the page's own title. |
text | Words to start the post with (up to 500 characters). The member can change them. |
tags | Up to 5 tags, separated by commas. |
via | Your site's short name, kept with the share. |
popup=1 | For a small window: it says "Posted" and closes itself. |
To open it in a small window: window.open(link, 'share', 'width=560,height=640').
Addresses
| What | Address |
|---|---|
| Allow page (send the member here) | https://spidertaz.com/silk/authorize |
| Passes (POST, from your server) | https://spidertaz.com/silk/token |
| Stop a pass (POST) | https://spidertaz.com/silk/revoke |
| Member profile (GET) | https://spidertaz.com/silk/me |
The flow
- Make a code verifier: 43 to 128 random characters from
A-Z a-z 0-9 - . _ ~. Keep it on your server for this sign-in. The challenge isBASE64URL(SHA256(verifier))without padding. - Send the member to the Allow page:
https://spidertaz.com/silk/authorize?response_type=code &client_id=YOUR_CLIENT_ID &redirect_uri=https%3A%2F%2Fexample.com%2Fsilk%2Fcallback &scope=profile.read &state=RANDOM_VALUE_YOU_CHECK_LATER &code_challenge=CHALLENGE &code_challenge_method=S256redirect_urimust exactly match a return address you added.stateis required. Addprompt=consentto always show the page; otherwise a member who already allowed the same permissions goes straight back. - The member comes back to your return address with
?code=...&state=..., or?error=access_denied&state=...if they cancelled. Checkstate. The code works once, for 60 seconds. - Swap the code for passes from your server:
Answer:curl -X POST https://spidertaz.com/silk/token \ -u "YOUR_CLIENT_ID:YOUR_APP_SECRET" \ -d grant_type=authorization_code \ -d code=THE_CODE \ -d redirect_uri=https://example.com/silk/callback \ -d code_verifier=THE_VERIFIER
Phone and desktop apps (app type "Phone or desktop app") have no secret: send{"access_token":"silk_at_...","token_type":"Bearer","expires_in":3600, "refresh_token":"silk_rt_...","scope":"profile.read"}client_idin the body and rely on PKCE. - Use the access pass:
curl https://spidertaz.com/silk/me -H "Authorization: Bearer silk_at_..." {"sub":"3f9c...","name":"SpiderFan","profile_url":"https://spidertaz.com/member/spiderfan"}subis the member's ID for your app only. It stays the same for your app and is different in every other app.
Permissions
| Permission | What the member sees | Status |
|---|---|---|
profile.read | See your public screen name and profile address | Ready |
pinitin.post | Post on PinItIn as you | Ready, needs review |
eatdrama.post | Post on EatDrama as you | Ready, needs review |
arcspoiler.post | Post in the ArcSpoiler community as you | Ready, needs review |
wruniverse.post | Post War Reports on WRUniverse as you | Ready, needs review |
pintotrav.post | Post traveler stories on PinToTrav as you | Ready, needs review |
geodigg.post | Post community reports on GeoDigg as you | Ready, needs review |
wrunity.post | Suggest links to WRUnity as you | Ready, needs review |
frontiers.post | Post War Reports on WRUniverse Frontiers as you | Ready, needs review |
gtageo.post | Send GTA 6 tips to GTAGeo as you | Ready, needs review |
newsspoiler.post | Send news tips to NewsSpoiler as you | Ready, needs review |
Posting for a member
With a site's posting permission (pinitin.post, eatdrama.post, arcspoiler.post, wruniverse.post, pintotrav.post, geodigg.post, wrunity.post, frontiers.post, gtageo.post or newsspoiler.post) and your app approved in review, post with the member's access pass. Each site checks the pass with SpiderTaz and applies its own posting rules and limits.
curl -X POST https://pinitin.com/api/v1/posts \
-H "Authorization: Bearer silk_at_..." \
-H "Content-Type: application/json" \
-d '{"text":"Loved this one","url":"https://example.com/story","title":"Great story","visibility":"public"}'
{"id":123,"url":"https://pinitin.com/post/123"}
| Site | Address | Fields |
|---|---|---|
| PinItIn | POST https://pinitin.com/api/v1/posts | text, url, title, visibility (public, members, private), allow_repeat |
| EatDrama | POST https://eatdrama.com/api/v1/posts | title, text, url, post_type (entertainment, celebrity, drama, gossip, lifestyle, post, reaction, clip, status), allow_repeat |
| ArcSpoiler | POST https://arcspoiler.com/api/v1/posts | text, url, category (general, runs, questions, discoveries), allow_repeat. The member needs an ArcSpoiler player profile. |
| WRUniverse | POST https://wruniverse.com/api/v1/posts | text, url, visibility (members, private, public), category (general, battle_results, builds, questions, achievements, clan_updates). For verified pilots only; five an hour. |
| PinToTrav | POST https://pintotrav.com/api/v1/posts | place (a PinToTrav destination like kyoto, or a place name like "Savannah, Georgia"), title, text (50 to 6,000 characters, no links), url (shown beside the story), allow_repeat. The member needs a confirmed email; five stories a day. |
| GeoDigg | POST https://geodigg.com/api/v1/posts | city ("City, ST", like "Palm Bay, FL"), title, text, url (added as the source), type (traffic, weather, public-safety, closure, event, community, question, other), timing (now, earlier, scheduled). A member's first 3 reports wait for a moderator; the answer says published or waiting_for_review. |
| WRUnity | POST https://wrunity.org/api/v1/posts | url (required), title, text, type (resource, lesson_idea, creator, other), allow_repeat. Every suggestion waits for a moderator before it shows. |
| WRUniverse Frontiers | POST https://frontiers.wruniverse.com/api/v1/posts | The same fields and rules as WRUniverse, with frontiers.post. |
| GTAGeo | POST https://gtageo.com/api/v1/posts | title and text (required: what was found and how players can check it), url (saved as the source), type (Location, Discovery, Screenshot, Video or Guide, Suggest a Fix, Player Tip, Map Note). Every tip waits for GTAGeo Review before anything changes on the map. |
| NewsSpoiler | POST https://newsspoiler.com/api/v1/posts | url (required), title, text, place, allow_repeat. Tips are private and reviewed; they are never published by themselves. |
Send text, url or both. Every post shows "via" your app's name. If the member shared the same link in the last day you get 409 duplicate with the earlier post; send allow_repeat: true to post it again. Other answers: 401 invalid_token, 403 insufficient_scope, 422 not_posted (the site's own limits or rules, with a plain reason), 429 slow_down.
Renewing and stopping
Access passes last 1 hour. Renewal passes last 60 days and are replaced every time you use one: always keep the newest. Sending an old renewal pass again stops all of that member's passes for your app, in case it was copied.
curl -X POST https://spidertaz.com/silk/token -u "YOUR_CLIENT_ID:YOUR_APP_SECRET" \
-d grant_type=refresh_token -d refresh_token=silk_rt_...
When a member signs out of your app for good, stop their passes: POST /silk/revoke with token=... and your app's sign-in. If a member removes your app in SILK connected apps, renewing fails with invalid_grant.
Errors
| Error | What it means |
|---|---|
invalid_client | Wrong client ID or app secret, or the app is suspended. |
invalid_grant | The code or renewal pass is wrong, used, expired, or the member removed your app. |
invalid_request | Something required is missing, such as state or PKCE. |
invalid_scope | You asked for a permission your app hasn't chosen, or one that isn't ready. |
access_denied | The member tapped Cancel, or your app is in test mode and they aren't a test member. |
invalid_token / insufficient_scope | From /silk/me: the access pass is wrong or expired, or lacks the permission. |
slow_down | Too many requests. Wait a minute (limits: 120 a minute from one address, 600 a minute per app). |
Rules
- Keep your app secret on your server. If it leaks, make a new one: the old one stops after 24 hours.
- Ask only for the permissions you use, and say plainly on your site what you do with them.
- New apps start in test mode: only you and up to 5 test members can allow them. Going live needs a description, website, privacy policy, a return address and Human Check Level 2 on your account.
- Posting apps are reviewed by SpiderTaz first, and every post says it came "via" your app.
- Apps that mislead members, spam or break these rules are suspended, which stops all their passes at once.