API usage and setup guide

Java 17+ (HttpClient)

import java.net.http.*;
import java.net.URI;

var body = """
{
  "certificateType": "ai_report",
  "signerName": "Maria Lopez",
  "issuingCompany": "Acme Industrial",
  "inputEvidence":  [{"sha256Hash":"%s","evidenceType":"input"}],
  "outputEvidence": [{"sha256Hash":"%s","evidenceType":"output"}],
  "model": {"provider":"openai","modelName":"gpt-4o"}
}
""".formatted(inputHash, outputHash);

var req = HttpRequest.newBuilder(URI.create("https://api.needine.com/certificates"))
    .header("X-API-Key", System.getenv("NEEDINE_API_KEY"))
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

var res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());

.NET 8 (HttpClient)

using System.Net.Http.Json;

var http = new HttpClient { BaseAddress = new Uri("https://api.needine.com/") };
http.DefaultRequestHeaders.Add("X-API-Key", Environment.GetEnvironmentVariable("NEEDINE_API_KEY"));

var payload = new {
    certificateType = "ai_report",
    signerName = "Maria Lopez",
    issuingCompany = "Acme Bank",
    inputEvidence  = new[] { new { sha256Hash = inputHash,  evidenceType = "input"  } },
    outputEvidence = new[] { new { sha256Hash = outputHash, evidenceType = "output" } },
    model = new { provider = "openai", modelName = "gpt-4o" }
};

var res = await http.PostAsJsonAsync("certificates", payload);
res.EnsureSuccessStatusCode();
var cert = await res.Content.ReadFromJsonAsync<Dictionary<string, object>>();

Go

payload := map[string]any{
    "certificateType": "ai_report",
    "signerName":      "Maria Lopez",
    "issuingCompany":  "Acme Logistics",
    "inputEvidence":   []map[string]string{{"sha256Hash": inputHash,  "evidenceType": "input"}},
    "outputEvidence":  []map[string]string{{"sha256Hash": outputHash, "evidenceType": "output"}},
    "model":           map[string]string{"provider": "openai", "modelName": "gpt-4o"},
}
b, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.needine.com/certificates", bytes.NewReader(b))
req.Header.Set("X-API-Key", os.Getenv("NEEDINE_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)

PHP 8

$payload = [
  "certificateType" => "ai_report",
  "signerName"      => "Maria Lopez",
  "issuingCompany"  => "Acme Legal",
  "inputEvidence"   => [["sha256Hash" => $inputHash,  "evidenceType" => "input"]],
  "outputEvidence"  => [["sha256Hash" => $outputHash, "evidenceType" => "output"]],
  "model"           => ["provider" => "openai", "modelName" => "gpt-4o"],
];

$ch = curl_init("https://api.needine.com/certificates");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST           => true,
  CURLOPT_HTTPHEADER     => ["X-API-Key: " . getenv("NEEDINE_API_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS     => json_encode($payload),
]);
$cert = json_decode(curl_exec($ch), true);

Adapter architecture

[ERP / CRM]
   │ Event (BAPI / Outbound Message / Business Rule / Webhook)
   ▼
[Needine adapter]   ← customer or Needine microservice
   │ • ERP fields → Needine schema mapping
   │ • SHA-256 computation
   │ • Retries + queue (idempotency by externalId)
   │ • Vault for API key
   ▼
[Needine API]
   │
   │ signed webhook
   ▼
[Adapter]  →  Update ERP record (custom field: needine_certificate_id)

Apex (Salesforce) — example

public with sharing class NeedineService {
  @future(callout=true)
  public static void certify(Id reportId) {
    Report__c r = [SELECT Id, OutputHash__c, InputHash__c FROM Report__c WHERE Id = :reportId];

    HttpRequest req = new HttpRequest();
    req.setEndpoint('callout:Needine/certificates');
    req.setMethod('POST');
    req.setHeader('Content-Type', 'application/json');
    req.setBody(JSON.serialize(new Map<String, Object>{
      'certificateType' => 'ai_report',
      'signerName'      => UserInfo.getName(),
      'issuingCompany'  => 'Acme',
      'inputEvidence'   => new List<Object>{ new Map<String,String>{ 'sha256Hash' => r.InputHash__c,  'evidenceType' => 'input'  } },
      'outputEvidence'  => new List<Object>{ new Map<String,String>{ 'sha256Hash' => r.OutputHash__c, 'evidenceType' => 'output' } },
      'model'           => new Map<String,String>{ 'provider' => 'openai', 'modelName' => 'gpt-4o' }
    }));

    HttpResponse res = new Http().send(req);
    Map<String,Object> body = (Map<String,Object>) JSON.deserializeUntyped(res.getBody());
    update new Report__c(Id = reportId, NeedineCertificateId__c = (String) body.get('certificateId'));
  }
}