docs: Document data.readOneBy method with usage examples

This commit is contained in:
Jonas Perusquia Morales
2025-12-17 09:35:24 -06:00
parent 8ba4793160
commit 15ed075de3

View File

@@ -137,6 +137,35 @@ To retrieve a single record from an entity, use the `readOne` method:
const { data } = await api.data.readOne("posts", 1); const { data } = await api.data.readOne("posts", 1);
``` ```
### `data.readOneBy([entity], [query])`
To retrieve a single record from an entity using a query (e.g., by a specific field value) instead of an ID, use the `readOneBy` method:
```ts
const { data } = await api.data.readOneBy("posts", {
where: {
slug: "hello-world",
},
});
```
This is useful when you want to find a record by a unique field other than the primary key. You can also use `select`, `with`, and `join` options:
```ts
const { data } = await api.data.readOneBy("users", {
select: ["id", "email", "name"],
where: {
email: "user@example.com",
},
with: {
posts: {
limit: 5,
},
},
join: ["profile"],
});
```
### `data.createOne([entity], [data])` ### `data.createOne([entity], [data])`
To create a single record of an entity, use the `createOne` method: To create a single record of an entity, use the `createOne` method: