Documentação
Lista de espera
Envie o registro da lista de espera por meio da API do aplicativo local.
Traduzido automaticamente do inglês. Ver o original em inglês
Envie essas solicitações para seu próprio sidecar em execução. Os valores permanecem neste navegador.
Como isso funciona
O sidecar escuta em uma porta de loopback escolhida na inicialização e a imprime em seu ready linha; use esse URL e o CADCAMFUN_TOKEN foi iniciado. As solicitações vão direto desta página para esse endereço.
O sidecar envia cabeçalhos CORS apenas para as origens Tauri e para http://localhost ou http://127.0.0.1 em qualquer porto. Nos documentos hospedados, o navegador bloqueia a resposta, então execute os documentos localmente (bun run dev em packages/web) para usar o playground ou copie a solicitação como curl. Para experimentar sem tocar em dados reais, inicie o sidecar com CADCAMFUN_DATA_DIR apontado para um diretório descartável - veja o passo a passo da API.
Operações
1 endpoint no waitlist grupo, gerado a partir do próprio sidecar Documento OpenAPI. As operações protegidas levam Authorization: Bearer $CADCAMFUN_TOKEN; ver autenticação. Comportamento e limites estão em o guia do subsistema.
| publicar | /api/waitlist | waitlist.join |
/api/waitlist
waitlist.join Requer Authorization: Bearer <token>.
{ email: string }
201 objeto application/json
{ success: true message: string }
400 WaitlistBadRequestEncoded application/json
WaitlistBadRequestEncoded
401 UnauthorizedEncoded application/json
UnauthorizedEncoded
409 WaitlistConflictEncoded application/json
WaitlistConflictEncoded
500 WaitlistInternalEncoded application/json
WaitlistInternalEncoded
Exemplo de SDK
import { CadCam } from "@cadcamfun/api/sdk"
const client = CadCam.make({
baseUrl: process.env.CADCAMFUN_URL!,
headers: { authorization: `Bearer ${process.env.CADCAMFUN_TOKEN}` },
})
// WaitlistJoinInput
const result = await client.waitlist.join({
email: ""
}) curl
curl --request POST "${CADCAMFUN_URL}/api/waitlist" \
--header "Authorization: Bearer ${CADCAMFUN_TOKEN}" \
--header "Content-Type: application/json" \
--data-binary @request.json Experimente
Esquemas
Esquemas nomeados acessíveis a partir dos parâmetros, corpos e respostas deste grupo. UM ? marca um campo opcional; | null marca um campo que pode estar presente com um valor nulo.
WaitlistBadRequestEncoded{ _tag: "WaitlistBadRequest" success: false message: string }
WaitlistConflictEncoded{ _tag: "WaitlistConflict" success: false message: string }
WaitlistInternalEncoded{ _tag: "WaitlistInternal" success: false message: string }
Chamando este grupo
Os IDs de operação têm o formato waitlist.<name>. O Promise SDK gerado (@cadcamfun/api/sdk) expõe a maioria deles como client.<namespace>.<method>(input), onde input é um objeto plano de parâmetros de caminho e campos de corpo; o exemplo do SDK de cada cartão mostra o acessador e o tipo de entrada exatos. Multipart uploads, respostas binárias ou JavaScript e webhooks brutos não são gerados; essas cartas mostram fetch em vez disso.
import { CadCam, ClientError } from "@cadcamfun/api/sdk"
const client = CadCam.make({
baseUrl: process.env.CADCAMFUN_URL!,
headers: { authorization: `Bearer ${process.env.CADCAMFUN_TOKEN}` },
})
try {
await client.projects.list()
} catch (error) {
if (error instanceof ClientError) {
// Transport | UnexpectedStatus | UnsupportedContentType | MalformedResponse | SseEventTooLarge
} else {
// a declared error body: switch on error._tag
}
} Solução de problemas
| Sintoma | Causa provável | Consertar |
|---|---|---|
| 401 em cada chamada | Token de um lançamento anterior ou ausente Bearer prefixo | Enviar Authorization: Bearer <token> com o token com o qual o sidecar foi iniciado. |
| 400 antes que algo aconteça | O corpo ou parâmetro não corresponde ao esquema | Compare a carga útil com o esquema de solicitação no cartão. |
| 403 ou 404 em um registro que você vê em outro lugar | A conta atuante difere | Envie o certo x-session-tokenou use o perfil local que possui o registro. |
| 409 | Estado conflitante, como um nome duplicado ou um cabeçalho de ramificação obsoleto | Leia novamente o recurso e tente novamente com os dados atuais. |
| Tente dizer "bloqueado pelo CORS" | Os documentos são veiculados a partir de uma origem sem loopback | Execute os documentos localmente ou copie a solicitação como curl. |
| Ligação recusada | O sidecar foi reiniciado em uma nova porta | Leia a porta do novo ready linha. |