1
0
Fork 0
mirror of synced 2024-08-02 12:01:37 +12:00
appwrite/docs/sdks/dotnet/GETTING_STARTED.md

49 lines
1.8 KiB
Markdown
Raw Normal View History

2021-03-23 23:35:45 +13:00
## Getting Started
### Initialize & Make API Request
2023-05-15 19:13:20 +12:00
Once you have installed the package, it is extremely easy to get started with the SDK; all you need to do is import the package in your code, set your Appwrite credentials, and start making API calls. Below is a simple example:
2021-03-23 23:35:45 +13:00
```csharp
using Appwrite;
2023-05-15 19:13:20 +12:00
var client = new Client()
.SetEndpoint("http://cloud.appwrite.io/v1") // Make sure your endpoint is accessible
2023-05-16 14:40:55 +12:00
.SetProject("5ff3379a01d25") // Your project ID
.SetKey("cd868db89") // Your secret API key
.SetSelfSigned(); // Use only on dev mode with a self-signed SSL cert
2021-03-23 23:35:45 +13:00
2023-05-15 19:13:20 +12:00
var users = new Users(client);
2021-03-23 23:35:45 +13:00
2023-05-15 19:13:20 +12:00
var user = await users.Create(
userId: ID.Unique(),
email: "email@example.com",
password: "password",
name: "name");
2021-03-23 23:35:45 +13:00
2023-05-15 19:13:20 +12:00
Console.WriteLine(user.ToMap());
2021-03-23 23:35:45 +13:00
```
2021-03-26 21:00:50 +13:00
### Error Handling
2023-05-15 19:13:20 +12:00
The Appwrite .NET SDK raises an `AppwriteException` object with `message`, `code` and `response` properties. You can handle any errors by catching `AppwriteException` and present the `message` to the user or handle it yourself based on the provided error information. Below is an example.
2021-03-26 21:00:50 +13:00
```csharp
2023-05-15 19:13:20 +12:00
var users = new Users(client);
2021-03-26 21:00:50 +13:00
try {
2023-05-15 19:13:20 +12:00
var user = await users.Create(
userId: ID.Unique(),
email: "email@example.com",
password: "password",
name: "name");
2021-03-26 21:00:50 +13:00
} catch (AppwriteException e) {
2023-05-15 19:13:20 +12:00
Console.WriteLine(e.Message);
2021-03-26 21:00:50 +13:00
}
```
2021-03-23 23:35:45 +13:00
### Learn more
2021-07-07 22:25:49 +12:00
You can use the following resources to learn more and get help
2021-03-23 23:35:45 +13:00
- 🚀 [Getting Started Tutorial](https://appwrite.io/docs/getting-started-for-server)
- 📜 [Appwrite Docs](https://appwrite.io/docs)
- 💬 [Discord Community](https://appwrite.io/discord)
- 🚂 [Appwrite Dart Playground](https://github.com/appwrite/playground-for-dotnet)