API রেফারেন্স

অতিথি GraphQL

শেয়ার লিঙ্কের মাধ্যমে এনক্রিপ্ট করা অ্যাক্সেস।

key = Base64UrlDecode(shared_token)শেয়ার লিংকের shared_token; c-id = shareId

ক্লায়েন্ট
https://<host>:<port>/guest_graphql
সার্ভার

POST /guest_graphql

c-id: 01a1cd7b-b900-7331-9331-313131313131

HTTP · binary

JSON({ requestId, query, variables })

requestId হলো UUIDv7 এবং অনুরোধের সময় ধারণ করে। variables, operationName ও extensions ঐচ্ছিক।

XChaCha20-Poly1305 · ক্ষেত্রে মাউস রাখুন বা স্পর্শ করুন
1 / 2

রিপ্লে প্রতিরোধ

requestId = UUIDv7()JSON { requestId, query, variables } → authenticated encryption
↓ POST /guest_graphql
প্রমাণীকরণ ও ডিক্রিপ্ট করুনshareId → shared_token✕ → প্রত্যাখ্যান করুন
↓
UUIDv7-এর সময় যাচাই করুন|serverTime − requestId timestamp| ≤ 60 s✕ → প্রত্যাখ্যান করুন
↓
চালানোর আগে requestId সংরক্ষণ করুনSQLite: guest + shareId + requestId
✓ ↓GraphQL চালান
✕ ↓পুনর্ব্যবহৃত requestId প্রত্যাখ্যান করুন
লাইব্রেরি কল

Desktop-এর অংশ। একই graphqlRequestPayload সহায়ক UUIDv7 requestId তৈরি করে; আলাদা timestamp বা পুনরাবৃত্তি রোধের nonce পাঠানো হয় না।

typescript
// plain-desktop/src/lib/api/guest.ts
const payload = graphqlRequestPayload(query, variables)
const requestBody = chachaEncrypt(key, payload, httpRequestAad('/guest_graphql'))
const response = await httpRequest(url, {
  method: 'POST', headers: { 'c-id': shareId }, body: requestBody
})
if (!response.ok) throw new Error(String(response.status))
const bytes = new Uint8Array(await response.arrayBuffer())
const result = JSON.parse(decryptGraphqlResponse(key, requestBody, bytes))
// Feature error codes are carried in extensions.code; message is diagnostic text.
if (result.errors?.length) throw GqlError.fromGraphql(result.errors[0])

HTTP 403: নিষ্ক্রিয় শেয়ার বা দূরবর্তী প্রবেশ বন্ধ। 401: ডিক্রিপশন ব্যর্থ। 400: ভুল বিন্যাসের, মেয়াদোত্তীর্ণ বা পুনরাবৃত্ত অনুরোধ।

টাইপ ডেফিনিশন

graphql
scalar Instant

scalar Long

type Query {
	sharedInfo(relativePath: String, password: String): SharedInfo!
}

type SharedFile {
	name: String!
	relativePath: String!
	isDir: Boolean!
	size: Long!
	mimeType: String!
	hasThumb: Boolean!
	createdAt: Instant
	updatedAt: Instant!
}

type SharedInfo {
	name: String!
	readOnly: Boolean!
	requiresPassword: Boolean!
	expiresAt: Instant
	urlToken: String!
	entries: [SharedFile!]!
}

"""
Directs the executor to include this field or fragment only when the `if` argument is true.
"""
directive @include(if: Boolean!) on FIELD | FRAGMENT_SPREAD | INLINE_FRAGMENT
"""
Directs the executor to skip this field or fragment when the `if` argument is true.
"""
directive @skip(if: Boolean!) on FIELD | FRAGMENT_SPREAD | INLINE_FRAGMENT
schema {
	query: Query
}