Factuarea APIDevelopers

Cercar una tasca per clau

Cerca una tasca per la seva clau (DEV-12) enviada al body de la petició.

  • Les claus anteriors d'una tasca continuen funcionant després de moure-la a un altre projecte o de canviar la clau del projecte.
  • Retorna 404 task_not_found quan cap tasca de la teva empresa coincideix; una clau mal formada retorna 422 invalid_task_key.
  • És una consulta de només lectura: no cal Idempotency-Key.
POST
/companies/{company}/tasks/find-by-key

Authorization

AuthorizationBearer <token>

La teva API key com a token Bearer: fact_live_… en producció, fact_test_… en sandbox. Consulta la guia d'autenticació.

A: header

Paràmetres de ruta

company*string

Identificador públic (UUID v7) de l'empresa. Obtén-lo de GET /v1/me (data.scope[].id).

Formatuuid

Headers

Factuarea-Version?string

Fixa la versió de l'API (YYYY-MM-DD, versionat per data estil Stripe) per a aquesta petició; omet-lo per usar la versió fixada de la clau, o l'última si no n'hi ha cap. Versió no suportada → 400 unsupported_api_version; mal formada → 400 parameter_invalid_format. La versió efectiva es reflecteix a la capçalera de resposta Factuarea-Version. Consulta la guia de Versioning.

Formatdate

Cos de la petició

application/json

Definicions de TypeScript

Usa el tipus request body a TypeScript.

Cos de la resposta

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json