Skip to content

Commit 62dd54b

Browse files
Merge pull request #132 from appwrite/feat-add-api-info
2 parents d49d7c5 + 0e2ddb5 commit 62dd54b

File tree

1 file changed

+13
-6
lines changed

1 file changed

+13
-6
lines changed

src/routes/docs/references/+page.markdoc

+13-6
Original file line numberDiff line numberDiff line change
@@ -3,21 +3,28 @@ layout: article
33
title: References
44
description: Complete API references for Appwrite SDK, REST, and GraphQL APIs. Learn how to use Authentication, Databases, Storage, Functions, Avatars, Locale, and other Appwrite APIs.
55
---
6-
Appwrite lets you build integrations on web, mobile, native, and server platforms through a set of APIs. You can use one of our many SDKs or integrate directly through the REST API or GraphQL API.
6+
Appwrite lets you build integrations on web, mobile, native, and server platforms through a set of APIs. You can use one of our many [SDKs](/docs/sdks) or integrate directly through the [REST API](/docs/apis/rest) or [GraphQL API](/docs/apis/graphql).
77

88
## Client vs Server APIs {% #client-vs-server %}
99

1010
Client APIs and SDKs are for integrating with Appwrite to build client-based applications and websites.
11-
They're authenticated with sessions and operate within the permissions granted to the user account used to create the session.
11+
Client APIs only give access to resources if users have been [granted permissions](/docs/advanced/platform/permissions).
1212

1313
Server API and SDKs are for integrating with Appwrite to build backend or server applications.
14-
They're authenticated with API keys and are constrained by scope, ignoring user permissions.
14+
Server APIs are constrained by an [API key's](/docs/advanced/platform/api-keys) scope, ignoring user permissions.
1515

16-
Choose the appropriate API and SDK for your use case.
16+
## APIs {% #api %}
17+
Before using the Appwrite APIs, in the **Settings** of your Appwrite project, obtain your **API endpoint** and **Project ID**.
18+
Client APIs require an active session, created from [signing up and logging in](/docs/products/auth/accounts##-login).
19+
Server APIs require [API keys](/docs/advanced/platform/api-keys).
1720

18-
[Learn about SDKs {% icon icon="cheveron-right" /%}](/docs/sdks)
1921

20-
## APIs {% #api %}
22+
{% only_dark %}
23+
![Project settings screen](/images/docs/quick-starts/dark/project-id.png)
24+
{% /only_dark %}
25+
{% only_light %}
26+
![Project settings screen](/images/docs/quick-starts/project-id.png)
27+
{% /only_light %}
2128

2229
{% cards %}
2330
{% cards_item href="/docs/references/cloud/client-web/account" title="Account" %}

0 commit comments

Comments
 (0)