FIRMATO ORIGINAL · MOCK API v1
Integre o seu arquivo criativo
Teste as API Firmato com obras sintéticas e créditos virtuais: sem originais, débitos reais ou publicação pública.
Como começar
Aceda ao portal de parceiros, conclua as verificações e crie um projeto MOCK. Solicite explicitamente original:read e original:write. Os tokens existentes não recebem novas permissões automaticamente.
Authorization: Bearer <FIRMATO_MOCK_TOKEN>
Content-Type: application/json · Idempotency-Key: TEST-ORIGINAL-0001
Operações disponíveis
| Método | Recurso | Operação |
|---|---|---|
| GET | /v1/original-works | Listar obras sintéticas do projeto |
| POST | /v1/original-works | Criar uma obra sintética |
| GET | /v1/original-works/{id} | Consultar uma obra sintética |
| POST | /v1/original-works/{id}/compare | Simular a comparação de uma cópia |
| POST | /v1/original-works/{id}/cost-preview | Simular um resumo de custos |
https://firmato.org/api/v1/partners/index.php?route=%2Fmock%2Fv1%2Foriginal-works
external_reference: TEST-example · media_kind: image | audio | video | other
candidate_fixture: same | different
service_code: deposit | timestamp | storage | licence
Exemplo PHP
$client = new \Firmato\Sdk\Client(getenv('FIRMATO_MOCK_TOKEN'));
$work = $client->createOriginal('TEST-example', 'image', 'TEST-ORIGINAL-0001');
$id = $work['data']['id'];
$comparison = $client->compareOriginal($id, 'same', 'TEST-COMPARE-0001');
$preview = $client->previewOriginalCost($id, 'timestamp', 'TEST-PREVIEW-0001');Regras do Sandbox
Use referências TEST- e uma Idempotency-Key estável por pedido POST. Não envie ficheiros nem dados pessoais. A mesma chave com outro pedido devolve HTTP 409.
Os recursos são isolados por projeto. Os resultados MOCK não são assinaturas, selos temporais nem provas de titularidade ou publicação. Os créditos virtuais não representam preços reais.
Recursos Original apenas MOCK; LIVE desativado. Os testes nos CMS e o ensaio autenticado completo do novo fluxo continuam pendentes.
